80 lines
3.6 KiB
Markdown
80 lines
3.6 KiB
Markdown
<!-- gitea-wiki-mirror:start -->
|
|
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
|
|
<!-- gitea-wiki-mirror:end -->
|
|
|
|
# 7 Claude Code 模型路由
|
|
|
|
- 类型：开发规则优化
|
|
- 所属 Epic：无
|
|
- 所属 MVP / 版本：无
|
|
- 状态：待验收
|
|
- 日期：2026-08-08
|
|
- Gitea 工单：http://ilaer.eicp.net:8418/opc/dev_harness/issues/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/耗时基准；这些均不在本任务范围内。
|
|
|
|
## 相关提交
|
|
|
|
- `3bfe752` `docs: 增加 Claude Code 模型路由 (#7)`
|
|
- 归档提交哈希在提交后回写 Gitea 工单，避免归档自引用。
|