Superpowers 详细用法教程

Superpowers 详细用法教程项目地址 https github com obra superpowers 作者 Jesse Vincent obra 适用平台 主要为 Claude Code Claude 的编码环境 也支持 Codex OpenCode 等编码代理工具 核心理念 这是一个 代理技能框架 agentic skills framework

大家好,我是讯享网,很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



项目地址: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 实施。

  1. 打开 Claude Code。
  2. 输入命令注册市场:
     
  3. 安装 Superpowers 插件:
     
  4. 重启 Claude Code(或新开会话)让插件生效。
  5. 验证安装:
     你应该看到新命令,如: 
        
    • - 交互式设计精炼
    • - 创建实施计划
    • - 批量执行计划

更新插件

 
  

技能会自动更新。

  • 对于 Codex:
    在会话中告诉 AI:
     



  • 对于 OpenCode:
     

详细文档在仓库的 目录。

  • 技能发现与调用:AI 在收到任何任务时,必须先检查是否有相关技能适用(即使只有 1% 可能)。使用 工具加载技能文件,然后严格遵循。
  • 强制性:技能不是建议,而是必须遵守的规则。违反规则(如先写代码再写测试)会被视为错误。
  • 核心规则(来自 技能):
    • 在任何响应前,先调用相关技能。
    • 如果技能有 checklist,就逐项创建 todo。
    • 多技能时优先级:过程技能(如 brainstorming) > 实现技能。

典型开发流程(AI 会自动触发):

  1. Brainstorming:AI 先理解需求,通过一问一答精炼设计,探索多种方案,分段呈现设计供你确认。最终保存到 。
  2. 创建工作空间:使用 git worktrees 创建隔离分支,避免污染主分支。
  3. Writing Plans:把设计拆成极小的任务(每个 2-5 分钟),每个任务包含精确文件路径、完整代码、测试命令、预期输出。
  4. 执行计划
    • 子代理驱动(subagent-driven-development):主 AI 派发子代理逐任务实施 + 双阶段审查。
    • 或批量执行(executing-plans):在独立会话中批量跑,定期检查点。
  5. TDD 强制:每个实现都必须 Red → Green → Refactor,且必须看到测试先失败。
  6. 代码审查:任务间自动请求审查。
  7. 完成分支:测试全通过后,提供合并/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 系统。

 
  

小讯
上一篇 2026-04-07 07:15
下一篇 2026-04-07 07:13

相关推荐

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/219685.html