|
4 | 4 |
|
5 | 5 | --- |
6 | 6 |
|
7 | | -## 快速启动(5 步) |
| 7 | +## 快速启动(3 步) |
8 | 8 |
|
9 | 9 | ``` |
10 | | -1. 读取 README.md → 了解仓库定位 |
11 | | -2. 读取 prompts/INDEX.md → 了解 Prompts 结构 |
12 | | -3. 读取 AI-USAGE.md → 了解如何使用 |
13 | | -4. 读取 AI-ROUTING.md → 了解如何路由 |
14 | | -5. 准备执行用户任务 → 开始工作 |
| 10 | +1. 读取 README.md → 了解仓库定位和HCSA架构 |
| 11 | +2. 读取 .trae/skills/README.md → 了解Skills结构 |
| 12 | +3. 读取 .trae/skills/config/routing.yaml → 了解路由规则 |
15 | 13 | ``` |
16 | 14 |
|
17 | 15 | --- |
18 | 16 |
|
19 | | -## 仓库自扫描流程 |
20 | | - |
21 | | -当 AI 首次接触这个仓库时,应执行以下扫描: |
22 | | - |
23 | | -### 第一步:扫描仓库结构 |
24 | | - |
25 | | -``` |
26 | | -读取文件: |
27 | | -1。 README。md → 仓库定位 |
28 | | -2。 prompts/INDEX。md → Prompts 仓库结构 |
29 | | -3。 registry/ → 可用资源索引 |
30 | | -
|
31 | | -输出: |
32 | | -— 仓库功能概览 |
33 | | -— 可用资源地图 |
34 | | -— 快速导航路径 |
35 | | -``` |
36 | | - |
37 | | -### 第二步:构建任务地图 |
38 | | - |
39 | | -使用 `prompts/_routing/scan-repository-and-build-task-map.md` |
40 | | - |
41 | | -``` |
42 | | -执行扫描后,AI 应该知道: |
43 | | -— 有哪些任务类型可用 |
44 | | -— 每种任务类型对应哪些 Prompts |
45 | | -— 如何快速定位需要的资源 |
46 | | -``` |
47 | | - |
48 | | -### 第三步:理解路由机制 |
49 | | - |
50 | | -``` |
51 | | -AI 应该理解: |
52 | | -1。 何时需要路由?(用户需求不明确时) |
53 | | -2。 如何路由?(按 AI—ROUTING。md 的流程) |
54 | | -3。 组合原则?(Prompts 组合规则) |
55 | | -``` |
56 | | - |
57 | | ---- |
58 | | - |
59 | | -## 启动检查清单 |
60 | | - |
61 | | -### 仓库理解检查 |
62 | | - |
63 | | -- [ ] 理解仓库的定位和目标 |
64 | | -- [ ] 了解 prompts/ 的目录结构 |
65 | | -- [ ] 知道各类 Prompts 的用途 |
66 | | -- [ ] 了解 Skills 和 Workflows 的关系 |
67 | | -- [ ] 理解注册表的作用 |
68 | | - |
69 | | -### 路由能力检查 |
70 | | - |
71 | | -- [ ] 知道如何判断任务类型 |
72 | | -- [ ] 知道如何选择合适的 Prompt |
73 | | -- [ ] 知道何时需要 Workflow |
74 | | -- [ ] 知道如何组合多个 Prompts |
75 | | -- [ ] 知道如何使用 tool-use |
76 | | -- [ ] 知道如何使用 output prompt |
77 | | - |
78 | | -### 执行准备检查 |
79 | | - |
80 | | -- [ ] 能够准确理解用户需求 |
81 | | -- [ ] 能够识别隐含需求 |
82 | | -- [ ] 能够判断任务复杂度 |
83 | | -- [ ] 准备好备选方案 |
84 | | - |
85 | | ---- |
86 | | - |
87 | | -## 首次使用流程 |
| 17 | +## 仓库结构 |
88 | 18 |
|
89 | 19 | ``` |
90 | | -用户发起请求 |
91 | | - ↓ |
92 | | -┌─────────────────────────────────────┐ |
93 | | -│ 1。 快速扫描仓库(如果还没做) │ |
94 | | -│ — 读取 prompts/INDEX。md │ |
95 | | -│ — 构建任务类型映射 │ |
96 | | -└─────────────────────────────────────┘ |
97 | | - ↓ |
98 | | -┌─────────────────────────────────────┐ |
99 | | -│ 2。 理解用户需求 │ |
100 | | -│ — 提取核心目标 │ |
101 | | -│ — 识别隐含需求 │ |
102 | | -│ — 判断复杂度 │ |
103 | | -└─────────────────────────────────────┘ |
104 | | - ↓ |
105 | | -┌─────────────────────────────────────┐ |
106 | | -│ 3。 执行路由选择 │ |
107 | | -│ — 判断任务类型 │ |
108 | | -│ — 选择 Prompts │ |
109 | | -│ — 判断是否需要 Workflow │ |
110 | | -└─────────────────────────────────────┘ |
111 | | - ↓ |
112 | | -┌─────────────────────────────────────┐ |
113 | | -│ 4。 组合执行 │ |
114 | | -│ — 按顺序执行 Prompts │ |
115 | | -│ — 必要时使用 tool—use │ |
116 | | -│ — 使用 output prompt 格式化 │ |
117 | | -└─────────────────────────────────────┘ |
118 | | - ↓ |
119 | | -返回结果给用户 |
| 20 | +skill/ |
| 21 | +├── .trae/skills/ # HCSA架构技能库 |
| 22 | +│ ├── meta/ # 战略层 (任务规划、协调、反思) |
| 23 | +│ ├── workflows/ # 战术层 (流程编排) |
| 24 | +│ ├── actions/ # 执行层 (具体操作) |
| 25 | +│ ├── domains/ # 领域层 (领域专用) |
| 26 | +│ ├── config/ # 配置文件 |
| 27 | +│ └── shared/ # 共享资源 |
| 28 | +├── docs/ # 文档 |
| 29 | +├── src/ # 源代码 |
| 30 | +└── tests/ # 测试 |
120 | 31 | ``` |
121 | 32 |
|
122 | 33 | --- |
123 | 34 |
|
124 | | -## 缓存和记忆 |
125 | | - |
126 | | -### 短期记忆(单次会话) |
127 | | - |
128 | | -AI 应在会话中记住: |
129 | | -- 用户的主要目标 |
130 | | -- 已选择的 Prompts/Skills |
131 | | -- 任务执行状态 |
132 | | - |
133 | | -### 长期记忆(跨会话) |
| 35 | +## HCSA 四层架构 |
134 | 36 |
|
135 | | -如果仓库更新,AI 应重新: |
136 | | -1. 扫描 prompts/INDEX.md 更新索引 |
137 | | -2. 检查 registry/ 更新资源映射 |
138 | | -3. 确认新增的 Prompts/Skills |
| 37 | +| 层级 | 职责 | 示例 | |
| 38 | +|------|------|------| |
| 39 | +| **Meta** | 战略规划、任务分解 | task-planner, orchestrator, reflector | |
| 40 | +| **Workflow** | 流程编排、状态管理 | coding-workflow, debugging-workflow | |
| 41 | +| **Action** | 具体操作、工具调用 | code-generator, test-generator | |
| 42 | +| **Domain** | 领域专用知识 | python, react, docker, langchain | |
139 | 43 |
|
140 | 44 | --- |
141 | 45 |
|
142 | | -## 常见启动问题 |
143 | | - |
144 | | -### Q1:用户需求很模糊怎么办? |
145 | | - |
146 | | -``` |
147 | | -使用 workflow/vague—request—to—action |
148 | | -先澄清问题,再确定任务类型 |
149 | | -``` |
150 | | - |
151 | | -### Q2:不确定选哪个 Prompt? |
152 | | - |
153 | | -``` |
154 | | -参考 prompts/_routing/select—relevant—prompts—from—index |
155 | | -或使用 identify—task—type—and—route 让系统帮你选 |
156 | | -``` |
157 | | - |
158 | | -### Q3:需要多个 Prompts 怎么组合? |
159 | | - |
160 | | -``` |
161 | | -使用 prompts/_routing/compose—multiple—prompts—for—one—task |
162 | | -按单一职责、顺序传递、格式统一的原则组合 |
163 | | -``` |
| 46 | +## 路由规则 |
164 | 47 |
|
165 | | -### Q4:仓库很大,扫描太慢? |
166 | | - |
167 | | -``` |
168 | | -优先扫描: |
169 | | -1。 prompts/INDEX。md (必须) |
170 | | -2。 prompts/_routing/ (推荐) |
171 | | -3。 对应任务类型的目录 (按需) |
172 | | -
|
173 | | -其他内容:按需读取 |
174 | | -``` |
175 | | - |
176 | | ---- |
| 48 | +根据任务复杂度自动路由: |
177 | 49 |
|
178 | | -## 相关文档 |
| 50 | +- **复杂度 < 3**: 直接调用 Action 或 Domain skill |
| 51 | +- **复杂度 3-5**: 使用 Workflow skill 协调 |
| 52 | +- **复杂度 > 5**: 完整 Meta → Workflow → Action 流程 |
179 | 53 |
|
180 | | -- [README.md](README.md) - 仓库入口 |
181 | | -- [prompts/INDEX.md](prompts/INDEX.md) - Prompts 索引 |
182 | | -- [AI-USAGE.md](AI-USAGE.md) - 使用指南 |
183 | | -- [AI-ROUTING.md](AI-ROUTING.md) - 路由指南 |
| 54 | +详见 [.trae/skills/config/routing.yaml](.trae/skills/config/routing.yaml) |
0 commit comments