Superpowers:如何让AI编程助手自己走完设计到审查的5步?技能框架完整上手指南-编程实验室

Superpowers:如何让AI编程助手自己走完设计到审查的5步?技能框架完整上手指南

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

Superpowers 是一套面向 AI 编程代理的技能框架,把"头脑风暴、写计划、TDD 实现、代码审查"整理成可自动触发的标准流程,支持 Claude Code、Codex、Cursor 等主流工具。

你跟 AI 助手说"帮我做个待办清单应用",它二话不说就开始生成代码。方向对不对?测试写了没有?设计文档在哪?你只能在最后对着满屏代码做返工判断。

Superpowers 改变的第一步动作:代理看到你"要做一个东西"时,不会先写代码,而是反过来追问你到底想解决什么问题,把设计拆成一段段能读完的规格给你确认。你点头之后,它才动手。

以 Claude Code 为例,在插件市场一条命令完成安装:

/plugin install superpowers@claude-plugins-official

装完不用做任何配置。开个新会话,直接发一句 "Let's make a react todo list",如果代理先停下来问你需求而不是甩出一堆代码,说明 brainstorming 技能已经自动触发,安装成功。

你在 Cursor、Codex、Gemini CLI、OpenCode 等其他工具里使用时,走各自插件市场的安装入口即可,过程类似。用了几款工具,就分别装几次——每个环境是独立的。

这套技能全部放在 skills/ 目录下,每个技能一个文件夹。按开发时间线看,可以分为三段。

brainstorming:用提问把你的模糊想法磨成具体设计,设计稿分节展示,你逐节确认,确认后存成文档。
using-git-worktrees:设计通过后,自动开独立工作区和新分支,跑一遍项目初始化,确认测试基线是干净的。
writing-plans:把实现拆成 2–5 分钟一个的小任务,每个任务都写清楚文件路径、完整代码和验证方式,标准低到"一个没有判断力的初级工程师"照着也能做。

subagent-driven-development:你说"开工"后,每个任务派一个全新的子代理去执行,做完先查是否符合规格,再查代码质量,两级审查都过才进入下一个任务。代理连续自主工作一两个小时是常态。
test-driven-development:严格执行红-绿-重构循环——先写失败的测试,看它失败,写最少代码,看它通过,提交。如果代码写在测试前面,直接删掉重写。
executing-plans / dispatching-parallel-agents:不想用子代理模式时,可以批量执行计划并在关键节点人工检查,或把独立任务并行派给多个子代理。

requesting-code-review / receiving-code-review:任务之间按计划做审查,问题按严重程度分级,关键问题不解决不推进。
systematic-debugging:出 bug 时走四阶段根因分析,而不是改一处碰一下试试。
verification-before-completion:声称"修好了"之前,必须有验证证据。
finishing-a-development-branch:任务全部完成时,验证测试,然后让你选合并、提 PR、保留还是丢弃,并清理工作区。

另外两个是"元技能":using-superpowers 定义技能系统的使用规则,writing-skills 教你按规范写新技能。

多个技能同时适用时,流程类技能优先——先定方法,再谈实现。比如"我们做个 X"先走 brainstorming,"修这个 bug"先走 systematic-debugging。你自己的指令(CLAUDE.md、AGENTS.md 等)又永远压过技能,技能压过代理的默认行为。

关键在 hooks/session-start 这个启动钩子:每次会话开始,它把 using-superpowers 的完整内容注入代理上下文,告诉代理"任何动作之前先查技能"。对话被平台压缩后,钩子会再次注入,流程不会中途失忆。这就是你什么都不用记、技能却能"准时到场"的原因。

按工具分别安装。Claude Code 装过,Cursor 里还是空白,每个环境独立装一次。
验证自动触发。装完用一句 "Let's make a react todo list" 测试,代理必须先触发 brainstorming 再写码,否则安装没生效。
目录完整性。技能靠目录结构发现,更新或迁移后检查 skills/ 下的文件夹是否齐全、文件权限是否正常。
遥测可关。brainstorming 的可视化伴侣功能默认会从官网加载一个带版本号的标识,想彻底关掉就设置环境变量SUPERPOWERS_DISABLE_TELEMETRY为任意真值。
别和它抢方向盘。你的项目文档和明确要求优先级高于技能,想跳过某个流程时直说即可;但随意禁用会失去质量保障,建议保留。