From abb50cbce512b912af56e721f8c53d6cf0435a3c Mon Sep 17 00:00:00 2001 From: claude_dev Date: Wed, 1 Jul 2026 19:05:28 +0800 Subject: [PATCH] =?UTF-8?q?docs(v0.5.1):=20=E8=A1=A5=E5=85=85=20Linus=20?= =?UTF-8?q?=E4=B8=89=E9=97=AE=20+=20Superpowers=20=E4=BA=94=E6=8A=80?= =?UTF-8?q?=E8=83=BD=E4=BD=93=E7=B3=BB?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 添加 Linus 三问工程审慎决策框架到决策部分 - 对齐 Superpowers 五技能标准工作流 - writing-plans → executing-plans → requesting-code-review → systematic-debugging → finishing-a-development-branch - 更新能力对照表和工作流图 - 添加版本变更说明附录 --- .../06-design-v0.5-dynamic-orchestration.md | 208 +++++++++++++++--- 1 file changed, 174 insertions(+), 34 deletions(-) diff --git a/docs/design/06-design-v0.5-dynamic-orchestration.md b/docs/design/06-design-v0.5-dynamic-orchestration.md index 837f0f2..cfba84f 100644 --- a/docs/design/06-design-v0.5-dynamic-orchestration.md +++ b/docs/design/06-design-v0.5-dynamic-orchestration.md @@ -17,6 +17,7 @@ | v0.3 | 移除 CCB，采用 Claude Code 内置多 Agent | 2026-06-30 | | v0.4 | 三实例方案：SendMessage 跨实例 | 2026-06-30 | | **v0.5** | **Main + Sub Agent：动态编排** | **2026-07-01** | +| **v0.5.1** | **补充 Linus 三问 + Superpowers 五技能体系** | **2026-07-01** | ### v0.5 核心变化 @@ -459,31 +460,95 @@ Main Agent 直接安排 Sub Agents... ## 6. Superpowers 集成 -### 6.1 Main Agent 使用 Superpowers +### 6.1 Superpowers 五技能体系 -```javascript -// 需求讨论 - 使用 deep-interview -const requirements = await /deep-interview "用户认证系统需求" -// 记录到 requirements/requirements.md +videotext 方案定义了标准的软件开发生命周期五技能： -// 复杂任务，先规划 -const plan = await /plan "设计用户认证系统" +| 阶段 | Superpowers 技能 | 用途 | v0.5 对应实践 | +|------|------------------|------|---------------| +| **1. 规划** | `writing-plans` | 编写综合实现计划，假设工程师对代码库零上下文 | `planning` skill | +| **2. 执行** | `executing-plans` | 按步骤执行计划文件，有审查检查点 | Agent 工具编排 | +| **3. 审查** | `requesting-code-review` | 请求代码审查，突出需要关注的区域 | `CODE-REVIEW` skill | +| **4. 调试** | `systematic-debugging` | 系统化调试问题，而不是随机尝试 | `debugger` skill | +| **5. 完成** | `finishing-a-development-branch` | 完成开发分支的收尾（测试、文档、清理） | Main Agent 验收整合 | -// 根据规划安排 Sub Agents -// ... +**工作流程**： +``` +writing-plans → executing-plans → requesting-code-review → systematic-debugging → finishing-a-development-branch + ↓ ↓ ↓ ↓ ↓ + 编写计划 执行计划 请求审查 系统调试 完成收尾 ``` -### 6.2 Main Agent 验收整合使用 Superpowers +### 6.2 Main Agent 使用 Superpowers + +#### 规划阶段 (writing-plans) + +```javascript +// 复杂任务，先规划 +Skill({ skill: "writing-plans", args: "用户认证系统实现计划" }) +// 输出计划文件，假设执行者对代码库零上下文 +``` + +#### 需求讨论 (deep-interview) + +```javascript +// 需求讨论 - 使用 deep-interview (补充能力) +Skill({ skill: "deep-interview", args: "用户认证系统需求" }) +// 记录到 requirements/requirements.md +// ASK -> LISTEN -> WRITE -> DEEPEN -> REPEAT +``` + +#### 执行阶段 (executing-plans) + +```javascript +// 通过 Agent 工具编排 Sub Agents +const backend = await Agent({ + subagent_type: "claude", + prompt: "作为后端开发专家，执行计划中的后端任务..." +}) + +const frontend = await Agent({ + subagent_type: "claude", + prompt: "作为前端开发专家，执行计划中的前端任务..." +}) +``` + +#### 审查阶段 (requesting-code-review) + +```javascript +// 使用 CODE-REVIEW skill 进行代码审查 +Skill({ skill: "code-review", args: "审查用户认证代码" }) +// 检查逻辑正确性、安全、性能、测试覆盖率 +``` + +#### 调试阶段 (systematic-debugging) + +```javascript +// 遇到问题时，使用 systematic-debugging +Skill({ skill: "systematic-debugging", args: "登录接口问题诊断" }) +// 系统化定位问题，而非随机尝试 +``` + +#### 完成阶段 (finishing-a-development-branch) + +```javascript +// Main Agent 验收整合 +// - 检查所有测试通过 +// - 确认代码质量 +// - 准备提交 Git +``` + +### 6.3 Main Agent 验收整合使用 Superpowers ```javascript // 使用 CODE-REVIEW skill 进行验收 -const review = await /code-review "审查用户认证代码" +const review = await Skill({ skill: "code-review", args: "审查用户认证代码" }) // 检查逻辑正确性、安全、性能、测试覆盖率 // 整合结果并提交 Git ``` -### 6.2 Sub Agent 使用 Superpowers +### 6.4 Sub Agent 使用 Superpowers ```javascript // Execute Sub Agent 内部也可以使用 Superpowers @@ -507,16 +572,17 @@ Agent({ // 4. 返回结果 ``` -### 6.3 所有 Agent 共享 +### 6.5 所有 Agent 共享 ``` Main Agent │ - ├─ deep-interview — 需求讨论和知识提取 - ├─ planning — 复杂任务规划 - ├─ CODE-REVIEW — 代码审查验收 - ├─ debugger — 问题诊断 - ├─ ... (其他 Superpowers) + ├─ writing-plans — 编写实现计划 + ├─ executing-plans — 执行计划 (Agent 工具编排) + ├─ requesting-code-review — 请求代码审查 (CODE-REVIEW) + ├─ systematic-debugging — 系统化调试 (debugger) + ├─ finishing-a-development-branch — 完成收尾 + ├─ deep-interview — 需求讨论和知识提取 (补充) └─ Agent 工具编排 Sub Agents @@ -525,18 +591,20 @@ Sub Agents ├─ frontend-dev skill ├─ CODE-REVIEW skill ├─ test-engineer skill + ├─ debugger skill ├─ ... (其他 Superpowers) └─ Agent 工具 (可启动更深层 Agent) -Superpowers Skills +Superpowers Skills 核心五技能 │ - ├─ deep-interview — 需求讨论 (Main 核心能力) - ├─ planning — 任务规划 - ├─ CODE-REVIEW — 代码审查 (Main 验收能力) - ├─ test-engineer — 测试工程 + ├─ writing-plans — 编写计划 ⭐ + ├─ executing-plans — 执行计划 ⭐ + ├─ requesting-code-review — 请求代码审查 ⭐ + ├─ systematic-debugging — 系统化调试 ⭐ + ├─ finishing-a-development-branch — 完成收尾 ⭐ + ├─ deep-interview — 需求讨论 (补充) ├─ backend-dev — 后端开发 ├─ frontend-dev — 前端开发 - ├─ debugger — 问题调试 ├─ ... (100+ skills) ``` @@ -746,10 +814,20 @@ Skill({ skill: "code-review-skill", args: "文件路径" }) ## 可用能力 (Superpowers) -- **deep-interview** — 需求讨论和知识提取 (核心能力) -- **planning** — 复杂任务的方案规划 -- **CODE-REVIEW** — 代码审查验收 (核心能力) -- **debugger** — 问题诊断 +### Superpowers 五技能体系 (核心工作流) + +- **writing-plans** — 编写综合实现计划，假设工程师对代码库零上下文 +- **executing-plans** — 按步骤执行计划文件，有审查检查点 (通过 Agent 工具实现) +- **requesting-code-review** — 请求代码审查，突出需要关注的区域 (CODE-REVIEW) +- **systematic-debugging** — 系统化调试问题，而非随机尝试 (debugger) +- **finishing-a-development-branch** — 完成开发分支收尾 (测试、文档、清理) + +### 补充能力 + +- **deep-interview** — 需求讨论和知识提取 (ASK→LISTEN→WRITE→DEEPEN→REPEAT) +- **backend-dev** — 后端开发专业能力 +- **frontend-dev** — 前端开发专业能力 +- **test-engineer** — 测试工程 - 其他 100+ Superpowers skills - Agent 工具编排 @@ -783,7 +861,25 @@ Agent({ ## 决策框架 -在安排 Sub Agents 之前问自己: +### Linus 三问 (工程审慎决策) + +**Main Agent 在安排 Sub Agents 之前，必须先进行工程审慎判断**： + +| 问题 | 判断标准 | 决策 | +|------|---------|------| +| **1. 这是现实问题还是想象问题？** | 有明确证据/用户反馈 vs "可能需要"/"也许将来" | 拒绝过度设计 | +| **2. 这个问题真的需要解决吗？** | 影响核心功能/用户体验 vs 边缘场景/伪需求 | 拒绝伪需求 | +| **3. 这个方案真的能解决问题吗？** | 有明确验证路径 vs 理论上可行 | 拒绝自嗨 | + +**如何应用**： +- 用户提出模糊需求时，使用 Linus 三问过滤 +- 规划复杂功能前，先验证问题真实性 +- 选择技术方案时，评估是否能真正解决问题 + +### 技术编排决策 + +通过 Linus 三问后，再进行技术决策： + 1. 需求是否清晰? 不清晰 → 使用 deep-interview 2. 这个任务需要哪些 Sub Agents? 3. 需要 planning 吗? @@ -1013,12 +1109,33 @@ Workflow({ | 能力 | Superpowers Skill | 用途 | |------|------------------|------| -| **需求讨论** | `deep-interview` | 与用户系统化讨论需求，ASK->LISTEN->WRITE->DEEPEN->REPEAT | -| **任务规划** | `planning` | 复杂任务的方案规划 | -| **代码审查** | `CODE-REVIEW` | 验收代码质量、安全、性能 | -| **问题诊断** | `debugger` | 定位和诊断问题 | +| **规划** | `writing-plans` | 编写综合实现计划，假设执行者对代码库零上下文 | +| **执行** | `executing-plans` (Agent 工具) | 按步骤执行计划，有审查检查点 | +| **审查** | `requesting-code-review` (CODE-REVIEW) | 验收代码质量、安全、性能 | +| **调试** | `systematic-debugging` (debugger) | 系统化定位问题，而非随机尝试 | +| **收尾** | `finishing-a-development-branch` | 完成开发分支收尾（测试、文档、清理） | +| **需求讨论** | `deep-interview` (补充) | 与用户系统化讨论需求，ASK→LISTEN→WRITE→DEEPEN→REPEAT | | **编排能力** | Agent 工具 | 动态安排 Sub Agents | +### Superpowers 五技能工作流 + +``` +┌─────────────────────────────────────────────────────────────────┐ +│ Main Agent (编排者) │ +│ │ +│ 工作流 (Superpowers 五技能): │ +│ 1. writing-plans → 编写实现计划 │ +│ 2. executing-plans → 执行计划 (Agent 工具编排 Sub Agents) │ +│ 3. requesting-code-review → 请求代码审查 (CODE-REVIEW) │ +│ 4. systematic-debugging → 系统化调试 (debugger) │ +│ 5. finishing-a-development-branch → 完成收尾 │ +│ │ +│ 补充能力: │ +│ - deep-interview — 需求讨论和知识提取 │ +│ - Agent 工具 — 动态编排 Sub Agents │ +└─────────────────────────────────────────────────────────────────┘ +``` + ### 与 v0.4 的区别 | v0.4 | v0.5 | @@ -1046,8 +1163,31 @@ Workflow({ --- -**文档版本**: v0.5 +**文档版本**: v0.5.1 **最后更新**: 2026-07-01 **作者**: Claude Dev **审核状态**: Draft **实施状态**: 设计阶段 + +--- + +## 附录：版本变更说明 + +### v0.5.1 (2026-07-01) + +**补充内容**： + +1. **Linus 三问 (工程审慎决策框架)** + - 添加到决策框架部分 + - 在安排 Sub Agents 之前必须先进行工程审慎判断 + - 防止过度设计、伪需求、自嗨方案 + +2. **Superpowers 五技能体系** + - 对齐 videotext 方案的标准工作流 + - 明确五个核心技能：writing-plans → executing-plans → requesting-code-review → systematic-debugging → finishing-a-development-branch + - 保持 v0.5 灵活性的同时，遵循 Superpowers 标准实践 + +3. **能力对照更新** + - 更新 Main Agent 核心能力表 + - 添加 Superpowers 五技能工作流图 + - 明确 v0.5 实践与 Superpowers 标准的映射关系