如何让 Codex 不断进化?用项目复盘沉淀你的专属规则
Codex 用久以后,真正拉开差距的不是某一句神奇 Prompt,而是你有没有把每次合作中的经验沉淀下来。
比如:
- 哪些指令容易让 Codex 误解
- 哪些执行方式导致它改错文件
- 你更喜欢什么样的 UI 风格
- 你希望它遇到不确定问题时怎么处理
- 哪些规则应该写进 AGENTS.md,变成下一次工作的默认约束
如果这些经验只留在聊天记录里,下一次开新项目时还要重新解释。
更好的做法,是让 Codex 定期复盘当前项目的对话记录、执行日志和修改过程,把经验整理成可复用文档。
可复制 Prompt
下面这段适合在一个已经积累了多轮对话和执行记录的项目里使用。
因为它包含多个目标和输出结构,所以使用长 Prompt 格式。
Prompt
阅读并检索我们本项目所有的 Codex 对话记录与执行日志,进行系统性复盘,提炼出可复用的经验文档。
文档需要涵盖以下内容:
一、执行经验总结:记录哪些做法导致了问题、最终正确的执行方式是什么,以及从中得出的教训。
二、我的偏好与理念提炼:从对话中识别并归纳我的 UI 设计偏好、产品设计理念、交互原则等,形成结构化的个人风格档案。
三、可复用规则清单:将上述内容整理为 Codex 未来可直接遵循的行为准则,保存为md。
如果你只是想先快速看结果,也可以让 Codex 直接在对话里输出。
但如果这是一个长期项目,建议保存成文件,后续可以继续迭代。
如果你愿意进一步工程化,可以把其中一部分内容写进:
AGENTS.md- 项目规范文档
- 个人工作流说明
- Skill 说明文件
- 项目复盘记录
操作步骤
第 1 步:让 Codex 先确认可读取范围
不要一上来就让它总结全部经验。
先让它确认自己能看到哪些记录。
Prompt
请先检查当前项目里有哪些可用于复盘的对话记录、执行日志、工作记录或修改记录。只列出文件路径和内容类型,不要开始总结。
这样做的好处是,你能先确认它不会把无关文件也纳入分析。
第 2 步:让 Codex 做系统复盘
确认范围后,再使用上面的长 Prompt。
如果项目记录很多,可以让它分阶段处理:
- 先看最近一次项目。
- 再看同类任务。
- 最后总结跨项目规则。
第 3 步:检查它有没有编造偏好
复盘最容易出现的问题,是 Codex 把一次偶然选择总结成“你的长期偏好”。
所以你要重点检查:
- 它有没有引用具体证据
- 它有没有把单次反馈放大成长期规则
- 它有没有把自己的判断当成你的偏好
- 它有没有把项目限制误认为个人审美
如果证据不足,就让它降级表达。
Prompt
请把刚才总结里的每条个人偏好都标注证据来源。如果只有一次证据,请标为「弱证据」;如果没有明确证据,请移到「待确认」。
第 4 步:把稳定规则写进 AGENTS.md
不是所有复盘内容都适合写进 AGENTS.md。
适合写进去的是长期稳定、反复适用、能直接指导 Codex 行为的规则。
比如:
- 不要删除或重命名已有 Markdown 文件
- 新文章文件名使用英文短横线
- Prompt 很长时使用
::: prompt-long 长 Prompt - 修改前先确认当前目录和已有文件
- 构建失败时先区分本次改动和历史遗留问题
不适合写进去的是临时偏好、一次性任务安排、还没有确认的推测。
第 5 步:定期复盘,而不是每天复盘
复盘不需要太频繁。
建议在这些节点做:
- 一个项目完成后
- 连续出现同类错误后
- 站点规范发生变化后
- 你明显调整了设计偏好后
- 新增一批文章、插件或 Skill 后
太频繁会浪费时间,也容易把还没稳定的想法写成规则。
进阶用法:让 Codex 输出 AGENTS.md 更新建议
如果你已经有 AGENTS.md,可以让 Codex 不直接修改,而是先给出更新建议。
::: prompt-long 长 Prompt 请基于刚才的复盘结果,生成一份 AGENTS.md 更新建议。
要求:
- 不要直接修改 AGENTS.md
- 只列出建议新增、建议调整、建议删除的规则
- 每条建议说明原因
- 每条建议标注优先级:高、中、低
- 如果某条规则证据不足,请放到「待确认」
- 不要把一次性任务写成长期规则 :::
这样更稳妥。
你可以先人工确认,再决定是否写入 AGENTS.md。
常见问题
Codex 能不能自动记住所有经验?
不能完全依赖它自动记住。
更可靠的方式,是把重要经验写成明确文档,放在项目里。这样下一次 Codex 工作前可以读取,不需要只靠聊天上下文。
所有偏好都要写进 AGENTS.md 吗?
不需要。
AGENTS.md 更适合放长期规则。个人审美、内容风格、设计理念可以单独放在偏好档案里,需要时再让 Codex 读取。
如果 Codex 总结错了怎么办?
让它回到证据。
可以要求它为每条总结标注来源、置信度和适用范围。没有证据的内容不要写成规则。
复盘会不会消耗很多额度?
会。
如果项目日志很多,建议分批复盘。先复盘最近一次任务,再逐步扩展到整个项目。不要一次让 Codex 读取所有大文件。
留言
元芳,你怎么看?