Superpowers 上手指南：三步给你的编码 Agent 装上一套完整 Agentic 技能系统
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
Superpowers 是一个面向编码 Agent（Claude Code、Codex、Cursor、Gemini CLI 等）的 agentic 技能框架：它不替代你的 Agent，而是注入一组可组合的技能（头脑风暴、TDD、系统化调试、子代理协作等）和一套固定的开发方法论，让 Agent 从"接到需求到收尾"都走可验证的流程，而不是自由发挥。本文不按难度递进，而是按角色路径组织——你"只想跑起来"、"想拿真实需求干活"还是"想写自己的技能"，直接跳到对应章节即可。
路径一：5 分钟把 Superpowers 装上你的 Agent
如果你只关心"能不能跑"，这一节就够了。
按你用的 Agent 安装
Superpowers 以插件/扩展形式分发，各平台入口不同。用多个 Agent 就分别装一遍：
| Agent 平台 | 安装动作 |
|---|---|
| Claude Code | /plugin install superpowers@claude-plugins-official |
| Codex CLI | /plugins→ 搜索superpowers→ Install Plugin |
| Cursor | /add-plugin superpowers |
| Kimi Code | /plugins→ Marketplace → 安装 Superpowers |
| Gemini CLI | 执行gemini extensions install扩展安装命令 |
| OpenCode | 在opencode.json的plugin数组中加入 superpowers 后重启 |
需要源码安装（如 Pi，或想读代码）时，克隆仓库即可：
git clone https://gitcode.com/GitHub_Trending/su/superpowers30 秒验证是否装成功
打开 Agent 问一句：
Tell me about your superpowers能列出技能清单即成功；若无响应，先确认安装命令执行成功，然后重启 Agent。
装完后的第一站
技能库都在skills/目录下，每个技能一个SKILL.md。入口是 using-superpowers 技能，它定义了核心规则：做任何事之前先检查有没有适用技能——哪怕只有 1% 可能相关也要先调用。所以装完后你不需要改变和 Agent 的说话方式，它会自动拉起对应工作流。
路径二：让 Agent 完整跑通一个真实需求
装上之后，真正的价值体现在你给它一个真实需求时。Superpowers 的标准流程是固定的，值得记住这条主线：
- brainstorming：Agent 先反问，把模糊想法问成规格，分段给你确认
- using-git-worktrees：设计确认后自动建隔离 worktree，验证测试基线是绿的
- writing-plans：把工作拆成 2~5 分钟的小任务，每个任务带精确文件路径与验证步骤
- subagent-driven-development：每个任务派一个全新子代理执行，做两级审查（规格符合性 + 代码质量）
- test-driven-development：严格执行 RED-GREEN-REFACTOR，测试前写的代码会被删掉
- requesting-code-review：任务之间做代码审查，Critical 问题直接阻塞
- finishing-a-development-branch：验证测试，给出合并/PR/保留/丢弃选项，清理工作区
新手不必背每个技能的细节，理解一点即可：技能是自动触发的强制流程，不是建议。以两个最高频的为例：
- 修 Bug 时走 系统化调试四阶段流程：先复现、再找根因，然后才允许动代码
- 写功能时走 测试驱动开发：先写失败测试、看它失败、写最小代码、看它通过
💡 实战建议：第一次跑流程选一个"中等"的需求（一个小功能或一个明确的 bug）。太大你会淹没在审查里，太小又不值得走完整流程。
路径三：写自己的技能并参与贡献
用久了发现"我希望 Agent 也做 X"时，写技能就是自然的下一步。
一个 SKILL.md 就是一个技能
技能格式极简：一个 Markdown 文件，头部声明"何时用"：
--- name: my-skill description: Use when [触发条件] - [做什么] ---正文是给 Agent 执行的具体步骤。写作规范、常见反模式和用子代理测试技能的方法都在 writing-skills 指南 里，跟着它写基本不会跑偏。
最小贡献流程
- 克隆仓库，切到
dev分支，再建功能分支 - 按 writing-skills 指南开发并本地测试
- 跑
tests/下对应平台的测试脚本，例如cd tests/opencode && ./run-tests.sh - 提交 PR 并填写模板
提醒一句：维护者一般不直接接受新技能贡献，且任何技能改动必须验证在 Claude Code、Codex、Cursor 等所有支持平台都能工作，所以动代码前先读项目 README 的 Contributing 部分。
常见卡点与排查
- Agent 不用技能，直接自由发挥：先跑一遍"Tell me about your superpowers"验证安装，再在对话里明确要求"先查可用技能再动手"
- 流程显得笨重、慢：这是设计取向，用流程换可验证性；小任务可改用 executing-plans 技能按批次执行，不必每任务都走子代理审查
- 多平台安装冲突：每个平台维护独立安装，互不影响，升级时逐个处理即可
- 想关掉可选遥测：设置环境变量
SUPERPOWERS_DISABLE_TELEMETRY为真值，头脑风暴的可视化伴侣将不再加载远程 logo
下一步：挑一个你实际在用的平台按路径一完成安装，然后给它一个能完整走通 brainstorming → 计划 → 执行 → 审查全流程的小需求，感受这套 Superpowers 技能系统的完整闭环。
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
