Superpowers 完整指南：给 AI 编码代理一套真正的开发纪律
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
你告诉 AI"加个登录功能"，它立刻动手写代码，产出一堆看似漂亮但跑不通测试、没有设计、修 bug 时改得满世界都是的文件。Superpowers 就是给 AI 编码代理装上标准开发流程的一整套技能：动手做任何事之前，代理必须先检查该用哪个技能——先头脑风暴，再写计划，然后才执行。
Superpowers 解决的是什么问题
AI 编码代理的默认行为是"接到任务立刻写代码"：不问清需求、不先写测试、不等你审核、最后自己给自己通过。Superpowers 把自己定位为一套完整的软件开发方法论：它由一组可组合的技能（每个技能就是一份 Markdown 文档）加一段在会话启动时注入的初始指令构成，强制代理按流程走完再动代码。如果你在用 Claude Code、Codex、Cursor、Gemini CLI 等编码代理，希望它能自主跑几个小时而不停下来等你，这就是为你准备的。
核心机制：它是怎么按住代理的手的
问题很简单：代理的自由度太高，每一步全凭它自己判断，走偏了你也不知道。
方案分两层。第一层是初始指令，通过 hooks/session-start 钩子在会话开始时注入一条硬规则：只要一个技能有哪怕 1% 的可能适用，代理就必须调用它，"我回头再想"不算数。第二层是技能本身，skills/ 目录下每个技能一份 SKILL.md，写清触发时机和执行步骤。
效果是整条流程变成了强制流水线，而不是建议：
- 你说"我要做 X" →brainstorming用苏格拉底式追问，把粗糙想法变成可读的设计文档
- 设计确认后 →using-git-worktrees建隔离工作区，writing-plans把工作拆成 2-5 分钟的小任务
- 你说"开工" →subagent-driven-development每个任务派一个全新子代理，做完即审（先查规范符合度，再查代码质量）
- 全部完成 →finishing-a-development-branch校验测试，给出合并/PR 选项
技能是自动触发的，你不需要记命令，代理也不靠你反复叮嘱。
能力全景：按开发时间线各站一位
仓库里共 14 个技能，按你使用它们的先后排开：
- 需求期：brainstorming（提问式打磨设计）、writing-plans（每个任务带文件路径和验证步骤）
- 编码期：test-driven-development（强制红-绿-重构：先写失败测试、看它失败、写最小代码通过）、executing-plans（按批次执行、留人工检查点）
- 自主执行期：subagent-driven-development（每个任务新子代理，上下文互不污染）、dispatching-parallel-agents（并行子代理流）
- 质量与排障期：requesting-code-review、receiving-code-review、systematic-debugging（四阶段根因定位）、verification-before-completion（有证据才准说"修好了"）
- 元层面：writing-skills（用 TDD 造新技能）——先在不给技能的情况下跑一个"压力场景"，记录代理在哪走样，再写技能并复核代理是否守规
目录结构非常扁平，一个技能一个 SKILL.md：
skills/ brainstorming/ test-driven-development/ subagent-driven-development/ ...实战走查：一个重试功能从零到落地
背景：你想给支付回调加个重试机制，最多三次、指数退避。
- 你说"给支付回调加重试机制"。代理不写代码，先激活brainstorming，追问重试上限、退避策略、重试耗尽后是否进死信
- 你确认设计文档后，它自己建新分支和 worktree、跑项目初始化、确认测试基线全绿，并产出每任务 2-5 分钟的计划
- 你说"go"。subagent-driven-development派新子代理逐个实现，每完成一个任务就审一轮，发现问题进入修复循环，通过才推进下一个
- 任务全部完成后走finishing-a-development-branch，验证测试，你决定合并还是开 PR
结果：你只做了"确认设计、开工、合并"几个决定，代理中间自主执行了一大段，且所有改动都能回溯到那份设计文档。
快速上手：三步装到代理上
- 克隆仓库：
git clone https://gitcode.com/GitHub_Trending/su/superpowers- 以 Claude Code 为例，从官方市场安装：
/plugin install superpowers@claude-plugins-official- 开新会话，直接告诉代理你要做什么，技能会自动触发，无需额外操作。其他平台（Cursor、Codex、Gemini CLI 等）的安装命令见仓库 README。
避坑清单：最常见的四个坑
- 注意：不同编码代理的安装命令互不相同，如果你同时用 Claude Code、Cursor、OpenCode 等多个代理，要给每一个分别安装 Superpowers
- 建议：代理说"这个改动很简单，可以跳过流程"时别点头。技能是强制工作流而非建议，你可以明确要求它先调用对应技能再动手
- 注意：TDD 铁律在这里是硬性的——先于测试写的代码必须删掉，不能留作"参考"。这是整套框架里看着最狠、实际最保命的一条
- 建议：brainstorming 的可视化伴侣默认会联网加载一个 logo（携带版本号遥测），不需要可把 SUPERPOWERS_DISABLE_TELEMETRY 设为任意真值关闭
写在最后
Superpowers 的价值就一句话：把"代理很强但不守纪律"变成"代理守一套被反复压测过的方法论"，你才敢放开让它跑几个小时。clone 下来，下个功能先让它 brainstorm 一轮。
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
