Superpowers 技能框架完整指南:让编码代理按流程干活-开发者社区

Superpowers 技能框架完整指南:让编码代理按流程干活

【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers

Superpowers 技能框架是给编码代理（AI 编程助手）装上的完整开发方法论：装上后，代理不再上来就写代码，而是先出设计、再拆计划、按 TDD（测试驱动开发，先写失败测试再写实现）推进，最后才合并分支。

项目速览

它装在你日常使用的编码代理上，覆盖"需求 → 设计 → 实现 → 评审 → 合并"的整段流程。我把它挂在 Claude Code 和 Codex CLI 上跑了半年，适合想把这条链完整交给代理、又不想全程盯着的人。

能力	一句话说明
技能库（skills/）	头脑风暴、写计划、TDD、系统化调试、代码评审、分支收尾等一套内置技能
钩子（hooks/）	会话启动时自动把"用技能的规矩"注入上下文，技能因此自动触发
子代理驱动开发	每个任务派全新子代理 + 两阶段评审，连跑数小时不跑偏
多 harness 支持	同一套技能在 Claude Code、Codex、Cursor、Gemini CLI 等 11 种代理工具里通用

和很多"指令包"类工具不同，Superpowers 技能框架把流程设为强制工作流：代理每做一个任务前都必须先查技能库，没有"可跳过"一说。

核心能力拆解 🧩

钩子驱动的会话初始化：技能为什么能自动触发

钩子（hook）是 harness 在固定时机执行的命令，比如会话启动时。你启动会话，harness 读hooks/hooks.json的声明并运行hooks/session-start：脚本把 using-superpowers 技能的 SKILL.md 读出来，按平台输出不同 JSON 字段注入上下文——Cursor 收additional_context，Claude Code 收hookSpecificOutput.additionalContext。这一次注入，就是后面所有技能"活着"的开关。

"SessionStart": [ { "matcher": "startup|clear|compact", "hooks": [ { "type": "command", "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" session-start" } ] } ]

你不需要在对话开头提醒"先别写代码"，引导在启动时已就位。

技能流转：从头脑风暴走到分支收尾

内置技能串成一条标准流水线：

brainstorming → using-git-worktrees → writing-plans → subagent-driven-development → test-driven-development → requesting-code-review → finishing-a-development-branch

多个技能同时适用时，流程技能（如 brainstorming、systematic-debugging）先定方向，实现类技能负责落地；brainstorming 还有硬门禁：设计没获你批准，不写一行代码、不搭任何脚手架。每个环节的完整规则在 skills/ 下对应的 SKILL.md 里，想看哪个环节怎么执行，直接打开那份文件。

子代理驱动开发：每任务换一个"新同事"

SDD（subagent-driven-development）的打法是：每个任务派一个全新子代理（独立上下文的新 agent 实例），实现完先查规格符合度、再查代码质量，整条分支收尾前还有一次全量评审。任务之间它不会停下来问你"继续吗"，按计划连跑几个小时很常见。

skills/subagent-driven-development/ ├── SKILL.md # 主流程 ├── implementer-prompt.md # 实现者子代理提示词 ├── task-reviewer-prompt.md # 任务评审提示词 └── re-review-prompt.md # 定向复审提示词

上下文隔离加每任务评审，质量才不会随任务数量下滑。

进阶组合与实战技巧

团队里有人用 Claude Code、有人用 Cursor，钩子声明的格式还不一样（hooks.json对hooks-cursor.json）。遇到这种情况，把钩子声明当代码来管：给所有人钉住同一个 Superpowers 版本号，流程口径就一致了——

/plugin install superpowers@claude-plugins-official # Claude Code /add-plugin superpowers # Cursor

自己业务特有的流程（比如发布清单），别往核心技能里塞，核心刻意保持零依赖和通用。按 writing-skills 的规范单独写一个技能，与内置技能串起来用：流程技能仍然先走，你的技能接住实现细节。技能文件本身就在仓库里，改起来和改配置一样，可以直接走 code review。

新手常见坑与排查 🛠️

装好之后最常卡住的三件事，都花不了几分钟。

现象：装完代理还是上来就写代码。正确做法：多半是 session-start 钩子没生效——手动拷贝技能文件的装法不会加载引导。在干净会话发一句 "Let's make a react todo list"，没自动触发 brainstorming 就用官方插件命令重装。
现象：两个工具都装了，只有一个有技能。正确做法：各 harness 的插件体系互相独立，Claude Code 装完后，OpenCode、Cursor 要各自再装一遍。
现象：担心 visual companion 上报数据。正确做法：它默认只回传版本号，不含项目与提示词细节；想彻底关掉，设个环境变量即可：