6.3 本地提交流程：看改动、选范围、存档
面向经管学生、研究者与从业者的 AI 智能体设计教材
这一节把最基础、最常用、本章最重要的本地提交流程走一遍。读者先把这个流程熟练掌握，再接入分支和 Worktree，会更稳定。
最小提交路径
假设你刚让智能体改完一轮章节内容，现在准备把这一轮落成一个本地提交。对应的对话顺序是：
- 让 Claude Code 看当前改动范围
- 让它检查正文到底改了什么
- 让它挑出本次要提交的文件
- 让它再确认一次选定内容
- 让它形成新的提交点
在 Claude Code 中可以这样输入：
我修改了第 6 章的两节内容，帮我把这次改动存档。
请先看一下改动范围，然后只提交这两节的修改：
- chapters/chapter-6/section-6-1.qmd
- chapters/chapter-6/section-6-2.qmd
其他文件的改动先不要提交。提交前把选定内容列出来让我确认，备注用中文。Claude Code 会按顺序执行，并在提交前给出确认清单：
已检查改动，本次准备提交：
文件：
- section-6-1.qmd（+32 行 -4 行）
- section-6-2.qmd（+58 行 -12 行）
其余文件改动未纳入本次提交。
建议备注："docs: 重写第 6 章 6.1 和 6.2，建立对话化工作流"
确认提交吗？你确认后，它完成提交并回报存档编号。
如果改动范围很大，不要让 AI 把所有文件一次性提交。这会把附带修改、临时文件和无关调整一并送进历史。一次提交只对应一个明确目标，后续才容易审，也容易回退。
好备注 vs 坏备注
提交信息不需要复杂，但要让人看得出这次提交的目标。比较规范和比较随意的备注差别很大：
| 随意的备注 | 规范的备注 |
|---|---|
| “修改代码” | fix: 修正控制变量的滞后阶数（t-1 改为 t-2） |
| “更新论文” | feat: 添加稳健性检验（替换被解释变量度量） |
| “试一下” | exp: 实验 Probit 模型（当前 Logit 结果不显著） |
| “改了研报” | docs: 下调新能源评级至标配，依据补贴退坡预期 |
规范备注让你三个月后仍能看懂这次修改的目的。Claude Code 会自动生成规范备注，你可以随时要求修改：
备注改一下，重点是缺失值处理，异常值检测只是附带。一句纠正，备注立刻更新。
常用的前缀有四种：feat（新增功能）、fix（修复问题）、docs（文档改动）、exp（试验性改动）。类型加冒号加简短说明，就是一条合格的备注。
WIP：改到一半先存档
实证写作或研报撰写经常遇到这种情况：改了一半被叫去开会，或临时要切到别的任务。这时不要硬撑着改完再提交，而应该先把未完成的进度存档。
我正在重写实证部分，改了大约 60%，现在要先去开会。
帮我把当前进度存档，备注标明这是未完成的工作。Claude Code 会识别未完成的部分，生成带 WIP（Work In Progress，进行中）标记的备注：
检测到未完成的修改：
- paper.tex 实证部分重写约 60%
- 有 TODO 注释：补充内生性讨论
已存档，备注："WIP: 重写实证部分（60%），待补充内生性讨论"
存档编号：c3d4e5f
回来后可以说"继续修改论文"，我会定位到这个进度。这种习惯让你随时中断工作，回来时 Claude Code 会告诉你上次停在哪里。
小步提交
每次提交只包含一个明确目的的改动。提交越小，回退越精准，审阅越容易，出问题时排查范围也越窄。
| 场景 | 推荐做法 |
|---|---|
| 数据清洗改了三步 | 每完成一步存档一次 |
| 跑完基准回归和两组稳健性 | 每组结果各存一次 |
| 改引言又改文献综述 | 分两次提交 |
存档的成本是一句话的时间，不存档的成本可能是丢失半天工作。AI 协作中尤其如此——模型单轮改动范围往往较大，拆成多个小提交能有效控制风险。
提交后确认与本地回退
提交完成后不要立刻离开。让 Claude Code 展示最近几次存档，确认本次提交已经进入历史：
显示最近 5 次提交的简要记录，让我确认本次提交在里面。回退不是失败，而是工作流的一部分。本地回退有三种常见场景，全部可以用对话表达：
刚才的修改有问题，结果完全不对。
我要回到上一个稳定版本，但保留这次修改在历史里，方便以后查看。Claude Code 会给出回退方式选择：保留改动到工作区、完全丢弃、或创建一条回退记录。第三种最稳妥——既恢复了稳定状态，又保留了被撤销的改动痕迹。
真正重要的不是记住每一步，而是形成固定对话顺序：看现场 → 看改动 → 选定本次范围 → 存档 → 看历史 → 必要时回退。