// 怎么做 · 让多个 agent 共用规则和技能
AGENTS.md 怎么写
AGENTS.md 是放在仓库里给编程 agent 看的说明文件，作用类似给新同事的 README：怎么构建、怎么测试、代码规范和提交要求。
核实于 2026-10-102 个官方来源
现象
- agent 每次都要重新摸索怎么跑测试
- 不同 agent 生成的代码风格不一致
常见原因
- 仓库里没有给 agent 的固定说明，或者说明分散在多个工具各自的文件里
解决步骤
- 在仓库根目录新建
AGENTS.md，写清楚安装依赖、构建、运行测试和 lint 的确切命令 - 写代码规范、目录结构要点、不允许做的事（例如不要改生成文件、不要直接推主分支）
- 大型仓库可以在子目录再放
AGENTS.md，就近覆盖该目录的规则 - 保持简短具体，写命令和规则，不写空泛的口号；规则变了随代码一起改
- Claude Code 读取的是
CLAUDE.md，可以在其中引用或链接到AGENTS.md，避免维护两份
官方参考
2026-10-10 根据官方文档和公开讨论整理，尚未在本站环境复现；与官方文档不一致时以官方为准。