展开知识库目录
AGENTS.md / CLAUDE.md：把项目规矩写下来，AI 才不会每次从头猜
Codex 读 AGENTS.md，Claude Code 读 CLAUDE.md。把项目结构、构建命令、禁止事项和验收方式写进这些文件，AI 每次开工都能自动读到，不用反复交代。
把命令、风格和禁止事项写进规则文件
你大概烦透了每次开新会话都要重新交代“这个项目怎么构建、哪些不能动、代码风格是什么”。解决办法很简单：把规矩写进项目根目录的 AGENTS.md（Codex 读这个）或 CLAUDE.md（Claude Code 读这个）。
规则文件不是写作文，是给 AI 看的操作手册：项目结构、命令、禁止事项、验收标准，每一条都要具体到能执行。写好后新会话自动生效，你再也不用复述。
这些情况适合用，另外几种先停一下
适合用
- 同一个项目反复被 AI 处理，每次都重新交代
- 项目有明确的结构、命令和禁止事项
- 团队多人共用一套 AI 工作流，需要统一规则
先别急着用
- 一次性小任务，写规则文件比任务本身还费劲
- 规则还没想清楚，先别写，免得约束错方向
把项目结构、命令、禁止事项和验收写进 AGENTS.md / CLAUDE.md
为什么这样安排
Codex 的规则加载顺序是全局 AGENTS.md → 项目 AGENTS.md，Claude Code 的 CLAUDE.md 与 .claude/rules 支持路径级约束；两者文件名不能互换，写错文件等于没写。
- 01
选对文件名
Codex 用项目根目录 AGENTS.md，Claude Code 用 CLAUDE.md；两个都在用就各维护一份，内容保持一致。
- 02
写可验证规则
命令、禁止路径、输出格式、验收方式写具体，删掉“保持代码质量”这类空话，每条都能检查。
- 03
路径规则分开放
Claude Code 的目录级约束放 .claude/rules/ 并带 paths 字段，别全堆在 CLAUDE.md。
- 04
新会话验证生效
开新会话问“项目有哪些规则”，看它能否复述关键命令和禁区，复述不对就改文件。
复制前先替换 {占位}
规则文件起草提示词（复制后改 {占位}）
请帮我起草一份项目规则文件，供 AI 编程代理在每次会话开始时读取。项目是{项目名}，技术栈{技术栈}。
请按以下结构输出纯文本，不要客套话：
1. 项目一句话介绍与主要目录；
2. 常用命令（构建、测试、启动、格式化），注明从哪里读到的；
3. 禁止事项（例如：不许改生成的产物目录、不许覆盖未提交改动、凭证不许写进代码）；
4. 改动流程（改源文件→构建→验证→提交）；
5. 验收标准（构建退出码为 0、测试通过、diff 无多余改动）。
输出后说明：这份文件应保存为 AGENTS.md（Codex）还是 CLAUDE.md（Claude Code），放在哪个目录。AGENTS.md 示例（可直接改成你的版本）
下面是已经填过变量的示例。复制时请换成自己的文件名、数字和材料位置，别把示例数据原样交出去。
看清格式再改
AGENTS.md 示例（可直接改成你的版本）
项目：订单后台 构建：npm run build（必须通过） 测试：npm test（改动后必须运行） 禁止：改 package.json 依赖版本、覆盖未提交改动 风格：组件用 Composition API 验收：测试通过 + 页面可操作 验证：新会话已确认规则生效
先对症状，别一上来重写整段提示词
写了规则文件但它没遵守
- 常见原因
- 文件没放对位置或名字不对
- 怎么修
- Codex 放项目根目录 AGENTS.md，Claude Code 放 CLAUDE.md，用一个小任务验证它复述规则。
规则太抽象执行不了
- 常见原因
- 写的是“代码要规范”这类感想
- 怎么修
- 改成具体命令和禁止清单，每一条都能直接检查。
规则过时导致错误
- 常见原因
- 项目变了规则没更新
- 怎么修
- 命令和结构变化时同步更新规则文件，并写更新日期。
最后五分钟，逐项打勾
这篇具体参考了什么
正文按公开教程和官方文档重新整理，并换成了可以直接操作的中文场景。产品能力、规则和投稿要求会更新，真正执行前请再打开原始页面核对一次。