Back to Details

aile-subagent-dev

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Aile：子代理驱动开发（aile-subagent-dev）

Aile：子代理驱动开发（aile-subagent-dev）

概述

概述

在团队流程中，本技能用于阶段 3 的任务执行：
  • 输入：
    docs/plans/{Story-Key}/analysis.md
    和
    docs/plans/{Story-Key}/plan.md
    中的任务拆解
  • 输出：按任务完成代码实现与验证，并通过双阶段审查把关
核心原則： 每個任務新鮮的子代理+兩階段審查（規格然後質量）=高質量，快速迭代
在团队流程中，本技能用于阶段3的任务执行：
  • 输入：
    docs/plans/{Story-Key}/analysis.md
    和
    docs/plans/{Story-Key}/plan.md
    中的任务拆解
  • 输出：按任务完成代码实现与验证，并通过双阶段审查把关
核心原则： 每个任务配备全新子代理+双阶段审查（规格合规→代码质量）=高质量、快速迭代

何時使用

何时使用

何时使用

—
  • 你已经有“已批准”的阶段 2 计划（
    analysis.md
    ）
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"];
}
與。執行計劃（平行會議）：
  • 同一會話（無上下文切換）
  • 每個任務都有新的子代理（無上下文污染）
  • 每項任務後進行兩階段審查：首先是規範合規性，然後是程式碼品質
  • 更快的迭代（任務之間沒有人在循環）
  • 你已经有“已批准”的阶段2计划（
    analysis.md
    ）
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"];
}
与「执行计划（平行会话）」的对比：
  • 同一会话（无上下文切换）
  • 每个任务都有新的子代理（无上下文污染）
  • 每项任务后进行两阶段审查：首先是规范合规性，然后是代码质量
  • 更快的迭代（任务之间无需人工介入）

流程

流程

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";
}
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
    - 派遣代碼質量審核員子代理
  • ./implementer-prompt.md
    - 派发实现者子代理
  • ./spec-reviewer-prompt.md
    - 派法规格合规审查员子代理
  • ./code-quality-reviewer-prompt.md
    - 派发代码质量审核员子代理

示例工作流程

示例工作流程

You: I'm using Subagent-Driven Development to execute this plan.

[Read plan file once: docs/plans/feature-plan.md]
[Extract all 5 tasks with full text and context]
[Create TodoWrite with all tasks]

Task 1: Hook installation script

[Get Task 1 text and context (already extracted)]
[Dispatch implementation subagent with full task text + context]

Implementer: "Before I begin - should the hook be installed at user or system level?"

You: "User level (~/.config/superpowers/hooks/)"

Implementer: "Got it. Implementing now..."
[Later] Implementer:
  - Implemented install-hook command
  - Added tests, 5/5 passing
  - Self-review: Found I missed --force flag, added it
  - Committed

[Dispatch spec compliance reviewer]
Spec reviewer: ✅ Spec compliant - all requirements met, nothing extra

[Get git SHAs, dispatch code quality reviewer]
Code reviewer: Strengths: Good test coverage, clean. Issues: None. Approved.

[Mark Task 1 complete]

Task 2: Recovery modes

[Get Task 2 text and context (already extracted)]
[Dispatch implementation subagent with full task text + context]

Implementer: [No questions, proceeds]
Implementer:
  - Added verify/repair modes
  - 8/8 tests passing
  - Self-review: All good
  - Committed

[Dispatch spec compliance reviewer]
Spec reviewer: ❌ Issues:
  - Missing: Progress reporting (spec says "report every 100 items")
  - Extra: Added --json flag (not requested)

[Implementer fixes issues]
Implementer: Removed --json flag, added progress reporting

[Spec reviewer reviews again]
Spec reviewer: ✅ Spec compliant now

[Dispatch code quality reviewer]
Code reviewer: Strengths: Solid. Issues (Important): Magic number (100)

[Implementer fixes]
Implementer: Extracted PROGRESS_INTERVAL constant

[Code reviewer reviews again]
Code reviewer: ✅ Approved

[Mark Task 2 complete]

...

[After all tasks]
[Dispatch final code-reviewer]
Final reviewer: All requirements met, ready to merge

Done!
你：我正在使用子代理驱动开发来执行此计划。

[读取计划文件一次：docs/plans/feature-plan.md]
[提取所有5个任务的完整文本和上下文]
[创建包含所有任务的TodoWrite清单]

任务1：Hook安装脚本

[获取任务1的文本和上下文（已提取）]
[派发实现者子代理，附带完整任务文本+上下文]

实现者：“开始之前 - 钩子应该安装在用户级别还是系统级别？”

你：“用户级别（~/.config/superpowers/hooks/）”

实现者：“明白了。开始实现...”
[稍后] 实现者：
  - 已实现install-hook命令
  - 添加了测试，5/5通过
  - 自我审查：发现遗漏了--force参数，已补充
  - 已提交

[派法规格合规审查员]
规格审查员：✅ 符合规格 - 满足所有需求，无额外内容

[获取git哈希值，派发代码质量审查员]
代码审查员：优点：测试覆盖率良好，代码简洁。问题：无。已批准。

[标记任务1完成]

任务2：恢复模式

[获取任务2的文本和上下文（已提取）]
[派发实现者子代理，附带完整任务文本+上下文]

实现者：[无疑问，直接开始]
实现者：
  - 添加了verify/repair模式
  - 8/8测试通过
  - 自我审查：一切正常
  - 已提交

[派法规格合规审查员]
规格审查员：❌ 问题：
  - 遗漏：进度报告（规格要求“每处理100项内容进行一次报告”）
  - 多余：添加了--json参数（未在需求中提及）

[实现者修复问题]
实现者：已移除--json参数，添加了进度报告功能

[规格审查员再次审查]
规格审查员：✅ 现在符合规格

[派发代码质量审查员]
代码审查员：优点：代码扎实。问题（重要）：存在魔法数字（100）

[实现者修复]
实现者：已提取为PROGRESS_INTERVAL常量

[代码审查员再次审查]
代码审查员：✅ 已批准

[标记任务2完成]

...

[所有任务完成后]
[派发最终代码审查员对整个实现进行审查]
最终审查员：所有需求均已满足，可合并

完成！

優點

优点

與。手動執行：
  • 子代理自然地遵循TDD
  • 每個任務都有新鮮的背景（沒有混淆）
  • 並行安全（子代理不幹擾）
  • 子代理可以提問（工作之前和工作期間）
與。執行計劃：
  • 同一會話（無切換）
  • 持續進步（無需等待）
  • 自動審查檢查點
效率提升：
  • 無檔案讀取開銷（控制器提供全文）
  • 控制器準確地規劃所需的上下文
  • 子代理預先取得完整資訊
  • 問題在工作開始之前（而不是之後）出現
質量門：
  • 移交前自我審查發現問題
  • 兩階段審查：規範合規性，然後是代碼質量
  • 審查循環確保修復確實有效
  • 符合規範可防止過度建設/建設不足
  • 代碼品質確保實施良好
成本：
  • 更多子代理呼叫（每個任務的實施者 + 2 個審閱者）
  • 控制器做更多的準備工作（預先提取所有任務）
  • 審查循環添加迭代
  • 但儘早發現問題（比稍後調試便宜）
与手动执行对比：
  • 子代理自然遵循TDD流程
  • 每个任务都有全新上下文（无混淆）
  • 支持安全并行（子代理之间无干扰）
  • 子代理可在工作前或工作中提出问题
与「执行计划」对比：
  • 同一会话（无需切换上下文）
  • 持续推进（无需等待）
  • 自动设置审查检查点
效率提升：
  • 无文件读取开销（控制器提供完整文本）
  • 控制器精准规划所需上下文
  • 子代理预先获取完整信息
  • 问题在工作开始前暴露（而非事后）
质量保障：
  • 移交前通过自我审查发现问题
  • 双阶段审查：规格合规性→代码质量
  • 审查循环确保修复切实有效
  • 符合规格可防止过度开发/开发不足
  • 代码质量审查确保实现方案优秀
成本说明：
  • 子代理调用次数更多（每个任务对应1个实现者+2个审查员）
  • 控制器需完成更多准备工作（预先提取所有任务）
  • 审查循环增加迭代次数
  • 但问题发现更早（比后期调试成本更低）

危險信號

危险信号

絕不：
  • 在使用者明確同意的情況下開始在 main/master 分支上實施
  • 跳過審查（規範合規性或程式碼品質）
  • 繼續處理未解決的問題
  • 並行調度多個實施子代理（衝突）
  • 讓子代理程式讀取計劃檔案（改為提供全文）
  • 跳過場景設定上下文（子代理程式需要了解任務適合的位置）
  • 忽略子代理問題（在繼續之前回答）
  • 接受規範合規性“足夠接近”（規範審核者發現問題=未完成）
  • 跳過審核循環（審核者發現問題 = 實施者修復 = 再次審核）
  • 讓實施者自我審查取代實際審查（兩者都需要）
  • **在規範合規性為✅**之前開始代碼質量審查（順序錯誤）
  • 當任一審核有未解決的問題時移至下一個任務
如果子代理提出問題：
  • 回答清楚、完整
  • 如果需要，提供額外的上下文
  • 不要急於實施
如果審閱者發現問題：
  • 實施者（同一子代理）修復它們
  • 審稿者再次審稿
  • 重複直至獲得批准
  • 不要跳過重新審核
如果子代理任務失敗：
  • 調度帶有特定說明的修復子代理
  • 不要嘗試手動修復（上下文污染）
绝对禁止：
  • 在未获得用户明确同意的情况下，在main/master分支上开始实现
  • 跳过审查（规格合规性或代码质量审查）
  • 继续处理存在未解决问题的任务
  • 并行派发多个实现者子代理（可能导致冲突）
  • 让子代理读取计划文件（应直接提供完整文本）
  • 跳过场景上下文设置（子代理需要了解任务的定位）
  • 忽略子代理的问题（继续前必须解答）
  • 接受规格合规性“大致符合”（规格审查员发现问题=未完成）
  • 跳过审查循环（审查员发现问题=实现者修复=再次审查）
  • 用实现者的自我审查替代正式审查（两者都需要）
  • 在规格合规性未通过✅前开始代码质量审查（顺序错误）
  • 当任一审查存在未解决问题时，推进到下一个任务
如果子代理提出问题：
  • 清晰、完整地回答
  • 必要时提供额外上下文
  • 不要急于开始实现
如果审查员发现问题：
  • 由同一实现者子代理修复问题
  • 审查员再次进行审查
  • 重复此过程直至获得批准
  • 不得跳过重新审查
如果子代理任务失败：
  • 派发带有明确指令的修复子代理
  • 不要尝试手动修复（会造成上下文污染）

一體化

集成

所需的工作流程技能：
  • 超級能力：使用-git-worktrees - 必需：在開始之前設置隔離的工作區
  • 超級大國：寫作計劃 - 創建該技能執行的計劃
  • superpowers:requesting-code-review - 審閱者子代理方案的方案碼審閱模板
  • 超級大國：完成開發分支 - 在完成所有任務後完成開發
子代理應使用：
  • 超級能力：測試驅動開發 - 子代理程式遵循TDD執行每項任務
替代工作流程：
  • superpowers:executing-plans - 用於端點會話而不是相同會話執行
所需工作流技能：
  • superpowers:using-git-worktrees - 必需：开始前设置隔离工作区
  • superpowers:writing-plans - 创建本技能可执行的计划
  • superpowers:requesting-code-review - 审查员子代理使用的代码审查模板
  • superpowers:finishing-a-development-branch - 所有任务完成后，完成开发分支的收尾工作
子代理应使用：
  • superpowers:test-driven-development - 子代理执行每个任务时需遵循TDD流程
替代工作流：
  • superpowers:executing-plans - 适用于平行会话而非同一会话的执行场景

执行流程

执行流程

开始时声明：“我正在使用 aile-subagent-dev 技能按计划执行任务。”
  1. 读取 
    analysis.md
    ，提取所有任务全文与依赖
  2. 建立任务列表（以依赖顺序执行）
  3. 对每个任务：
    • 若任务状态为 BLOCKED，先执行“阻塞任务处理”（见下文），仅在解除阻塞后进入实现
    • 派发 implementer 子代理：只给任务全文、相关文件路径、验证命令、约束（必须 TDD）
    • implementer 完成后：自检（是否按计划、是否验证、是否有多做/少做）
    • 派发 spec reviewer：核对“计划/AC/测试”一致性
    • 派发 code quality reviewer：核对质量与安全
    • 有问题则返工并复审，直到通过
  4. 所有任务完成后：派发一次全量代码审查（可选），进入交付流程
开始时声明：“我正在使用aile-subagent-dev技能按计划执行任务。”
  1. 读取
    analysis.md
    ，提取所有任务的完整文本与依赖关系
  2. 建立任务列表（按依赖顺序执行）
  3. 对每个任务：
    • 若任务状态为BLOCKED，先执行「阻塞任务处理」（见下文），仅在解除阻塞后进入实现环节
    • 派发implementer子代理：仅提供任务完整文本、相关文件路径、验证命令、约束条件（必须遵循TDD）
    • implementer完成后：进行自检（是否符合计划、是否完成验证、是否存在多做/少做内容）
    • 派发spec reviewer：核对「计划/验收标准/测试」的一致性
    • 派发code quality reviewer：核对代码质量与安全性
    • 若存在问题则返工并重新审查，直至通过
  4. 所有任务完成后：派发一次全量代码审查（可选），进入交付流程

阻塞任务处理

阻塞任务处理

遇到 BLOCKED 状态的任务时：
  1. 使用 
    jira_get_issue
    读取当前任务的 
    blocked-by
    Link。
  2. 检查被依赖 Issue 的状态：
    • 若依赖 Issue 仍未完成：跳过当前任务，继续执行其他非阻塞任务。
    • 若依赖 Issue 已完成：
      • 读取其 Comment，提取接口契约/事件定义等关键信息。
      • 将契约信息写入当前任务上下文（供 implementer 与 reviewer 使用）。
      • 将当前任务状态从 BLOCKED 流转为 IN PROGRESS。
      • 按本技能流程进入 TDD 开发与后续双阶段审查。
遇到状态为BLOCKED的任务时：
  1. 使用
    jira_get_issue
    读取当前任务的
    blocked-by
    链接。
  2. 检查被依赖Issue的状态：
    • 若依赖Issue仍未完成：跳过当前任务，继续执行其他非阻塞任务。
    • 若依赖Issue已完成：
      • 读取其评论，提取接口契约/事件定义等关键信息。
      • 将契约信息写入当前任务上下文（供implementer与reviewer使用）。
      • 将当前任务状态从BLOCKED流转为IN PROGRESS。
      • 按照本技能流程进入TDD开发与后续双阶段审查。

危险信号

危险信号

  • 在未通过规格合规审查前进入代码质量审查
  • 子代理未运行验证就声称完成
  • 任务间并发派发多个实现子代理导致冲突
  • 让子代理通读整份计划导致上下文膨胀与偏航
  • 在未通过规格合规审查前进入代码质量审查
  • 子代理未运行验证就声称任务完成
  • 任务间并发派发多个实现子代理导致冲突
  • 让子代理通读整份计划导致上下文膨胀与偏离方向