Superpowers 完整实践:给 AI 编程代理装上“先想后写“的 7 步工作流

Superpowers 完整实践:给 AI 编程代理装上“先想后写“的 7 步工作流 Superpowers 完整实践:给 AI 编程代理装上先想后写的 7 步工作流【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowersSuperpowers 是一个面向 AI 编程代理的技能框架,装一次,就能让 Claude Code、Cursor、Codex 这类工具自动走头脑风暴设计→拆小任务→TDD 实现→分级审查的标准化流程。这篇文章从一个真实场景讲起,带你把它装起来、跑起来,顺带说清一个最容易踩的坑。这个边想边写的毛病,值得你警惕你一定见过这种场面:你对代理说帮我写个 react todo list,它一句不问就开始哗哗输出代码。最后得到的东西,往往是没有设计、没有测试、结构散乱。Superpowers 的解法很直接:它把一套开发流程技能塞进你的代理。每个技能就是一段场景化规则——动手前先头脑风暴、写代码走 TDD、调试要定位根因、任务拆成 2~5 分钟的小块。关键是技能会按场景自动触发:你不用记命令、不用贴提示词,代理做任何事之前会先检查这件事有没有对应技能,有就先调用。三步让 Superpowers 跑起来挑一个你在用的工具,装一次。Superpowers 官方支持十几种代理工具,各自独立安装。以 Claude Code 为例,一行命令:/plugin install superpowersclaude-plugins-officialCodex CLI、Cursor、Gemini CLI、OpenCode 等用的是各自的插件或扩展安装命令,完整清单在 README 的 Installation 一节。想先翻源码的话,也可以直接克隆仓库:git clone https://gitcode.com/GitHub_Trending/su/superpowers装完先验证。项目自己验收新工具集成时的做法就很妙:开一个新会话,问代理你有哪些超能力?它能答出自己有一整套技能库——brainstorming、TDD、systematic-debugging——说明会话启动时的注入成功了。然后照常提需求。不需要学任何新语法。正常打出那句帮我写个 react todo list,你会看到它不再直接开写,而是先一条条提问,把需求聊清楚。装好之后,一条需求的完整旅程跑起来之后,你的需求会依次经过七个阶段:brainstorming(头脑风暴):先弄清意图,再分节展示设计。这里有一道硬门槛——设计没经你批准,一行代码都不许写。using-git-worktrees:在新分支上建独立工作树,确认测试基线干净,你现有的东西不受影响。writing-plans:把工作拆成 2~5 分钟的小任务,每个都写明文件路径和验证步骤。subagent-driven-development:每个任务交给一个全新的子代理执行,做完走两级审查——先查是否按规格实现,再查代码质量如何。test-driven-development:红绿循环。先写测试、看着它失败,再写最少代码让它通过;在测试之前写好的代码,会被要求直接删掉。requesting-code-review:任务之间做审查,关键问题直接卡住进度。finishing-a-development-branch:全部完成后验证测试,再让你选合并、提 PR 还是丢弃。README 里说,代理经常能自主工作一两个小时而不偏离计划。想看每个阶段具体怎么定义的,打开 skills/brainstorming/SKILL.md 读读里面的清单,你会发现那些规则写的不是建议,而是必须。一个最容易踩的坑:装上了不等于生效了Superpowers 的核心机制是会话启动钩子:每次新会话开始,由 hooks/session-start 这个启动脚本把 using-superpowers 技能的内容注入模型上下文。这一步依赖各工具的钩子或插件机制,注入没成功,技能文件就只是一堆躺在磁盘上的文件,代理根本不知道它们存在。症状通常长这样:上面的冒烟验证没过,代理不知道自己有超能力→ 引导没注入,检查安装方式和工具版本是否支持对应机制同时用多个工具,以为装一次全都有了 → 每个工具都是独立安装,Cursor、Claude Code、OpenCode 之间互不相通时灵时不灵 → 多半是注入失败或重复注入如果你在给一个不熟悉的工具排查问题,docs/porting-to-a-new-harness.md 值得一读,它把 shell 钩子、进程内插件、指令文件三种注入形态和各形态的真实陷阱讲得非常透。再补一个小细节:brainstorming 的可选可视化功能默认带版本统计遥测,介意的话设置环境变量SUPERPOWERS_DISABLE_TELEMETRY为任意真值即可关掉。从这里开始Superpowers 不是魔法盒子,而是一套严格的流程纪律——TDD、YAGNI、先有证据再宣布完成,都被写进技能里,由代理替你执行。建议你挑一个最常用的工具装一次,拿一个小需求完整走一遍流程;之后想改流程,再去看 skills/writing-skills/ 里的写作方法,照着扩展属于你自己的技能。【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考