Superpowers 上手指南：三步给你的编码 Agent 装上一套完整 Agentic 技能系统

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 就分别装一遍：

需要源码安装（如 Pi，或想读代码）时，克隆仓库即可：

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

30 秒验证是否装成功

打开 Agent 问一句：

Tell me about your superpowers

能列出技能清单即成功；若无响应，先确认安装命令执行成功，然后重启 Agent。

装完后的第一站

技能库都在skills/目录下，每个技能一个SKILL.md。入口是 using-superpowers 技能，它定义了核心规则：做任何事之前先检查有没有适用技能——哪怕只有 1% 可能相关也要先调用。所以装完后你不需要改变和 Agent 的说话方式，它会自动拉起对应工作流。

路径二：让 Agent 完整跑通一个真实需求

装上之后，真正的价值体现在你给它一个真实需求时。Superpowers 的标准流程是固定的，值得记住这条主线：

1. brainstorming：Agent 先反问，把模糊想法问成规格，分段给你确认
2. using-git-worktrees：设计确认后自动建隔离 worktree，验证测试基线是绿的
3. writing-plans：把工作拆成 2~5 分钟的小任务，每个任务带精确文件路径与验证步骤
4. subagent-driven-development：每个任务派一个全新子代理执行，做两级审查（规格符合性 + 代码质量）
5. test-driven-development：严格执行 RED-GREEN-REFACTOR，测试前写的代码会被删掉
6. requesting-code-review：任务之间做代码审查，Critical 问题直接阻塞
7. finishing-a-development-branch：验证测试，给出合并/PR/保留/丢弃选项，清理工作区

新手不必背每个技能的细节，理解一点即可：技能是自动触发的强制流程，不是建议。以两个最高频的为例：

• 修 Bug 时走 系统化调试四阶段流程：先复现、再找根因，然后才允许动代码
• 写功能时走 测试驱动开发：先写失败测试、看它失败、写最小代码、看它通过

💡 实战建议：第一次跑流程选一个"中等"的需求（一个小功能或一个明确的 bug）。太大你会淹没在审查里，太小又不值得走完整流程。

路径三：写自己的技能并参与贡献

用久了发现"我希望 Agent 也做 X"时，写技能就是自然的下一步。

一个 SKILL.md 就是一个技能

技能格式极简：一个 Markdown 文件，头部声明"何时用"：

--- name: my-skill description: Use when [触发条件] - [做什么] ---

正文是给 Agent 执行的具体步骤。写作规范、常见反模式和用子代理测试技能的方法都在 writing-skills 指南 里，跟着它写基本不会跑偏。

最小贡献流程

1. 克隆仓库，切到dev分支，再建功能分支
2. 按 writing-skills 指南开发并本地测试
3. 跑tests/下对应平台的测试脚本，例如cd tests/opencode && ./run-tests.sh
4. 提交 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