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

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

作者

李学恒、林建浩、严翊歆

发布于

2026-05-11

场景如下：你正在用智能体写一份 A 股市场月度策略报告。项目已初始化，初稿在上周完成并提交。现在需要更新宏观数据、修正一处行业判断。这个案例展示日常推进中如何使用 Git——查看状态、比对差异、分步提交、发现错误后回退。

项目目录

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

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

配置文件

CLAUDE.md 里和 Git 相关的部分：

## Git 工作流

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

## 写作要求

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

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

用户操作

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

▶ Claude Code

先运行 git status 确认当前工作区干净。

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

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

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

两次提交都完成后，运行 git log --oneline -n 5 让我确认历史。

智能体会按顺序执行：git status → 修改数据 → git add → git commit → 修改判断 → git add → git commit → git log。两条提交各自独立，后续审阅时能分别确认。

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

▶ Claude Code

刚才对新能源板块评级的修改判断有误，补贴政策实际延续。
请用 git revert HEAD 撤销最近一次提交，然后把行业判断恢复为"维持超配"。

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

分步提交的回退优势

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

这个案例只用了 status、add、commit、log、revert 五个命令，覆盖了日常推进中最常见的操作链。每一步改动都有据可查，出错时能精准回退到正确的版本点。

--- title: "6.6 案例一：投资研报的 Git 管理" --- ![6.6 配图](images/img_06_case_report.png) 场景如下：你正在用智能体写一份 A 股市场月度策略报告。项目已初始化，初稿在上周完成并提交。现在需要更新宏观数据、修正一处行业判断。这个案例展示日常推进中如何使用 Git——查看状态、比对差异、分步提交、发现错误后回退。 ### 项目目录 ```txt a-share-monthly-202603/ ├── data/ # 原始数据 │ ├── 宏观数据_202603.xlsx │ └── 行业轮动数据.csv ├── drafts/ # 研报草稿（Git 跟踪） │ ├── 月度策略_v1.md │ └── 月度策略_v2.md ├── output/ # 终稿输出 └── CLAUDE.md ``` `data/` 放原始数据文件，`drafts/` 放各版本草稿，`output/` 放最终交付。Git 跟踪 `drafts/` 和 `CLAUDE.md`，大体量数据文件写进 `.gitignore`。 ### 配置文件 `CLAUDE.md` 里和 Git 相关的部分： ```txt ## Git 工作流 - 每次修改前先运行 git status，确认当前状态干净 - 数据更新和内容修改分开提交，不要混在一起 - 提交信息用中文，说明改了什么、为什么改 - 不确定的改动先开新分支试验，确认无误再合入主线 ## 写作要求 - 数据必须来自 data/ 中的文件，不可自行编造 - 修改行业判断时，在提交信息里注明修改依据 ``` 这份规则让智能体在每轮操作中自动遵守分步提交和清晰记录的习惯。 ### 用户操作项目已经有了初稿提交。现在要做两件事：更新宏观数据部分，修正一处对新能源板块的判断。在 Claude Code 中输入： ```opencode 先运行 git status 确认当前工作区干净。然后做两步修改，分开提交：第一步：打开 drafts/月度策略_v2.md，把宏观经济部分的 GDP 增速和 CPI 数据更新为 data/宏观数据_202603.xlsx 中的最新值。改完后单独提交，提交信息写"更新 3 月宏观数据：GDP 增速和 CPI"。第二步：把第三节"行业轮动建议"中对新能源板块的判断从"维持超配" 改为"下调至标配"，理由是补贴退坡预期。改完后单独提交，提交信息写"下调新能源板块评级至标配，依据补贴退坡预期"。两次提交都完成后，运行 git log --oneline -n 5 让我确认历史。 ``` 智能体会按顺序执行：`git status` → 修改数据 → `git add` → `git commit` → 修改判断 → `git add` → `git commit` → `git log`。两条提交各自独立，后续审阅时能分别确认。如果提交后发现新能源板块的修改有误——比如补贴政策实际上延续了——可以继续输入： ```opencode 刚才对新能源板块评级的修改判断有误，补贴政策实际延续。请用 git revert HEAD 撤销最近一次提交，然后把行业判断恢复为"维持超配"。 ``` 因为数据更新和内容修改分开提交了，回退只影响第二条提交，宏观数据的更新完好保留。 ::: {.callout-tip} ## 分步提交的回退优势数据更新和内容修改分开提交后，回退只影响单条提交。如果混在一起，撤销判断修改的同时会丢失数据更新。 ::: 这个案例只用了 `status`、`add`、`commit`、`log`、`revert` 五个命令，覆盖了日常推进中最常见的操作链。每一步改动都有据可查，出错时能精准回退到正确的版本点。