docs: 归档任务 #7

CLAUDE.md

@@ -5,5 +5,27 @@
 ## Claude Code 专用说明
 
 - 上方导入的 `AGENTS.md` 是所有编码 Agent 的共同规则事实来源，Claude Code 必须完整遵守。
-- 本文件只记录 Claude Code 特有的入口或工具差异；当前没有额外的项目专用差异。
+- 本文件只记录 Claude Code 特有的模型路由、工具和 Agent 协作规则。
 - 共同规则变化时只修改 `AGENTS.md`，不要在本文件重复维护。
+
+## 模型路由
+
+- 目标、范围和修改位置已经明确时，默认使用 Sonnet 分析、建单和实施。
+- 需求模糊、根因不明，或涉及跨模块架构、安全、权限、并发、迁移和不可逆操作时，使用 Opus 或 `opusplan` 制定方案。
+- Opus 输出方案后必须等待用户确认；确认后由 Sonnet 根据方案创建工单并实施。
+- Haiku 只用于范围明确的只读任务，例如查找代码入口、读取项目文档、提取日志事实和整理调用关系。
+- 不让 Haiku 决定最终根因、技术方案、风险等级或验收结论。
+- 当前模型足以完成任务时不升级模型，也不为了形式固定依次调用三个模型。
+
+## Agent 交接
+
+- Opus 向 Sonnet 交接目标、非目标、事实、假设、方案、修改范围、风险、回退方式和验收标准。
+- Haiku 向主 Agent 交接结论、证据位置和仍不确定的内容，不返回与任务无关的大段原文。
+- Sonnet 严格按照已确认方案和工单实施；发现范围变化时返回主流程重新确认。
+- 不同 Agent 复用仍然有效的检查结果；会话、环境或关键前提变化时才重新检查。
+
+## Haiku 只读约束
+
+- Haiku 子 Agent 只允许使用读取、搜索和只读代码图谱工具。
+- 禁止 Haiku 修改文件、创建或更新工单、提交 Git、更新 Wiki 或执行具有副作用的命令。
+- 只读必须通过子 Agent 工具权限实现，不能只依赖提示语；未配置只读权限时不得调用 Haiku 处理项目内容。

dev_scripts/check_harness.py

@@ -206,6 +206,13 @@ def check_claude_code_entry(errors: list[str], root: Path = ROOT) -> None:
         "共同规则事实来源",
         "只记录 Claude Code 特有",
         "只修改 `AGENTS.md`",
+        "## 模型路由",
+        "## Agent 交接",
+        "## Haiku 只读约束",
+        "当前模型足以完成任务时不升级模型",
+        "Opus 输出方案后必须等待用户确认",
+        "不让 Haiku 决定最终根因",
+        "只读必须通过子 Agent 工具权限实现",
     )
     for section in missing_sections(content, required):
         errors.append(f"CLAUDE.md 缺少：{section}")

docs/task/7-ClaudeCode模型路由.md

@@ -0,0 +1,79 @@
+<!-- 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 工单，避免归档自引用。

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"
     }
   ]
 }