Superpowers 上手拆解：让编码 Agent 先计划再写码的 AI 技能库

Superpowers 上手拆解让编码 Agent 先计划再写码的 AI 技能库【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowersSuperpowers 是一套面向编码 Agent 的 AI 技能库与开发方法论解决 Agent 拿到需求就闷头写码、跑偏还自称完成的问题。装上它Agent 会先问清需求、产出设计与计划再由子代理逐任务执行并做两阶段评审。它解决什么问题瓶颈不在模型写代码的能力而在 Agent 缺少流程约束。把功能需求丢给 Claude Code 或 Codex 这类编码 Agent常见结果是它直接开始写代码方向错了你事后才发现而完成了往往只是一堆未经验证的声明。Superpowers 的定位是把 TDD测试先行开发、设计先行、子代理评审这些方法论做成一组可组合、自动触发的技能从会话第一条消息起就注入 Agent 的上下文。它适用于你想把多步开发任务交给 Agent 自主推进、并且要拿到可审查产出的场景纯问答或改一行配置则用不上这套流程。五分钟跑起来三步验证 Superpowers 环境最短跑通路径是clone 仓库 → 按你用的 Agent 安装 → 问一句验证全程不需要改你的项目代码。克隆仓库安装对每个编码 Agent 是独立的git clone https://gitcode.com/GitHub_Trending/su/superpowers按你的 harness 安装。以 OpenCode 为例把 superpowers 加进 opencode.json 的 plugin 数组具体配置见 docs/README.opencode.md。重启 Agent 验证提一个功能需求如果它先开始向你提问而不是直接写码或声明Using brainstorming to...说明技能引导已生效。⚠️ 你用几个编码 Agent 就要装几遍漏装是时灵时不灵最常见的原因。核心机制拆解技能触发系统怎么工作Superpowers 的核心一句话Agent 做任何动作前必须先查可用技能。按输入 → 处理 → 输出看这套触发系统分三段。SessionStart hook把技能规则打进上下文输入是会话 startup、clear、compact 三类事件。hooks/session-start 脚本由 hook 配置匹配这些事件后执行内部读取 using-superpowers 技能全文做 JSON 转义并按平台差异输出 additionalContext 字段Cursor、Claude Code、Copilot CLI 读的键名不同。输出是每次会话开头Agent 上下文里都带着You have superpowers引导段之后的每个响应都要先过技能检查。关键配置长这样{ matcher: startup|clear|compact, command: hooks/run-hook.cmd session-start }触发规则为什么 1% 可能也要查技能skills/using-superpowers/SKILL.md 把规则写得极端只要某个技能有 1% 可能适用就必须先调用它再响应包括先于澄清提问。文档随后列了一张红旗表逐条反驳这只是个简单问题我先看看代码再说这类念头因为 Agent 最常见的失败模式就是用合理化绕开流程。多技能同时适用时流程技能优先brainstorming 决定做什么systematic-debugging 决定怎么查实现类技能再落地。按需加载技能正文不在启动时全量注入引导段只含规则和索引其余技能正文由 Skill 工具在被调用时才加载加载后 Agent 声明Using X to Y并严格按技能文档执行。这是技能能数量不少却不撑爆上下文的原因也允许每个技能文档里放完整步骤、流程图和反例表。从单用到协作Superpowers 子代理调度与并行评审单个技能跑通后真正改变产出速度的是协作能力其中三项影响最大。子代理驱动开发每个任务一个全新子代理skills/subagent-driven-development/SKILL.md 把一个长会话做完一个项目改成主会话只调度和评审每个计划任务派发一个全新实现者子代理只带该任务需要的上下文完成后生成评审包任务审查者按规范符合度和代码质量两阶段评审不通过自动进入最多 5 轮修复。这意味着你可以放手让 Agent 连续自主工作数小时进度记在 ledger 文件里防止上下文压缩后重复派发已完成任务。并行代理调度独立问题同时开工skills/dispatching-parallel-agents/SKILL.md 面向另一类场景多个互不相关的问题比如不同子系统、不同测试文件的失败。按问题域各派一个 Agent 并行调查主会话保留协调用的上下文。它有严格前提问题之间无共享状态、修一个不影响另一个否则并行只会互相干扰。worktree 隔离并行任务不互相踩skills/using-git-worktrees/SKILL.md 在设计批准后创建新分支上的隔离工作区并先验证测试基线干净让多条开发线物理隔离收尾时配合 finishing-a-development-branch 走固定的合并、PR 或丢弃决策流程。拿一个真实任务练手别一上来做大功能先用两个输入输出明确的小任务跑通链路。任务一走通设计 → 计划链路。目标给 Agent 一个小需求例如给某个脚本加超时重试让它产出设计文档和实施计划全程不写实现代码。 涉及模块路径skills/brainstorming/SKILL.md、skills/writing-plans/SKILL.md。 验收标准docs/superpowers/specs/ 下出现 -design.md 文件且各节都经你确认docs/superpowers/plans/ 下每个任务粒度 2–5 分钟带精确文件路径、验证步骤和 checkbox。任务二跑一个 SDD 任务的两阶段评审。目标取任务一产出的计划让第一任务走子代理驱动开发流程。 涉及模块路径skills/subagent-driven-development/ 下的 implementer-prompt.md、task-reviewer-prompt.md 与 scripts/ 里的 review-package 等脚本。 验收标准实现者子代理只拿到任务简报而非你的整段会话上下文实现后先跑测试、提交并自审评审包由脚本生成规范符合度与代码质量两条结论分别给出。扩展与参与写新技能前先读 writing-skills扩展 Superpowers 基本只有两件事写新技能或改旧技能两者都受 writing-skills 方法论约束。项目不轻易接受全新技能任何技能更新必须兼容所有支持的编码 Agent。标准流程是fork 仓库、切到 dev 分支、建工作分支按 skills/writing-skills/SKILL.md 与 skills/writing-skills/anthropic-best-practices.md 创建并测试技能再填好模板提 PR。插件基础设施测试在 tests/ 目录按对应 run-*.sh 或 npm test 执行。方法论不会自己长进模型里。装上 Superpowers让 Agent 从下一个需求开始先问清、再计划、后写码。【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考