Superpowers 技能库:3 步让 AI 编程助手接上专业开发流程
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
你输入“加个登录功能”,AI 立刻动手写代码,一小时后你发现方向错了。Superpowers 技能库是一套给 Claude Code、OpenCode、Codex 等编码代理用的技能框架——它在写代码之前,先逼你的代理确认设计、写好计划、再审完代码。
⚡ 30 秒完成 Superpowers 安装:三大平台对比
安装很轻,但每个平台都要单独装一遍。你用哪个代理,就跑哪一段:
| 平台 | 命令 | 备注 |
|---|---|---|
| Claude Code(推荐) | /plugin install superpowers@superpowers-marketplace | 先添加 marketplace 再装,装完即用 |
| OpenCode | opencode.json里加一行插件配置 | 改完重启,问一句 "Tell me about your superpowers" 验证 |
| Codex | git clone https://gitcode.com/GitHub_Trending/su/superpowers ~/.codex/superpowers | 轻量目录方式,无额外依赖 |
Claude Code 只需两条命令:
/plugin marketplace add obra/superpowers-marketplace /plugin install superpowers@superpowers-marketplaceOpenCode 则在opencode.json的plugin数组里加一行:
{ "plugin": ["superpowers@git+https://gitcode.com/GitHub_Trending/su/superpowers.git"] }改完重启,插件会自动注册全部技能,不用手动建软链接。
🎯 它到底帮你省了哪几步
按你真实的工作节奏看,它替代的是三段手工活:
动手前定方案
你把想法抛出去,代理不写代码,先逐条提问,再把设计切成你能读完的小段,你确认后才动工。brainstorming 技能 里有硬门槛:设计没批准,一行代码都不许写。省掉的是返工时间。
写代码时
实现按任务拆给新的子代理,每个子代理独立上下文,不会被你前面的对话污染;每个任务做完自动走一轮“是否符合规格 + 代码质量”的审查,通过才进下一个。你不用逐步骤盯——流程细节在 subagent-driven-development。
提交之前
TDD 是强制的:先写失败的测试,再写最小实现(见 test-driven-development);任务之间还有一次对照计划的审查,严重问题直接阻断。排错则遵循 systematic-debugging 的铁律:先找根因,再谈修复。“修好了”有测试证据,不是感觉。
🔄 走一遍完整流程:加一个登录功能
下面是你会经历的实际交互:
- 你输入:“加个邮箱登录。”它做:不碰代码,逐个问清登录方式、安全要求、失败处理。你拿到:按段落展示的设计,确认批准后存进
docs/superpowers/specs/,并自检一遍有没有占位符和自相矛盾的地方。 - 你说:“批准,开工。”它做:把工作拆成 2–5 分钟一个的小任务,每个任务带精确文件路径、完整代码和验证步骤,同时开一个隔离的 worktree 工作区,确认测试基线是干净的。你拿到:一份照着做就能落地、不会跑偏的计划。
- 你说:“开始。”它做:每个任务派发一个全新子代理实现,另一个子代理审查;先写红测试再写绿实现,通过就记入账本、继续下一个,全程不停下来问“要继续吗”。你拿到:逐任务过审、逐任务过测的代码和提交记录,代理可以自主跑上几个小时不偏航。
- 收尾:自动触发分支收尾流程——跑全部测试,然后给你合并 / 提 PR / 保留 / 丢弃四个选项,顺手清理工作区。
全程你不需要手动调用任何技能。技能到点自动触发,你只负责拍板。
⚖️ 比“裸用” AI 强在哪
- 裸用靠你记得提醒,Superpowers 靠机制兜底。每次会话启动,session-start 钩子 把 using-superpowers 规则注入代理,要求它在回答前检查有没有适用技能——这是硬规则,不是建议。
- 裸用上下文会越滚越脏,Superpowers 做隔离。主会话只做协调,实现丢给独立上下文的子代理,工作放在 git worktree 的独立分支工作区,主项目和进行中的实验互不干扰。
- 裸用的“完成”是 AI 说了算,Superpowers 的“完成”有证据。计划里每个任务都带验证步骤,审查按严重级别报告问题,关键问题不解决就不往下走。
🧭 不同人怎么切入
- 独立开发者:先挑一个小功能(比如登录页)走完整流程,别一上来就动大重构。跑完一轮你就知道它省了哪些返工。
- 小团队:把它当共享流程模板——spec → plan → 实现 → 审查 → 收尾就是团队规范,新成员第一天就按同一套节奏干活,不用口头约定。
- 已有 AI 工作流想加强:只装一个平台,盯两个点:是否自动先问需求、是否在提交前自动审查。都成立,再扩到其他平台。
🕳️ 新手常踩的坑
问:技能没触发?先确认当前用的这个平台装了没有——Superpowers 各平台独立,给 Claude Code 装了对 OpenCode 没用。直接问代理“Tell me about your superpowers”,答不上来就是没生效。
问:OpenCode 更新后还是旧版本?OpenCode 的 git 依赖可能被锁在 lockfile 或缓存里,重启不一定拉到新提交。更新不生效就清包缓存或重装插件。
问:代理跳过设计直接写代码?说明技能没激活。重启代理,确认 session-start 注入成功;仍复现的话,检查技能目录是否被插件正确注册。
问:怎么更新?marketplace 装的插件通常自动更新;clone 方式进目录git pull后重启代理即可。
问:会上报数据吗?brainstorming 可选的视觉伴侣功能默认带一个版本追踪标识,设SUPERPOWERS_DISABLE_TELEMETRY即可关闭,不包含你的项目内容。
🏁 现在就可以试
下次说“开始写”之前,先把想法丢给装了 Superpowers 的代理,让它先问清你到底想做什么。
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考