Superpowers 上手指南：10 分钟跑通第一个 AI 开发技能

Superpowers 上手指南10 分钟跑通第一个 AI 开发技能【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowersSuperpowers 是一套给编码代理用的 AI 开发技能库装上它你的代理会先问清需求、再写计划、带着测试动手还能派子代理分工协作。适合用 Claude Code、Codex、Cursor 等工具写代码的人读完你能完整走一遍从 clone 到技能调用的流程。花 30 秒逛一遍项目仓库不大但结构很讲究。先认识四个核心目录后面每一步你都会用到目录管什么skills/技能本体调试、测试驱动开发、写计划、子代理驱动开发等一组可组合技能docs/设计规格与实现计划每个改动都有据可查tests/覆盖 Claude Code、OpenCode、Codex 等平台的技能行为测试脚本hooks/会话启动钩子保证技能从对话第一条消息就开始生效值得一试的原因很简单技能是自动触发的。你不用记任何咒语只要正常提出需求代理会自己先检查有没有适用的技能然后按流程干活——设计、计划、实现、审查一气呵成。快速上手从 clone 到第一次技能调用整条动线就四步拿代码、按你的代理装插件、跑一遍测试、发一条真实需求。git clone https://gitcode.com/GitHub_Trending/su/superpowers安装方式因平台而异README 里每个 harness 都有对应小节用哪个装哪个如果同时用多个平台记得各自单独安装。装完别急着干活先验证环境cd tests/opencode ./run-tests.shOpenCode 用这条命令用 Claude Code 的话跑tests/claude-code/run-skill-tests.sh更快。测试全绿说明技能真的加载上了。最后是对话里发一句帮我修这个 bug或给我做个小功能观察代理是否会先说出它要用的技能。背后的规则只有一条先技能后操作——在回答、看代码、做任何事之前只要有一丝可能适用技能就必须先调用它。这条规则的完整定义在skills/using-superpowers/SKILL.md里面还有一张合理化思维红旗表专门拦住那些这次太简单不用走流程的念头。按场景挑技能而不是背清单技能不该按学习顺序记忆而该按你卡住的地方去挑。排查不出 Bug 时先找根因再谈修复 skills/systematic-debugging/SKILL.md是仓库里语气最硬的一个技能没完成根因调查之前禁止提出任何修复。流程分四步——仔细读报错、稳定复现、检查最近的改动、在多层系统里加探针收集证据然后才轮到动手。它还捆了一套现成工具root-cause-tracing.md教你沿调用栈往回追find-polluter.sh用二分法定位是哪个测试污染了环境。越是再快点修一下的压力下越该走这条路因为系统排查比反复试错更快。想让代码带测试先行时先写计划再红绿重构动手前先用writing-plans把活拆成 2-5 分钟一块的小任务每个任务带精确的文件路径、完整代码和验证步骤——计划清晰到没上下文也能照做。实现阶段交给test-driven-development的铁律先写一个失败的测试亲眼看着它失败再写最少代码让它通过最后重构。顺序反了就删掉重来没有留作参考这种说法。附带的好处是tests/目录里的自动化脚本会持续替你守住这条线。想让多代理并行干活时三种角色各司其职 ⚡计划写完、任务彼此独立时subagent-driven-development会接管执行。核心是三个角色实现者每个任务派一个全新子代理拿到精心裁剪的上下文写代码、跑测试、提交并自审任务审查者每个任务完成后审查两件事——是否符合计划、代码质量是否过关最终审查者全部任务结束后对整个分支做一次广域审查全程不需要你在任务之间点头代理可以连续自主推进。如果场景是同一时刻有多个互不相关的故障用dispatching-parallel-agents更合适按问题域拆分每个域派一个子代理在同一条回复里同时发出它们就真正并行跑了。从示例到自己项目先跟练再自检仓库自带两个端到端跟练项目都配了完整的设计文档和实现计划Svelte Todo带 localStorage 和 Playwright 测试的 CRUD 应用12 个任务适合走一遍测试驱动开发加子代理协作的完整流程Go 分形生成器谢尔宾斯基/曼德博 CLI 工具10 个任务适合练复杂算法的拆解与调试照计划跑完一遍你会对计划怎么切分任务、审查卡在哪一环有肌肉记忆。交付前留两道自检都在skills/下requesting-code-review让你对照计划逐项审查、按严重级别报告问题严重问题直接阻塞verification-before-completion逼你在宣布完成前先拿到确实修好了的证据而不是应该好了。继续深入给框架写一个新技能用到顺手之后最扎实的进阶动作是动手改或写技能。skills/writing-skills/SKILL.md是完整指南anthropic-best-practices.md收录了编写最佳实践examples/CLAUDE_MD_TESTING.md是一个可对照的实例。提交走 PR改动必须在你支持的所有编码代理上都验证过另外项目一般只接受对现有技能的完善不轻易收新技能提之前先看这一条。后续资源看三处就够RELEASE-NOTES.md跟进每次变更docs/superpowers/specs/里的设计规格能告诉你每个机制为什么长这样调试遇到硬骨头回到root-cause-tracing.md再读一遍。打开终端clone 仓库跑通你的第一个技能。【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考