#AGENTS 全局路由协议

当你的 Claude Code 同时安装了多个 Skill 框架（如 Superpowers 和 Gstack），它们可能会"打架"——都想接管任务，都自动触发，互相覆盖默认行为。全局路由协议通过在 AGENTS.md 中定义优先级层级和职责边界来解决这个问题。

#核心原则

#优先级层级（从高到低）

当两个框架对同一个任务都声称"我来处理"时，按优先级裁决。用户指令永远优先。

#单主导原则

每一轮对话中，只能有一个主流程框架接管控制。另一个框架只能作为补充能力出现。

✅ 正确：Superpowers 负责规划和实现 → 调用 Gstack 的 /qa 做浏览器测试
❌ 错误：Gstack 接管了实现计划，又调用 Superpowers 重新规划

#职责分工

#Superpowers：通用研发工作流框架（默认主导）

Superpowers 是默认的主流程框架，负责：

#Gstack：专项能力框架（补充角色）

Gstack 提供 Superpowers 没有的专项工程能力：

#路由决策树

遇到任务时，按以下逻辑选择框架：

这个任务需要什么？
  ├─ 需求探索、设计讨论、写规格   → Superpowers: brainstorming
  ├─ 拆分实现计划                 → Superpowers: writing-plans
  ├─ TDD 编码、功能实现           → Superpowers: test-driven-development
  ├─ Bug 排查、系统化调试         → Superpowers: systematic-debugging
  ├─ 浏览器 QA、E2E 测试         → Gstack: /qa
  ├─ 安全审计                    → Gstack: /cso
  ├─ 设计审查                    → Gstack: /design-review
  ├─ 性能基准                    → Gstack: /benchmark
  ├─ 发布上线                    → Gstack: /ship
  └─ 不确定                      → 默认 Superpowers（它是通用框架）

#七大审查视角

Gstack 的路由协议定义了 7 个命名审查视角（Named Review Perspectives）。这些不是"角色扮演"，而是分析镜片——每个视角关注代码的不同维度。

#如何使用审查视角

在代码审查时，可以指定一个或多个视角：

> 从 Lucas（失败场景）和 Henry（性能并发）视角审查 src/sync/service.ts

Claude Code 会分别从这两个维度分析代码，各自独立提出问题，最后汇总。

#配置 AGENTS.md

在项目根目录创建 AGENTS.md，定义路由规则：

# AGENTS.md — 全局路由协议

## 主流程框架

- 默认主框架：Superpowers
- 补充框架：Gstack

## 路由规则

1. 需求探索、设计、计划、编码、调试 → Superpowers 主导
2. 浏览器 QA、安全审计、性能基准、发布 → Gstack 主导
3. 每轮只允许一个主框架接管
4. 用户明确指定时，以用户指令为准

## 审查视角

- 常规项目：Benjamin（实现质量）、Noah（架构边界）、Lucas（失败场景）、Harper（外部事实）
- 性能敏感项目：增加 Henry（性能并发）
- 量化交易项目：增加 William（交易结构）、Charlotte（统计验证）

## 响应要求

- 语言：中文（简体）
- 风格：直接、简洁，不废话
- 代码注释：英文

#全局 vs 项目级

#冲突解决

#常见冲突场景

#禁止行为

• 不要在同一轮中让两个框架交替接管
• 不要让补充框架覆盖主框架的设计决策
• 不要在没有用户明确要求时自动切换主框架

#相关资源

• Superpowers 插件 — 通用研发工作流框架
• Gstack 工具包 — 专项工程能力框架
• OpenSpec + Superpowers 双层规划 — 双层规划工作流
• SDD 方法论与工具辨析 — SDD 三层模型和工具选择
• 最佳实践 — 四阶段工作流和业务场景

#下一步

• SDD 方法论与工具辨析 — 理解 SDD、OpenSpec、Spec-Kit、Superpowers 的关系
• OpenSpec + Superpowers 双层规划 — 企业级双层规划工作流
• 最佳实践：四阶段工作流 — 将路由协议融入完整开发流程