ECC /model-route 命令详解按任务复杂度与预算自动推荐最佳模型层级【免费下载链接】ECCThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.项目地址: https://gitcode.com/GitHub_Trending/ev/ECC在同时承载 Claude Code、Codex、Opencode、Cursor 等多套 Agent 执行环境的 ECCagent harness performance optimization system中/model-route是一个面向模型选型成本治理的轻量级斜杠命令。它不做代码修改不委托给任何子代理而是在任务开始之前依据任务的复杂度、风险与预算快速给出该用哪一档模型的明确建议从而帮助开发者避免两端的浪费简单任务过度使用昂贵旗舰模型、复杂架构任务却落到了低能力模型上。阅读完本文你将掌握/model-route的完整调用语法、三档路由启发式的判断依据、四要素输出契约的具体解读方式以及它在 ECC 成本治理体系cost-aware-llm-pipeline、ecc-tools-cost-audit、harness-audit中的配套位置。一、命令定位只做推荐不做执行/model-route是 ECC 于 1.8.0harness-first 版本新增的一组平台命令之一。在 CHANGELOG.md 中可以看到它与/harness-audit、/loop-start、/loop-status、/quality-gate一同被引入整体围绕 harness 可靠性、评估纪律与自治循环运营展开。一个非常值得注意的设计点是/model-route是一个**无代理命令**。在 docs/COMMAND-AGENT-MAP.md 的命令→代理映射表中它的 Primary agents 一栏明确标注为—注释为Model recommendation (no agent)在 docs/COMMAND-REGISTRY.json 中它的primaryAgents、allAgents、skills数组全部为空类型被归类为review。这说明该命令的价值不在于调用谁来干活而在于在动手前给出一个人工可复核的模型决策依据属于典型的决策辅助层而非执行层。在 COMMANDS-QUICK-REF.md 中它的速查描述为Route a task to the right model (Haiku / Sonnet / Opus)即把任务路由到 Haiku / Sonnet / Opus 三档模型之一——这与命令定义文件 commands/model-route.md 的路由启发式完全一致。二、命令语法与参数说明/model-route的完整用法由两部分构成任务描述与预算档位。命令定义文件 commands/model-route.md 中给出的调用形式为/model-route [task-description] [--budget low|med|high]两个参数均为可选项说明该命令即使在零参数下也能给出基于默认规则的推荐适合作为进入一段工作前的例行路由检查参数是否必填取值作用task-description可选自由文本描述待处理任务的背景、范围与难点作为复杂度判断的输入--budget可选low/med/high声明本次任务的成本预算档位用于约束模型选择上限在 OpenCode 风格的命令模板中该文件中的$ARGUMENTS占位符会把用户键入的剩余参数原样追加到模板末尾。以 ECC 的command配置模式见 .opencode/opencode.json 中其它命令的template: {file:commands/xxx.md}\n\n$ARGUMENTS写法为参照实际渲染效果相当于把 命令模板 task-description--budget 拼接成一段完整提示词交给 Agent 解析。2.1 实际使用示例/model-route 将支付模块的单测由 jest 迁移到 vitest涉及约 40 个测试文件与 mock 改造 --budget low/model-route 设计跨租户的数据隔离方案需要权衡 schema 拆分与行级安全 --budget high三、核心路由启发式三个档位的判据命令定义文件 commands/model-route.md 给出了三档模型与任务特征的核心映射这是整个命令的灵魂haiku确定性高、低风险的机械性改动deterministic, low-risk mechanical changessonnet实现与重构的默认档位default for implementation and refactorsopus架构设计、深度审查、需求模糊的场景architecture, deep review, ambiguous requirements将其转化为可操作的任务分类判断可以得到如下决策对照推荐档位典型任务画像判断要点反例应升级/降级haiku重命名变量、批量格式化、模板代码补全、简单 bug 定点修复改动路径可枚举、输出可验证、几乎不涉及跨模块决策一旦涉及 API 契约变更或公共签名调整即应升级sonnet功能模块实现、中等规模重构、常规 code review有清晰需求边界、存在既有模式可循、多数情况下是照规范执行若需求出现多个互斥实现方案则升级至opusopus系统架构设计、深度代码审查、安全边界评审、需求本身模糊不清需要在多个方案间权衡取舍、影响面跨越多个子系统、隐含约束未知若仅为单一确定性改动降级可显著节约成本3.1 复杂度阈值在仓库中的印证三层分档的成本意识并非孤例。ECC 仓库中的 skills/cost-aware-llm-pipeline/SKILL.md 给出了同源的可量化路由实现可作为/model-route把复杂度落到代码层面的参照MODEL_SONNET claude-sonnet-5 MODEL_HAIKU claude-haiku-4-5-20251001 _SONNET_TEXT_THRESHOLD 10_000 # chars _SONNET_ITEM_THRESHOLD 30 # items def select_model(text_length, item_count, force_modelNone): if force_model is not None: return force_model if text_length _SONNET_TEXT_THRESHOLD or item_count _SONNET_ITEM_THRESHOLD: return MODEL_SONNET # Complex task return MODEL_HAIKU # Simple task (3-4x cheaper)从该实现可以读出两个与/model-route同构的设计理念复杂度可以量化在批处理场景中用文本规模和条目数两个硬指标作为升档触发条件对应到开发任务里文件改动数量、涉及模块数、公共接口变更数同样可作为升级模型的信号。低成本档是默认而不是例外简单任务默认落到更便宜的模型该 skill 注明简单任务成本约为复杂任务的 1/3~1/4只有越过阈值才升级——这与/model-route中haiku承接低风险机械改动的定位一脉相承。四、预算档位--budget的解读命令定义文件把预算限定为low/med/high三档但未在文件内给出与模型档位的硬绑定。结合路由启发式与成本治理类 skill 的原则可以按以下口径理解三档预算——这是与low省到high放的连续刻度一致的推荐口径--budget推荐倾向适用情形low优先haiku仅在无法满足时升到sonnet批量机械改动、探索性草稿、成本敏感的一次性脚本med默认sonnet作为实现与重构的主力档常规功能开发、需求明确的中型重构是大多数任务的默认值high允许opus把正确性置于成本之上架构评审、跨子系统改造、安全与合规审查、上线前的最终质量把关需要强调/model-route的定位是在开工前给出参考建议实际模型选择仍取决于运行 harness 的全局配置。ECC 对模型选择的官方态度是把模型选择权交给 harness 本身——在 .opencode/README.md 中有明确说明The reference config intentionally leaves model selection to OpenCode. Connect a provider and select a model in OpenCode; ECCs primary agent uses that global selection。也就是说/model-route提供的是一份应该用哪一档的决策参考最终仍需由用户在当前会话中确认并切换模型二者并不冲突反而构成先路由、后执行的协作关系。五、输出契约四要素缺一不可命令定义文件 commands/model-route.md 对命令的产出提出了刚性要求Required Output每次调用必须输出以下四项这是保证推荐可被人工复核、可被后续流程引用的关键recommended model推荐模型本次建议使用的具体模型档位如sonnet必要时给出具体模型标识。confidence level置信度对当前推荐的确信程度。建议采用结构化取值如high/medium/low并附一句理由当任务描述含混或task-description缺失时置信度应当相应下调。why this model fits适配原因对照第三节的路由启发式说明该任务落入当前档位的具体依据——例如改动为纯机械替换、无跨模块影响支撑haiku或需求存在两套互斥方案需权衡支撑opus。fallback model回退模型当首选模型在首次尝试中失败或表现不达预期时的备选方案。回退方向通常与成本方向相反首选偏省时回退向更强档首选偏强时回退向更省档从而在够用与兜底之间留出安全缓冲。5.1 输出示例对于前文的 vitest 迁移示例一个符合契约的输出大致如下推荐模型: sonnet 置信度: high 适配原因: 迁移涉及 40 测试文件改动属于有既有模式可循的实现类重构 但 mock 改造存在少量环境差异排查落在 haiku 与 sonnet 的边界上 声明 budgetlow 故不选择 opus。 回退模型: haiku —— 若确认全部改动为机械性 API 替换可在首批样例验证通过后降档 若遭遇 vitest 环境级疑难问题则升级回 sonnet 并补充上下文。六、在成本治理体系中的位置/model-route不是孤立存在的命令它是 ECC先决策、后执行、再审计成本治理链路的第一环。仓库中存在多条可与之串联的证据链模型选择本身留白.opencode/README.md 明确 ECC 参考配置有意把模型选择权交给 harness这使/model-route成为唯一一个系统提供的人工选型参考点恰好补上配置留白处的决策空档。成本审计互为表里/model-route做事前路由而 skills/ecc-tools-cost-audit/SKILL.md 一类的技能做事后成本核算两者合起来构成开工前省、运行后查的闭环。可被 harness 检查强制约束在 scripts/harness-audit.js 的成本类检查项中cost-model-route-command会校验仓库内存在commands/model-route.md及其路由策略并强调 cheap-default execution即默认便宜的执行倾向。这说明对 ECC 官方而言模型路由引导文档本身就是 harness 健康度评分的一部分另一个相关检查项context-model-route见 scripts/harness-audit.js也把该命令文件的存在视为必检条件。注册与索引完备该命令同时登记在 docs/COMMAND-REGISTRY.json类型review与 docs/COMMAND-AGENT-MAP.md 中便于在 OpenCode、Claude Code 等多 harness 场景下被统一发现和引用。七、使用建议与注意事项在任务开始前调用/model-route的最佳触发点是拿到任务、尚未动工的瞬间。若在已有大量上下文的中途调用模型可能被既有 token 消耗与惯性带偏推荐档位。任务描述越具体推荐越可信task-description中尽量交代改动范围涉及文件/模块数、风险面是否触碰公共接口、安全边界与需求清晰度这三类信息与路由启发式的三档判据直接对应。预算与档位要显式联动默认不传--budget可视为med需要明确表达只求最便宜可用或正确性优先不计成本时务必显式声明low或high避免 Agent 按默认档推断而偏离你的真实意图。把 fallback 当作一等公民输出契约中的第四项回退模型决定了失败时的重试方向。推荐策略是成本侧失败升级、能力侧失败降级因输出质量不足而失败时向更强档回退因简单任务被过度复杂化或延迟过高时向更省档回退。落地仍以会话配置为准该命令产出的是建议文本不自动切换运行 harness 的模型。在多 harnessClaude Code / Codex / Opencode场景下请将推荐结果与当前会话的全局模型设置核对后再动手。八、小结/model-route用一行命令、三档模型、四个输出要素把当前任务该用哪一档模型这个原本依赖个人经验与项目惯性判断的问题变成了一个可重复、可解释、可被审计的显式决策。它不执行任何代码却在每一个高成本任务启动前提供了一次成本上的刹车检查是 ECC 在 harness 层面践行research-first、cheap-default思路的典型切片。结合仓库中cost-aware-llm-pipeline的量化阈值、harness-audit的强制校验以及命令注册表的多 harness 索引你可以在自己的工作流中把模型路由从随手一选升级为有据可依的工程实践。【免费下载链接】ECCThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.项目地址: https://gitcode.com/GitHub_Trending/ev/ECC创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考