Codex 协作规则
给 AI 写一套能执行的规则,说清事实源在哪、哪些操作要先确认、什么算做完。
自己长期在用的规则,随任务调整,没有对外版本。
项目规则每个项目一份规则文件,写清定位、目录约定和验收方式
→唯一事实源哪类信息以哪个目录为准写进规则,避免同一个事实存两份
→授权边界删除、推送和部署这类操作单独列出,动手之前先确认
它解决什么
让 AI 在真实项目里干活,容易出问题的地方往往不在写代码,而在它不知道边界:产物该写到哪个目录、哪个数字算真的、哪一步可以直接做。
每次重新解释一遍,成本高还容易漏。把这些写进文件,后面每个任务都从这个起点开始。
规则分几层
- 全局规则管沟通方式、任务判断和授权边界,对所有项目生效。
- 项目规则管这个项目的事实源、目录、命名和验收方式,更近的规则优先。
- 用户偏好单独一层,写作和表达任务开始前读取,可以被覆盖,不能动硬约束。
- 结论要区分已验证的事实、来源信息、推断和假设,猜测不写成结论。
事实源
同一个事实只维护一份,其它位置引用:
- 项目状态和交付物以对应项目目录为准。
- 稳定的判断和方法以知识库为准。
- 可执行的 Skill 以自管目录为准,工具里的入口只是链接。
- 代码以仓库为准。
- 个人背景资料单独存放,默认不对外。
什么算做完
规则里写明验证方式。构建通过、命令跑起来都算不到做完,要跑通实际路径,拿到可以给人看的结果,再说完成。
改动之后要说明改了什么、为什么、怎么验证,还有哪些风险留着。