企业官网建设流程全解析

Superpowers：让AI编程助手自动走专业开发流程

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

上周做个跨五个模块的重构，AI 编程助手两次跳过测试直接改代码，每次都要返工才把状态理清。装上 Superpowers 这套技能框架之后，同样的需求它先停下来追问设计意图，写计划、补测试都按固定流程走，返工次数降到了零。

它到底解决了什么

Superpowers 是一组可组合的 AI 编程技能，外加一段强制注入的引导指令，让编码代理按完整软件方法论工作：先澄清需求、出设计，再写计划、按 TDD 执行。

它的第一道关卡是硬性的：设计没经过你批准之前，禁止调用任何实现类技能、禁止写任何代码，项目再简单也不例外。这一条直接挡住了"顺手先写一版"的常见行为。

第二个特点是技能会被触发，而不是躺在那里当文档。会话启动时通过 session-start 钩子 把 using-superpowers 引导内容注入上下文，代理在响应任何问题之前都要先检查有没有技能适用。第三点是流程产物落盘：设计存成docs/superpowers/specs/下的日期命名文档，计划存到plans/，可追溯、可交接。

跑起来

走一条最简路径：Claude Code 支持从官方插件市场直接安装，一条命令完成：

/plugin install superpowers@claude-plugins-official

其他平台同理，各装各的。比如 OpenCode 在opencode.json里加一行即可：

{ "plugin": ["superpowers@git+https://gitcode.com/GitHub_Trending/su/superpowers.git"] }

重启后问一句"Tell me about your superpowers"，有回应就是装好了。用源码方式接入的话，先git clone https://gitcode.com/GitHub_Trending/su/superpowers再指到本地路径。Codex、Cursor、Gemini CLI 等十余种平台的入口在 README.md 的 Installation 一节，OpenCode 的完整说明在 docs/README.opencode.md。

一次完整任务里发生了什么

接到需求：你说"做一个 X"，代理先触发 brainstorming 技能，一次只问一个澄清问题，理解目的、约束和成功标准，再给两三个带取舍的方案，最后分段展示设计并逐段要你的确认。批准后才把设计文档写入docs/superpowers/specs/并提交。

写计划：writing-plans 技能把设计拆成 2-5 分钟粒度的任务，每个任务写清要动的文件、完整代码和验证步骤，以复选框跟踪，计划保存到plans/。它假定执行者对代码库零上下文，所以信息冗余是刻意的。

执行：subagent-driven-development 为每个任务派发一个全新子代理，不让它继承会话历史，避免上下文污染；任务完成后先过一遍规范符合性审查，再过代码质量审查，全部任务跑完还有一次整分支审查。实现期间 test-driven-development 技能强制 RED-GREEN-REFACTOR：先写失败测试、看着它失败、再写最少实现，测试之前写的代码会被要求删掉。

遇到 bug：systematic-debugging 的铁律是"没有根因调查不许提修复"，四个阶段按序走完，专治"看起来一处小改动就能修"的冲动。收尾时 finishing-a-development-branch 技能先验证测试，再给出合并、提 PR、保留或丢弃四个选项。

技能之间还有优先级：仓库内项目技能 > 个人技能 > Superpowers 内置技能，用户指令永远压过技能。

踩坑与排查

插件没加载

症状：装完重启后代理完全不提 Superpowers。原因：opencode.json里 plugin 行写错，或 CLI 版本太旧。解决：用opencode run --print-logs "hello" 2>&1 | grep -i superpowers查日志确认插件状态，确认无误后升级到近期版本。

更新不生效

症状：仓库已经拉到新版，代理行为却还是旧的。原因：OpenCode 对 git 来源的依赖会在 lockfile 或缓存里锁住已解析版本，重启不够。解决：清掉 OpenCode 包缓存后重装插件；也可以直接钉住 tag，如#v5.0.3。

Windows 下 git 安装失败

症状：git+https规格的插件装不上，报找不到git.exe，但终端里 git 正常。原因：部分 Windows 构建的上游安装器对 git 依赖路径有已知问题。解决：改用系统 npm 把包装到~/.config/opencode下，再在配置里指向本地包路径。

收尾

适合想让 AI 编码代理按可验证、可追溯流程干活的个人开发者和小队。下一步把仓库 clone 下来，挑一个手头小功能，从 brainstorming 跑一遍完整流程，看看产物落在 docs/superpowers 里的样子。

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