Superagents

Superagents

当前状态

!git branch --show-current 2>/dev/null && git log --oneline -5 2>/dev/null !git status --short 2>/dev/null | head -20

Superpowers 能力基线

• superpowers:using-superpowers
• superpowers:brainstorming
• superpowers:systematic-debugging
• superpowers:test-driven-development
• superpowers:writing-plans
• superpowers:executing-plans
• superpowers:subagent-driven-development
• superpowers:dispatching-parallel-agents
• superpowers:requesting-code-review
• superpowers:receiving-code-review
• superpowers:verification-before-completion
• superpowers:using-git-worktrees
• superpowers:finishing-a-development-branch
• superpowers:writing-skills

校验命令：curl -fsSL https://api.github.com/repos/obra/superpowers/contents/skills | jq -r '.[].name'

适用场景

• 所有任务统一入口（问答、Git/GitHub、handoff、bug、feature、refactor、review、架构评审、复杂排障）
• 跨模块交互，单 Agent 易漏上下文
• 需要并行探索/实现/评审
• using-superpowers 后仍存在多种可行技能，需要统一路由决策

主入口路由（using-superpowers）

执行 superpowers:using-superpowers 后，不再做“是否进入 superagents”的判断；所有请求已在 superagents 内，只需判定 lane + 流程档位。

路由硬规则：

1. 所有请求强制进入 superagents（自动触发，无需显式 $superagents）。
2. answer/git/github/handoff/fix-bug/develop-feature/refactor/review-code/architecture-review 全部作为内部 lane，不作为直接入口。
3. Lite 仅用于低风险小任务；命中 rules/fast-path.md 条件才可采用。
4. 默认使用 Standard；涉及安全/高风险/复杂并发时升级到 Full。
5. 输出中必须记录 lane 与档位决策证据（为何进入该 lane 与该档位）。

编排总则

1. 固定入口：先 superpowers:using-superpowers
2. 开场对齐：任何实施前先向用户回显 目标/范围/不做/关键假设
3. 请求规范化：将用户原始请求收敛为可执行摘要（目标/范围/不做/验收）
4. 最小覆盖：仅选择完成任务所需的最少 Superpowers
5. 双轨执行：Superpowers（方法）+ 仓库 Agents（执行）同时生效
6. 证据闭环：关键结论附 file:line、命令摘要或链接
7. 质量基线：review 与自检优化统一遵循 rules/code-quality.md

开场对齐与请求规范化门禁（执行前）

1. 路由完成后、任何实现前，必须先向用户输出任务理解摘要。
2. 摘要最少包含：目标、范围、不做、关键假设、验收。
3. 输出建议使用固定字段：intent_summary/scope/out_of_scope/assumptions/open_questions/proceed。
4. Lite 且需求明确：允许 1-2 句回显后继续执行。
5. Standard/Full 且需求明确、实现路径唯一：开场对齐后继续执行。
6. 涉及业务决策、缺少关键输入、明显歧义或多方案权衡：一次性提出关键问题并等待用户确认；AskUserQuestion 不可用时改为普通文本提问。
7. 已进入 superpowers:brainstorming 时，提问节奏切换为“一次一问”。
8. 需求模糊、跨模块交互或存在多个设计分歧：调用 superpowers:brainstorming 收敛边界，再进入计划/实现。

brainstorming 触发阈值

满足任一项即触发：

1. 涉及跨模块交互，且边界或职责划分不清晰。
2. 存在 2 个及以上等价方案，需比较权衡后决策。
3. 用户显式要求先讨论设计/方案而非直接实施。
4. 关键验收标准无法通过一次性澄清确定。

不触发（直接澄清后执行）：

1. 仅缺少单一参数或输入值。
2. 单文件低风险修改且实现路径唯一。

流程档位（固定三档）

档位选择规则：

1. 默认 Standard。
2. 命中 rules/fast-path.md 才能降级到 Lite。
3. 涉及安全、鉴权、敏感数据、生产事故或跨模块复杂并发，必须升级为 Full。

三层架构

Lane 映射（Skill × Agent × 档位）

团队拓扑（默认 1 master + N workers）

工作流

1. 路由预检（master）：执行 superpowers:using-superpowers，判定 lane + 档位，并记录证据
2. 开场对齐 + 请求规范化（master）：向用户回显 目标/范围/不做/关键假设/验收（Lite 可 1-2 句）
3. 需求澄清（master）：仅在业务决策/缺少关键输入/明显歧义或多方案权衡时提问并等待回答；brainstorming 激活后切换为一次一问
4. 方案收敛（planner，可选）：命中 brainstorming 触发阈值时调用 superpowers:brainstorming 后再继续
5. Lite 快速收敛（可选）：若命中 Lite 且已无疑问，执行“请求对照 → 最小修改/执行 → 最小验证 → 汇报”，然后结束
6. 并行探索（research）：Standard/Full 至少 1 个 researcher；需要外部资料时追加 1 个；输出必须含 file:line 或链接
7. 规划拆分（planner）：产出步骤、依赖、并行标记、负责人、验收条件；每步可独立验证
8. 实现与评审（implement/review）：按文件边界执行；Full 启用并行 implement + 双评审；禁止同文件并行写
9. 自检优化（master+implement）：按 rules/code-quality.md 第 6 节执行最小优化回路；禁止顺手扩大范围
10. 验证门禁（verifier）：Standard/Full 固定顺序 Typecheck/Build → Lint → Test；失败回退修复并回到第 8 步，最多 3 轮
11. 汇报交付（reporter）：输出 Done/Partial/Skipped、关键改动、验证证据、残余风险、后续建议

会话预算与收敛

• 禁止“无限 loop”表述；默认最多 3 轮 review → optimize → verify。
• 单会话上下文接近预算上限时，优先压缩上下文（结论化摘要 + 证据索引），必要时触发 handoff 跨会话续跑。
• 到达轮次上限仍未收敛：停止继续打补丁，输出残余风险与下一轮执行建议。

Review 自检检查清单

• 手术式改动：是否只改动当前目标相关代码
• Minimal：是否存在可移除的非必要抽象/依赖/配置
• Efficient：热点路径是否避免明显低效实现
• Dead code：触及范围内未使用代码是否已清理
• 注释质量：是否只保留解释“为什么”的必要注释
• Robust：边界与失败路径是否有明确处理策略

并发与冲突策略

• 并行 worker 建议 2-4，默认 3
• 小任务或高冲突任务：降到 2
• 跨模块且文件边界清晰：可升到 4
• 禁止同文件被多个 implementer 同时写入

冲突优先级与降级

优先级：安全 > 正确性 > 用户明确要求 > CLAUDE.md 强制项 > 其他规则/技能

子 Agent 输入模板

目标:
范围:
不做:
输入证据:
输出要求:
- status: success|partial|failed|blocked
- 结论:
- 证据: file:line / command / url
- 风险:
- 下一步:

领域提示词复用

• 模板文件：skills/superagents/templates/universal-engineering-task-prompt.md
• 模板装配顺序（强制）：
  1. 模板 A（入口路由）：统一进入 superagents 后判定 lane + 档位
  2. 模板 A2（开场对齐）：先向用户回显任务理解；必要时提问并等待确认
  3. 模板 B（工程编排）：输出 目标/范围/不做/验收/lane_plan
  4. 模板 C（子任务委派）：向 worker 下发统一任务单，保证证据格式一致
  5. 模板 D（用户汇报）：按 Done/Partial/Skipped + 验证证据交付
• 约束：
  1. 提示词必须保持“最小必要信息”，禁止重复同义规则
  2. 每条“完成/通过”结论必须可追溯到 file:line 或命令摘要
  3. 对用户输出优先中文、短句、可执行

退出标准