Superpowers实战指南:给AI编程代理一套标准开发流程,两条命令接入
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
Superpowers 是一个面向 AI 编程代理的技能框架和软件开发方法论,覆盖 Claude Code、Codex、Cursor、OpenCode 等十几种主流工具。它适合用 AI 写代码、但不满足于"随口一问就开始改代码"的开发者。
为什么代理总是急着动手
两个高频场景。一是你描述了一个模糊需求,代理立刻开始写代码,来回改几轮后发现方向错了,得推倒重来。二是让它修 bug,它"修"完之后问题还在,或者带出新问题——只处理了表象。
Superpowers 的做法是在写代码之前插入流程。装好之后,代理先向你提问确认真实目标,把设计拆成你能逐段消化的小块给你确认;你签核后它才生成任务清单,实现阶段强制执行测试先行。效果是"随口问就写"变成"先对齐、再动手、每步有检查点"。
最简接入路径
以 Claude Code 为例,在代理里执行两条命令:
/plugin marketplace add obra/superpowers-marketplace /plugin install superpowers@superpowers-marketplace安装后即时生效。Codex、Cursor、OpenCode 等工具各有独立的安装入口,命令不同,见 README.md 对应章节。
它什么时候派上用场
- 当你只有一个模糊想法时,它自动触发 brainstorming 技能:通过提问收敛需求、对比备选方案,最后落成一份可确认的设计文档。
- 当你准备动手做一个较大功能时,它会先用 git worktree 建出隔离工作区,你的主分支不受影响,还能先跑一遍基线测试确认是干净的。
- 当你逐任务实现时,它执行测试驱动循环:先写失败的测试,再写让它通过的最小代码,测试之前写的实现代码视为不合规。
- 当你让它长时间自主干活时,它把任务分派给子代理逐个执行,每个任务经过规范符合性、代码质量两道审查,而不是自己闷头写。
值得了解的机制:技能如何被触发
技能不是需要你记的指令列表。插件在会话启动时注入一段引导规则,上下文被压缩后还会再次注入,所以长会话中功能不丢失。多条技能同时适用时按优先级执行:流程类技能(如 brainstorming、systematic-debugging)先定方向,实现类技能再动手。规则是强制的——代理在每次任务前都会检查有没有适用技能,而不是当作建议。
三个容易踩的坑
- 多平台要各装一遍。每个工具的插件体系独立,同时用 Claude Code 和 OpenCode 就得分别安装,配置不互通。
- 流程不会自己跳过。如果觉得"杀鸡用牛刀",要显式告诉代理跳过某步;它默认会按技能要求走完整流程。
- 遥测可关。brainstorming 的可选可视化面板会从作者网站加载一张带版本号的图片用于统计,设置环境变量
SUPERPOWERS_DISABLE_TELEMETRY即可关闭,不会上传你的项目内容。
下一步
挑你最常用的平台装一次,然后扔一个中等规模的需求,完整观察设计确认、计划拆分、测试驱动这几个环节。想调整工作流的话,从 docs/ 入手,那里记录了每个功能的设计取舍和演进过程。
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考