Superpowers 上手路线:5 步给编码代理装上这套技能框架
2026/8/28 14:59:43 网站建设 项目流程

Superpowers 上手路线:5 步给编码代理装上这套技能框架

【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers

Superpowers 技能框架解决的问题很直接:你的编码代理一接到需求就埋头写码,跳过设计、测试和评审。它给 Claude Code、Cursor、Codex、OpenCode 等代理装上一套可组合的开发技能,让代理从"接活就写"变成"先想清楚再动手"。适合日常用 AI 写代码、但受够了改三遍才对的开发者。

5 分钟装好并跑通第一次会话

装好之前你没法体会这套流程的价值,所以第一步就是让它真正生效。

  1. 先克隆仓库,装好之后你也能读源码:

    git clone https://gitcode.com/GitHub_Trending/su/superpowers

  2. 以 Claude Code 为例,在代理里执行官方市场安装命令:/plugin install superpowers@claude-plugins-official。装完重启会话。

  3. 再问它一句"Tell me about your superpowers",它能列出技能清单,说明插件和 bootstrap 都注入了。

  4. 然后发一句"帮我做一个 React todo 应用",它应该先触发 brainstorming 开始追问需求,而不是直接堆代码。这就是验收标准。

用 Cursor、Gemini CLI、Codex 等其他 harness 的,看 README.md 里各自的安装小节,每个 harness 单独装一份。OpenCode 用户另有 docs/README.opencode.md 说明插件配置方式。

仓库目录速览:先看 skills,再看 hooks

熟悉目录之后再排坑或改东西会快很多,重点先放 skills 和 hooks 上。

目录 / 文件职责
skills/技能本体,每个子目录是一个技能,核心文档是其中的 SKILL.md
hooks/会话启动钩子,负责把 using-superpowers 引导内容注入会话
tests/各 harness 的插件加载、技能触发、发布同步测试脚本
scripts/版本号、打包、同步等维护脚本
docs/各平台使用指南和设计文档

一条需求走完 brainstorming 到自主开发

这是整个框架的心脏,搞懂它,其他技能都只是这个循环里的零件。

输入是一句自然语言需求,比如"帮我写个 React todo"。过程分四步走:

  • 先查技能。代理在动手前检查可用技能,命中即调用,"哪怕 1% 可能适用也必须查"。
  • 再进 brainstorming。通过提问、给替代方案,把模糊想法磨成设计文档,分块展示给你确认。这是流程里唯一的硬性人工卡点。
  • 设计敲定后,用 using-git-worktrees 开独立分支,再进 writing-plans:把设计拆成 2~5 分钟一个的小任务,每个任务都写清文件路径、完整代码和验证方式,标准是"没有判断力的实习生也能照做"。
  • 最后 subagent-driven-development 逐任务派新子代理执行,每个任务完成后过两道审查:先审规格符合度,再审代码质量;TDD 技能在此时强制红-绿-重构循环,没测试的代码会被删掉。finishing-a-development-branch 收尾:验证测试,给你合并、发 PR、保留或丢弃的选项。

输出是一份设计文档、一份计划文档、全绿的测试,和一个可合并的分支。README 里提到,代理可以连续自主跑几个小时而不偏离你定的计划。

两个练手任务与 4 个常见卡点

跑通只是知道,动手改一遍才记住。

练手任务一:用"React todo"完整走一遍流程,别跳过 brainstorming,拿到设计、计划、全绿测试和收尾选项。 练手任务二:找一个真 bug,要求代理用 systematic-debugging 修,感受它的四阶段根因流程如何约束动作。

常见卡点:

  • 装了插件但技能不触发:多半是 bootstrap 没注入。重启会话,再用技能清单那句问一次;还不行就查 harness 版本是否够新。
  • 混用多个 harness 时以为装一次就够:每个 harness 都要单独装,OpenCode 尤其容易漏,它走自己的插件体系。
  • OpenCode 更新不生效:git 依赖会被锁文件缓存住,清包缓存或重装插件;想固定版本就在插件地址上挂 tag。
  • Windows 上 OpenCode 装 git 依赖失败:用 npm 把包装到本地,再在 opencode.json 里指向本地路径。

接下来看哪里

  • 想自己写技能:读 skills/writing-skills/SKILL.md,里面有完整的技能编写与测试方法。
  • 跟更新:看 RELEASE-NOTES.md,新版本说明都在这。
  • 想贡献:先读 AGENTS.md 里的 PR 要求,这个仓库对贡献质量卡得很严,PR 要指向 dev 分支。

把 Superpowers 装进你现在最常用的那个代理,然后让它先帮你规划一个小功能。装好跑通一次,就能在日常开发里直接用它自动走完设计到收尾的全流程。

【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询