用项目约定、共享实现与检查维护一致性,明确各类机制的适用边界。
Lesson 05 · 要打破的信念
AI 代码的一致性,只能靠反复人工评审。
用项目约定、共享实现和适当检查共同维护一致性。
时长
90 分钟
受众
已使用编码智能体,关注团队协作质量
现场演示
从仓库案例理解规则的用途
课后实践
写出可验证的项目约定
先理解,再演示,最后动手。按需展开,每次聚焦一节。
本课把项目约定称为“法典”;它不是 OpenAI Codex 产品的名称。
同一个项目可能出现多种命名方式、错误处理约定和重复工具函数。单看每次选择未必有错,但组合后会增加理解与维护成本。先识别哪些决定需要统一,再检查是否已有实现、约定或必要的例外。
把稳定约定写成可查阅的指引,并让组件、工具函数和检查规则共同落实。Codex 使用 AGENTS.md;Claude Code 使用 CLAUDE.md,也可从中导入 AGENTS.md。写入指引不等于强制执行:加载范围和更新时机取决于工具,遵守情况仍需核验。