开发与工程 workflowsubagentscode-reviewsuperpowers

Subagent-Driven Development(子代理驱动开发)

同一会话内为每个任务派发全新子代理实现,配两阶段审查,用进度台账防止压缩后重复劳动

FollowSkills 评估 · FSRS-1.0
谨慎使用
61/ 100
价值适配17 / 20

为已有实施计划且任务大体独立的当前会话提供清晰的多代理执行与审查流程;每项任务都有实现者、任务审查和最终分支审查,具有明确的质量优势。边界也有说明,例如紧密耦合任务、并行会话和缺少计划时应使用其他流程。未提供量化成功率或适用规模证据。

可靠性14 / 20

流程包含任务简报、报告文件、进度账本、状态处理、基于提交范围的审查包和修复后复审,支持一定程度的可恢复性与复现性。可靠性依赖当前代理具备子代理调度、文件读写、Git、测试和相关共享技能;本文件未定义这些依赖的兼容性、失败重试上限或工具不可用时的替代路径,也没有该技能自身的执行测试证据。

安全性15 / 25

要求未经明确同意不得在主分支开始实现,并要求使用隔离工作树、审查循环和完成分支流程,降低直接破坏代码的风险。实现者会修改文件、运行测试并提交,且流程要求连续执行、不在任务间向人类确认,外部影响和错误代理行为的即时遏制有限。未明确列出权限边界、敏感数据处理、提交回滚步骤或任务级用户批准点。

证据5 / 15

文本对过程控制和报告格式有较强的可追溯设计,包括基础提交、头提交、差异包、测试报告和账本记录。但这里没有该技能的行为测试、运行结果、独立评估或跨环境验证;示例中的测试通过是说明性内容而非本次审查可验证的证据。流程要求代理自报测试结果,独立复核测试真实性的机制不足。

易用性6 / 10

触发条件、适用场景、流程图、状态定义、模型选择指导、文件交接规则和提示模板都较完整,熟悉该框架的操作者可以按步骤执行。首次使用者仍需了解计划文件、工具调用、Git 工作树、共享技能和 scripts 路径;输入输出、运行成本、不同代理平台兼容性、工具缺失时的故障排查和安全退出说明不完整。

维护性4 / 10

仓库上下文提供 MIT 许可证和版本 6.1.1,但选定技能文件本身没有版本、变更记录或维护责任说明。它引用多个其他技能、模板和脚本,依赖关系可能随仓库变化而失效;未提供该技能专门的更新策略、兼容性矩阵或响应路径。发布者未被企业注册表验证,因此不能提供额外治理加分。

证据充分度: 评估于 2026年7月15日 审查版本 d884ae04edeb
使用前请注意
  • 连续执行规则可能在长任务中减少用户介入;在涉及高影响代码、生产配置或敏感数据时,应在任务边界增加人工批准和停止条件。
  • 在采用该流程前,应确认相关共享技能、脚本、子代理工具和 Git 工作树能力存在且版本兼容。
  • 不要把实现者报告或示例中的测试通过当作独立验证;应核实测试命令、覆盖范围、输出和实际提交差异。
  • 流程要求提交代码但未给出细化的回滚操作;应在执行前确认分支、工作树、提交和未提交改动的恢复方案。
查看完整评分方法 →

它能做什么 & 适用场景

Superpowers 工作流里承担实际编码的核心 skill:为计划里的每个任务派发一个全新的实现子代理(不继承会话历史),完成后生成 diff 包、派发任务评审子代理做「规格符合度」+「代码质量」两阶段审查,通过才标记完成,全部任务做完后再做一次整分支的最终评审。专门设计了一套「进度台账」机制应对长会话被压缩(compaction)后 Claude 忘记做过什么,靠 git log 和台账文件而不是记忆恢复进度,这是本文档篇幅最长(418 行)也是规则最密集的一个 skill。

读计划、记全局约束、建 todo;每个任务:派发实现子代理(用 implementer-prompt.md 模板)→ 子代理有疑问就答疑 → 子代理实现/测试/提交/自查 → 生成评审包(review-package 脚本)→ 派发任务评审子代理(task-reviewer-prompt.md 模板)→ 未通过则派修复子代理并重新评审 → 通过后在台账追加一行「任务N完成」;全部任务完成后派发最终整分支评审;最后交给 finishing-a-development-branch 收尾。还包含模型分级策略(机械任务用便宜模型、需要判断的任务用中档、架构设计用最强模型)、给评审子代理构造 prompt 的详细规则(不能预判评审结论、不能让评审重跑实现者已经跑过的测试、约束条款要从计划里逐字复制)、以及「产物用文件传递而不是塞进上下文」的具体做法。

  1. 有一份 writing-plans 产出的计划,任务之间基本独立,且想留在当前会话里快速迭代(不想切到新会话)
  2. 长时间会话中途被压缩,需要靠进度台账和 git log 恢复「做到哪了」而不是凭记忆瞎猜继续
  3. 根据任务复杂度自动选择子代理用什么档位的模型(机械改动用便宜模型、架构判断用最强模型)控制成本

优缺点一览

优点
  • 两阶段审查(规格符合度 + 代码质量)+ 全流程结束后的整分支审查,比大多数「写完就完」的工作流严谨得多
  • 进度台账机制专门解决了 agent 长会话的一个真实痛点——上下文压缩后忘记进度、重新执行已完成任务,是很实际的工程考量
  • 对评审 prompt 的构造给了非常具体的反模式清单(不许预判结论、不许要求评审重跑测试、约束条款必须逐字复制而不是转述),减少评审子代理被「带节奏」的空间
局限
  • 只在会自动读取和遵循 SKILL.md 指令的 harness 里可靠工作(Claude Code、Codex CLI 等);纯聊天式界面里等于一份说明文档,需要人工照做。
  • 418 行是这批 skill 里最长的,规则密度很高,人工通读理解成本不低
  • 整套流程涉及大量子代理调用(每任务至少 2 次,问题多时更多),token 和时间成本明显高于直接自己写代码,适合看重质量胜过速度的场景

如何安装

作为 obra/superpowers 插件的一部分安装,不能单独安装某一个 skill:

  1. Claude Code:官方市场 /plugin install superpowers@claude-plugins-official;或先注册 Superpowers 自建市场 /plugin marketplace add obra/superpowers-marketplace,再 /plugin install superpowers@superpowers-marketplace
  2. 也支持 Antigravity、Codex App/CLI、Cursor、Factory Droid、GitHub Copilot CLI、Kimi Code、OpenCode、Pi 等 harness,具体命令见仓库 README

装好后这个 skill 会和其余 13 个 Superpowers skill 一起启用,由 using-superpowers 统一引导、按场景自动触发,无需单独调用。

如何使用

当你有一份多任务的实现计划、任务之间相对独立、且想在当前会话内快速迭代时使用;跟 executing-plans 二选一,不建议同时用于同一份计划。

对比同类

跟 executing-plans 相比,这个 skill 是「重装版」:子代理隔离更彻底、审查更严格(两阶段+终审)、有台账防丢进度,但代价是更多子代理调用和更高 token 消耗;executing-plans 更轻量,适合没有子代理能力或想要更少开销的场景。

常见问题

评审没通过怎么办?
派发一个修复子代理处理 Critical/Important 发现项,改完重新走一遍评审子代理流程,直到通过才标记任务完成——不允许跳过重新评审。
为什么要用「模型分级」策略?
机械性任务(改动1-2个文件、需求明确)用便宜模型即可;需要多文件协调或判断力的任务用中档模型;架构设计和终审用最强模型——目的是控制成本同时不牺牲关键节点的质量。

同仓库的其他 Skills

均来自 obra/superpowers

开发与工程

Test-Driven Development(测试驱动开发)

铁律:没有先写失败测试就不能写生产代码,写了也要删掉重来,不允许「补测试」

开发与工程

Brainstorming(需求澄清与设计)

写代码前先把需求逼问清楚,禁止在没有确认设计前直接动手实现

开发与工程

Verification Before Completion(完成前必须验证)

没有当次运行过的验证证据,就不能说「完成了」「测试通过了」——包括「应该」「看起来」这类措辞

开发与工程

Finishing a Development Branch(收尾开发分支)

开发完成后先验证测试通过,再用固定的 4 选项菜单让人决定合并/PR/保留/丢弃,并按规则清理 worktree

开发与工程

Receiving Code Review(接收代码评审反馈)

禁止「你说得对!」式的表演性附和,要求先核实反馈再决定实施还是据理反驳

开发与工程

Requesting Code Review(发起代码评审)

派一个独立上下文的评审子代理来审查改动,而不是让主会话自己一边写一边给自己打分

开发与工程

Systematic Debugging(系统化调试)

任何 bug 都必须先完成根因排查再提修复方案,明确禁止「先随手改一下试试」

开发与工程

Writing Plans(撰写实现计划)

把需求拆成假设执行者对代码库一无所知也能照做的、每步 2-5 分钟的具体任务,杜绝「TBD」「补充细节」类占位符

开发与工程

Executing Plans(分会话执行实现计划)

在没有子代理能力的场景下,按人工检查点批量执行一份已写好的实现计划

开发与工程

Using Git Worktrees(隔离工作区管理)

开始新功能开发前,优先用平台原生隔离工具,没有的话再退回手动 git worktree

开发与工程

Dispatching Parallel Agents(并行子代理调度)

面对多个互不依赖的问题时,一次性并行派发多个子代理分别处理,而不是串行排队

开发与工程

Writing Skills(撰写与测试 Skill 本身)

把 TDD 的红绿重构套用到「写 Skill 文档」这件事上:先用无 skill 基线测试暴露真实失败模式,再针对性写文档,而不是凭直觉写

开发与工程

Using Superpowers(Superpowers 入口引导)

整套 Superpowers 方法论的启动引导 skill,规定「只要有 1% 可能相关就必须调用对应 skill」

相关 Skills