子代理驱动开发(Subagent Driven Development)
通过 delegate_task 子代理执行计划(2 阶段审查)。
Skill 元数据
| 来源 | Optional(可选)— 使用 kopi skills install official/software-development/subagent-driven-development 安装 |
| 路径 | optional-skills/software-development/subagent-driven-development |
| 版本 | 1.1.0 |
| 作者 | KOPI AI AGENT(改编自 obra/superpowers) |
| 许可证 | MIT |
| 平台 | linux, macos, windows |
| 标签 | delegation, subagent, implementation, workflow, parallel |
| 相关 skill | plan, requesting-code-review, test-driven-development |
参考:完整 SKILL.md
以下是触发该 skill 时 Kopi Agent 加载的完整 skill 定义。这就是 skill 处于激活状态时 agent 看到的指令。
子代理驱动开发(Subagent-Driven Development)
概述
通过为每个任务调度全新的 subagent(子代理),并进行系统的两阶段审查,来执行实施计划。
核心原则: 每个任务使用全新的 subagent + 两阶段审查(先规格后质量)= 高质量、快速迭代。
何时使用
在以下情况使用此 skill:
- 你已有一份实施计划(来自
planskill 或用户需求) - 任务之间基本相互独立
- 质量和规格合规性很重要
- 你希望在任务之间进行自动化审查
与手动执行相比:
- 每个任务都有全新的上下文(不会因累积状态而产生混淆)
- 自动化审查流程能尽早发现问题
- 所有任务都有一致的质量检查
- subagent 可以在开始工作前提出问题
流程
1. 读取并解析计划
读取计划文件。一次性提取所有任务的完整文本和上下文。创建待办清单:
# Read the plan
read_file("docs/plans/feature-plan.md")
# Create todo list with all tasks
todo([
{"id": "task-1", "content": "Create User model with email field", "status": "pending"},
{"id": "task-2", "content": "Add password hashing utility", "status": "pending"},
{"id": "task-3", "content": "Create login endpoint", "status": "pending"},
])
关键点: 只读一次计划。提取全部内容。不要让 subagent 去读取计划文件——而是在上下文中直接提供完整的任务文本。
2. 每个任务的工作流
对计划中的每个任务:
步骤 1:调度实施者 subagent
使用 delegate_task 并提供完整上下文:
delegate_task(
goal="Implement Task 1: Create User model with email and password_hash fields",
context="""
TASK FROM PLAN:
- Create: src/models/user.py
- Add User class with email (str) and password_hash (str) fields
- Use bcrypt for password hashing
- Include __repr__ for debugging
FOLLOW TDD:
1. Write failing test in tests/models/test_user.py
2. Run: pytest tests/models/test_user.py -v (verify FAIL)
3. Write minimal implementation
4. Run: pytest tests/models/test_user.py -v (verify PASS)
5. Run: pytest tests/ -q (verify no regressions)
6. Commit: git add -A && git commit -m "feat: add User model with password hashing"
PROJECT CONTEXT:
- Python 3.11, Flask app in src/app.py
- Existing models in src/models/
- Tests use pytest, run from project root
- bcrypt already in requirements.txt
""",
toolsets=['terminal', 'file']
)
步骤 2:调度规格合规审查者
实施者完成后,对照原始规格进行验证:
delegate_task(
goal="Review if implementation matches the spec from the plan",
context="""
ORIGINAL TASK SPEC:
- Create src/models/user.py with User class
- Fields: email (str), password_hash (str)
- Use bcrypt for password hashing
- Include __repr__
CHECK:
- [ ] All requirements from spec implemented?
- [ ] File paths match spec?
- [ ] Function signatures match spec?
- [ ] Behavior matches expected?
- [ ] Nothing extra added (no scope creep)?
OUTPUT: PASS or list of specific spec gaps to fix.
""",
toolsets=['file']
)
如果发现规格问题: 修复差距,然后重新运行规格审查。仅在符合规格后才继续。
步骤 3:调度代码质量审查者
规格合规通过后:
delegate_task(
goal="Review code quality for Task 1 implementation",
context="""
FILES TO REVIEW:
- src/models/user.py
- tests/models/test_user.py
CHECK:
- [ ] Follows project conventions and style?
- [ ] Proper error handling?
- [ ] Clear variable/function names?
- [ ] Adequate test coverage?
- [ ] No obvious bugs or missed edge cases?
- [ ] No security issues?
OUTPUT FORMAT:
- Critical Issues: [must fix before proceeding]
- Important Issues: [should fix]
- Minor Issues: [optional]
- Verdict: APPROVED or REQUEST_CHANGES
""",
toolsets=['file']
)
如果发现质量问题: 修复问题,重新审查。仅在获得批准后才继续。
步骤 4:标记为完成
todo([{"id": "task-1", "content": "Create User model with email field", "status": "completed"}], merge=True)
3. 最终审查
所有任务完成后,调度最终集成审查者:
delegate_task(
goal="Review the entire implementation for consistency and integration issues",
context="""
All tasks from the plan are complete. Review the full implementation:
- Do all components work together?
- Any inconsistencies between tasks?
- All tests passing?
- Ready for merge?
""",
toolsets=['terminal', 'file']
)
4. 验证并提交
# Run full test suite
pytest tests/ -q
# Review all changes
git diff --stat
# Final commit if needed
git add -A && git commit -m "feat: complete [feature name] implementation"
任务粒度
每个任务 = 2-5 分钟的专注工作。
过大:
- "实现用户身份验证系统"
合适大小:
- "创建包含 email 和 password 字段的 User 模型"
- "添加密码哈希函数"
- "创建登录端点"
- "添加 JWT token 生成"
- "创建注册端点"
危险信号——绝不要做这些
- 在没有计划的情况下开始实施
- 跳过审查(无论是规格合规还是代码质量)
- 在关键/重要问题未修复的情况下继续
- 为涉及相同文件的任务调度多个实施 subagent
- 让 subagent 读取计划文件(应改为在上下文中提供完整文本)
- 跳过背景情境说明(subagent 需要理解该任务在整体中的位置)
- 忽视 subagent 的问题(应先回答再让他们继续)
- 在规格合规问题上接受"差不多就行"
- 跳过审查循环(审查者发现问题 → 实施者修复 → 再次审查)
- 让实施者自我审查代替真正的审查(两者都需要)
- 在规格合规通过(PASS)之前就开始代码质量审查(顺序错误)
- 在任一审查仍有未解决问题时就进入下一个任务
处理问题
如果 subagent 提出问题
- 清晰、完整地回答
- 如有需要,提供更多上下文
- 不要催促他们立刻开始实施
如果审查者发现问题
- 实施者 subagent(或新的 subagent)修复问题
- 审查者再次审查
- 重复直到获得批准
- 不要跳过重新审查
如果 subagent 任务失败
- 调度一个新的修复 subagent,并针对出错的地方给出具体指示
- 不要在控制会话中手动修复(会造成上下文污染)
效率说明
为什么每个任务使用全新的 subagent:
- 防止累积状态造成的上下文污染
- 每个 subagent 都获得干净、聚焦的上下文
- 不会受到之前任务的代码或推理过程的干扰
为什么采用两阶段审查:
- 规格审查能尽早发现构建不足或过度构建的问题
- 质量审查确保实现构建良好
- 在问题跨任务累积之前将其捕获
成本权衡:
- 更多的 subagent 调用(每个任务 = 实施者 + 2 个审查者)
- 但能尽早发现问题(比日后调试累积问题成本更低)
与其他 Skill 的集成
与 plan 集成
本 skill 执行由 plan skill 创建的计划:
- 用户需求 → plan → 实施计划
- 实施计划 → subagent-driven-development → 可运行的代码
与 test-driven-development 集成
实施者 subagent 应遵循 TDD:
- 先编写会失败的测试
- 实现最小化代码
- 验证测试通过
- 提交
在每个实施者上下文中包含 TDD 指令。
与 requesting-code-review 集成
两阶段审查流程本身就是代码审查。对于最终集成审查,使用 requesting-code-review skill 的审查维度。
与 systematic-debugging 集成
如果 subagent 在实现过程中遇到 bug:
- 遵循 systematic-debugging 流程
- 修复前先找到根本原因
- 编写回归测试
- 继续实现
示例工作流
[Read plan: docs/plans/auth-feature.md]
[Create todo list with 5 tasks]
--- Task 1: Create User model ---
[Dispatch implementer subagent]
Implementer: "Should email be unique?"
You: "Yes, email must be unique"
Implementer: Implemented, 3/3 tests passing, committed.
[Dispatch spec reviewer]
Spec reviewer: ✅ PASS — all requirements met
[Dispatch quality reviewer]
Quality reviewer: ✅ APPROVED — clean code, good tests
[Mark Task 1 complete]
--- Task 2: Password hashing ---
[Dispatch implementer subagent]
Implementer: No questions, implemented, 5/5 tests passing.
[Dispatch spec reviewer]
Spec reviewer: ❌ Missing: password strength validation (spec says "min 8 chars")
[Implementer fixes]
Implementer: Added validation, 7/7 tests passing.
[Dispatch spec reviewer again]
Spec reviewer: ✅ PASS
[Dispatch quality reviewer]
Quality reviewer: Important: Magic number 8, extract to constant
Implementer: Extracted MIN_PASSWORD_LENGTH constant
Quality reviewer: ✅ APPROVED
[Mark Task 2 complete]
... (continue for all tasks)
[After all tasks: dispatch final integration reviewer]
[Run full test suite: all passing]
[Done!]
记住
Fresh subagent per task
Two-stage review every time
Spec compliance FIRST
Code quality SECOND
Never skip reviews
Catch issues early
质量不是偶然产生的。它是系统化流程的结果。
延伸阅读(在相关时加载)
当编排过程涉及大量的上下文占用、较长的审查循环或复杂的验证检查点时,请加载以下参考资料,以获得相应的规范指导:
references/context-budget-discipline.md—— 四级上下文衰减模型(PEAK / GOOD / DEGRADING / POOR)、随上下文窗口大小缩放的阅读深度规则,以及静默衰减的早期预警信号。当一次运行明显会消耗大量上下文时加载(多阶段计划、多个 subagent、大型产物)。references/gates-taxonomy.md—— 四种标准 gate 类型(Pre-flight、Revision、Escalation、Abort)及其行为、恢复机制与示例。在设计或审查任何带有验证检查点的工作流时加载——请显式使用这些术语,确保每种 gate 都有明确的进入条件、失败行为和恢复规则。
以上两份参考资料均改编自 gsd-build/get-shit-done(MIT © 2025 Lex Christopherson)。