Superpowers 3 分钟上手指南给 AI 编程助手装技能库【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowersSuperpowers 是一个面向 Claude Code、OpenCode、Codex 等编程代理的 AI 编程助手技能库它给代理装上一套完整的开发方法论。它把代理你说一句它就写代码的行为改成先头脑风暴、再写计划、然后 TDD、再系统化排错的固定流程。本文讲三件事三个平台怎么装并验证、最常用的 3 个技能怎么用、装不上时查哪里。读完能在 3 分钟内让技能库在你的代理里跑起来。解决的问题代理不再上来就写代码默认情况下编程代理一理解你的意图就动手写代码设计假设没人审查、测试补在代码后面、排错靠猜。Superpowers 把这条链反过来代理在每个任务开始前先检查有没有匹配的技能有就必须按技能里的流程走。仓库当前版本 6.2.0MIT 协议版本号见.codex-plugin/plugin.jsonskills/目录下共 14 个技能串成 7 步链路brainstorming → using-git-worktrees → writing-plans → subagent-driven-development → test-driven-development → requesting-code-review → finishing-a-development-branch。这些是强制工作流而不是建议由代理自动触发不需要你手动喊。一键安装并验证各平台独立安装装好 Claude Code 不代表 OpenCode 或 Codex 也能用。Claude Code插件市场两条命令在 Claude Code 会话里依次执行/plugin marketplace add obra/superpowers-marketplace /plugin install superpowerssuperpowers-marketplace也可以用官方市场一条命令装/plugin install superpowersclaude-plugins-official。装完在会话里输入/help能看到技能相关命令即表示注册成功。OpenCodeopencode.json 加一行在全局或项目级的opencode.json的plugin数组里加入详见docs/README.opencode.md{ plugin: [superpowersgithttps://gitcode.com/GitHub_Trending/su/superpowers.git] }插件做两件事给每轮对话注入 Superpowers 引导上下文并通过 config 钩子注册skills/下的全部技能不需要软链接或手工配置。改完配置重启 OpenCode。如果你之前用旧版git clone 软链接方式装过先按docs/README.opencode.md的迁移小节删掉旧软链接。Codex/plugins 市场里搜索在 Codex CLI 里运行/plugins打开插件市场。搜索 superpowers。选择 Install Plugin。Codex App 用户则在侧边栏点 Plugins找到 Superpowers 后点 号。三个平台验证方式统一问代理tell me about your superpowers。它能列出 brainstorming、TDD 等技能说明注册成功该验证方式见docs/README.opencode.md。最常用的 3 个技能怎么用brainstorming设计没批准就不许写代码技能 frontmatter 声明它在任何创造性工作建功能、加组件、改行为之前必须使用。它设了一道 HARD-GATE设计展示并获批之前不得调用任何实现类技能、不得写代码、不得搭脚手架。流程共 9 步探索项目上下文、一次只问一个问题、给 2-3 个带取舍的方案、分段展示设计逐段获批最后把设计文档存到docs/superpowers/specs/并 commit完整内容见skills/brainstorming/SKILL.md。test-driven-development红绿重构循环frontmatter 要求在任何功能或 bug 修复的实现代码写之前使用。循环是 5 步写一个失败测试、看它失败、写最少代码、看它通过、commit。技能还有一条硬规定先写代码后补测试的那段代码要删掉重来。systematic-debugging四阶段根因分析遇到 bug、测试失败或异常行为在提出任何修复之前使用它。流程是 4 阶段根因定位同目录还有三篇配套文档按需加载root-cause-tracing.md根因追踪、defense-in-depth.md防御纵深、condition-based-waiting.md条件等待附带示例文件condition-based-waiting-example.ts。装不上时的 3 个排查点以下路径取自docs/README.opencode.md的 Troubleshooting 一节其他平台思路相同。插件没加载查日志里的 superpowersopencode run --print-logs hello 21 | grep -i superpowers没输出先核对opencode.json里那行 plugin 是否写对再把 OpenCode 升到较新版本后重试。技能找不到检查 SKILL.md 的 frontmatter让代理用 skill 工具列出可用技能。列表不全时逐个检查对应目录是否有带合法 YAML frontmattername 和 description 两个字段的SKILL.mdfrontmatter 缺失或格式错是最常见的未注册原因。版本没更新lockfile 缓存钉在旧 commit插件按 git 源安装部分 OpenCode 和 Bun 版本会把解析出的 git 依赖钉在 lockfile 或缓存里重启也不拉新 commit。处理办法清包缓存或重新安装插件也可以把配置里的 URL 追加 tag例如#v5.0.3钉住特定版本。下一步写自己的技能和移植新平台用 writing-skills 建新技能skills/writing-skills/SKILL.md是创建新技能的完整指南配套anthropic-best-practices.mdAnthropic 最佳实践和testing-skills-with-subagents.md子代理测试方法两篇参考examples/目录里有一个完整示例。个人技能放在各平台的个人技能目录OpenCode 是~/.config/opencode/skills/名称/SKILL.md项目技能放在项目内.opencode/skills/。优先级项目技能 个人技能 Superpowers 技能。移植到新平台你在用没覆盖到的平台时读docs/porting-to-a-new-harness.md它把移植过程走了一遍。每个平台的接入就是一个小文件Claude Code 读.claude-plugin/plugin.jsonOpenCode 读.opencode/plugins/superpowers.jsCodex 读.codex-plugin/plugin.json结构照抄即可扩展。第一个要做的动作打开你的平台跑上面对应小节的安装命令然后问代理tell me about your superpowers。验证通过后从一个小任务开始让它先走 brainstorming。【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考