manager

子 Agent 调度参考

来源： metyatech/skill-sub-agent-dispatch。 要更新此技能，请编辑仓库并推送。Agent 不得编辑已安装的副本。

此技能包含用于调度子 Agent 的参考数据和详细流程。始终加载的子 Agent 调度不变量（agents-mcp 工具、ai-quota、模式、决策框架、验证交付格式、成本约束、执行规范、生命周期）位于 sub-agent-dispatch 规则模块中。生成提示词的要求和委派 Agent 的义务位于 delegation 规则模块中。审批规则位于 approval-gates 规则模块中。

调度工作流

1. 接收用户请求。
2. 将任务拆分为独立的工作项，并进行跟踪。
3. 使用 sub-agent-dispatch 规则中定义的决策框架对每个工作项进行分类。
4. 并行调度所有相互独立的工作项。
5. 向用户报告已调度的任务和待处理事项。立即交还控制权。
6. 在此后收到的每条用户消息中，Agent 必须先调用 Status(wait=false)，并在处理用户的新请求前报告任何状态变化。
7. 所有子 Agent 完成且审核关卡通过后，Agent 必须总结结果并继续后续步骤。

跨 Agent 调用（agents-mcp）

agents-mcp 是 metyatech 的 MCP 服务，可在 Claude Code、Codex、Gemini CLI 和其他 Agent CLI 中统一使用。

一次性设置

平台专用安装命令请参阅 README.md。

调度任务

使用 agents-mcp 生成子 Agent，并设置以下参数：

• prompt — 完整且自包含的任务说明。
• agent_type — 目标 Agent（claude、codex、copilot）。 Agent 不得使用 gemini（见下文 Gemini 部分）。
• model — 来自模型清单的明确模型字符串 （例如 "claude-sonnet-4-6"）。
• effort — 可选的推理力度。根据模型清单设置；不需要时省略。
• mode: 'edit' — 实现 Agent 必须设置。

监控

生成 Agent 后，立即返回给用户。使用后台或非阻塞监控，以便在 Agent 完成时收到通知。agents-mcp wait 和 Status(wait=true) 都会轮询，直到任务完成或超时。

如果未配置 agents-mcp

停止并向用户说明此限制。Agent 不得模拟或替代执行该工作。

验证提示词模板

实现 Agent 模板

Delegated mode. Implement approved scope only.
Return exactly: (1) Restated AC, (2) AC->evidence with exact commands/manual steps + PASS/FAIL/NOT RUN, (3) Files changed, (4) Assumptions/uncertainties, (5) Risks/rollback notes.
If spec/behavior text changed: cite file + section and summarize behavior delta.
Run applicable tests/verification and include exact commands and outputs summary.

审核 Agent 模板

Delegated mode reviewer. Do not implement; review only.
Original requirements: [paste original AC/spec here]
Implementation output: [paste implementation agent's report here]
Note: tests were written by an agent and may confirm implementation behavior rather than spec intent.
Return: explicit PASS or FAIL, reasons, spec alignment (does the implementation meet the original requirements, not just the tests?), AC coverage gaps, and any ambiguous points.
Reject if evidence format is incomplete, outcomes are unsupported, or implementation deviates from original spec.

规范变更流程

• 如果行为或规范文本发生变更，实现 Agent 必须注明变更位置（文件 + 章节标题），并概述行为差异。
• 审核者必须明确确认与规范的一致性，并列出需要跟进的任何模糊之处。

审核者模型选择

• 对于验证失败的 Standard 级审核：使用 claude-haiku-4-5-20251001。
• 对于 Heavy 级审核以及发布/生产变更：使用 claude-sonnet-4-6，并设为 medium 努力级别。

错误处理

• 如果子 Agent 失败，调用 Status，并将 agents[].errors 和 agents[].diagnostics.tail_errors 作为主要失败原因。
• 仅在需要时通过 agents[].diagnostics.log_paths.stdout 打开原始日志（例如，查看文件末尾）。不要手动搜寻日志。

模型清单与路由

上次审核：2026-02-27。 模型变更时请更新本节。

层级定义

• Free — 简单查询、简单问答、直接的单文件编辑。仅使用 Copilot。
• Light — 机械式转换、格式调整、简单实现、快速答疑。
• Standard — 常规实现、代码审查、多文件更改以及大多数开发工作。
• Heavy — 架构决策、安全关键代码、复杂的多步推理。
• Large Context — 输入超过 200k token 的任务。
• Bulk/Idle — 自动化合规检查、跨代码仓库的重复转换。优先选择成本最低的 Agent。

将每项任务归入相应层级，然后选择配额充足的 Agent，并选择该层级标有 ★ 的首选模型。如果首选模型所属的 Agent 没有配额，则改用同一层级的其他模型。

Claude

层级	模型	推理力度	备注
Light	claude-haiku-4-5-20251001	—	不支持推理力度；SWE-bench 73%
Standard	claude-sonnet-4-6	medium	★ 默认；SWE-bench 80%
Heavy	claude-opus-4-6	high	SWE-bench 81%；最难的任务使用 max 推理力度

Codex

层级	模型	推理力度	备注
Light	gpt-5.1-codex-mini	medium	仅支持 medium/high
Standard	gpt-5.3-codex	medium	★ 最新旗舰模型；SWE-bench Pro 57%
Standard	gpt-5.2-codex	medium	上一代；SWE-bench Pro 56%
Standard	gpt-5.2	medium	通用型；非 Codex 模型中推理能力最佳；SWE-bench 80%
Heavy	gpt-5.3-codex	xhigh	★ 推理力度设为最大时表现最佳的 Codex 模型
Heavy	gpt-5.1-codex-max	xhigh	扩展推理；上下文压缩
Heavy	gpt-5.2-codex	xhigh	替代选择
Heavy	gpt-5.2	xhigh	通用推理备用选项

Gemini 子 Agent 可靠性

⚠ 不得将 gemini Agent 类型用于子 Agent 委派。 Gemini CLI Agent 频繁因 HTTP 429「无可用容量」服务器错误而失败，可靠性不足，即使是单个无人值守任务也不例外。用户直接调用时，可以交互式使用 Gemini CLI。对于大上下文工作，请改用 Copilot 搭配 gemini-3-pro 模型。

层级	模型	推理力度	备注
Light	gemini-3-flash-preview	—	SWE-bench 78%
Standard	gemini-3-pro-preview	—	★ 1M token 上下文；SWE-bench 76%（仅限交互式使用）
Large Context	gemini-3-pro-preview	—	>200k token 任务；1M 上下文（仅限交互式使用）

Aider（BYOK）

Aider 使用外部 API 密钥。费用按 token 计，由服务提供商收取（无订阅）。最适合使用低价 API 模型处理批量／空闲任务。

层级	模型	服务提供商	备注
Bulk/Idle	deepseek/deepseek-chat	DeepSeek	★ 输入每 MTok $0.07-$0.27；SWE-bench 73%
Bulk/Idle	deepseek/deepseek-reasoner	DeepSeek	每项 Aider 任务 $1.30
Light	claude-3-5-haiku-20241022	Anthropic	与 Claude Haiku 相同
Standard	claude-sonnet-4-6-20261022	Anthropic	与 Claude Sonnet 相同

通过 DEEPSEEK_API_KEY 或 ANTHROPIC_API_KEY 进行配置。Aider 尚未集成到 agent-runner 中（已记录为待办任务）。

Copilot

Copilot 会根据模型收取不同额度。任务复杂度允许时，优先使用倍率较低的模型。无法配置工作强度（设置会被忽略）。

Tier	Model	Quota	Notes
免费	gpt-5-mini	0x	★ SWE-bench 约 70%
免费	gpt-4.1	0x	1M 上下文；SWE-bench 55%
轻量	claude-haiku-4-5	0.33x	★ SWE-bench 73%
轻量	gpt-5.1-codex-mini	0.33x	机械式转换
标准	claude-sonnet-4-6	1x	★ 默认；SWE-bench 80%
标准	gpt-5.3-codex	1x	最新的 codex 旗舰模型
标准	gpt-5.2	1x	通用推理能力最佳
标准	gpt-5.2-codex	1x	Agent 式编码
标准	gpt-5.1-codex-max	1x	扩展推理
标准	claude-sonnet-4-5	1x	SWE-bench 77%；优先选择 4.6
标准	gpt-5.1-codex	1x	SWE-bench 77%
标准	gpt-5.1	1x	通用；SWE-bench 约 76%
标准	gemini-3-pro	1x	1M 上下文；SWE-bench 76%
标准	claude-sonnet-4	1x	旧版；最后选择
重型	claude-opus-4-6	3x	★ SWE-bench 81%
重型	claude-opus-4-5	3x	SWE-bench 81%；优先选择 4.6
—	claude-opus-4-6 fast	30x	避免使用；额度消耗过高

路由原则

• 可用的子 Agent 类型有 claude、codex、copilot。不得启动 gemini Agent 类型（参见上文 Gemini 部分）。所有可用的 Agent 类型均使用独立的固定费率订阅。根据模型质量、额度节省和额度分配进行路由。
• 所有 Agent 都可以执行代码、修改文件并完成多步骤任务。应根据模型质量和额度进行路由，而不是根据执行能力。
• 将工作分散到各个 Agent，以最大化总吞吐量。
• 对于需要大上下文的任务（>200k tokens），优先使用 Copilot 的 gemini-3-pro 模型。不得使用 gemini Agent 类型。
• 对于简单任务，优先使用 Copilot 免费层模型（额度为 0x），再消耗其他 Agent 的额度。
• 多个 Agent 都能同样出色地处理任务时，优先选择剩余额度最多的 Agent。

成本效益优先级

• 有可用额度时，优先使用固定费率（订阅）Agent，而非按 token 付费的 Agent。
• 空闲或批量任务不得消耗高级额度。按以下顺序路由： Copilot 0x → Aider+DeepSeek → Amazon Q。
• 将高级额度留给交互式使用。用量门槛要求 Claude 和 Codex 的 5 小时窗口至少保留 70% 额度。
• Sonnet 4.6 是主力模型。 默认使用 Sonnet；对于重型任务，或严格遵守规则失败时，升级到 Opus。两者均使用 medium 工作强度——研究表明，对于包含多项约束的规则集，提高工作强度会降低指令遵循能力（arXiv:2505.11423）。

额度回退逻辑

如果主 Agent 没有剩余额度：

1. 通过 ai-quota 查询所有 Agent 的额度。
2. 选择有可用额度且模型达到所需等级的任意 Agent。
3. 回退到 Copilot 时，优先选择倍率较低的模型，以节省额度。
4. 对于没有订阅额度的标准等级任务：回退到 Aider + DeepSeek（按 token 付费，每项任务约 $1）。
5. 如果回退模型的能力明显较弱，请在调度报告中说明性能下降。
6. 如果所有 Agent 都没有额度，且没有可用的按 token 付费回退方案，则将任务加入队列，并立即报告受阻情况。不得不作说明就静默丢弃任务。

路由决策顺序

1. 为任务划分层级（Free / Light / Standard / Heavy / Large Context / Bulk/Idle）。
2. 对于 Free 层级：派发给使用 0x 模型的 Copilot。跳过 配额检查。
3. 对于 Bulk/Idle 层级：依次派发给 Copilot 0x → Aider+DeepSeek → Amazon Q。跳过高级 Agent，不要使用 Gemini Agent 类型。
4. 对于其他层级：通过 ai-quota 检查所有 Agent 的配额。
5. 选择在所需层级有可用配额的 Agent； 如果有多个符合条件，优先选择剩余配额最多的 Agent。
6. 根据上表设置 agent_type、model 和 effort（列中显示 — 时省略 effort）。
7. 如果首选项没有配额：应用回退逻辑。
8. 在派发报告中注明所选 Agent、模型、层级和 effort。

值得关注的模型（尚未纳入当前路由）

这些模型目前尚无法通过受支持的 Agent CLI 访问，但 值得持续关注：

模型	提供商	优势	访问方式
Kimi K2.5	Moonshot AI	IFEval SOTA 94.0	仅限 API；无 CLI
Grok 4.20	xAI	4-Agent 委员会；2M 上下文	仅限 xAI API
Qwen 3.5	Alibaba	IFEval 92.6	仅限 API
GLM-4.7	Zhipu AI	双评审最高分	仅限 API

特定平台的变通方案

• 在文件删除命令受策略限制的平台上（例如， Windows 上的 Codex），请参阅 command-execution 规则模块中的 Codex 专用变通方案。