skills/cc-switch-dev-workflow/references/knowledge-base/decisions/ADR-2026-03-21-model-routing-and-fallbacks.md

ADR-2026-03-21 Model Routing And Fallbacks

Purpose

记录当前默认模型路由和 fallback 边界。

When to Use

• 需要决定主辅模型时
• 需要启用 fallback 时

Inputs

• 当前阶段
• 任务类型
• 文档长度

Outputs

• 模型路由决策

Primary Agent/Model

项目 owner + GPT-5.4 Pro xhigh

Secondary Agent/Model

Claude Opus 4.6

Required Skills

• 无

Steps

1. 先判断任务类型。
2. 再确定主辅模型。
3. 若需要 fallback，先写边界，再压缩回主线程。

Exit Criteria

• 主辅模型与 fallback 路线都明确

Failure Recovery

• 若 fallback 成为默认路线，说明本 ADR 被破坏，应重新审查

Related Templates

• ../templates/agent-handoff-template.md

Status

Accepted

Context

• 团队需要在长文处理、复杂推演、Spec 审查和实施之间切换最合适模型。
• 不能把临时 fallback 升级为默认主路线。

Decision

• 默认主模型：GPT-5.4 Pro xhigh
• 默认辅模型：Claude Opus 4.6
• GPT-5.4 Pro xhigh 负责研究规划、任务拆分、结构化文档、实施与重构主链路。
• Claude Opus 4.6 负责长文消化、Spec 审读、第二视角复核。
• GLM / Minimax / Kimi 仅作受控 fallback，不作为默认项目主链路。
• 任何 fallback 输出都必须压缩为标准 handoff 后才能回到主线程。

Consequences

• 模型切换更可预测
• handoff 质量变成模型协作的硬约束
• fallback 使用频率可被审计，而不是隐形扩散

Revisit When

• 主模型能力或成本结构显著变化
• 团队引入新的主编排系统