企业官网建设流程全解析

Superpowers 完整指南：让 AI 编程代理按设计、计划与 TDD 流程开发的上手方法

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

让代理"给登录模块加个缓存"，多数编码代理会立刻动手写代码，等 diff 出来你才发现它把缓存理解成了内存 Map。Superpowers 是面向这类编码代理的技能框架：它让代理在写码前先把设计跟你确认清楚，之后按规划、测试驱动、分阶段审查这些标准环节自动触发对应技能。全部核心就是 skills/ 目录下一组 Markdown 技能加一段会话引导，当前版本 6.2.0。

它是什么：给编码代理注入开发方法论的技能框架

Superpowers 不是模型、不是工具库，也不是独立产品。它是一套"agentic skills framework + 开发方法论"：把一组 Markdown 技能装进会话，每个技能用 SKILL.md 定义触发时机与代理该做什么。项目自我定位是零依赖插件，不引入任何第三方服务，内容都是可读可改的文本文件。

适合谁：你日常用 Claude Code、Codex、Gemini CLI 这类编码代理写真实项目，且被"代理想都不想就写码"的行为困扰，它强制的设计先行、计划、TDD、审查流程正是你要的约束。不适合谁：只把代理当问答工具、每次改动都手动把关的人，这套流程的开销大于收益。

第一次上手：安装 Superpowers 并用一句话验证

以 Claude Code 为例，安装只需一条命令：

/plugin install superpowers@claude-plugins-official

Codex CLI 走自己的插件市场：打开/plugins，搜索 superpowers 后选择安装即可。

最小验证用的是仓库自带的验收测试：新开一个干净会话，发送 "Let's make a react todo list"。集成正常时，代理会先触发 brainstorming 技能向你提问，而不是直接写码。如果它一上来就搭脚手架，说明会话引导没有正确加载。

实际体验：brainstorming、TDD 与子代理执行三个环节

brainstorming：设计没确认就不写码

触发方式：你不需要说任何话。代理一察觉你要构建东西，它就自动接管，一次只问一个问题，摸清目的、约束和成功标准，再给出 2-3 个带权衡的方案，设计分段呈现、逐段征求你的同意，最后把规格写入docs/superpowers/specs/并 commit。技能里有一条硬约束：设计未获批准，不启动任何实现。

对比一下：开头那个一句话需求，装它之前产出往往是一个方向错误的完整工程；装它之后产出先是几轮提问加一份规格文件。多花几分钟，换来的是方向还能低成本修正。

test-driven-development：没有失败测试就没有生产代码

进入实现阶段后由 TDD 技能接管，规则相当刚性：先写一个会失败的测试，运行、看着它失败，再写最少量代码让它通过。如果先写了生产代码，删除重来，连"留作参考"都不允许。效果是每个测试都有"亲眼见过它失败"的记录，全绿时对覆盖面的信心更实。

subagent-driven-development：每任务一个子代理 + 两级审查

计划就绪后，每个任务派发一个全新子代理实现，上下文隔离、不继承会话历史。每完成一个任务，审查者检查两件事：是否符合规格、代码质量是否过关。任务之间流程自行推进，README 里提到代理自主工作数小时不偏离计划并不罕见。你的角色收缩到起点批准设计、在检查点看结果。

进阶配置与常见问题

安装后技能不触发，怎么排查

检查 session-start 钩子是否加载了 using-superpowers 引导。没有这段引导，技能只是躺在磁盘上、永远不会被调用。可以重新发一遍上手小节那条验收消息确认。

能否关闭遥测

brainstorming 的可视化伴随功能默认从官网加载一个带版本号的小标识，用于统计使用版本。把环境变量SUPERPOWERS_DISABLE_TELEMETRY设为任意真值即可关闭，同时也遵循 Claude Code 的DISABLE_TELEMETRY设置。

用多个编码代理时是否要分别安装

是。各平台安装相互独立，Claude Code 装过不代表 OpenCode 可用，OpenCode 的加载方式见 docs/README.opencode.md。

能否自己写新技能

可以，仓库自带 writing-skills 技能，完整指南在 skills/writing-skills/SKILL.md。但面向特定领域或单一项目的技能建议发布为独立插件，而不是塞进核心。

Superpowers 把代理的"立刻动手"改造成"设计、计划、测试驱动实现、分阶段审查"，每个环节都留下可读的产物。它最适合已经把编码代理纳入日常开发、想约束流程而不是更换模型的人。

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