docs: 增加 Claude Code 模型路由 (#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}")