Superpowers：让AI编程代理先想清楚再写代码的完整指南（3步上手）

Superpowers让AI编程代理先想清楚再写代码的完整指南3步上手【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowersSuperpowers 是面向 AI 编程代理帮你写代码的 AI 助手的技能库和开发方法论。它强制代理在动手写码前先定方案解决代理上来就开写、越写越跑偏的问题适合所有在用 Claude Code、Codex、Cursor 写代码的人。它解决什么问题两个让你抓狂的场景场景一你说加个登录功能代理立刻开写写出来没有错误处理、不符合你的产品想法只能推倒重来。场景二你让代理重构一个模块它自主跑了两个小时回头一看代码方向已经偏了。这两个问题的根源一样你的代理太积极了——不确认需求、不做计划先写了再说。Superpowers 给代理装上一套技能文件写代码前先问清需求brainstorming苏格拉底式追问再把工作拆成小任务writing-plans最后由子代理逐个执行、双重检查subagent-driven-development即每个任务派一个全新代理去做做完由别的代理审查。技能是自动触发的你不需要记任何命令。3步完成初始化第1步把项目拿到本地git clone https://gitcode.com/GitHub_Trending/su/superpowers第2步装进你用的编程工具。不同工具装法不同以 Claude Code 为例在对话里输入/plugin install superpowersclaude-plugins-official即可Codex、Cursor 等各有对应命令。第3步开个新会话验证。你说我想做个小工具代理应该先追问用途和约束而不是直接写代码——追问就说明技能生效了。注意用多个工具就分别安装每个工具里只在那边生效。核心能力实操3个最值得体验的技能brainstorming把模糊想法变成可确认的设计场景你脑子里只有一句需求具体怎么做全凭代理发挥。做法正常说出你的想法就行技能自动接管。它会先看项目现状再逐条提问尽量是选择题然后给你 2-3 个方案并附推荐最后把设计分段展示逐段等你确认。效果最终产出一份设计文档存在docs/superpowers/specs/目录并提交进仓库。换会话、换代理需求不丢。writing-plans把设计拆成2-5分钟小任务场景设计定了但让代理一口气做完中途很容易跑偏。做法设计确认后该技能自动激活把工作拆成极小的任务。每个任务写清楚改哪个文件、写什么代码、怎么验证。效果每个任务 2-5 分钟就能完成并验证哪怕某一步出错回滚成本也极小。subagent-driven-development子代理干活双重审查场景计划好了你希望代理长时间自主跑又怕质量失控。做法你说一句go每个任务派给一个全新子代理做完先对照设计方案检查再查代码质量两关不过就得返工。效果代理经常能自主工作一两小时产出的代码基本不偏离你批准的方案。进阶玩法3个方向 ️团队协作设计规格和计划都是仓库里的纯文本 markdown提交后全团队对需求的理解就统一了。还可以配合using-git-worktrees技能让代理在 git worktreeGit 提供的平行工作区里干活互不干扰。二次扩展想把自己的团队规范变成技能照着 writing-skills 目录里的模板和测试方法新建一个即可代理会自动加载。流程调节不想走全流程时可以用executing-plans技能批量执行并设人工检查点更适合小改动。避坑指南4个最常见的情况1. 代理没触发技能直接开写现象装完插件代理还是上来就写代码。 原因当前工具没装成功或还在旧会话里。 解决在对应工具里确认安装成功后开一个新会话。2. 代理先问一堆问题嫌慢现象说个需求代理连续追问十几轮。 原因brainstorming 有硬门槛——设计没批准一律不许写代码小项目也不例外。 解决这是刻意设计别试图跳过把需求想清楚再提确认会快很多。3. 代理删掉你手写的代码要求先写测试现象你先写了实现代理坚持要你先写失败的测试。 原因TDD 技能有铁律——没有失败测试就不准有生产代码。 解决一次性原型、生成代码这类例外情况提前说明即可。4. 代理长时间自主跑你跟不上进度现象它自己干了两小时你不知道中间发生了什么。 原因子代理模式就是为长时间自主运行设计的。 解决说go之前把计划文档认真看一遍那是你最后的纠偏机会。一句话收尾Superpowers 的价值不是给代理更多的手而是逼它按想清楚→做计划→执行→验证的顺序干活。装好插件开新会话就能用完整技能清单和各工具的安装说明见 README.md 和 skills/ 目录。【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考