Superpowers 完整集成指南14 个技能让 AI 编程代理像资深工程师一样开发【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowersSuperpowers 是面向 AI 编程代理的技能框架与开发方法论。它让 coding agent 先想清楚、先写测试、先自查再动手写代码。本文带你一次跑通安装、使用与排错。3 分钟看懂技能自动触发的原理5 分钟装好覆盖 Claude Code、Gemini CLI 等 11 个平台掌握三个典型流程新功能、修 bug、执行计划快速定位技能不触发、钩子失效等常见坑Superpowers 解决什么问题直接对 coding agent 说帮我做个功能常见的翻车方式有三种需求没聊透就开写agent 跳过澄清直接产出方向跑偏的代码代码没有测试兜底改一处坏三处回归全靠运气长会话上下文漂移会话一长agent 忘记最初约定质量下滑Superpowers 的思路是把一套被验证过的开发方法论TDD、系统性调试、计划先行拆成 14 个技能文件交给 agent 强制执行。它的项目哲学只有四条测试先行、流程优先于猜测、持续简化、拿证据说话而不是口头宣称。技能全在 skills/ 目录每个技能一个文件夹一份 SKILL.md 加若干参考资料。当前版本 6.2.0MIT 协议。核心原理技能为什么会自动触发技能 工位上的 SOP 卡。类比一下新工厂不让工人凭感觉操作而是在每个工位贴标准作业卡。技能就是贴给 AI 的 SOP 卡每张卡写清楚什么时候用、按什么步骤做。技能卡的结构很简单文件开头是 YAML 元数据--- name: my-skill description: 什么时候该用这个技能 ---name和description是 agent 判断该不该用这张卡的依据缺一不可。开场自动注入员工手册。光有 SOP 卡不够还得让 agent 知道上班第一件事是找卡片。Superpowers 靠一个会话启动钩子解决钩子定义在 hooks/hooks.json匹配startup|clear|compact三种时机会话开始、清空、压缩上下文时hooks/session-start 会把using-superpowers技能全文注入会话这份技能里有著名的1% 规则只要有一丝可能某技能适用就必须调用优先级流程技能先行执行技能在后。比如做个功能先走 brainstorming修 bug先走 systematic-debugging。而人的指令永远排在技能之前CLAUDE.md、AGENTS.md 或你的直接要求都高于技能规定。不同平台对钩子输出的字段要求不一样钩子脚本会自动适配Cursor 读additional_contextClaude Code 读hookSpecificOutputCopilot CLI 读顶层additionalContext。你不用管知道它存在即可。Superpowers 安装步骤各平台安装方式不同。装完在任意平台说一句帮我做个东西agent 会先声明Using [skill] to [purpose]就说明生效了。平台安装方式Claude Code/plugin install superpowersclaude-plugins-officialCodex CLI/plugins搜索 superpowers 后安装Codex App侧栏 Plugins 中找到 Superpowers点Cursor/add-plugin superpowersGitHub Copilot CLIcopilot plugin install superpowerssuperpowers-marketplaceKimi Code/plugins进入 Marketplace 安装Factory Droiddroid plugin install superpowerssuperpowersAntigravityagy plugin install指向本仓库地址Gemini CLIgemini extensions install指向本仓库地址Pipi install指向本仓库地址OpenCode按 docs/README.opencode.md 走独立插件流程需要用到仓库地址时Antigravity、Gemini CLI、Pi 等按仓库安装的平台仓库是git clone https://gitcode.com/GitHub_Trending/su/superpowers更新多数平台自动更新。手动的话Gemini CLI 用gemini extensions update superpowersAntigravity 重装一遍即可。本地开发Pi 支持临时加载本地改动pi -e /path/to/superpowers。其他平台的基础设施测试跑 tests/ 下对应目录的run-*.sh或npm test。三个典型用法新功能、修 Bug、执行计划场景一从零开发一个新功能这是完整的主线流程共 7 步每步由对应技能自动接管brainstorming一次只问一个问题把需求聊透给 2-3 个方案供选择设计文档存到docs/superpowers/specs/下你签字才放行using-git-worktrees新建分支和隔离工作区先确认测试基线是绿的writing-plans把活拆成 2-5 分钟一个的小任务每个任务带精确文件路径、完整代码和验证步骤subagent-driven-development每个任务派一个全新子代理执行做完先查是否符合规范、再看代码质量test-driven-development红绿重构循环——先写失败的测试再写最小实现。测试前写的代码会被删掉requesting-code-review按严重程度报告问题Critical 级别直接挡住进度finishing-a-development-branch验证测试后四选一收尾合并、提 PR、保留或丢弃README 提到agent 经常能自主连续工作几小时而不偏离计划。场景二排查一个难缠的 Bug对 agent 说修这个 bugsystematic-debugging 会先接管四阶段定位根因配 root-cause-tracing、defense-in-depth 等参考文档。修完后 verification-before-completion 会逼着它验证真的修好了而不是只看测试变绿就收工。参考资料在 skills/systematic-debugging/包括条件等待示例和找污染源脚本。场景三执行一份现成的计划计划已经写好时有两条路subagent-driven-development同会话内连续执行任务之间不打断你executing-plans分批执行每个批次留人工检查点任务之间互相独立、可以并发时dispatching-parallel-agents 会帮你同时派多个子代理。常见问题排查技能不触发与钩子失效技能不触发按顺序检查新开会话。钩子只在 startup、clear、compact 时机触发老会话不会自动补注入确认该平台装完了。多个平台混用时Superpowers 需要每个平台各装一份装 A 不算装 B检查技能文件格式。SKILL.md 缺少name或descriptionagent 就无法识别该技能直接点名试试。对 agent 说用 brainstorming 技能能唤起说明技能在、自动判断有问题官方在 tests/explicit-skill-requests/ 里有一组点名触发的测试提示词可以参考钩子没跑起来现象是会话里看不到using-superpowers注入内容。检查平台环境变量是否被正确识别钩子靠CURSOR_PLUGIN_ROOT、CLAUDE_PLUGIN_ROOT、COPILOT_CLI判断该输出哪种 JSON 字段识别失败时会退回 SDK 标准格式个别平台可能不消费。Windows 上的钩子调用走 hooks/run-hook.cmd。行为和你的约定冲突指令优先级是你的指令 技能 默认行为。想跳过某段流程直接告诉 agent这次不用走 brainstorming。想长期改行为写进 CLAUDE.md、AGENTS.md 或 GEMINI.md而不是改技能文件。调优与扩展速查可调旋钮一览表旋钮位置默认值何时调整钩子触发时机hooks/hooks.json 的 matcherstartup|clear|compact需要更多时机重新注入时遥测开关环境变量开启仅上报版本号企业合规要求时关闭任务粒度writing-plans 技能每个任务 2-5 分钟任务偏小导致代理开销过大时本地调试Pi 的pi -e参数不加载本地包改技能后想立即验证时遥测只上报 Superpowers 版本号不含项目和提示词内容。关闭方式把SUPERPOWERS_DISABLE_TELEMETRY设为任意真值Claude Code 的DISABLE_TELEMETRY、CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC也会被尊重。验证技能行为项目分两层测试详见 docs/testing.mdtests/插件基础设施测试bash node python跑run-*.sh或npm testevals/drill 评测框架驱动真实 LLM 会话LLM 评审员判断技能是否被正确遵守单个场景 3-30 分钟写一个自己的技能按 skills/writing-skills/SKILL.md 的规范来frontmatter 带 name 和 description正文按触发条件—执行流程—输出格式组织并用子代理做技能测试参考 testing-skills-with-subagents.md。给新平台做适配可以看 docs/porting-to-a-new-harness.md。下一步建议装好 Superpowers丢一个新功能需求给 agent看它先问出第一个澄清问题。【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Superpowers 完整集成指南：14 个技能让 AI 编程代理像资深工程师一样开发
Superpowers 完整集成指南14 个技能让 AI 编程代理像资深工程师一样开发【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowersSuperpowers 是面向 AI 编程代理的技能框架与开发方法论。它让 coding agent 先想清楚、先写测试、先自查再动手写代码。本文带你一次跑通安装、使用与排错。3 分钟看懂技能自动触发的原理5 分钟装好覆盖 Claude Code、Gemini CLI 等 11 个平台掌握三个典型流程新功能、修 bug、执行计划快速定位技能不触发、钩子失效等常见坑Superpowers 解决什么问题直接对 coding agent 说帮我做个功能常见的翻车方式有三种需求没聊透就开写agent 跳过澄清直接产出方向跑偏的代码代码没有测试兜底改一处坏三处回归全靠运气长会话上下文漂移会话一长agent 忘记最初约定质量下滑Superpowers 的思路是把一套被验证过的开发方法论TDD、系统性调试、计划先行拆成 14 个技能文件交给 agent 强制执行。它的项目哲学只有四条测试先行、流程优先于猜测、持续简化、拿证据说话而不是口头宣称。技能全在 skills/ 目录每个技能一个文件夹一份 SKILL.md 加若干参考资料。当前版本 6.2.0MIT 协议。核心原理技能为什么会自动触发技能 工位上的 SOP 卡。类比一下新工厂不让工人凭感觉操作而是在每个工位贴标准作业卡。技能就是贴给 AI 的 SOP 卡每张卡写清楚什么时候用、按什么步骤做。技能卡的结构很简单文件开头是 YAML 元数据--- name: my-skill description: 什么时候该用这个技能 ---name和description是 agent 判断该不该用这张卡的依据缺一不可。开场自动注入员工手册。光有 SOP 卡不够还得让 agent 知道上班第一件事是找卡片。Superpowers 靠一个会话启动钩子解决钩子定义在 hooks/hooks.json匹配startup|clear|compact三种时机会话开始、清空、压缩上下文时hooks/session-start 会把using-superpowers技能全文注入会话这份技能里有著名的1% 规则只要有一丝可能某技能适用就必须调用优先级流程技能先行执行技能在后。比如做个功能先走 brainstorming修 bug先走 systematic-debugging。而人的指令永远排在技能之前CLAUDE.md、AGENTS.md 或你的直接要求都高于技能规定。不同平台对钩子输出的字段要求不一样钩子脚本会自动适配Cursor 读additional_contextClaude Code 读hookSpecificOutputCopilot CLI 读顶层additionalContext。你不用管知道它存在即可。Superpowers 安装步骤各平台安装方式不同。装完在任意平台说一句帮我做个东西agent 会先声明Using [skill] to [purpose]就说明生效了。平台安装方式Claude Code/plugin install superpowersclaude-plugins-officialCodex CLI/plugins搜索 superpowers 后安装Codex App侧栏 Plugins 中找到 Superpowers点Cursor/add-plugin superpowersGitHub Copilot CLIcopilot plugin install superpowerssuperpowers-marketplaceKimi Code/plugins进入 Marketplace 安装Factory Droiddroid plugin install superpowerssuperpowersAntigravityagy plugin install指向本仓库地址Gemini CLIgemini extensions install指向本仓库地址Pipi install指向本仓库地址OpenCode按 docs/README.opencode.md 走独立插件流程需要用到仓库地址时Antigravity、Gemini CLI、Pi 等按仓库安装的平台仓库是git clone https://gitcode.com/GitHub_Trending/su/superpowers更新多数平台自动更新。手动的话Gemini CLI 用gemini extensions update superpowersAntigravity 重装一遍即可。本地开发Pi 支持临时加载本地改动pi -e /path/to/superpowers。其他平台的基础设施测试跑 tests/ 下对应目录的run-*.sh或npm test。三个典型用法新功能、修 Bug、执行计划场景一从零开发一个新功能这是完整的主线流程共 7 步每步由对应技能自动接管brainstorming一次只问一个问题把需求聊透给 2-3 个方案供选择设计文档存到docs/superpowers/specs/下你签字才放行using-git-worktrees新建分支和隔离工作区先确认测试基线是绿的writing-plans把活拆成 2-5 分钟一个的小任务每个任务带精确文件路径、完整代码和验证步骤subagent-driven-development每个任务派一个全新子代理执行做完先查是否符合规范、再看代码质量test-driven-development红绿重构循环——先写失败的测试再写最小实现。测试前写的代码会被删掉requesting-code-review按严重程度报告问题Critical 级别直接挡住进度finishing-a-development-branch验证测试后四选一收尾合并、提 PR、保留或丢弃README 提到agent 经常能自主连续工作几小时而不偏离计划。场景二排查一个难缠的 Bug对 agent 说修这个 bugsystematic-debugging 会先接管四阶段定位根因配 root-cause-tracing、defense-in-depth 等参考文档。修完后 verification-before-completion 会逼着它验证真的修好了而不是只看测试变绿就收工。参考资料在 skills/systematic-debugging/包括条件等待示例和找污染源脚本。场景三执行一份现成的计划计划已经写好时有两条路subagent-driven-development同会话内连续执行任务之间不打断你executing-plans分批执行每个批次留人工检查点任务之间互相独立、可以并发时dispatching-parallel-agents 会帮你同时派多个子代理。常见问题排查技能不触发与钩子失效技能不触发按顺序检查新开会话。钩子只在 startup、clear、compact 时机触发老会话不会自动补注入确认该平台装完了。多个平台混用时Superpowers 需要每个平台各装一份装 A 不算装 B检查技能文件格式。SKILL.md 缺少name或descriptionagent 就无法识别该技能直接点名试试。对 agent 说用 brainstorming 技能能唤起说明技能在、自动判断有问题官方在 tests/explicit-skill-requests/ 里有一组点名触发的测试提示词可以参考钩子没跑起来现象是会话里看不到using-superpowers注入内容。检查平台环境变量是否被正确识别钩子靠CURSOR_PLUGIN_ROOT、CLAUDE_PLUGIN_ROOT、COPILOT_CLI判断该输出哪种 JSON 字段识别失败时会退回 SDK 标准格式个别平台可能不消费。Windows 上的钩子调用走 hooks/run-hook.cmd。行为和你的约定冲突指令优先级是你的指令 技能 默认行为。想跳过某段流程直接告诉 agent这次不用走 brainstorming。想长期改行为写进 CLAUDE.md、AGENTS.md 或 GEMINI.md而不是改技能文件。调优与扩展速查可调旋钮一览表旋钮位置默认值何时调整钩子触发时机hooks/hooks.json 的 matcherstartup|clear|compact需要更多时机重新注入时遥测开关环境变量开启仅上报版本号企业合规要求时关闭任务粒度writing-plans 技能每个任务 2-5 分钟任务偏小导致代理开销过大时本地调试Pi 的pi -e参数不加载本地包改技能后想立即验证时遥测只上报 Superpowers 版本号不含项目和提示词内容。关闭方式把SUPERPOWERS_DISABLE_TELEMETRY设为任意真值Claude Code 的DISABLE_TELEMETRY、CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC也会被尊重。验证技能行为项目分两层测试详见 docs/testing.mdtests/插件基础设施测试bash node python跑run-*.sh或npm testevals/drill 评测框架驱动真实 LLM 会话LLM 评审员判断技能是否被正确遵守单个场景 3-30 分钟写一个自己的技能按 skills/writing-skills/SKILL.md 的规范来frontmatter 带 name 和 description正文按触发条件—执行流程—输出格式组织并用子代理做技能测试参考 testing-skills-with-subagents.md。给新平台做适配可以看 docs/porting-to-a-new-harness.md。下一步建议装好 Superpowers丢一个新功能需求给 agent看它先问出第一个澄清问题。【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考