dev_harness/CLAUDE.md

Claude Code 项目入口

@AGENTS.md

Claude Code 专用说明

• 上方导入的 AGENTS.md 是所有编码 Agent 的共同规则事实来源，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 处理项目内容。