sanguo/sanguo_moziplus_v3
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(v0.5.1): 补充 Linus 三问 + Superpowers 五技能体系

Browse Source 
- 添加 Linus 三问工程审慎决策框架到决策部分
- 对齐 Superpowers 五技能标准工作流
  - writing-plans → executing-plans → requesting-code-review → systematic-debugging → finishing-a-development-branch
- 更新能力对照表和工作流图
- 添加版本变更说明附录
This commit is contained in:
Claude Dev
2026-07-01 19:05:28 +08:00
parent 2195bb4542
commit abb50cbce5
1 changed files with 174 additions and 34 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/design/06-design-v0.5-dynamic-orchestration.md
+174 -34
View File
@@ -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 标准的映射关系