# Subagent Driven Development > 在当前会话中执行包含独立任务的实现计划时使用。触发词：子智能体驱动开发、子智能体开发、分派子智能体执行、任务分派开发、子智能体审查、两阶段审查、独立任务并行开发、按任务分派 - Skill: `kscz0000/subagent-driven-development` (Agent Skill, multi-file: 4 files) - Install (CLI): `npx skillmds@latest add kscz0000/subagent-driven-development` - Raw SKILL.md: https://api.skillmd.com/api/skills/kscz0000/subagent-driven-development/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: kscz0000 (https://skillmd.com/u/kscz0000) - Updated: 2026-09-21 - Page: https://skillmd.com/skills/kscz0000/subagent-driven-development --- # 子智能体驱动开发 为每个任务分派独立子智能体执行计划，每个任务完成后进行两阶段审查：先审查规格符合性，再审查代码质量。 **核心原则：** 每任务独立子智能体 + 两阶段审查（规格→质量）= 高质量、快迭代 ## 何时使用 ```dot digraph when_to_use { "Have implementation plan?" [shape=diamond]; "Tasks mostly independent?" [shape=diamond]; "Stay in this session?" [shape=diamond]; "subagent-driven-development" [shape=box]; "executing-plans" [shape=box]; "Manual execution or brainstorm first" [shape=box]; "Have implementation plan?" -> "Tasks mostly independent?" [label="yes"]; "Have implementation plan?" -> "Manual execution or brainstorm first" [label="no"]; "Tasks mostly independent?" -> "Stay in this session?" [label="yes"]; "Tasks mostly independent?" -> "Manual execution or brainstorm first" [label="no - tightly coupled"]; "Stay in this session?" -> "subagent-driven-development" [label="yes"]; "Stay in this session?" -> "executing-plans" [label="no - parallel session"]; } ``` **对比 executing-plans（并行会话）：** - 同一会话（无上下文切换） - 每任务独立子智能体（无上下文污染） - 每个任务后两阶段审查：先规格符合性，再代码质量 - 更快迭代（任务间无需人工介入） ## 流程 ```dot digraph process { rankdir=TB; subgraph cluster_per_task { label="Per Task"; "Dispatch implementer subagent (./implementer-prompt.md)" [shape=box]; "Implementer subagent asks questions?" [shape=diamond]; "Answer questions, provide context" [shape=box]; "Implementer subagent implements, tests, commits, self-reviews" [shape=box]; "Dispatch spec reviewer subagent (./spec-reviewer-prompt.md)" [shape=box]; "Spec reviewer subagent confirms code matches spec?" [shape=diamond]; "Implementer subagent fixes spec gaps" [shape=box]; "Dispatch code quality reviewer subagent (./code-quality-reviewer-prompt.md)" [shape=box]; "Code quality reviewer subagent approves?" [shape=diamond]; "Implementer subagent fixes quality issues" [shape=box]; "Mark task complete in TodoWrite" [shape=box]; } "Read plan, extract all tasks with full text, note context, create TodoWrite" [shape=box]; "More tasks remain?" [shape=diamond]; "Dispatch final code reviewer subagent for entire implementation" [shape=box]; "Use superpowers:finishing-a-development-branch" [shape=box style=filled fillcolor=lightgreen]; "Read plan, extract all tasks with full text, note context, create TodoWrite" -> "Dispatch implementer subagent (./implementer-prompt.md)"; "Dispatch implementer subagent (./implementer-prompt.md)" -> "Implementer subagent asks questions?"; "Implementer subagent asks questions?" -> "Answer questions, provide context" [label="yes"]; "Answer questions, provide context" -> "Dispatch implementer subagent (./implementer-prompt.md)"; "Implementer subagent asks questions?" -> "Implementer subagent implements, tests, commits, self-reviews" [label="no"]; "Implementer subagent implements, tests, commits, self-reviews" -> "Dispatch spec reviewer subagent (./spec-reviewer-prompt.md)"; "Dispatch spec reviewer subagent (./spec-reviewer-prompt.md)" -> "Spec reviewer subagent confirms code matches spec?"; "Spec reviewer subagent confirms code matches spec?" -> "Implementer subagent fixes spec gaps" [label="no"]; "Implementer subagent fixes spec gaps" -> "Dispatch spec reviewer subagent (./spec-reviewer-prompt.md)" [label="re-review"]; "Spec reviewer subagent confirms code matches spec?" -> "Dispatch code quality reviewer subagent (./code-quality-reviewer-prompt.md)" [label="yes"]; "Dispatch code quality reviewer subagent (./code-quality-reviewer-prompt.md)" -> "Code quality reviewer subagent approves?"; "Code quality reviewer subagent approves?" -> "Implementer subagent fixes quality issues" [label="no"]; "Implementer subagent fixes quality issues" -> "Dispatch code quality reviewer subagent (./code-quality-reviewer-prompt.md)" [label="re-review"]; "Code quality reviewer subagent approves?" -> "Mark task complete in TodoWrite" [label="yes"]; "Mark task complete in TodoWrite" -> "More tasks remain?"; "More tasks remain?" -> "Dispatch implementer subagent (./implementer-prompt.md)" [label="yes"]; "More tasks remain?" -> "Dispatch final code reviewer subagent for entire implementation" [label="no"]; "Dispatch final code reviewer subagent for entire implementation" -> "Use superpowers:finishing-a-development-branch"; } ``` ## 提示词模板 - `./implementer-prompt.md` - 分派实现子智能体 - `./spec-reviewer-prompt.md` - 分派规格符合性审查子智能体 - `./code-quality-reviewer-prompt.md` - 分派代码质量审查子智能体 ## 示例工作流 ``` 你：我正在使用子智能体驱动开发来执行这个计划。 [读取计划文件一次：docs/plans/feature-plan.md] [提取全部5个任务的完整文本和上下文] [创建包含所有任务的 TodoWrite] 任务1：Hook 安装脚本 [获取任务1文本和上下文（已提取）] [分派实现子智能体，附带完整任务文本+上下文] 实现者："开始之前——hook 应该安装在用户级别还是系统级别？" 你："用户级别（~/.config/superpowers/hooks/）" 实现者："明白了。现在开始实现..." [稍后] 实现者： - 已实现 install-hook 命令 - 添加测试，5/5 通过 - 自审：发现遗漏 --force 标志，已添加 - 已提交 [分派规格符合性审查者] 规格审查者：✅ 规格符合——所有需求已满足，无多余实现 [获取 git SHA，分派代码质量审查者] 代码审查者：优点：测试覆盖率好，代码整洁。问题：无。通过。 [标记任务1完成] 任务2：恢复模式 [获取任务2文本和上下文（已提取）] [分派实现子智能体，附带完整任务文本+上下文] 实现者：[无疑问，直接开始] 实现者： - 添加了验证/修复模式 - 8/8 测试通过 - 自审：一切正常 - 已提交 [分派规格符合性审查者] 规格审查者：❌ 问题： - 缺失：进度报告（规格要求"每100项报告一次"） - 多余：添加了 --json 标志（未要求） [实现者修复问题] 实现者：移除 --json 标志，添加进度报告 [规格审查者再次审查] 规格审查者：✅ 现在符合规格 [分派代码质量审查者] 代码审查者：优点：扎实。问题（重要）：魔法数字（100） [实现者修复] 实现者：提取 PROGRESS_INTERVAL 常量 [代码审查者再次审查] 代码审查者：✅ 通过 [标记任务2完成] ... [所有任务完成后] [分派最终代码审查者] 最终审查者：所有需求已满足，可以合并 完成！ ``` ## 优势 **对比手动执行：** - 子智能体天然遵循 TDD - 每任务独立上下文（无混淆） - 并行安全（子智能体互不干扰） - 子智能体可以提问（开始前和工作中均可） **对比 executing-plans：** - 同一会话（无交接） - 进度连续（无等待） - 审查检查点自动化 **效率提升：** - 无文件读取开销（控制器提供完整文本） - 控制器精确筛选所需上下文 - 子智能体预先获得完整信息 - 问题在开始前暴露（而非完成后） **质量门禁：** - 自审在交接前发现问题 - 两阶段审查：规格符合性→代码质量 - 审查循环确保修复真正生效 - 规格符合性防止过度/不足实现 - 代码质量确保实现精良 **成本：** - 更多子智能体调用（每任务：实现者+2审查者） - 控制器做更多准备工作（预先提取所有任务） - 审查循环增加迭代 - 但能尽早发现问题（比后期调试成本更低） ## 红线 **绝不：** - 跳过审查（规格符合性或代码质量） - 带着未修复的问题继续 - 并行分派多个实现子智能体（会冲突） - 让子智能体读取计划文件（应提供完整文本） - 跳过场景设定上下文（子智能体需要理解任务定位） - 忽视子智能体的问题（先回答再让其继续） - 在规格符合性上接受"差不多就行"（规格审查者发现问题=未完成） - 跳过审查循环（审查者发现问题=实现者修复=再次审查） - 让实现者自审替代实际审查（两者都需要） - **在规格符合性通过前开始代码质量审查**（顺序错误） - 在任一审查有未解决问题时进入下一个任务 **如果子智能体提问：** - 清晰完整地回答 - 必要时提供额外上下文 - 不要催促其开始实现 **如果审查者发现问题：** - 实现者（同一子智能体）修复 - 审查者再次审查 - 重复直到通过 - 不要跳过复审 **如果子智能体任务失败：** - 分派修复子智能体并附具体指令 - 不要尝试手动修复（会污染上下文） ## 集成 **必需的工作流技能：** - **superpowers:writing-plans** - 创建本技能执行的计划 - **superpowers:requesting-code-review** - 审查子智能体的代码审查模板 - **superpowers:finishing-a-development-branch** - 所有任务完成后完成开发 **子智能体应使用：** - **superpowers:test-driven-development** - 子智能体为每个任务遵循 TDD **替代工作流：** - **superpowers:executing-plans** - 用于并行会话而非同一会话执行 ## 局限性 - 仅在任务明确匹配上述范围时使用本技能。 - 不要将输出替代环境特定的验证、测试或专家审查。 - 如果缺少必需的输入、权限、安全边界或成功标准，请停下来寻求澄清。