# 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 复用仍然有效的检查结果；会话、环境或关键前提变化时才重新检查。

## 三项目角色路由

- 用户要求 Sense、Brain、Bell 并行建单时，主 Claude 作为 dispatcher，分别启动 Sense、Brain、Bell 三个项目 agent；公共建单顺序和写路径规则以 `AGENTS.md` 为准。
- Sense、Brain、Bell agent 首轮只分析并创建本项目独立功能工单，不创建跨项目契约或端到端工单，也不修改其他项目目录。
- 三个项目 agent 返回后，主 Claude 负责去重、检查依赖与写路径，再创建协同工单；需要实施共享契约、根级编排或端到端验证时才启动单独的 coordination agent。
- coordination agent 只取得协同工单明确列出的共享写路径。三端适配仍优先拆成各自主 agent 的非重叠工单。
- 建单阶段和实施阶段分开路由；不得因为三个工单已经建立，就忽略尚未冻结的契约依赖而同时实施。

## Haiku 只读约束

- Haiku 子 Agent 只允许使用读取、搜索和只读代码图谱工具。
- 禁止 Haiku 修改文件、创建或更新工单、提交 Git、更新 Wiki 或执行具有副作用的命令。
- 只读必须通过子 Agent 工具权限实现，不能只依赖提示语；未配置只读权限时不得调用 Haiku 处理项目内容。