别急着让 Codex 写代码

很多人第一次打开 Codex，马上就丢一句：“帮我做个功能。”结果常见问题是：它很勤快，但不一定按你的习惯干活。它可能过度抽象，可能改太多文件，可能测试没跑，甚至在不该动的地方动手。

所以我更建议第一步先写 AGENTS.md。这不是给 AI 增加束缚，而是给合作建立边界。边界越清楚，后面越少反复解释。

AGENTS.md 本质是“协作说明书”

你可以把 AGENTS.md 理解成写给 Codex 的入职手册。不是写项目愿景，也不是写一堆漂亮口号，而是告诉它：你希望它怎么沟通、怎么改代码、什么事情必须停下来问你。

尤其是内容、教育、运营团队，用 AI 往往不是一次性生成，而是长期协作。今天写脚本，明天改页面，后天整理素材。如果每次都重新交代规则，人的精力会被消耗在“纠偏”上。

最小可用规则就够了

不要一上来写十几页规范。刚开始只需要覆盖五类规则。

第一，沟通规则。比如中文沟通，但代码、命令、变量名、日志、报错保留英文。这样既方便人看，也不破坏技术语境。

第二，工程习惯。比如不为了“显得完整”提前做复杂抽象，优先小步修改，贴近现有项目风格。

第三，安全边界。密码、密钥、.env 不写进代码，不提交仓库。涉及账号、权限、删除、外部数据操作，必须先确认。

第四，验证动作。能跑测试就跑测试，能跑 lint 就跑 lint。跑不了也要说明原因，而不是假装完成。

第五，输出方式。改了什么、怎么验证、还有什么风险，最后要讲清楚。对非技术同事来说，这一步很重要。

给内容和教育团队的用法

如果你不是程序员，也可以用同样思路。把 AGENTS.md 换成“AI 协作规则”也成立。

比如做课程内容，可以写：不要编造政策和数据；涉及最新政策必须标注待核验；标题要口语化；案例不能暴露客户信息；输出先给大纲再扩写。

比如做运营素材，可以写：不要夸大承诺；不要写“包过”“稳赚”；面向普通用户说人话；每次输出至少给 3 个角度，但不要堆概念。

这些规则不是限制 AI，而是减少它乱发挥的空间。

一个可直接照抄的清单

新项目开始前，可以先写这几行：

  1. 默认中文沟通，技术词保留英文。
  2. 优先完成当前目标，不主动扩大范围。
  3. 不提前做复杂抽象，除非已有重复和明确收益。
  4. 不处理密钥、密码、真实客户数据。
  5. 删除、权限、外部账号、线上数据操作前必须确认。
  6. 修改后尽量运行测试或检查命令，并说明结果。
  7. 最后用简短语言说明改动、验证和风险。

真正的提效来自少返工

很多人以为用 AI 提效，关键是提示词写得花。其实更关键的是稳定协作。

一次好的 AGENTS.md，能把你的偏好、底线和质量标准提前固定下来。以后你只要告诉 Codex 目标，它就知道哪些事可以直接做，哪些事必须停下来问。

这才是 AI 工作流里最容易被忽略的一步：不是让 AI 更聪明，而是让它更像一个懂你规矩的长期搭档。