6.6 案例一：投资研报的 Git 管理

面向经管学生、研究者与从业者的 AI 智能体设计教材

6.6 配图

场景如下：你正在用智能体写一份 A 股市场月度策略报告。项目已初始化，初稿在上周完成并存档。现在需要更新宏观数据、修正一处行业判断。这个案例展示日常推进中如何用对话做版本管理。

项目目录

a-share-monthly-202603/
├── data/                        # 原始数据（写入 .gitignore）
│   ├── 宏观数据_202603.xlsx
│   └── 行业轮动数据.csv
├── drafts/                      # 研报草稿（Git 跟踪）
│   ├── 月度策略_v1.md
│   └── 月度策略_v2.md
├── output/                      # 终稿输出
└── CLAUDE.md

data/ 放原始数据文件，drafts/ 放各版本草稿，output/ 放最终交付。Git 跟踪 drafts/ 和 CLAUDE.md，大体量数据文件写入忽略规则。

配置文件

CLAUDE.md 里和版本管理相关的部分：

## Git 工作流

- 每次修改前先确认当前工作区干净
- 数据更新和内容修改分开提交，不要混在一起
- 提交信息用中文，说明改了什么、为什么改
- 不确定的改动先开新分支试验，确认无误再合入主线

## 写作要求

- 数据必须来自 data/ 中的文件，不可自行编造
- 修改行业判断时，在提交信息里注明修改依据

这份规则让智能体在每轮操作中自动遵守分步提交和清晰记录的习惯。

用户操作

项目已经有了初稿存档。现在要做两件事：更新宏观数据部分，修正一处对新能源板块的判断。在 Claude Code 中输入：

▶ Claude Code

先确认当前工作区干净。

然后做两步修改，分开提交：

第一步：打开 drafts/月度策略_v2.md，把宏观经济部分的 GDP 增速和 CPI 数据
更新为 data/宏观数据_202603.xlsx 中的最新值。改完后单独提交，
备注写"更新 3 月宏观数据：GDP 增速和 CPI"。

第二步：把第三节"行业轮动建议"中对新能源板块的判断从"维持超配"
改为"下调至标配"，理由是补贴退坡预期。改完后单独提交，
备注写"下调新能源板块评级至标配，依据补贴退坡预期"。

两次提交都完成后，显示最近 5 次存档记录让我确认。

智能体会按顺序执行：确认状态 → 修改数据 → 选定范围 → 存档 → 修改判断 → 选定范围 → 存档 → 展示历史。两次提交各自独立，后续审阅时能分别确认。

如果提交后发现新能源板块的修改有误——比如补贴政策实际上延续了——可以继续输入：

▶ Claude Code

刚才对新能源板块评级的修改判断有误，补贴政策实际延续。
请撤销最近一次提交，但保留这次撤销在历史里，备注写"撤销新能源评级下调：补贴政策延续"。
然后把行业判断恢复为"维持超配"，重新提交。

因为数据更新和内容修改分开提交了，撤销只影响第二条提交，宏观数据的更新完好保留。

分步提交的回退优势

数据更新和内容修改分开提交后，回退只影响单条提交。如果混在一起，撤销判断修改的同时会丢失数据更新。

这个案例覆盖了日常推进中最常见的操作链：看状态、分步提交、查看历史、精准回退。每一步改动都有据可查，出现错误时能精准回到正确的版本点。