自定义审查
AGENTS.md
将团队的编码约定、测试命令和审查重点写入仓库根目录的 AGENTS.md。某个目录需要更具体的约定时，可在该目录添加 AGENTS.md。
HeyDeer 要求所有审查智能体（包括最终验证者）读取本次审查基础版本中的 AGENTS.md，并遵循适用于所审查文件的说明。目录层级更深的约定优先。PR 对这些说明的修改在进入基础分支后生效。
# Review guidance
- Check that every database query is scoped to a workspace.
- Run pnpm test for changes to billing calculations.
- Keep public API responses backward-compatible.在 AGENTS.md 中维护通用约定；用仓库检查定义需要单独报告通过、失败或跳过结果的专项规则。仓库约定不能覆盖已配置的审查指令或审查安全规则。
目前只用 CLAUDE.md？
将共享说明移入 AGENTS.md。如果文件已存在，请合并规则，不要覆盖。跨目录移动内容时，记得更新相对链接。
对于旧版 Claude Code 或不支持原生读取 AGENTS.md 的会话，在旁边保留一个 CLAUDE.md，并写入以下导入语句。规则仍统一维护在 AGENTS.md 中：
@AGENTS.md在本地使用 Claude Code
Claude Code 2.1.277+ 默认会在当前目录及其父目录没有 CLAUDE.md 或 CLAUDE.local.md 时读取 AGENTS.md。运行 claude update 更新后重启。如果 CLAUDE.md 只包含导入语句，此时可以移除。
如果要同时加载两种文件，在 /config → Project instructions 中选择 claude-md-and-agents-md。此选项需设在用户设置中，项目设置和本地项目设置均不支持。
原生支持依赖内置插件和功能开关。禁用 hooks 或遥测、使用第三方提供商，或处于升级后的首次会话时，可能无法使用。这些情况下请使用上面的导入方式。