AGENTS.md 教学：让 Codex 按你的项目规则工作

如果你经常在同一个项目里使用 Codex，不应该每次都重复说明“文章在哪里”“构建命令是什么”“不要删除文件”。AGENTS.md 就是用来保存这些项目规则的说明文件，让 Codex 在工作时先读取并遵守。

AGENTS.md 的价值在于降低沟通成本。它不是越长越好，而是把团队真正需要 Codex 遵守的规则写清楚：项目结构、常用命令、代码风格、验证标准、危险操作限制和内容规范。

适合谁阅读

• 长期维护同一个网站或代码库的人
• 团队多人使用 Codex 的项目负责人
• 希望 Codex 每次都遵守相同规则的站长
• 有固定构建、测试、部署流程的开发者
• 担心 AI 乱改文件或忽略检查的人

Codex 可以做什么

• 告诉 Codex 项目目录和内容来源
• 记录常用测试、构建和预览命令
• 规定文章、SEO、CTA 和免责声明写法
• 限制危险操作，例如删除、部署、推送前必须确认
• 统一团队对 AI 输出的验收标准

实际操作步骤

1. 在项目根目录创建 AGENTS.md。
2. 写清楚项目目标和主要目录，例如 app、lib、content、components。
3. 列出常用命令：typecheck、build、lint、test。
4. 写内容规则：简体中文、不要夸张承诺、Affiliate disclosure 不可删除。
5. 写危险操作规则：部署、删除、推送、数据库操作前要确认。
6. 让 Codex 每次任务开始先阅读 AGENTS.md，并按规则汇报验证。

示例 Prompt

请先阅读项目根目录的 AGENTS.md，然后再处理任务。
目标：新增一篇 AI 工具文章。
要求：必须遵守 AGENTS.md 的内容规范、验证流程和危险操作确认规则。
完成后：请说明你遵守了哪些规则、改了哪些文件、运行了什么检查。

实战说明

AGENTS.md 应该写什么

最有用的内容包括项目简介、目录说明、技术栈、常用命令、代码风格、内容规范、SEO 规则、验证流程和禁止事项。不要写大量空泛原则，Codex 更需要具体可执行规则。

不同目录可以有不同规则

如果项目很大，可以在子目录放更具体的 AGENTS.md。例如内容目录强调文章格式，组件目录强调 UI 风格，API 目录强调安全和测试。更接近文件的规则通常更具体。

把经验沉淀成规则

每次发现 Codex 重复犯同类错误，都可以把修正后的规则写进 AGENTS.md。这样项目会越来越适合 AI 协作，而不是每次从零沟通。

注意事项

• 不要把密码、API key 或私密后台资料写进 AGENTS.md。
• 规则不要互相冲突，例如同时要求不改文件又要求完成重构。
• 命令要真实存在，不能凭印象写。
• AGENTS.md 不能替代人工检查，只能提高一致性。
• 项目规则变更后，要让团队知道并保持同步。

内部链接建议

• Codex Prompt 写法
• Codex 权限、安全与沙盒
• 用 Codex 做代码审查
• 关于 AI.No1.my

FAQ

AGENTS.md 是必须的吗？

不是必须，但长期项目强烈建议使用，它能减少重复说明和错误操作。

AGENTS.md 要写多长？

写必要规则即可。通常一到三页清楚说明比十页空话更好。

可以用中文写 AGENTS.md 吗？

可以。命令、路径和技术名词保持准确即可。

AGENTS.md 会让 Codex 永远不犯错吗？

不会，但能提高一致性。关键操作仍要验证和人工确认。

总结

AGENTS.md 是让 Codex 稳定协作的重要工具。把项目结构、命令、规范和验收标准写进去，可以让 AI 更像了解项目的助手，而不是每次重新解释的新成员。

如果你想学习更多 AI 工具、AI 自动化和 Codex 实战教学，欢迎持续关注 ai.no1.my。