Skills
skills/zhucl1006/ailesuperpowers/aile-subagent-dev

aile-subagent-dev

SKILL.md

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

来源原 Skill

  • 来源：superpowers 子代理开发能力（已迁移为 aile-only）
  • 策略：保留“实现→规格审查→质量审查”双阶段循环，并对齐团队 Jira 流转。

概述

在团队流程中，本技能用于阶段 3 的任务执行：

  • 输入：docs/plans/{Story-Key}/analysis.md 和docs/plans/{Story-Key}/plan.md 中的任务拆解
  • 输出：按任务完成代码实现与验证，并通过双阶段审查把关

核心原則： 每個任務新鮮的子代理+兩階段審查（規格然後質量）=高質量，快速迭代

工作流程概览

项目初始化：project-docs-init（创建文档）
      ↓
需求分析：aile-requirement-analysis（结构化需求分析  + 更新文档）
      ↓
计划制定：aile-writing-plans（设计 + 计划）
      ↓
执行开发：aile-executing-plans 或 aile-subagent-dev（按计划执行 + 人工检查点）
      ↓
交付总结：aile-delivery-report（整理交付材料 + 回链 Story）

何時使用

何时使用

  • 你已经有“已批准”的阶段 2 计划（analysis.md）
digraph when_to_use {
    "Have implementation plan?" [shape=diamond];
    "Tasks mostly independent?" [shape=diamond];
    "Stay in this session?" [shape=diamond];
    "aile-subagent-dev" [shape=box];
    "aile-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?" -> "aile-subagent-dev" [label="yes"];
    "Stay in this session?" -> "aile-executing-plans" [label="no - parallel session"];
}

與。執行計劃（平行會議）：

  • 同一會話（無上下文切換）
  • 每個任務都有新的子代理（無上下文污染）
  • 每項任務後進行兩階段審查：首先是規範合規性，然後是程式碼品質
  • 更快的迭代（任務之間沒有人在循環）

流程

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 aile-delivery-report" [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 aile-delivery-report";
}

提示模板

  • ./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!

優點

與。手動執行：

  • 子代理自然地遵循TDD
  • 每個任務都有新鮮的背景（沒有混淆）
  • 並行安全（子代理不幹擾）
  • 子代理可以提問（工作之前和工作期間）

與。執行計劃：

  • 同一會話（無切換）
  • 持續進步（無需等待）
  • 自動審查檢查點

效率提升：

  • 無檔案讀取開銷（控制器提供全文）
  • 控制器準確地規劃所需的上下文
  • 子代理預先取得完整資訊
  • 問題在工作開始之前（而不是之後）出現

質量門：

  • 移交前自我審查發現問題
  • 兩階段審查：規範合規性，然後是代碼質量
  • 審查循環確保修復確實有效
  • 符合規範可防止過度建設/建設不足
  • 代碼品質確保實施良好

成本：

  • 更多子代理呼叫（每個任務的實施者 + 2 個審閱者）
  • 控制器做更多的準備工作（預先提取所有任務）
  • 審查循環添加迭代
  • 但儘早發現問題（比稍後調試便宜）

危險信號

絕不：

  • 在使用者明確同意的情況下開始在 main/master 分支上實施
  • 跳過審查（規範合規性或程式碼品質）
  • 繼續處理未解決的問題
  • 並行調度多個實施子代理（衝突）
  • 讓子代理程式讀取計劃檔案（改為提供全文）
  • 跳過場景設定上下文（子代理程式需要了解任務適合的位置）
  • 忽略子代理問題（在繼續之前回答）
  • 接受規範合規性“足夠接近”（規範審核者發現問題=未完成）
  • 跳過審核循環（審核者發現問題 = 實施者修復 = 再次審核）
  • 讓實施者自我審查取代實際審查（兩者都需要）
  • **在規範合規性為✅**之前開始代碼質量審查（順序錯誤）
  • 當任一審核有未解決的問題時移至下一個任務

如果子代理提出問題：

  • 回答清楚、完整
  • 如果需要，提供額外的上下文
  • 不要急於實施

如果審閱者發現問題：

  • 實施者（同一子代理）修復它們
  • 審稿者再次審稿
  • 重複直至獲得批准
  • 不要跳過重新審核

如果子代理任務失敗：

  • 調度帶有特定說明的修復子代理
  • 不要嘗試手動修復（上下文污染）

一體化

所需的工作流程技能：

  • 超級能力：aile-git-worktrees - 必需：在開始之前設置隔離的工作區
  • 超級大國：aile-writing-plans - 創建該技能執行的計劃
  • aile-code-review - 審閱者子代理方案的方案碼審閱模板
  • 超級大國：aile-delivery-report - 在完成所有任務後完成開發

子代理應使用：

  • 超級能力：aile-tdd - 子代理程式遵循TDD執行每項任務

替代工作流程：

  • aile-executing-plans - 用於端點會話而不是相同會話執行

执行流程

开始时声明：“我正在使用 aile-subagent-dev 技能按计划执行任务。”

  1. 读取 analysis.md，提取所有任务全文与依赖
  2. 建立任务列表（以依赖顺序执行）
  3. 对每个任务：
    • 若任务状态为 BLOCKED，先执行“阻塞任务处理”（见下文），仅在解除阻塞后进入实现
    • 派发 implementer 子代理：只给任务全文、相关文件路径、验证命令、约束（必须 TDD）
    • implementer 完成后：自检（是否按计划、是否验证、是否有多做/少做）
    • 派发 spec reviewer：核对“计划/AC/测试”一致性
    • 派发 code quality reviewer：核对质量与安全
    • 有问题则返工并复审，直到通过
  4. 所有任务完成后：派发一次全量代码审查（可选），进入交付流程

阻塞任务处理

遇到 BLOCKED 状态的任务时：

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

危险信号

  • 在未通过规格合规审查前进入代码质量审查
  • 子代理未运行验证就声称完成
  • 任务间并发派发多个实现子代理导致冲突
  • 让子代理通读整份计划导致上下文膨胀与偏航
Weekly Installs
18
Repository
zhucl1006/ailes…erpowers
First Seen
Feb 14, 2026
Security Audits
Gen Agent Trust HubPass
SocketPass
SnykPass
Installed on
github-copilot18
codex18
kimi-cli18
gemini-cli18
amp18
opencode18