Superpowers 源码拆解

以 obra/superpowers 6.2.0 本地源码为依据，按 Agent 生命周期拆解一个“软件开发方法论插件”是如何启动、注入、编排和验证的。

在线阅读：https://hanqing.github.io/superpowers-ai-notes/

仓库：https://github.com/Hanqing/superpowers-ai-notes

这份拆解回答什么

Superpowers 不是一个模型 SDK，也不是一个单独的 coding agent。它更像一套装载在不同 coding harness 上的“过程操作系统”：

• 用 SessionStart hook 把入口规则送进新会话；
• 用 SKILL.md 把设计、计划、TDD、调试、审查和收尾流程写成可发现的能力模块；
• 用 subagent、worktree 和 review loop 把“实现一个任务”变成可观察的流水线；
• 用适配文件把同一套过程翻译到 Claude、Codex、Cursor、Gemini、Kimi、OpenCode、Pi 等宿主。

章节地图

01 总览
   ↓
02 启动与注入 → 03 技能系统 → 04 设计与计划 → 05 执行与协作
                                                     ↓
                  06 质量闭环 ← 07 多 Harness 适配 ← 08 测试与演进

每章都沿用参考拆解的三个问题：是什么、源码怎么做、为什么这样做。最后附有完整技能目录、源码映射和术语表。

本地运行

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
mkdocs serve

然后打开 http://127.0.0.1:8000。

严格构建：

mkdocs build --strict

证据口径

分析对象是工作区中的 superpowers-main 快照；插件 manifest 标记的版本是 6.2.0，上游地址是 https://github.com/obra/superpowers。文中的路径以源码仓库根目录为基准，例如 skills/test-driven-development/SKILL.md；行号以本次拆解时的本地快照为准。

本拆解文档采用 CC BY-SA 4.0。上游 Superpowers 源码仍受其 MIT License 约束，源码版权归原作者及贡献者所有。