Superpowers 技能库完整指南：如何用 14 个 AI 开发技能让 Claude Code 代理稳定干活
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
Superpowers 是一个为 Claude Code 等编码代理提供 AI 开发技能的技能库，内置 14 个一级技能，每个技能下还挂着更细的辅助技术与文档。装上之后，代理不会急着写代码：它先弄清你要做什么，再逐条排计划、按 TDD 实现、每完成一项就自审一遍，全程自动触发，不用你额外下指令。
代理老"跑偏"？把流程变成强制项而不是建议
用过编码代理的人都熟悉这个场景：你说一句"给登录加个校验"，它直接开写，第一版方向就跑偏；碰到 bug 就凭感觉改，改一个冒三个。
Superpowers 把开发流程从"建议"变成"强制"：代理每开始一项任务前，先检查该套用哪个技能；设计被确认后，把工作拆成 2 到 5 分钟一项的小任务，每项派一个新的子代理实现，做完先审规格符合度、再审代码质量，最后对整个分支做一轮总审。官方 README 里说，代理连续自主工作几小时不偏离计划，并不罕见。
三类技能：技术、模式、参考，各管一类问题
技能全部放在 skills/ 目录下，一个技能一个文件夹：
skills/ skill-name/ SKILL.md # 主参考文档（必需） supporting-file.* # 辅助文件（按需）打开任意一份 SKILL.md 会发现，frontmatter 里的 description 只写"什么时候用"，不写"做什么"——这样代理看到任务时，能凭触发条件快速决定加载哪份技能。正文结构也是统一的：概述、何时使用、核心模式、快速参考、常见错误，扫一眼就知道重点在哪。
按解决的问题分，技能分三种：
技术型：给代理一套可照做的步骤
systematic-debugging（系统化调试）是代表。它立了一条铁律：没查明根因之前不许提修复方案，四阶段调查没走完，连猜测都不许有。文档里特意强调，越是赶时间越要执行这套流程，因为系统排查比乱试更快。它下面还挂着具体技术，比如 root-cause-tracing 讲怎么顺藤摸瓜找根因，condition-based-waiting 讲异步测试里别用 sleep 赌时序，而是等条件成立。
模式型：给代理一种思考方式
如 flatten-with-flags、test-invariants，不给现成代码，给的是判断力——什么时候该重构数据结构、测试里该守住哪些不变量。
参考型：API 与语法速查
工具用法、库 API 文档，代理写代码时随查随用，不用去猜参数名。
另一个绕不开的代表是subagent-driven-development（子代理开发）：每项任务派一个全新的实现者子代理，不继承主会话的上下文；任务审完立刻进下一项，主会话的上下文只留给协调工作。计划再大，也不至于把上下文撑爆。
新技能也走 TDD：RED、GREEN、REFACTOR 三阶段
库里的技能不是拍脑袋写的，是"测"出来的。writing-skills 文档把 TDD 完整搬到技能写作上：
- RED：先搭一个压力场景，在没写技能的情况下跑一遍，记下代理走了哪些弯路、用了什么说辞为自己开脱；
- GREEN：只针对这些失败模式写最小技能，重跑场景，确认代理照做了；
- REFACTOR：再找新的漏洞和说辞，堵上，重复测试到没有侥幸空间。
核心原则说得直白：没看过代理在没有技能时怎么失败，你就不知道这份技能到底教对了没有。
快速上手：克隆仓库，从技能目录读起
git clone https://gitcode.com/GitHub_Trending/su/superpowers用 Claude Code 的话，也可以直接在官方插件市场执行/plugin install superpowers@claude-plugins-official；Codex、Gemini CLI、Cursor 等工具各有安装方式，见 README 的 Installation 一节。装好后正常使用即可，技能会自动触发。
想弄清它怎么运转，建议先读三份 SKILL.md：subagent-driven-development看分工流水线怎么转，systematic-debugging看系统化调试的四阶段，test-driven-development看 RED-GREEN-REFACTOR 在代码层面怎么落地。
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
