Skip to content

Commit 89a0e6f

Browse files
committed
docs: 更新文档以反映HCSA架构
- 更新 AI-BOOTSTRAP.md: 简化启动流程,添加HCSA架构说明 - 更新 AI-ROUTING.md: 更新路由规则和复杂度评估 - 更新 AI-USAGE.md: 更新技能选择指南 - 更新 ARCHITECTURE.md: 详细说明HCSA四层架构 - 更新 EXTENSION-GUIDE.md: 更新扩展指南 - 更新 INDEX.md: 更新全局索引 - 更新 SKILLS-INDEX.md: 按HCSA层级重新组织 - 删除 skills-inventory.md: 已被SKILLS-INDEX.md替代
1 parent a7ede30 commit 89a0e6f

File tree

8 files changed

+535
-1737
lines changed

8 files changed

+535
-1737
lines changed

AI-BOOTSTRAP.md

Lines changed: 29 additions & 158 deletions
Original file line numberDiff line numberDiff line change
@@ -4,180 +4,51 @@
44

55
---
66

7-
## 快速启动(5 步)
7+
## 快速启动(3 步)
88

99
```
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 → 了解路由规则
1513
```
1614

1715
---
1816

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+
## 仓库结构
8818

8919
```
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/ # 测试
12031
```
12132

12233
---
12334

124-
## 缓存和记忆
125-
126-
### 短期记忆(单次会话)
127-
128-
AI 应在会话中记住:
129-
- 用户的主要目标
130-
- 已选择的 Prompts/Skills
131-
- 任务执行状态
132-
133-
### 长期记忆(跨会话)
35+
## HCSA 四层架构
13436

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 |
13943

14044
---
14145

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+
## 路由规则
16447

165-
### Q4:仓库很大,扫描太慢?
166-
167-
```
168-
优先扫描:
169-
1。 prompts/INDEX。md (必须)
170-
2。 prompts/_routing/ (推荐)
171-
3。 对应任务类型的目录 (按需)
172-
173-
其他内容:按需读取
174-
```
175-
176-
---
48+
根据任务复杂度自动路由:
17749

178-
## 相关文档
50+
- **复杂度 < 3**: 直接调用 Action 或 Domain skill
51+
- **复杂度 3-5**: 使用 Workflow skill 协调
52+
- **复杂度 > 5**: 完整 Meta → Workflow → Action 流程
17953

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

Comments
 (0)