让 AI 记住你的项目
解决什么问题
Section titled “解决什么问题”每开一个新对话，你都要重新解释一遍：这项目用什么技术、代码放哪、有什么规矩不能破。
规则文件就是把这些话写成一个文件放在项目里，工具自动读。
写一次，之后每次对话它都知道。
| 写 | 别写 |
|---|---|
| 这项目是干什么的（两三句） | 长篇大论的产品愿景 |
| 用了什么技术栈 | 每个依赖的详细介绍 |
| 代码在哪、怎么跑起来、怎么跑测试 | 完整的 API 文档 |
| 绝对不能碰的东西 | 泛泛的「请写高质量代码」 |
| 你的偏好（注释用中文、不要过度抽象） | 通用编程常识 |
⚠️ 一个很多人会踩的坑
Section titled “⚠️ 一个很多人会踩的坑”现在有一个叫 AGENTS.md 的规范，已经成了事实标准——2025 年 12 月归到 Linux Foundation 旗下治理，六万多个开源项目在用，二十多个工具原生支持。
按理说写一个 AGENTS.md 就万事大吉了。但有个重要例外：
这个坑的典型症状是：「我明明写了规则，它怎么还是不听？」——它不是不听，是没看见。
更细的怎么办
Section titled “更细的怎么办”规则文件的完整写法、各工具的差异、目录级覆盖这些，转载区有现成的：
学完这一节，你应该能做到
Section titled “学完这一节，你应该能做到”- 你的项目里有一个规则文件，写了技术栈、怎么跑、不能碰什么
- 知道
AGENTS.md是事实标准 - 知道 Claude Code 不读
AGENTS.md，并且已经做了软链或导入 - 能验证规则生效了（问它「这个项目有什么规矩」，它答得上来）