32 lines
1.9 KiB
Markdown
32 lines
1.9 KiB
Markdown
# 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 处理项目内容。
|