opc/dev_harness

Table of Contents

7 Claude Code 模型路由

背景与目标
最终方案
修改文件
验收结果
测试
相关提交

7 Claude Code 模型路由

类型：开发规则优化
所属 Epic：无
所属 MVP / 版本：无
状态：已完成
日期：2026-08-08
Gitea 工单：#7
Wiki 页面：Task-7-ClaudeCode模型路由
Wiki revision：见本地镜像头

背景与目标

Claude Code 已通过 CLAUDE.md 导入共同开发规则，但没有说明 Opus、Sonnet 和 Haiku 应如何按任务复杂度分工。若每个任务固定依次调用三个模型，会增加重复上下文、Token 和等待时间；如果只用提示语要求 Haiku 只读，又不能真正限制其工具权限。

本任务在 Claude Code 专用入口中增加按需模型路由、结构化交接和 Haiku 只读边界。

最终方案

目标、范围和修改位置明确的任务默认由 Sonnet 分析、建单和实施。
模糊需求、复杂根因、跨模块架构或高风险任务由 Opus/opusplan 制定方案。
Opus 方案必须先由用户确认，再交给 Sonnet 创建工单和实施。
Haiku 仅用于范围明确的文档、代码入口、日志事实和调用关系检索。
Haiku 不承担最终根因、技术方案、风险等级和验收结论。
当前模型足够时不升级，不固定依次调用三个模型。
Agent 只交接结构化事实、假设、范围、风险、证据位置和未知项，减少大段重复上下文。
Haiku 只读必须由工具权限实现；本任务未创建子 Agent 配置，因此未配置只读权限时不得调用 Haiku 处理项目内容。
Harness 检查三个新增章节及关键边界，防止后续误删。
未写死具体模型版本，继续使用模型别名。

实施结果与已确认方案一致。

修改文件

CLAUDE.md：增加模型路由、Agent 交接和 Haiku 只读约束。
dev_scripts/check_harness.py：增加 Claude Code 路由规则的结构检查。
wiki-docs.json：登记本任务 Wiki 归档镜像。
docs/task/7-ClaudeCode模型路由.md：本页的自动导出镜像。

验收结果

用户于 2026-08-08 明确验收通过。

验收标准	结果
保留 `@AGENTS.md` 导入和共同规则来源说明	通过
包含模型路由、Agent 交接和 Haiku 只读约束	通过
不要求每个任务依次调用三个模型	通过
Opus 方案经用户确认后由 Sonnet 实施	通过
Haiku 不做最终决策	通过
Haiku 只读要求工具权限实施	通过
不写死具体模型版本	通过
Harness、测试和镜像检查	通过
实现和归档提交分离	通过

测试

执行命令：python -m unittest discover -s tests -v
结果：19/19 通过。
执行命令：python dev_scripts/check_harness.py --strict
结果：通过。
执行命令：python dev_scripts/sync_wiki_docs.py --check
结果：归档前 16/16 映射一致；归档后重新检查 17/17。
执行命令：python -m compileall -q dev_scripts tests
结果：通过。
执行命令：git diff --check
结果：通过。
未验证部分：未创建或运行 Haiku 只读子 Agent，未执行多模型 Token/耗时基准；这些均不在本任务范围内。

相关提交

3bfe752 docs: 增加 Claude Code 模型路由 (#7)
归档提交哈希在提交后回写 Gitea 工单，避免归档自引用。