From 98df3a2dc55f99ea5901ab8a5bfae2dc5b437bc5 Mon Sep 17 00:00:00 2001 From: QiuSW <105186638@qq.com> Date: Sat, 8 Aug 2026 11:21:08 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=BD=92=E6=A1=A3=E4=BB=BB=E5=8A=A1=20?= =?UTF-8?q?#7?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/task/7-ClaudeCode模型路由.md | 79 +++++++++++++++++++++++++++++++ wiki-docs.json | 4 ++ 2 files changed, 83 insertions(+) create mode 100644 docs/task/7-ClaudeCode模型路由.md diff --git a/docs/task/7-ClaudeCode模型路由.md b/docs/task/7-ClaudeCode模型路由.md new file mode 100644 index 0000000..0fc54ba --- /dev/null +++ b/docs/task/7-ClaudeCode模型路由.md @@ -0,0 +1,79 @@ + +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 工单：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 工单，避免归档自引用。 diff --git a/wiki-docs.json b/wiki-docs.json index 9699d74..4e9b116 100644 --- a/wiki-docs.json +++ b/wiki-docs.json @@ -67,6 +67,10 @@ { "page": "Task-6-优化ClaudeCode规则入口", "path": "docs/task/6-优化ClaudeCode规则入口.md" + }, + { + "page": "Task-7-ClaudeCode模型路由", + "path": "docs/task/7-ClaudeCode模型路由.md" } ] }