Loading skill
Install any skill in seconds. Free to start, no credit card required.
Get Started Free →Use when executing implementation plans with independent tasks in the project
| Test case | Without → With | Effect | Δ tokens | Δ turns |
|---|---|---|---|---|
| case-10 | ✗→✓ | ▲ Improved | 489% | 0% |
| case-02 | ✗→✓ | ▲ Improved | 336% | 0% |
| case-06 | ✗→✓ | ▲ Improved | 292% | 0% |
| case-08 | ✗→✓ | ▲ Improved | 252% | 0% |
| case-09 | ✗→✓ | ▲ Improved | 428% | 0% |
通过为每个任务分派全新子 Agent 执行计划，每个任务后进行两阶段审查：Spec 合规性审查优先，代码质量审查其次。
你委派任务给具有隔离上下文的专业 Agent。通过精确设计他们的指令和上下文，确保他们保持专注并成功完成任务。他们不应该继承你的会话上下文或历史——你构建他们需要的精确内容。这也为你保留了协调工作的上下文。
核心原则: 每个任务使用全新子 Agent + 两阶段审查（先 Spec 合规，后代码质量）= 高质量，快速迭代
mermaidflowchart TD A{有实现计划？} -->|是| B{任务大部分独立？} A -->|否| C[手动执行或先需求澄清] B -->|是| D{保持此会话？} B -->|否 - 紧密耦合| C D -->|是| E[sw-subagent-development]
mermaidflowchart TD Start([开始]) --> Read[读取计划<br/>提取所有任务<br/>创建 TodoWrite] Read --> ScanReady[2.0 扫描就绪任务<br/>检查依赖+冲突] ScanReady --> ReadyCount{就绪任务数？} ReadyCount -->|1| DispatchImpl[分派实现子 Agent<br/>单任务模式] ReadyCount -->|≥2| DispatchBatch[批量分派实现子 Agent<br/>并行模式] DispatchImpl --> ImplAsks{实现者提问？} DispatchBatch --> ImplAsks ImplAsks -->|是| Answer[回答问题<br/>提供上下文] Answer --> DispatchImpl ImplAsks -->|否| ImplWork[实现者：实现、测试、<br/>准备提交、自审] ImplWork --> Commit[主 Agent git commit] Commit --> DispatchSpec[分派 Spec 审查者<br/>单任务/批量] DispatchSpec --> SpecOk{符合 Spec？} SpecOk -->|否| FixSpec[实现者修复 Spec 问题] FixSpec -->|重审 ≤3次| DispatchSpec SpecOk -->|是| DispatchCode[分派代码质量审查者<br/>单任务/批量] DispatchCode --> CodeOk{代码质量通过？} CodeOk -->|否| FixCode[实现者修复质量问题] FixCode -->|重审 ≤3次| DispatchCode CodeOk -->|是| ShowSummary[展示任务摘要<br/>自动推进] ShowSummary --> MarkDone[标记任务完成<br/>TodoWrite] MarkDone --> MoreTasks{更多任务？} MoreTasks -->|是| ScanReady MoreTasks -->|否| FinalReview[最终代码审查] FinalReview --> ShowFinal[展示整体摘要<br/>自动调用验证] ShowFinal --> FixFinal[根据反馈<br/>修复或调整] FixFinal --> ScanReady ShowFinal --> Finish([调用 sw-task-verification])
每个任务执行前快速确认：
git commit（每次提交前询问用户，子 Agent 只准备摘要）sw-task-verification严禁一次性授权自动提交。每次 git commit 和 git push 前都必须单独询问用户。
每次提交前必须：
> "准备执行 git commit -m '[提交信息]'，变更摘要：摘要]。是否允许提交？"
每次推送前必须：
> "准备执行 git push origin [分支]，将推送 X 个提交。是否允许推送？"
> 注意：用户说"好的"、"可以"、"OK"等模糊回应不算明确允许。必须追问："请明确回复'允许提交'或'不允许'。"
读取计划文件：
bash# 一次性读取完整计划 cat docs/sw-agiledevelopment/plans/YYYY-MM-DD--feature-plan.md
提取任务：
每次循环开始时，主 Agent 执行扫描：
pending 的任务依赖 字段中列出的前置任务是否已全部标记 completed文件 字段）是否有重叠判定结果：
单任务模式（就绪队列 = 1）：
必须提供：
使用: ./subagent-prompts/implementer-prompt.md
批量模式（就绪队列 ≥2）：
当多个就绪任务无文件冲突时，主 Agent 同时分派多个实现子 Agent，每个 Agent 负责一个任务。
每个子 Agent 必须提供：
使用: ./subagent-prompts/implementer-prompt.md（已包含并行安全约束）
如果实现子 Agent 提问：
重新分派时必须传递上下文： OpenCode 子 Agent 每次分派都是全新上下文。重新分派实现者时，必须在提示中附带：
实现子 Agent 必须遵循 sw-test-driven-dev：
git commit）严禁：先写代码后补测试。这是红旗行为。
实现者只准备提交摘要，不自行 git commit。主 Agent 必须：
git commit -m "[建议提交信息]"必须在此阶段之前：
git commit，获取提交后的 git SHAs单任务模式：
分派 Spec 审查者：
使用: ./subagent-prompts/spec-reviewer-prompt.md
批量模式：
当多个任务并行完成后，统一进行批量 Spec 审查：
分派批量 Spec 审查者：
使用: ./subagent-prompts/spec-reviewer-prompt.md（支持批量输入）
审查迭代规则（单任务/批量共用）：
git commit → 重新审查批量审查的特殊处理：
Spec 合规 ✅，等待批量代码质量审查只有在 Spec 合规 ✅ 后才能开始
单任务模式：
分派代码质量审查者：
使用: ./subagent-prompts/code-quality-reviewer-prompt.md
批量模式：
所有并行任务通过 Spec 合规审查后，统一进行批量代码质量审查：
分派批量代码质量审查者：
使用: ./subagent-prompts/code-quality-reviewer-prompt.md（支持批量输入）
审查迭代规则（单任务/批量共用）：
批量审查的特殊处理：
代码质量 ✅，视为完成单任务模式：
子 Agent 审查通过后，任务即视为完成。向用户展示任务摘要，然后自动进入下一任务：
向用户展示：
自动推进模板： > "任务 X 已完成： > - 修改文件：文件列表] > - 测试结果：X/Y 通过 > - 审查状态：Spec 合规 ✅，代码质量 ✅ > - 提交 SHA：SHA] > > 自动进入下一任务。"
批量模式：
所有并行任务都通过审查后，统一展示批次摘要：
自动推进模板： > "批次 Y 已完成（并行任务）： > - 完成任务：任务编号列表] > - 修改文件：合并文件列表] > - 测试结果：X/Y 通过（各任务合计） > - 审查状态：Spec 合规 ✅，代码质量 ✅ > - 提交记录：SHA 列表] > > 自动扫描下一批就绪任务。"
> 说明：子 Agent 审查（Spec 合规 + 代码质量）是自动化质量门控。审查通过后自动推进，无需等待用户额外确认。用户如有问题可随时打断。
如果用户主动提出修改需求（单任务/批量共用）：
git commit（每次提交前询问）所有任务完成后：
分派最终代码审查者审查整个实现，确认跨任务一致性。
使用: ./subagent-prompts/final-reviewer-prompt.md
必须提供：
向用户展示整体摘要：
自动调用验证： > "所有任务已完成，整体审查通过。 > - 完成任务：X 个 > - 关键修改：文件列表] > - 审查迭代：X 次 > - 提交记录：SHA 列表] > > 自动调用 sw-task-verification 进行最终验证。"
展示摘要后自动调用 sw-task-verification，无需等待用户回复。
git commit（每次提交前询问）sw-task-verification Skill实现子 Agent 报告四种状态之一。适当处理：
| 状态 | 含义 | 处理 | |------|------|------| | DONE | 完成 | 进入 Spec 合规性审查 | | DONE_WITH_CONCERNS | 完成但有疑虑 | 阅读疑虑。如果是正确性或范围问题，审查前解决。如果是观察（如"文件变大了"），记录并进入审查。 | | NEEDS_CONTEXT | 需要信息 | 提供缺失的上下文并重新分派。 | | BLOCKED | 无法完成 | 评估阻塞原因：<br>1. 上下文问题 → 提供更多上下文，用相同模型重新分派<br>2. 需要更多推理 → 用更强模型重新分派<br>3. 任务太大 → 拆分为更小任务<br>4. 计划错误 → 上报给用户 |
绝不忽视升级或强制相同模型在没有改变的情况下重试。
使用能处理每个角色的最弱模型以节省成本并提高速度。
| 任务类型 | 推荐 | 说明 | |----------|------|------| | 机械实现任务 | 快速、便宜模型 | 独立函数、清晰 Spec、1-2 文件 | | 集成和判断任务 | 标准模型 | 多文件协调、模式匹配、调试 | | 架构、设计、审查任务 | 最强可用模型 | 需要广泛理解 |
任务复杂度信号：
| 想法 | 现实 | |------|------| | "跳过审查，节省时间" | 跳过任何审查（Spec 合规或代码质量）= 接受未验证的代码 | | "未做冲突检测就并行派发" | 重叠文件的任务并行会导致冲突。必须先检查目标文件是否重叠 | | "跳过冲突检测直接并行" | 文件冲突 = 代码覆盖或逻辑错误。冲突检测不可省略 | | "让子 Agent 自己读计划" | 子 Agent 不应读取计划文件。你应提供完整任务文本和上下文 | | "差不多合规就行" | 接受 Spec 合规的"差不多" = 未完成。发现问题 = 必须修复 | | "在 Spec 合规前开始代码质量审查" | 在 Spec 合规 ✅ 之前开始代码质量审查 = 顺序错误。先合规，后质量 | | "审查有问题但先继续下一任务" | 任一审查有未解决问题时进入下一任务 = 积累技术债务 | | "实现者自审就够了" | 让实现者自审替代实际审查 = 遗漏盲点。两者都需要 | | "跳过重新审查，直接继续" | 跳过审查循环 = 修复可能无效。重新审查是必需的 | | "子 Agent 的问题可以忽略" | 忽视子 Agent 提问 = 遗漏关键上下文。清晰完整地回答 | | "先实现后补测试" | 先写代码后补测试 = 不是 TDD。必须 RED→GREEN→REFACTOR | | "审查循环超过 3 次还继续" | 超过 3 轮未通过 = 计划或能力问题。必须上报用户 | | "子 Agent 审查通过就跳过质量检查" | 审查循环（最多 3 轮）是自动化质量门控，必须严格执行 | | "重新分派不带上下文" | 重新分派不带历史决策 = 重复工作、决策反复。必须传递上下文 |
| 借口 | 现实 | |------|------| | "审查浪费时间" | 审查防止问题复合。10 分钟审查可能节省数小时调试 | | "Spec 合规只是形式主义" | Spec 合规防止过度/不足构建。不是形式，是质量控制 | | "重新审查太繁琐" | 不重新审查 = 不知道修复是否有效。这是验证步骤 | | "实现者自审就够了" | 自审有盲点。独立审查发现不同问题 | | "子 Agent 问题太多，直接让它做" | 子 Agent 提问意味着上下文不足。回答前让它继续 = 错误实现 | | "跳过审查循环节省时间" | 跳过审查 = 接受未验证代码。最多 3 轮审查循环不可省略 | | "审查循环 3 次限制太死板" | 超过 3 次 = 根因未解决。上报用户调整计划比盲目修复更高效 | | "重新分派带上下文太啰嗦" | 不带上下文 = 重复问答、重复工作、决策反复。更浪费 | | "并行太复杂，还是串行吧" | 冲突检测只需检查文件重叠。能并行时不并行 = 浪费时间 |
如果子 Agent 提问：
如果审查者发现问题或审查循环超限：
如果子 Agent 任务失败：
vs. 手动执行：
vs. 批量执行：
效率提升：
质量门控：
必需工作流 Skill：
子 Agent 应使用：
完整示例参见 workflow-example.md。
完成摘要格式：
markdown## 子 Agent 驱动开发完成 **计划文件**: `docs/sw-agiledevelopment/plans/2026-04-08--auth-plan.md` **任务数**: 5 **完成**: 5/5 ### 审查统计 | 任务 | Spec 审查 | 代码审查 | 自动推进 | 迭代次数 | |------|----------|----------|----------|---------| | 1 | ✅ | ✅ | ✅ | 1 | | 2 | ✅ (1 修复) | ✅ (1 修复) | ✅ | 2 | | 3 | ✅ | ✅ | ✅ | 1 | | 4 | ✅ | ✅ (2 修复) | ✅ | 2 | | 5 | ✅ | ✅ | ✅ | 1 | ### 提交记录（由主 Agent 统一执行） - `abc1234`: 任务 1 - 用户登录 API - `def5678`: 任务 2 - JWT Token 生成 - ... ### 下一步 调用 sw-task-verification 标记完成
Other measured skills in the registry, with their headline benchmark lift.