企业官网建设流程全解析

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

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

Superpowers 是一套面向编码 Agent 的 AI 技能库与开发方法论，解决 Agent 拿到需求就闷头写码、跑偏还自称完成的问题。装上它，Agent 会先问清需求、产出设计与计划，再由子代理逐任务执行并做两阶段评审。

它解决什么问题

瓶颈不在模型写代码的能力，而在 Agent 缺少流程约束。把功能需求丢给 Claude Code 或 Codex 这类编码 Agent，常见结果是它直接开始写代码，方向错了你事后才发现，而"完成了"往往只是一堆未经验证的声明。Superpowers 的定位是把 TDD（测试先行开发）、设计先行、子代理评审这些方法论，做成一组可组合、自动触发的技能，从会话第一条消息起就注入 Agent 的上下文。它适用于你想把多步开发任务交给 Agent 自主推进、并且要拿到可审查产出的场景；纯问答或改一行配置则用不上这套流程。

五分钟跑起来：三步验证 Superpowers 环境

最短跑通路径是"clone 仓库 → 按你用的 Agent 安装 → 问一句验证"，全程不需要改你的项目代码。

1. 克隆仓库（安装对每个编码 Agent 是独立的）：

git clone https://gitcode.com/GitHub_Trending/su/superpowers

2. 按你的 harness 安装。以 OpenCode 为例，把 superpowers 加进 opencode.json 的 plugin 数组，具体配置见 docs/README.opencode.md。
3. 重启 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