第12篇：使用Git，把项目初始状态固化下来
为什么要做Git
Git 初始化只是建立了版本管理能力，但还没有真正形成基线。第一次提交的意义，是把当前已经确认的目录结构、控制文件、规则文件、索引文件和初步输出成果固定下来。以后 Codex 再生成或修改内容，你就能和这次初始状态对比，知道变化从哪里开始。
如何用Git
第一次提交不建议包含所有原始资料。更稳妥的做法是先提交项目总控文件、目录说明、AI 输出管理规则、初步诊断报告等文本型成果。
提交信息要写清楚，不要写“第一次”“更新一下”。建议写成“建立 Codex 工程管理 AI 工作仓初始基线”。
- 先执行 git status，确认有哪些新增文件
- 人工判断哪些文件应纳入第一次提交
- 优先添加 00_项目总控、90_Codex输出文件 中已经确认的文本文件
- 执行 git add 添加指定文件
- 执行 git commit，并写清楚提交说明
常用的命令
# 查看当前状态
git status
# 添加项目总控文件和 AI 输出管理规则等文本文件
git add 00_项目总控/PROJECT_CONTEXT.md
git add 00_项目总控/CODEX_RULES.md
git add 00_项目总控/MASTER_INDEX.md
git add 90_Codex输出文件/
# 提交初始基线
git commit -m “建立 Codex 工程管理 AI 工作仓初始基线”
# 查看提交记录
git log –oneline
给Codex的提示词
请根据当前 git status 结果，帮我判断本次是否适合进行第一次 Git 提交。
请只输出建议，不要执行任何命令。
判断要求：
1. 哪些文件适合作为初始基线提交；
2. 哪些文件不建议纳入第一次提交；
3. 是否存在原始资料、临时文件、大体积文件被误纳入的风险；
4. 推荐的提交说明文字；
5. 提交前还需要人工确认哪些事项。
注意事项和一些经验
- 第一次提交不是越多越好，而是要干净、清楚、可解释
- 不要把未确认资料和 AI 临时试错文件一起提交
- 提交信息要写明业务含义，不能只写 update
- 提交前最好再看一次 git status，确认没有误加文件
- 第一次提交的质量很重要。它相当于项目 AI 工作仓的“零号版本”。后续出问题时，你可以回到这个节点看最初状态
- 如果前期不小心把很多大文件加入了 Git，后面清理会比较麻烦。所以宁可第一次提交少一点，也不要把一堆不确定资料全部放进去
到这里的标准
- 已完成第一次 Git 提交
- 提交内容以控制文件、规则文件、索引文件和已确认的 AI 输出成果为主
- 提交说明清楚表达了业务节点
- 能够通过 git log –oneline 查看提交记录
