第 13 章：项目指引与定制——让规则看得见、改得了

你有没有遇过：今天已经说过“不要改这个文件”，下次新开任务又得重说一遍？解决办法不是期待 AI 自动越来越懂你，而是把真正重要的规则写在大家都找得到的地方。

本章目标：学会把个人和项目规则分层写清楚，让 Codex 每次协作都有可检查的依据。

---

13.1 先分清“这次交代”和“长期规则”

一段对话里的要求，只适合这一次任务；换新任务后，不应假定它仍然有效。长期规则则应该放进项目中的说明文件，方便你、同事和 AI 一起查看、修改和追溯。

可以把规则分成四层：

放在哪里	适合写什么	例子
当前任务	本次目标与限制	“只改首页文案，不部署”
AGENTS.md	团队长期协作规则	“改前先检查，改后列出验证方式”
项目配置	已获团队确认的工具设置	沙箱、模型或连接器等设置
SKILL.md	某一种稳定流程	“每周检查周报缺项”

你不需要一开始全都使用。对普通读者来说，先写好当前任务和一份简单的 AGENTS.md 就够了。

13.2 AGENTS.md 是什么？

把它理解成放在项目文件夹里的“新同事入职说明”。它不是代码，打开普通文本编辑器就能写。下面是一份很小但有用的示例：

# 本项目协作说明

## 修改前
- 先阅读 README.md 和现有文件，不要凭猜测重写。
- 不处理与当前任务无关的文件。

## 修改时
- 先说明准备改什么；涉及删除、发布或账号时等待人工确认。

## 修改后
- 列出改动的文件和验证方法。
- 不确定的地方明确说出来。

把它保存到项目根目录后，之后每次让 Codex 处理这个项目，都可以在任务里提醒：请先阅读 AGENTS.md，再开始。

13.3 怎样写出真正有用的偏好？

不要写“请写得更好”“按我的习惯来”这种模糊话。把习惯改成可检查的句子：

• 不说“注意安全”，说“不要读取 .env，不要在回复中展示密钥”。
• 不说“改得保守一点”，说“只修改 docs/ 目录，其他文件先列计划”。
• 不说“写得易懂”，说“第一次出现术语时用一句大白话解释”。

规则越具体，越容易发现是否被遵守；规则也应随项目变化而更新，而不是永远不动。

13.4 敏感信息不要写进规则文件

项目说明、Skill 和配置文件可能被同事看到或提交到版本库。不要在里面写密码、验证码、真实令牌、客户名单、身份证信息或私人账号资料。需要连接外部服务时，按当前界面的授权流程处理，并只给本次任务需要的权限。

如果你在共享电脑或共享项目中工作，结束后检查：是否登录在正确账号、是否留下不该共享的文件、是否仍有不需要的外部授权。不要依赖某个“自动清空记忆”的命令来解决隐私问题。

13.5 一次小练习

在 codex-practice 中新建一个 AGENTS.md，只写三条：只读练习文件、不要删除、完成后说明看到了什么。然后发送：

请先阅读 AGENTS.md 和 README.md。
只用三句话说明：本项目的规则是什么、README 写了什么、你接下来不会做什么。
不要修改文件。

打开两个原文件对照答案。这个练习让你知道：规则不是“隐藏记忆”，而是一份可以亲自检查的共同说明。

本章小结

可靠的定制来自可见规则：本次任务写在提示词里，长期项目规则写在 AGENTS.md，重复流程写在 SKILL.md。这样即使换设备、换同事或换界面，工作方法也不会丢。

下一步

继续阅读第 14 章：日常资料整理与写作辅助，把这些边界用到具体任务中。