项目地址:https://github.com/obra/superpowers
作者:Jesse Vincent (obra)
适用平台:主要为 Claude Code(Claude 的编码环境),也支持 Codex、OpenCode 等编码代理工具。
核心理念:这是一个“代理技能框架”(agentic skills framework),通过一系列可组合的“技能”(skills)强制 AI 编码代理遵循严格、可靠的软件开发方法论,而不是随意写代码。强调 TDD(测试驱动开发)、系统化调试、详细规划、子代理协作等,避免 AI 的常见问题(如跳过测试、过度复杂化)。
这个项目不是一个简单的系统提示词,而是一个插件化的技能系统。每个技能都是一个 Markdown 文件(SKILL.md),定义了特定场景下的严格规则。AI 在处理任务时必须先检查并调用相关技能。
适合所有开发者:无论你是初学者还是资深工程师,这个框架能让你的 AI 编码助手输出更可靠、生产级的代码。使用后,AI 不会直接冲上去写代码,而是先 brainstorm → plan → TDD 实施。
- 打开 Claude Code。
- 输入命令注册市场:
- 安装 Superpowers 插件:
- 重启 Claude Code(或新开会话)让插件生效。
- 验证安装: 你应该看到新命令,如:
- - 交互式设计精炼
- - 创建实施计划
- - 批量执行计划
更新插件:
技能会自动更新。
- 对于 Codex:
在会话中告诉 AI: - 对于 OpenCode:
详细文档在仓库的 目录。
- 技能发现与调用:AI 在收到任何任务时,必须先检查是否有相关技能适用(即使只有 1% 可能)。使用 工具加载技能文件,然后严格遵循。
- 强制性:技能不是建议,而是必须遵守的规则。违反规则(如先写代码再写测试)会被视为错误。
- 核心规则(来自 技能):
- 在任何响应前,先调用相关技能。
- 如果技能有 checklist,就逐项创建 todo。
- 多技能时优先级:过程技能(如 brainstorming) > 实现技能。
典型开发流程(AI 会自动触发):
- Brainstorming:AI 先理解需求,通过一问一答精炼设计,探索多种方案,分段呈现设计供你确认。最终保存到 。
- 创建工作空间:使用 git worktrees 创建隔离分支,避免污染主分支。
- Writing Plans:把设计拆成极小的任务(每个 2-5 分钟),每个任务包含精确文件路径、完整代码、测试命令、预期输出。
- 执行计划:
- 子代理驱动(subagent-driven-development):主 AI 派发子代理逐任务实施 + 双阶段审查。
- 或批量执行(executing-plans):在独立会话中批量跑,定期检查点。
- TDD 强制:每个实现都必须 Red → Green → Refactor,且必须看到测试先失败。
- 代码审查:任务间自动请求审查。
- 完成分支:测试全通过后,提供合并/PR/丢弃选项。
AI 会自动检查技能,并在合适时机触发。
仓库有 14 个核心技能(在 目录)。每个技能都是一个 SKILL.md 文件。下面挑选几个最重要的,完整贴出内容(作为“提示词实例”),让你明白技能的严格性。
这是第一个技能,建立整个框架规则。
完整内容:
(内容很长,核心是:任何任务前先调用技能,拒绝“简单问题就不用”的借口。)
触发时机:任何创意工作前(新功能、修改行为)。
完整内容示例(节选关键部分):
使用实例:
你说:“帮我建一个 Todo List app”。
AI 会先调用 brainstorming:
- 先问:“这是 Web app 还是命令行?用什么技术栈?”
- 提出 3 种方案(React + Flask、纯 Flask、Next.js 等)。
- 分段呈现设计,你确认后保存文档。
触发时机:任何实现或 bugfix 前。
完整内容示例(包含代码实例):
代码实例(来自技能文档):
为什么这么严格:防止 AI 写“看起来对”的代码而不验证。
触发时机:设计确认后。
完整内容示例:
计划文档实例(AI 会生成类似):
Step 2: Run test… (包含命令和预期)
…
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
/plugin update superpowers
我想用 Python 写一个命令行 Todo List 应用,支持 add、list、done、delete 命令,用 JSON 文件存数据。
设计看起来不错,继续吧。
设计批准了,请生成实施计划。
计划看起来好,去执行吧。
用 subagent-driven-development 执行计划,让它自主工作。
我的代码在添加任务时偶尔崩溃,帮我调试。下面是代码: [贴代码]
/superpowers:brainstorm 先分析可能的根因。
这个功能写完了,请做代码审查。
这个项目有前端和后端,可以并行开发吗?
全部搞定,准备合并。
快速写一个 Python 函数反转字符串。
告诉我怎么用 superpowers 系统。
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/219685.html