接入项目时,先整理约定、阶段目标和验收方式
官方 Cookbook 用一个小项目展示如何保存项目规则与分阶段记录,让后续开发有明确的上下文。
- 原厂发布
- 2026-08-03
- 中文整理
- 2026-10-30
项目说明要能指导下一步
官方 Cookbook 建议把仓库目的、代码习惯、测试标准和工作边界整理成持久说明;较长任务再按阶段记录目标、所需材料与验收条件。AGENTS.md 是 Codex 识别的约定文件,示例里的其他文件结构可以按项目取舍。
避免一开始就堆很多文档
搭一套建议先回答四件事:这次改什么、代码放哪里、哪些部分暂时不动、怎样判断完成。小型静态网站可以从一份简短说明开始;当任务变长,再补充阶段记录和关键决定。
- 保留实际可用的启动与检查方法。
- 用可观察的结果描述验收条件。
- 阶段结束时记录已完成项、已知限制和后续入口。
这些内容是为了让项目更容易接续维护。文档数量不是交付质量,只有能与实际文件和检查结果对应的约定,才适合继续保留。
原始资料
搭一套依据官方资料整理中文摘要与应用说明。具体功能以原厂当前版本及账号显示为准。

Codex