Skip to content

Commit 7149ccb

Browse files
committed
feat: 升级至HCSA v3.0架构
重大变更: - 重构为四层协作架构 (Meta → Workflow → Action → Domain) - 新增18个领域专用Skills (AI、测试、移动、数据等) - 完善智能路由系统 (routing.yaml v2.0) - 删除旧的prompts/registry/skills目录 - 更新主README和架构文档 新增Skills: - AI领域: langchain, prompt-engineering, rag-system - 测试领域: unit-test, integration-test, e2e-test - 移动开发: react-native, flutter - 数据处理: etl, data-validation - 后端开发: graphql, typescript - 前端开发: nextjs - 数据库: mongodb - DevOps: docker, kubernetes 统计: 423 files changed, +17234, -120443
1 parent da9f17a commit 7149ccb

File tree

423 files changed

+17234
-120443
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

423 files changed

+17234
-120443
lines changed

.trae/skills/README.md

Lines changed: 251 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,251 @@
1+
# Hierarchical Collaborative Skill Architecture (HCSA)
2+
3+
> **创新架构**: 将传统扁平Skill升级为四层协作系统,实现智能任务分解、自动协调、自我反思
4+
5+
## 目录结构
6+
7+
```
8+
.trae/skills/
9+
├── meta/ # 战略层 (任务规划、协调、反思)
10+
│ ├── task-planner/ # 任务规划器
11+
│ ├── orchestrator/ # 执行协调器
12+
│ └── reflector/ # 反思学习器
13+
14+
├── workflows/ # 战术层 (流程编排)
15+
│ ├── coding-workflow/ # 编码工作流
16+
│ └── debugging-workflow/ # 调试工作流
17+
18+
├── actions/ # 执行层 (具体操作)
19+
│ ├── code/ # 代码操作
20+
│ │ ├── api-design/ # API设计
21+
│ │ ├── code-formatting/ # 代码格式化
22+
│ │ ├── cross-file-refactor/ # 跨文件重构
23+
│ │ └── linting-config/ # Lint配置
24+
│ ├── code-generator/ # 代码生成
25+
│ ├── documentation/ # 文档生成
26+
│ ├── search/ # 代码搜索
27+
│ ├── test/ # 测试操作
28+
│ │ ├── code-coverage/ # 覆盖率分析
29+
│ │ └── test-generator/ # 测试生成
30+
│ └── tools/ # 工具操作
31+
│ ├── git-operations/ # Git操作
32+
│ └── tool-use/ # 工具使用
33+
34+
├── domains/ # 领域专用技能
35+
│ ├── ai/ # AI领域
36+
│ │ ├── langchain/ # LangChain框架
37+
│ │ ├── prompt-engineering/ # Prompt工程
38+
│ │ └── rag-system/ # RAG系统
39+
│ ├── backend/ # 后端开发
40+
│ │ ├── go/ # Go后端
41+
│ │ ├── graphql/ # GraphQL API
42+
│ │ ├── nodejs/ # Node.js后端
43+
│ │ ├── python/ # Python后端
44+
│ │ └── typescript/ # TypeScript开发
45+
│ ├── data/ # 数据处理
46+
│ │ ├── data-validation/ # 数据验证
47+
│ │ └── etl/ # ETL管道
48+
│ ├── database/ # 数据库
49+
│ │ ├── database-migration/ # 数据库迁移
50+
│ │ ├── mongodb/ # MongoDB
51+
│ │ ├── redis-caching/ # Redis缓存
52+
│ │ └── sql-optimization/ # SQL优化
53+
│ ├── devops/ # DevOps
54+
│ │ ├── ci-cd-pipeline/ # CI/CD流水线
55+
│ │ ├── docker/ # Docker容器化
56+
│ │ └── kubernetes/ # K8s编排
57+
│ ├── frontend/ # 前端开发
58+
│ │ ├── css-tailwind/ # Tailwind CSS
59+
│ │ ├── nextjs/ # Next.js全栈
60+
│ │ ├── react/ # React开发
61+
│ │ └── vue/ # Vue开发
62+
│ ├── infrastructure/ # 基础设施
63+
│ │ ├── docker/ # Docker容器化
64+
│ │ └── kubernetes/ # K8s编排
65+
│ ├── mcp/ # MCP集成
66+
│ │ ├── server-development/ # MCP服务器开发
67+
│ │ └── tools/ # MCP工具
68+
│ ├── mobile/ # 移动开发
69+
│ │ ├── flutter/ # Flutter开发
70+
│ │ └── react-native/ # React Native开发
71+
│ ├── performance/ # 性能优化
72+
│ │ └── performance-optimizer/ # 性能优化器
73+
│ ├── security/ # 安全
74+
│ │ └── security-auditor/ # 安全审计
75+
│ └── testing/ # 测试领域
76+
│ ├── e2e-test/ # 端到端测试
77+
│ ├── integration-test/ # 集成测试
78+
│ └── unit-test/ # 单元测试
79+
80+
├── shared/ # 共享资源
81+
│ └── schemas/ # JSON Schema
82+
83+
└── config/ # 配置文件
84+
```
85+
86+
## 快速索引
87+
88+
### 按层级查找
89+
90+
#### Meta层 (战略规划)
91+
| Skill | 描述 | 触发场景 |
92+
|-------|------|----------|
93+
| [task-planner](meta/task-planner) | 任务分解与规划 | 复杂任务、多步骤任务 |
94+
| [orchestrator](meta/orchestrator) | 执行协调与调度 | 多skill协作 |
95+
| [reflector](meta/reflector) | 反思与学习优化 | 任务完成后评估 |
96+
97+
#### Workflow层 (流程编排)
98+
| Skill | 描述 | 触发场景 |
99+
|-------|------|----------|
100+
| [coding-workflow](workflows/coding-workflow) | 编码任务流程 | 功能开发、代码实现 |
101+
| [debugging-workflow](workflows/debugging-workflow) | 调试任务流程 | Bug修复、问题排查 |
102+
103+
#### Action层 (执行操作)
104+
| Skill | 描述 | 触发场景 |
105+
|-------|------|----------|
106+
| [code-generator](actions/code-generator) | 代码生成 | 编写新代码 |
107+
| [documentation](actions/documentation) | 文档生成 | README、API文档 |
108+
| [code-search](actions/search) | 代码搜索 | 查找定义、用法分析 |
109+
| [api-design](actions/code/api-design) | API设计 | RESTful/GraphQL设计 |
110+
| [code-formatting](actions/code/code-formatting) | 代码格式化 | Prettier/Black配置 |
111+
| [linting-config](actions/code/linting-config) | Lint配置 | ESLint/Ruff配置 |
112+
| [cross-file-refactor](actions/code/cross-file-refactor) | 跨文件重构 | 重命名、移动代码 |
113+
| [test-generator](actions/test/test-generator) | 测试生成 | 创建测试用例 |
114+
| [code-coverage](actions/test/code-coverage) | 覆盖率分析 | 测试覆盖率 |
115+
| [git-operations](actions/tools/git-operations) | Git操作 | 分支管理、合并冲突 |
116+
| [tool-use](actions/tools/tool-use) | 工具使用 | 文件读取、命令执行 |
117+
118+
### 按领域查找
119+
120+
#### AI领域
121+
| Skill | 描述 | 技术栈 |
122+
|-------|------|--------|
123+
| [langchain](domains/ai/langchain) | LangChain框架 | Chain, Agent, RAG |
124+
| [prompt-engineering](domains/ai/prompt-engineering) | Prompt工程 | CoT, Few-shot, 结构化输出 |
125+
| [rag-system](domains/ai/rag-system) | RAG系统 | 向量数据库, Embeddings, 检索策略 |
126+
127+
#### 后端开发
128+
| Skill | 描述 | 技术栈 |
129+
|-------|------|--------|
130+
| [backend-python](domains/backend/python) | Python后端开发 | FastAPI, Django, Flask |
131+
| [backend-nodejs](domains/backend/nodejs) | Node.js后端开发 | Express, NestJS |
132+
| [backend-go](domains/backend/go) | Go后端开发 | Gin, Echo, gRPC |
133+
| [graphql](domains/backend/graphql) | GraphQL API开发 | Apollo, Schema设计 |
134+
| [typescript](domains/backend/typescript) | TypeScript开发 | 类型设计, 泛型编程 |
135+
136+
#### 前端开发
137+
| Skill | 描述 | 技术栈 |
138+
|-------|------|--------|
139+
| [frontend-react](domains/frontend/react) | React开发 | React, TypeScript |
140+
| [nextjs](domains/frontend/nextjs) | Next.js全栈 | SSR, SSG, App Router |
141+
| [frontend-vue](domains/frontend/vue) | Vue开发 | Vue3, Nuxt, TypeScript |
142+
| [css-tailwind](domains/frontend/css-tailwind) | Tailwind CSS | 响应式设计、暗黑模式 |
143+
144+
#### 移动开发
145+
| Skill | 描述 | 技术栈 |
146+
|-------|------|--------|
147+
| [react-native](domains/mobile/react-native) | React Native开发 | iOS, Android, Expo |
148+
| [flutter](domains/mobile/flutter) | Flutter开发 | Dart, Widget, 跨平台 |
149+
150+
#### 测试领域
151+
| Skill | 描述 | 技术栈 |
152+
|-------|------|--------|
153+
| [unit-test](domains/testing/unit-test) | 单元测试 | Jest, pytest, Go test |
154+
| [integration-test](domains/testing/integration-test) | 集成测试 | Supertest, TestContainers |
155+
| [e2e-test](domains/testing/e2e-test) | 端到端测试 | Playwright, Cypress |
156+
157+
#### 数据库
158+
| Skill | 描述 | 技术栈 |
159+
|-------|------|--------|
160+
| [mongodb](domains/database/mongodb) | MongoDB开发 | Mongoose, 聚合管道 |
161+
| [database-migration](domains/database/database-migration) | 数据库迁移 | Prisma, Flyway, Django |
162+
| [redis-caching](domains/database/redis-caching) | Redis缓存 | 缓存策略、限流、分布式锁 |
163+
| [sql-optimization](domains/database/sql-optimization) | SQL优化 | 索引设计、查询优化 |
164+
165+
#### 数据处理
166+
| Skill | 描述 | 技术栈 |
167+
|-------|------|--------|
168+
| [etl](domains/data/etl) | ETL管道开发 | Airflow, Spark, dbt |
169+
| [data-validation](domains/data/data-validation) | 数据验证 | Pydantic, Great Expectations |
170+
171+
#### DevOps
172+
| Skill | 描述 | 技术栈 |
173+
|-------|------|--------|
174+
| [docker](domains/devops/docker) | Docker容器化 | Dockerfile, Compose |
175+
| [kubernetes](domains/devops/kubernetes) | K8s编排 | Deployment, Service, Helm |
176+
| [ci-cd-pipeline](domains/devops/ci-cd-pipeline) | CI/CD流水线 | GitHub Actions, GitLab CI |
177+
178+
#### 安全与性能
179+
| Skill | 描述 | 技术栈 |
180+
|-------|------|--------|
181+
| [security-auditor](domains/security/security-auditor) | 安全审计 | 漏洞扫描、认证审查 |
182+
| [performance-optimizer](domains/performance/performance-optimizer) | 性能优化 | 瓶颈分析、算法优化 |
183+
184+
#### MCP集成
185+
| Skill | 描述 | 技术栈 |
186+
|-------|------|--------|
187+
| [mcp-server](domains/mcp/server-development) | MCP服务器开发 | TypeScript, MCP SDK |
188+
| [mcp-tools](domains/mcp/tools) | MCP工具创建 | Tool定义, 资源管理 |
189+
190+
## 使用指南
191+
192+
### 简单任务 (复杂度 < 3)
193+
194+
直接调用Action层或Domain层skill:
195+
196+
```
197+
用户: "给这个函数添加注释"
198+
→ 直接调用 code-generator
199+
```
200+
201+
### 中等任务 (复杂度 3-5)
202+
203+
使用Workflow层skill:
204+
205+
```
206+
用户: "实现用户登录功能"
207+
→ coding-workflow 协调多个action
208+
```
209+
210+
### 复杂任务 (复杂度 > 5)
211+
212+
完整三层流程:
213+
214+
```
215+
用户: "实现完整的用户认证系统"
216+
→ task-planner 分解任务
217+
→ orchestrator 协调执行
218+
→ coding-workflow 执行
219+
→ reflector 评估优化
220+
```
221+
222+
## Frontmatter规范
223+
224+
```yaml
225+
---
226+
name: skill-name
227+
description: "简短描述,包含关键词"
228+
layer: meta | workflow | action | domain
229+
role: planner | orchestrator | coordinator | executor | specialist
230+
version: 2.0.0
231+
invoked_by:
232+
- parent-skill
233+
capabilities:
234+
- capability1
235+
- capability2
236+
---
237+
```
238+
239+
## 统计信息
240+
241+
| 层级 | 数量 | 说明 |
242+
|------|------|------|
243+
| Meta | 3 | 战略规划层 |
244+
| Workflow | 2 | 流程编排层 |
245+
| Action | 11 | 执行操作层 |
246+
| Domain | 30+ | 领域专用层 |
247+
| **总计** | **46+** | 持续扩展中 |
248+
249+
## 相关文档
250+
251+
- [HCSA架构规范](../../docs/HIERARCHICAL-SKILL-ARCHITECTURE.md)

0 commit comments

Comments
 (0)