企业官网建设流程全解析

Superpowers 完整集成指南：14 个技能让 AI 编程代理像资深工程师一样开发

【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers

Superpowers 是面向 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.0，MIT 协议。

核心原理：技能为什么会自动触发

技能 = 工位上的 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_context，Claude Code 读hookSpecificOutput，Copilot CLI 读顶层additionalContext。你不用管，知道它存在即可。

Superpowers 安装步骤

各平台安装方式不同。装完在任意平台说一句"帮我做个东西"，agent 会先声明"Using [skill] to [purpose]"，就说明生效了。

需要用到仓库地址时（Antigravity、Gemini CLI、Pi 等按仓库安装的平台），仓库是：

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

更新：多数平台自动更新。手动的话，Gemini CLI 用gemini extensions update superpowers，Antigravity 重装一遍即可。

本地开发：Pi 支持临时加载本地改动：pi -e /path/to/superpowers。其他平台的基础设施测试跑 tests/ 下对应目录的run-*.sh或npm test。

三个典型用法：新功能、修 Bug、执行计划

场景一：从零开发一个新功能

这是完整的主线流程，共 7 步，每步由对应技能自动接管：

1. brainstorming：一次只问一个问题，把需求聊透；给 2-3 个方案供选择；设计文档存到docs/superpowers/specs/下，你签字才放行
2. using-git-worktrees：新建分支和隔离工作区，先确认测试基线是绿的
3. writing-plans：把活拆成 2-5 分钟一个的小任务，每个任务带精确文件路径、完整代码和验证步骤
4. subagent-driven-development：每个任务派一个全新子代理执行，做完先查是否符合规范、再看代码质量
5. test-driven-development：红绿重构循环——先写失败的测试，再写最小实现。测试前写的代码会被删掉
6. requesting-code-review：按严重程度报告问题，Critical 级别直接挡住进度
7. finishing-a-development-branch：验证测试后，四选一收尾：合并、提 PR、保留或丢弃

README 提到，agent 经常能自主连续工作几小时而不偏离计划。

场景二：排查一个难缠的 Bug

对 agent 说"修这个 bug"，systematic-debugging 会先接管：四阶段定位根因，配 root-cause-tracing、defense-in-depth 等参考文档。修完后 verification-before-completion 会逼着它验证"真的修好了"，而不是只看测试变绿就收工。

参考资料在 skills/systematic-debugging/，包括条件等待示例和"找污染源"脚本。

场景三：执行一份现成的计划

计划已经写好时，有两条路：

• subagent-driven-development：同会话内连续执行，任务之间不打断你
• executing-plans：分批执行，每个批次留人工检查点

任务之间互相独立、可以并发时，dispatching-parallel-agents 会帮你同时派多个子代理。

常见问题排查：技能不触发与钩子失效

技能不触发

按顺序检查：

1. 新开会话。钩子只在 startup、clear、compact 时机触发，老会话不会自动补注入
2. 确认该平台装完了。多个平台混用时，Superpowers 需要每个平台各装一份，装 A 不算装 B
3. 检查技能文件格式。SKILL.md 缺少name或description，agent 就无法识别该技能
4. 直接点名试试。对 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，而不是改技能文件。

调优与扩展速查

可调旋钮一览表

遥测只上报 Superpowers 版本号，不含项目和提示词内容。关闭方式：把SUPERPOWERS_DISABLE_TELEMETRY设为任意真值；Claude Code 的DISABLE_TELEMETRY、CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC也会被尊重。

验证技能行为

项目分两层测试（详见 docs/testing.md）：

• tests/：插件基础设施测试，bash + node + python，跑run-*.sh或npm test
• evals/：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