3.6 KiB
3.6 KiB
generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件) wiki_page: Task-7-ClaudeCode模型路由 wiki_url: http://ilaer.eicp.net:8418/opc/dev_harness/wiki/Task-7-ClaudeCode%E6%A8%A1%E5%9E%8B%E8%B7%AF%E7%94%B1.- wiki_revision: 21200c65b99ff5cd5a27cae6116ed8b56f938a28 synchronized_at: 2026-08-08T03:20:04Z
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：本页的自动导出镜像。
验收结果
| 验收标准 | 结果 |
|---|---|
保留 @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/耗时基准；这些均不在本任务范围内。
相关提交
3bfe752docs: 增加 Claude Code 模型路由 (#7)- 归档提交哈希在提交后回写 Gitea 工单，避免归档自引用。