claude-pangu 2.0.2 → 2.0.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/plugin.json +1 -1
- package/package.json +1 -1
- package/skills/yishan/SKILL.md +280 -305
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://code.claude.com/plugin-schema.json",
|
|
3
3
|
"name": "oh-my-claude",
|
|
4
|
-
"version": "2.0.
|
|
4
|
+
"version": "2.0.4",
|
|
5
5
|
"description": "基于中国传统文化的 Claude Code 智能编排插件 - A Claude Code plugin inspired by Chinese traditional culture",
|
|
6
6
|
"author": "ZDragon17",
|
|
7
7
|
"contributors": [
|
package/package.json
CHANGED
package/skills/yishan/SKILL.md
CHANGED
|
@@ -1,19 +1,26 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: yishan
|
|
3
3
|
description: |
|
|
4
|
-
愚公移山循环技能 v2.
|
|
5
|
-
|
|
4
|
+
愚公移山循环技能 v2.1 - 智能动态工作流编排系统。
|
|
5
|
+
根据任务类型自动选择 Agent，按需循环直到质量达标。
|
|
6
6
|
---
|
|
7
7
|
|
|
8
|
-
# 愚公移山循环 (Yishan Loop) v2.
|
|
8
|
+
# 愚公移山循环 (Yishan Loop) v2.1
|
|
9
9
|
|
|
10
|
-
基于 oh-my-opencode 的
|
|
10
|
+
基于 oh-my-opencode 的 ultrawork 机制重新设计，支持**智能动态工作流**。
|
|
11
11
|
|
|
12
|
-
##
|
|
12
|
+
## 核心理念
|
|
13
13
|
|
|
14
|
-
|
|
14
|
+
> **不是机械走流程，而是智能达目标。**
|
|
15
15
|
|
|
16
|
-
|
|
16
|
+
- 任务驱动：根据任务类型决定需要哪些 Agent
|
|
17
|
+
- 按需循环：测试失败就修复，修复后再测试
|
|
18
|
+
- 智能退出：满足质量标准才能退出
|
|
19
|
+
- 代码清洁：完成后清理测试产物，保持代码库整洁
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## 关键词触发
|
|
17
24
|
|
|
18
25
|
| 关键词 | 说明 |
|
|
19
26
|
|--------|------|
|
|
@@ -22,383 +29,351 @@ description: |
|
|
|
22
29
|
| `移山` / `愚公` | 中文触发词 |
|
|
23
30
|
| `persist` | 持续执行 |
|
|
24
31
|
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
激活时，Agent 必须执行以下行为：
|
|
28
|
-
|
|
29
|
-
```
|
|
30
|
-
**必须**：首先向用户宣告 "🏔️ 愚公移山模式已激活！"
|
|
31
|
-
```
|
|
32
|
+
---
|
|
32
33
|
|
|
33
|
-
|
|
34
|
+
## 智能动态工作流
|
|
34
35
|
|
|
35
|
-
|
|
36
|
+
### 工作流状态机
|
|
36
37
|
|
|
37
38
|
```
|
|
38
|
-
|
|
39
|
-
|
|
39
|
+
┌─────────────────────────────────────────────────────────────────┐
|
|
40
|
+
│ 愚公移山工作流 │
|
|
41
|
+
├─────────────────────────────────────────────────────────────────┤
|
|
42
|
+
│ │
|
|
43
|
+
│ ┌──────────┐ │
|
|
44
|
+
│ │ 任务分析 │ ← 入口：分析任务类型，决定工作流 │
|
|
45
|
+
│ └────┬─────┘ │
|
|
46
|
+
│ │ │
|
|
47
|
+
│ ▼ │
|
|
48
|
+
│ ┌──────────┐ 需要理解需求？ │
|
|
49
|
+
│ │ 需求理解 │ ←── 复杂功能/模糊需求 → 李白 │
|
|
50
|
+
│ └────┬─────┘ 简单明确 → 跳过 │
|
|
51
|
+
│ │ │
|
|
52
|
+
│ ▼ │
|
|
53
|
+
│ ┌──────────┐ 需要探索代码？ │
|
|
54
|
+
│ │ 代码探索 │ ←── 不熟悉代码库 → 悟空 │
|
|
55
|
+
│ └────┬─────┘ 已了解 → 跳过 │
|
|
56
|
+
│ │ │
|
|
57
|
+
│ ▼ │
|
|
58
|
+
│ ┌──────────┐ 需要架构设计？ │
|
|
59
|
+
│ │ 架构设计 │ ←── 新功能/重构 → 诸葛 │
|
|
60
|
+
│ └────┬─────┘ 小改动 → 跳过 │
|
|
61
|
+
│ │ │
|
|
62
|
+
│ ▼ │
|
|
63
|
+
│ ┌──────────┐ │
|
|
64
|
+
│ │ 代码实现 │ ←── 鲁班（后端）/ 顾恺之（前端）/ 仓颉（数据库） │
|
|
65
|
+
│ └────┬─────┘ │
|
|
66
|
+
│ │ │
|
|
67
|
+
│ ▼ │
|
|
68
|
+
│ ┌──────────┐ ┌──────────┐ │
|
|
69
|
+
│ │ 测试验证 │ ←─→ │ Bug 修复 │ ← 循环直到测试通过 │
|
|
70
|
+
│ └────┬─────┘ └──────────┘ 包拯 ↔ 扁鹊 │
|
|
71
|
+
│ │ 测试通过 │
|
|
72
|
+
│ ▼ │
|
|
73
|
+
│ ┌──────────┐ 需要优化？ │
|
|
74
|
+
│ │ 性能优化 │ ←── 有性能要求 → 孙子 │
|
|
75
|
+
│ └────┬─────┘ 无要求 → 跳过 │
|
|
76
|
+
│ │ │
|
|
77
|
+
│ ▼ │
|
|
78
|
+
│ ┌──────────┐ 需要安全审计？ │
|
|
79
|
+
│ │ 安全审计 │ ←── 涉及认证/敏感数据 → 墨子 │
|
|
80
|
+
│ └────┬─────┘ 不涉及 → 跳过 │
|
|
81
|
+
│ │ │
|
|
82
|
+
│ ▼ │
|
|
83
|
+
│ ┌──────────┐ │
|
|
84
|
+
│ │ 代码清理 │ ←── 老子：简化代码、清理测试产物 │
|
|
85
|
+
│ └────┬─────┘ │
|
|
86
|
+
│ │ │
|
|
87
|
+
│ ▼ │
|
|
88
|
+
│ ┌──────────┐ │
|
|
89
|
+
│ │ 完成验收 │ ←── 魏征：最终代码审查 │
|
|
90
|
+
│ └──────────┘ │
|
|
91
|
+
│ │
|
|
92
|
+
└─────────────────────────────────────────────────────────────────┘
|
|
40
93
|
```
|
|
41
94
|
|
|
42
|
-
|
|
95
|
+
### 任务类型自动识别
|
|
43
96
|
|
|
44
|
-
|
|
45
|
-
- 每次 `TodoWrite` 更新状态后自动显示
|
|
46
|
-
- 使用简洁的单行/双行格式，不中断工作流
|
|
47
|
-
- 里程碑提示：0-25% 🚀 | 26-50% 💪 | 51-75% 🎯 | 76-99% 🏃 | 100% 🎉
|
|
97
|
+
启动时，愚公会分析任务并决定需要哪些阶段：
|
|
48
98
|
|
|
49
|
-
|
|
99
|
+
| 任务类型 | 自动启用的阶段 | 示例 |
|
|
100
|
+
|---------|---------------|------|
|
|
101
|
+
| **Bug 修复** | 探索 → 诊断 → 修复 → 测试 → 清理 | "修复登录报错" |
|
|
102
|
+
| **新功能** | 需求 → 探索 → 设计 → 实现 → 测试 → 清理 | "添加用户注册" |
|
|
103
|
+
| **重构** | 探索 → 设计 → 实现 → 测试 → 审查 → 清理 | "重构认证模块" |
|
|
104
|
+
| **性能优化** | 探索 → 分析 → 优化 → 测试 → 清理 | "优化查询性能" |
|
|
105
|
+
| **简单修改** | 实现 → 测试 → 清理 | "修改按钮文字" |
|
|
50
106
|
|
|
51
|
-
|
|
107
|
+
### 阶段跳过规则
|
|
52
108
|
|
|
53
|
-
|
|
109
|
+
**【重要】** 不是每个任务都要走完整流程：
|
|
54
110
|
|
|
55
|
-
```text
|
|
56
|
-
╔══════════════════════════════════════════════════════════════╗
|
|
57
|
-
║ 🎉 愚公移山 - 任务完成！ ║
|
|
58
|
-
╠══════════════════════════════════════════════════════════════╣
|
|
59
|
-
║ 📊 完成统计: ✅ 10/10 (100%) ║
|
|
60
|
-
║ ⏱️ 总耗时: 约 15 分钟 ║
|
|
61
|
-
║ 🎭 参与 Agent: 悟空、诸葛、鲁班、包拯 ║
|
|
62
|
-
╚══════════════════════════════════════════════════════════════╝
|
|
63
111
|
```
|
|
112
|
+
简单任务（< 30分钟）：
|
|
113
|
+
✓ 实现 → 测试 → 清理
|
|
114
|
+
✗ 跳过：需求分析、架构设计、性能优化
|
|
64
115
|
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
- Linux: notify-send
|
|
69
|
-
|
|
70
|
-
### 5. 执行透明度（用户控制感）
|
|
71
|
-
|
|
72
|
-
为避免用户感到"黑盒执行"，必须在关键节点输出状态：
|
|
73
|
-
|
|
74
|
-
#### 5.1 任务启动时
|
|
75
|
-
|
|
76
|
-
```text
|
|
77
|
-
🏔️ 愚公移山模式已激活！
|
|
78
|
-
|
|
79
|
-
📋 任务概览:
|
|
80
|
-
目标: [用户的任务描述]
|
|
81
|
-
预估: ~[X] 分钟 (基于任务复杂度)
|
|
82
|
-
|
|
83
|
-
⚙️ 执行计划:
|
|
84
|
-
1. 探索阶段 - 悟空分析代码结构
|
|
85
|
-
2. 设计阶段 - 诸葛制定方案
|
|
86
|
-
3. 实现阶段 - 鲁班编写代码
|
|
87
|
-
4. 验证阶段 - 包拯测试验收
|
|
116
|
+
中等任务（30分钟 - 2小时）：
|
|
117
|
+
✓ 探索 → 实现 → 测试 → 修复循环 → 清理
|
|
118
|
+
✗ 跳过：详细需求分析、安全审计
|
|
88
119
|
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
• 输入 /pause 安全暂停（保存进度）
|
|
92
|
-
• 输入 /cancel-yishan 取消任务
|
|
120
|
+
复杂任务（> 2小时）：
|
|
121
|
+
✓ 全流程：需求 → 探索 → 设计 → 实现 → 测试 → 优化 → 审计 → 清理
|
|
93
122
|
```
|
|
94
123
|
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
**【NON-NEGOTIABLE】** 每次调用子 Agent 时，**必须**生成标准化交接报告：
|
|
98
|
-
|
|
99
|
-
```text
|
|
100
|
-
📦 Agent 交接报告
|
|
101
|
-
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
102
|
-
|
|
103
|
-
🔄 交接: [源 Agent] → [目标 Agent]
|
|
104
|
-
⏰ 时间: [当前时间]
|
|
105
|
-
|
|
106
|
-
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
107
|
-
|
|
108
|
-
✅ 已完成工作:
|
|
109
|
-
• [具体完成的任务 1]
|
|
110
|
-
• [具体完成的任务 2]
|
|
111
|
-
|
|
112
|
-
📁 产出文件:
|
|
113
|
-
• [文件路径 1] - [简要说明]
|
|
114
|
-
• [文件路径 2] - [简要说明]
|
|
115
|
-
|
|
116
|
-
📋 关键决策:
|
|
117
|
-
• [决策 1]: [原因]
|
|
118
|
-
|
|
119
|
-
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
120
|
-
|
|
121
|
-
📋 下一步任务:
|
|
122
|
-
• [具体任务 1]
|
|
123
|
-
• [具体任务 2]
|
|
124
|
-
|
|
125
|
-
⚠️ 注意事项:
|
|
126
|
-
• [注意点 1]
|
|
124
|
+
---
|
|
127
125
|
|
|
128
|
-
|
|
126
|
+
## Agent 智能分派
|
|
127
|
+
|
|
128
|
+
### Agent 职责映射
|
|
129
|
+
|
|
130
|
+
| Agent | 职责 | 触发条件 |
|
|
131
|
+
|-------|------|---------|
|
|
132
|
+
| 🎭 **李白** | 需求理解、用户故事 | 需求不明确、复杂功能 |
|
|
133
|
+
| 🔍 **悟空** | 代码探索、依赖分析 | 不熟悉代码、定位问题 |
|
|
134
|
+
| 🎯 **诸葛** | 架构设计、技术选型 | 新功能、重构、技术决策 |
|
|
135
|
+
| 🔧 **鲁班** | 后端实现、业务逻辑 | 编写代码 |
|
|
136
|
+
| 🎨 **顾恺之** | 前端实现、UI组件 | 界面相关 |
|
|
137
|
+
| 📊 **仓颉** | 数据库设计、SQL | 数据相关 |
|
|
138
|
+
| ⚖️ **包拯** | 测试编写、验证 | 需要测试 |
|
|
139
|
+
| 🩺 **扁鹊** | Bug诊断、修复 | 测试失败、报错 |
|
|
140
|
+
| ⚔️ **孙子** | 性能分析、优化 | 性能要求 |
|
|
141
|
+
| 🛡️ **墨子** | 安全审计、防护 | 涉及安全 |
|
|
142
|
+
| ☯️ **老子** | 代码简化、清理 | 完成后清理 |
|
|
143
|
+
| 🪞 **魏征** | 代码审查、规范 | 最终验收 |
|
|
144
|
+
| 📜 **司马迁** | 文档更新 | 需要文档 |
|
|
145
|
+
|
|
146
|
+
### 动态调用示例
|
|
147
|
+
|
|
148
|
+
```javascript
|
|
149
|
+
// 愚公根据任务动态决定调用哪些 Agent
|
|
150
|
+
|
|
151
|
+
任务: "用户反馈登录页面报错 500"
|
|
152
|
+
|
|
153
|
+
愚公分析:
|
|
154
|
+
→ 任务类型: Bug 修复
|
|
155
|
+
→ 需要阶段: 探索 → 诊断 → 修复 → 测试 → 清理
|
|
156
|
+
|
|
157
|
+
执行流程:
|
|
158
|
+
1. @悟空 定位登录相关代码和错误日志
|
|
159
|
+
2. @扁鹊 诊断 500 错误的根因
|
|
160
|
+
3. @鲁班 修复代码问题
|
|
161
|
+
4. @包拯 编写/运行测试验证
|
|
162
|
+
→ 如果测试失败 → 回到 @扁鹊 继续诊断
|
|
163
|
+
→ 循环直到测试通过
|
|
164
|
+
5. @老子 清理调试代码和临时文件
|
|
165
|
+
6. 完成 ✓
|
|
129
166
|
```
|
|
130
167
|
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
1. **不输出交接报告 = 违规** - 每次 Agent 切换必须有交接报告
|
|
134
|
-
2. **交接报告保存** - 同时保存到 `~/.oh-my-claude/handoffs/` 目录
|
|
135
|
-
3. **信息完整性检查** - 必须包含：已完成工作、产出文件、下一步任务
|
|
136
|
-
4. **简洁原则** - 报告要精炼，每项 1-2 句话即可
|
|
137
|
-
|
|
138
|
-
**交接报告详细格式**（参见 agent-handoff skill）：
|
|
168
|
+
---
|
|
139
169
|
|
|
140
|
-
|
|
141
|
-
- 提供产出文件的完整路径
|
|
142
|
-
- 说明关键技术决策及其原因
|
|
143
|
-
- 列出下一个 Agent 的具体可执行任务
|
|
144
|
-
- 标注可能的风险和注意事项
|
|
170
|
+
## 测试-修复循环（核心机制）
|
|
145
171
|
|
|
146
|
-
|
|
172
|
+
### 循环规则
|
|
147
173
|
|
|
148
|
-
```
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
174
|
+
```
|
|
175
|
+
┌─────────────┐
|
|
176
|
+
│ 编写测试 │ ← 包拯
|
|
177
|
+
└──────┬──────┘
|
|
178
|
+
↓
|
|
179
|
+
┌─────────────┐ 失败
|
|
180
|
+
│ 运行测试 │ ─────────┐
|
|
181
|
+
└──────┬──────┘ │
|
|
182
|
+
│ 通过 ↓
|
|
183
|
+
│ ┌─────────────┐
|
|
184
|
+
│ │ 诊断问题 │ ← 扁鹊
|
|
185
|
+
│ └──────┬──────┘
|
|
186
|
+
│ ↓
|
|
187
|
+
│ ┌─────────────┐
|
|
188
|
+
│ │ 修复代码 │ ← 鲁班/扁鹊
|
|
189
|
+
│ └──────┬──────┘
|
|
190
|
+
│ │
|
|
191
|
+
│ └────────→ 回到运行测试
|
|
192
|
+
↓
|
|
193
|
+
┌─────────────┐
|
|
194
|
+
│ 测试通过 │
|
|
195
|
+
└─────────────┘
|
|
153
196
|
```
|
|
154
197
|
|
|
155
|
-
###
|
|
156
|
-
|
|
157
|
-
#### 6.1 暂停命令 `/pause` 或 `/yishan-pause`
|
|
158
|
-
|
|
159
|
-
用户可以随时安全暂停，系统会保存当前状态：
|
|
160
|
-
|
|
161
|
-
```text
|
|
162
|
-
⏸️ 愚公移山 - 已暂停
|
|
163
|
-
|
|
164
|
-
📊 进度快照已保存:
|
|
165
|
-
已完成: 4/10 TODO
|
|
166
|
-
当前任务: 实现用户登录
|
|
167
|
-
参与 Agent: 悟空, 诸葛, 鲁班
|
|
168
|
-
|
|
169
|
-
💾 状态文件: ~/.claude/yishan-checkpoint.json
|
|
198
|
+
### 最大循环限制
|
|
170
199
|
|
|
171
|
-
|
|
172
|
-
• 输入 /yishan-resume 继续任务
|
|
173
|
-
• 或输入 /yishan [新任务] 开始新任务
|
|
174
|
-
```
|
|
200
|
+
为防止无限循环，设置上限：
|
|
175
201
|
|
|
176
|
-
|
|
202
|
+
| 情况 | 最大循环次数 | 超过后行为 |
|
|
203
|
+
|------|-------------|-----------|
|
|
204
|
+
| 单个测试修复 | 5 次 | 请求用户介入 |
|
|
205
|
+
| 整体测试套件 | 10 次 | 暂停并报告 |
|
|
177
206
|
|
|
178
|
-
|
|
207
|
+
---
|
|
179
208
|
|
|
180
|
-
|
|
181
|
-
📂 检测到未完成任务
|
|
209
|
+
## 代码清理阶段（强制）
|
|
182
210
|
|
|
183
|
-
|
|
184
|
-
任务: 重构认证模块
|
|
185
|
-
进度: 40% (4/10)
|
|
186
|
-
暂停时间: 2小时前
|
|
211
|
+
### 清理内容
|
|
187
212
|
|
|
188
|
-
|
|
189
|
-
[1] /yishan-resume - 继续上次任务
|
|
190
|
-
[2] /yishan [新任务] - 放弃并开始新任务
|
|
191
|
-
```
|
|
213
|
+
**【NON-NEGOTIABLE】** 完成后必须清理：
|
|
192
214
|
|
|
193
|
-
|
|
215
|
+
| 清理项 | 说明 |
|
|
216
|
+
|-------|------|
|
|
217
|
+
| 调试代码 | `console.log`、`debugger`、`print` 等 |
|
|
218
|
+
| 临时文件 | 测试过程中生成的临时文件 |
|
|
219
|
+
| 注释掉的代码 | 删除而非注释 |
|
|
220
|
+
| 未使用的导入 | 清理 dead imports |
|
|
221
|
+
| 测试数据 | 清理硬编码的测试数据 |
|
|
194
222
|
|
|
195
|
-
|
|
223
|
+
### 清理检查清单
|
|
196
224
|
|
|
197
225
|
```text
|
|
198
|
-
|
|
199
|
-
|
|
226
|
+
📋 代码清理检查
|
|
227
|
+
|
|
228
|
+
□ 无调试语句 (console.log/debugger/print)
|
|
229
|
+
□ 无注释掉的代码块
|
|
230
|
+
□ 无未使用的变量/导入
|
|
231
|
+
□ 无临时测试文件
|
|
232
|
+
□ 无硬编码测试数据
|
|
233
|
+
□ 代码格式统一 (运行 formatter)
|
|
234
|
+
□ 类型检查通过 (如适用)
|
|
200
235
|
```
|
|
201
236
|
|
|
202
237
|
---
|
|
203
238
|
|
|
204
|
-
##
|
|
239
|
+
## 退出条件（智能判断）
|
|
205
240
|
|
|
206
|
-
###
|
|
241
|
+
### 标准退出条件
|
|
207
242
|
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
| 中国文化 Agent | Claude subagent_type | 专长领域 |
|
|
211
|
-
|---------------|---------------------|----------|
|
|
212
|
-
| 悟空 (wukong) | `explore` | 代码侦察、文件探索 |
|
|
213
|
-
| 诸葛 (zhuge) | `oracle` | 架构设计、战略顾问 |
|
|
214
|
-
| 鲁班 (luban) | `general` | 代码实现、精工巧匠 |
|
|
215
|
-
| 扁鹊 (bianque) | `debugger` | Bug诊断、问题修复 |
|
|
216
|
-
| 司马迁 (simaqian) | `document-writer` | 文档撰写、变更记录 |
|
|
217
|
-
| 顾恺之 (gukaizhi) | `frontend-ui-ux-engineer` | UI/UX设计、界面美学 |
|
|
218
|
-
| 墨子 (mozi) | `security-auditor` | 安全审计、防御编程 |
|
|
219
|
-
| 孙子 (sunzi) | `performance-engineer` | 性能优化、系统调优 |
|
|
220
|
-
| 包拯 (baozheng) | `test-engineer` | 测试专家、TDD |
|
|
221
|
-
| 魏征 (weizheng) | `code-reviewer` | 代码审查、规范检查 |
|
|
222
|
-
| 老子 (laozi) | `general` | 代码简化、Clean Code |
|
|
223
|
-
| 仓颉 (cangjie) | `database-architect` | 数据库设计、SQL优化 |
|
|
224
|
-
|
|
225
|
-
### 任务分派规则
|
|
226
|
-
|
|
227
|
-
根据任务关键词自动识别需要的 Agent：
|
|
228
|
-
|
|
229
|
-
| 任务关键词 | 分派给 |
|
|
230
|
-
|-----------|--------|
|
|
231
|
-
| 探索、查找、定位 | 悟空 (explore) |
|
|
232
|
-
| 架构、设计、规划 | 诸葛 (oracle) |
|
|
233
|
-
| 实现、编码、开发 | 鲁班 (general) |
|
|
234
|
-
| 调试、诊断、修复 | 扁鹊 (debugger) |
|
|
235
|
-
| 文档、注释、记录 | 司马迁 (document-writer) |
|
|
236
|
-
| 界面、UI、样式 | 顾恺之 (frontend-ui-ux-engineer) |
|
|
237
|
-
| 安全、审计、防护 | 墨子 (security-auditor) |
|
|
238
|
-
| 性能、优化、加速 | 孙子 (performance-engineer) |
|
|
239
|
-
| 测试、验证、断言 | 包拯 (test-engineer) |
|
|
240
|
-
| 审查、检查、规范 | 魏征 (code-reviewer) |
|
|
241
|
-
|
|
242
|
-
### 实际调用方式
|
|
243
|
-
|
|
244
|
-
使用 `Task` 工具调用子 agents：
|
|
243
|
+
愚公在以下条件**全部满足**时才能退出：
|
|
245
244
|
|
|
246
245
|
```
|
|
247
|
-
|
|
248
|
-
Task(subagent_type="explore", prompt="作为悟空（代码侦察专家），请探索项目中所有与用户认证相关的代码文件，分析其结构和依赖关系。")
|
|
246
|
+
✅ 退出检查清单
|
|
249
247
|
|
|
250
|
-
|
|
251
|
-
|
|
248
|
+
1. 功能完成
|
|
249
|
+
□ 所有 TODO 标记为 completed
|
|
250
|
+
□ 用户需求已实现
|
|
252
251
|
|
|
253
|
-
|
|
254
|
-
|
|
252
|
+
2. 质量达标
|
|
253
|
+
□ 所有测试通过（如有）
|
|
254
|
+
□ 构建成功（如适用）
|
|
255
|
+
□ 无 TypeScript/ESLint 错误（如适用）
|
|
255
256
|
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
### 并行调用
|
|
261
|
-
|
|
262
|
-
独立任务应并行发起多个 agents：
|
|
257
|
+
3. 代码清洁
|
|
258
|
+
□ 清理检查清单已完成
|
|
259
|
+
□ 无调试代码残留
|
|
260
|
+
□ 代码已格式化
|
|
263
261
|
|
|
262
|
+
4. 验证通过
|
|
263
|
+
□ 手动验证功能正常（如需要）
|
|
264
|
+
□ 无回归问题
|
|
264
265
|
```
|
|
265
|
-
# 并行启动探索和文档任务
|
|
266
|
-
Task(subagent_type="explore", prompt="悟空：探索现有代码结构...")
|
|
267
|
-
Task(subagent_type="document-writer", prompt="司马迁：整理现有文档...")
|
|
268
266
|
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
267
|
+
### 不允许的退出情况
|
|
268
|
+
|
|
269
|
+
| 情况 | 为什么不能退出 |
|
|
270
|
+
|------|---------------|
|
|
271
|
+
| "测试应该能通过" | 没有证据，必须运行 |
|
|
272
|
+
| "我修复了 bug" | 没有验证，必须测试 |
|
|
273
|
+
| TODO 还有 pending | 任务未完成 |
|
|
274
|
+
| 有调试代码残留 | 代码不干净 |
|
|
275
|
+
| 构建失败 | 基本质量不达标 |
|
|
273
276
|
|
|
274
277
|
---
|
|
275
278
|
|
|
276
|
-
##
|
|
279
|
+
## 实时进度显示
|
|
277
280
|
|
|
278
|
-
###
|
|
281
|
+
### 进度条格式
|
|
279
282
|
|
|
283
|
+
```text
|
|
284
|
+
📊 ████████████░░░░░░░░░░░░░░░░░░ 40% (4/10) 💪
|
|
285
|
+
🔄 当前: @包拯 运行测试 | ⏳ 剩余: 6
|
|
280
286
|
```
|
|
281
|
-
Task(subagent_type="explore", prompt="悟空：全面探索代码库，分析现有实现和依赖关系...")
|
|
282
|
-
```
|
|
283
|
-
|
|
284
|
-
等待探索结果，了解代码现状。
|
|
285
287
|
|
|
286
|
-
###
|
|
288
|
+
### 阶段切换提示
|
|
287
289
|
|
|
290
|
+
```text
|
|
291
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
292
|
+
🔄 阶段切换: 实现 → 测试
|
|
293
|
+
📋 @鲁班 完成 → @包拯 接手
|
|
294
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
288
295
|
```
|
|
289
|
-
Task(subagent_type="oracle", prompt="诸葛：基于探索结果，设计实现方案...")
|
|
290
|
-
```
|
|
291
|
-
|
|
292
|
-
获取架构建议和技术决策。
|
|
293
296
|
|
|
294
|
-
|
|
297
|
+
---
|
|
295
298
|
|
|
296
|
-
|
|
297
|
-
# 后端实现
|
|
298
|
-
Task(subagent_type="general", prompt="鲁班：实现后端API和业务逻辑...")
|
|
299
|
+
## 任务启动模板
|
|
299
300
|
|
|
300
|
-
|
|
301
|
-
Task(subagent_type="frontend-ui-ux-engineer", prompt="顾恺之：实现前端界面...")
|
|
301
|
+
激活时输出：
|
|
302
302
|
|
|
303
|
-
|
|
304
|
-
|
|
305
|
-
```
|
|
303
|
+
```text
|
|
304
|
+
🏔️ 愚公移山模式已激活！
|
|
306
305
|
|
|
307
|
-
|
|
306
|
+
📋 任务分析:
|
|
307
|
+
类型: [Bug修复/新功能/重构/优化/简单修改]
|
|
308
|
+
复杂度: [简单/中等/复杂]
|
|
308
309
|
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
310
|
+
⚙️ 动态工作流:
|
|
311
|
+
[✓] 代码探索 - @悟空
|
|
312
|
+
[✓] 代码实现 - @鲁班
|
|
313
|
+
[✓] 测试验证 - @包拯 ↔ @扁鹊 (循环)
|
|
314
|
+
[✓] 代码清理 - @老子
|
|
315
|
+
[ ] 架构设计 - 跳过（简单任务）
|
|
316
|
+
[ ] 性能优化 - 跳过（无要求）
|
|
315
317
|
|
|
316
|
-
|
|
318
|
+
💡 提示:
|
|
319
|
+
• /status 查看当前状态
|
|
320
|
+
• /pause 安全暂停
|
|
321
|
+
• /cancel-yishan 取消任务
|
|
317
322
|
|
|
318
|
-
|
|
319
|
-
Task(subagent_type="performance-engineer", prompt="孙子：分析和优化性能...")
|
|
320
|
-
Task(subagent_type="general", prompt="老子：简化代码，去除冗余...")
|
|
321
|
-
Task(subagent_type="document-writer", prompt="司马迁：更新文档...")
|
|
323
|
+
开始执行...
|
|
322
324
|
```
|
|
323
325
|
|
|
324
326
|
---
|
|
325
327
|
|
|
326
|
-
##
|
|
327
|
-
|
|
328
|
-
### 规则
|
|
329
|
-
|
|
330
|
-
1. **必须使用 TodoWrite** - 将任务分解为具体的 TODO 项
|
|
331
|
-
2. **实时更新状态** - 完成一个就标记一个，不要批量更新
|
|
332
|
-
3. **不允许中途停止** - TODO 未全部完成前不能结束对话
|
|
333
|
-
4. **自我检查** - 每次准备停止前，检查是否有未完成的 TODO
|
|
328
|
+
## 完成报告模板
|
|
334
329
|
|
|
335
|
-
|
|
336
|
-
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
|
|
342
|
-
|
|
330
|
+
```text
|
|
331
|
+
╔══════════════════════════════════════════════════════════════╗
|
|
332
|
+
║ 🎉 愚公移山 - 任务完成！ ║
|
|
333
|
+
╠══════════════════════════════════════════════════════════════╣
|
|
334
|
+
║ ║
|
|
335
|
+
║ 📋 任务: [任务描述] ║
|
|
336
|
+
║ ║
|
|
337
|
+
║ 📊 执行统计: ║
|
|
338
|
+
║ • TODO 完成: ✅ 8/8 (100%) ║
|
|
339
|
+
║ • 测试-修复循环: 2 次 ║
|
|
340
|
+
║ • 参与 Agent: 悟空、鲁班、包拯、扁鹊、老子 ║
|
|
341
|
+
║ ║
|
|
342
|
+
║ ✅ 质量检查: ║
|
|
343
|
+
║ • 所有测试通过 ✓ ║
|
|
344
|
+
║ • 构建成功 ✓ ║
|
|
345
|
+
║ • 代码已清理 ✓ ║
|
|
346
|
+
║ • 无调试代码 ✓ ║
|
|
347
|
+
║ ║
|
|
348
|
+
║ 📁 变更文件: ║
|
|
349
|
+
║ • src/auth/login.ts (修改) ║
|
|
350
|
+
║ • tests/auth/login.test.ts (新增) ║
|
|
351
|
+
║ ║
|
|
352
|
+
╚══════════════════════════════════════════════════════════════╝
|
|
343
353
|
```
|
|
344
354
|
|
|
345
355
|
---
|
|
346
356
|
|
|
347
|
-
##
|
|
348
|
-
|
|
349
|
-
**没有证据 = 没有完成。**
|
|
357
|
+
## 与 v2.0 的主要变化
|
|
350
358
|
|
|
351
|
-
|
|
|
352
|
-
|
|
353
|
-
|
|
|
354
|
-
|
|
|
355
|
-
|
|
|
356
|
-
|
|
|
357
|
-
|
|
358
|
-
---
|
|
359
|
-
|
|
360
|
-
## 零容忍失败
|
|
361
|
-
|
|
362
|
-
| 违规 | 为什么失败 |
|
|
363
|
-
|------|-----------|
|
|
364
|
-
| "应该可以工作了" | 没有证据。运行它。 |
|
|
365
|
-
| "我添加了测试" | 它们通过了吗？显示输出。 |
|
|
366
|
-
| "修复了 bug" | 你怎么知道？你测试了什么？ |
|
|
367
|
-
| "实现完成" | 你根据成功标准验证了吗？ |
|
|
368
|
-
| 跳过测试执行 | 测试存在是为了运行，不只是写 |
|
|
369
|
-
|
|
370
|
-
---
|
|
371
|
-
|
|
372
|
-
## 禁止行为
|
|
373
|
-
|
|
374
|
-
- **禁止范围缩减**：不要做"demo"、"骨架"、"简化版"
|
|
375
|
-
- **禁止 MockUp**：用户要求 A，就 100% 完成 A
|
|
376
|
-
- **禁止部分完成**：不要在 60% 时说"你可以扩展..."
|
|
377
|
-
- **禁止提前停止**：TODO 全部完成前不能宣布完成
|
|
378
|
-
- **禁止删除测试**：不要删除失败测试来使构建通过
|
|
379
|
-
|
|
380
|
-
---
|
|
381
|
-
|
|
382
|
-
## 与 oh-my-opencode 的对应关系
|
|
383
|
-
|
|
384
|
-
| oh-my-opencode | oh-my-claude |
|
|
385
|
-
|----------------|--------------|
|
|
386
|
-
| Sisyphus | 愚公 (YuGong) |
|
|
387
|
-
| explore agent | 悟空 (WuKong) |
|
|
388
|
-
| oracle agent | 诸葛 (ZhuGe) |
|
|
389
|
-
| librarian agent | 司马迁 (SimaQian) |
|
|
390
|
-
| frontend-ui-ux-engineer | 顾恺之 (GuKaiZhi) |
|
|
391
|
-
| document-writer | 司马迁 (SimaQian) |
|
|
392
|
-
| ultrawork / ulw | ultrawork / ulw / 移山 |
|
|
393
|
-
| delegate_task() | Task(subagent_type=...) |
|
|
359
|
+
| 方面 | v2.0 | v2.1 |
|
|
360
|
+
|------|------|------|
|
|
361
|
+
| 工作流 | 固定5阶段 | 动态按需 |
|
|
362
|
+
| Agent 调用 | 手动/关键词 | 智能分派 |
|
|
363
|
+
| 测试机制 | 单次 | 循环直到通过 |
|
|
364
|
+
| 清理阶段 | 可选 | 强制 |
|
|
365
|
+
| 退出条件 | TODO 完成 | 质量达标 |
|
|
394
366
|
|
|
395
367
|
---
|
|
396
368
|
|
|
397
369
|
## 文化寓意
|
|
398
370
|
|
|
399
|
-
|
|
371
|
+
愚公移山的智慧不在于蛮力，而在于：
|
|
372
|
+
|
|
373
|
+
> **"方向正确，方法灵活，坚持到底。"**
|
|
400
374
|
|
|
401
|
-
|
|
402
|
-
|
|
375
|
+
- 方向正确：明确目标，不偏离
|
|
376
|
+
- 方法灵活：根据实际情况调整策略
|
|
377
|
+
- 坚持到底：直到质量达标才停止
|
|
403
378
|
|
|
404
|
-
|
|
379
|
+
**智者善变，愚公不愚。**
|