Superpowers 代理技能库一套让 AI 编码 Agent 守规矩的完整开发方法论指南【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers你让 AI 编码代理干活是不是经常提心吊胆它不跟你确认需求就开写你没盯住时写出一堆跑偏的代码出 bug 只治标不治本最后还自信满满地宣布完成了。Superpowers 正是为这类痛点准备的它由 14 个可组合技能加一套会话启动机制构成让代理自动先理需求、再写计划、后写代码、边干边审全程有章法可循。⚡ 一分钟认识 Superpowers一句话定位Superpowers 是一个开源MIT 协议的 agentic skills 框架相当于给你的编码代理装上一整套软件开发方法论。14 个技能覆盖从头脑风暴到分支收尾支持 Claude Code、Codex、Cursor 等 11 种工具技能自动触发你不需要记任何咒语技能本身按 TDD 编写行为经过验证 设计理念与底层机制Superpowers 最特别的地方不在技能本身而在技能是怎么造出来的。1. 技能创建就是 TDD把写文档当写代码先写测试给子代理设一个压力场景不给技能观察它失败并记录它找的借口RED再写一份针对这些失败模式的最小 SKILL.mdGREEN最后把新冒出来的漏洞一个个堵上、重新验证REFACTOR。核心信条是一句话如果你没亲眼见过代理在没有技能时失败你就不知道这份文档教对了没有。2. 技能分三类Technique技术型有具体步骤如 root-cause-tracingPattern模式型一种思考问题的方式Reference参考型API 文档、工具语法说明3. 七个环节串成主工作流代理每做一件事前都会先检查有没有相关技能顺序是brainstorming把粗糙想法问成设计文档→ using-git-worktrees开独立工作区→ writing-plans拆成 2~5 分钟一个的任务每个任务带精确文件路径和验证步骤→ subagent-driven-development 或 executing-plans分派执行→ test-driven-development写码时强制执行→ requesting-code-review任务间审查→ finishing-a-development-branch收尾合并。这不是建议是强制流程。 实战指南3 个最实用的技能systematic-debugging先找根因再谈修复适用场景任何测试失败、线上 bug、诡异行为——尤其是时间紧、看起来一眼就能修的时候恰恰最需要它。怎么用技能设了一条铁律未完成根因调查不许提修复方案按 4 个阶段推进仔细读报错、稳定复现、查最近改动、在组件边界埋诊断日志收集证据。能得到什么你看到的不是改了两处代码好了而是问题出在这条链路的这个环节。同样的 bug 不会再换个姿势复发。test-driven-development没看测试失败过代码删掉重写适用场景新功能、修 bug、重构、改行为——几乎所有实现类工作。怎么用严格按 RED-GREEN-REFACTOR 循环走先写失败测试、亲眼看它失败、写最小代码让它通过、再重构。技能对偷懒零容忍先写实现再补测试的代码要求删掉从头来不许留作参考。能得到什么每个测试都保证测的是对的东西而不是事后补出来的确认它能跑脚本。subagent-driven-development让子代理接力干活适用场景计划已经批准、任务清单明确你想让代理长时间自主推进。怎么用每个任务派一个全新的子代理执行完成后过两道审查——先查是否符合规范spec compliance再查代码质量。有阻塞级问题就打回否则继续下一任务。能得到什么README 里提到代理连续自主工作几个小时而不偏离计划是常态新子代理没有惯性偏见审查也更客观。 快速开始3 分钟上手克隆仓库git clone https://gitcode.com/GitHub_Trending/su/superpowers按你用的工具安装例如 Claude Code 中执行/plugin install superpowersclaude-plugins-official浏览 skills/ 目录14 个技能一目了然挑 1~2 个最常用技能通读其 SKILL.md如 skills/systematic-debugging/开个新会话直接说做一个 React todo list看 brainstorming 技能是否自动触发——触发了就说明装对了 避坑与最佳实践验证安装是否生效技能的自动触发依赖会话启动时加载 using-superpowers 引导。验收方法很简单——干净会话里发Lets make a react todo list没自动进入头脑风暴就是没装好。别指望 Agent 替你提 PR维护者明确写了约 94% 的 PR 被拒且要求人类审查完整 diff 后才能提交。贡献前先在 issues 和 PR 里查重。改技能内容要带证据技能是塑造行为的代码不是散文改动前后要跑对抗性压力测试并附 eval 结果否则基本会被拒。守住零依赖底线Superpowers 刻意不做第三方依赖需要外部工具的逻辑应拆成独立插件。领域技能别塞进核心只服务特定项目、领域或工作流的技能适合发布为独立插件而不是往主仓库提。不想要统计上报设置环境变量SUPERPOWERS_DISABLE_TELEMETRY为任意真值即可关闭遥测。最后Superpowers 证明了一件事给 AI 代理的不是更多能力而是一套被反复验证过的纪律。现在就去装一个用做一个 React todo list试试它的第一次头脑风暴觉得有用顺手点个 Star。【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考