Git 工作流：把你的 LLM Wiki 当代码库维护

Git 工作流

LLM Wiki 是 Markdown 文件夹，所以它天然就是一个 Git repo。Git 不是程序员专属工具，在这里它是你的知识库安全带。

没有 Git 的 LLM Wiki，有一个风险：

Agent 改坏了，你不知道它改了哪里，也不知道怎么回去。

这篇解决这个问题。

---

先说结论

• 每次 ingest、query 写回、lint 修复后，都应该形成一次清晰 commit。
• Agent 每次结束必须汇报新增和更新文件，方便你看 diff。
• 大规模 lint 修复应该开 branch，不要直接改主线。
• 不要让 Agent 删除页面，先 archived，再人工决定。
• Git 让 LLM Wiki 从“AI 自动写笔记”变成“可审查的知识工程”。

---

1. 初始化 Git

在 Wiki 根目录：

git init
git add AGENTS.md index.md log.md raw wiki
git commit -m "init llm wiki structure"

如果你还没有内容，也可以先 commit 空结构。

这是一个回滚点。

---

2. 每次操作后的基本流程

一次 ingest 后：

git status
git diff
git add .
git commit -m "ingest karpathy llm wiki"

一次 query 写回后：

git status
git diff
git add .
git commit -m "add synthesis on llm wiki use cases"

一次 lint 修复后：

git status
git diff
git add .
git commit -m "fix wiki index and missing sources"

commit message 不需要华丽。

要清楚。

---

3. Agent 必须汇报修改文件

在 AGENTS.md 里写：

## 修改报告要求

每次操作结束时，必须输出：

### 新增

- 文件路径：一句话说明

### 更新

- 文件路径：一句话说明

### 建议人工检查

- 文件路径：原因

### 不应提交的内容

- 如果发现 raw 被误改、敏感信息、临时文件，必须提醒。

这样你看 git diff 时就有心理地图。

---

4. 如何审查 diff

4.1 先看文件列表

git status --short

你会看到：

A  wiki/sources/karpathy-llm-wiki.md
A  wiki/concepts/llm-wiki.md
M  index.md
M  log.md

检查：

• 有没有意外修改 raw；
• 有没有新建太多页面；
• 有没有改到 AGENTS.md；
• 有没有临时文件。

4.2 再看具体 diff

git diff

重点看：

• Agent 是否编造事实；
• 是否把推断写成事实；
• 是否删掉旧结论；
• 是否漏来源；
• index 和 log 是否同步。

---

5. 大改动要开 branch

比如 lint report 建议合并 20 个重复页面。

不要直接在主线做。

git checkout -b lint-2026-04-25

让 Agent 修：

请根据 lint report 修复 P1 重复概念问题。
当前在 branch lint-2026-04-25。
要求：
1. 不删除页面；
2. 旧页面改为指向主页面，并标记 archived；
3. 更新 index.md；
4. 追加 log.md。

审查后：

git diff main...lint-2026-04-25

确认没问题再合并。

---

6. 如何回滚错误

6.1 回滚未提交修改

如果 Agent 改坏了，但你还没 commit：

git status

如果确认要丢掉所有未提交修改：

git restore .

注意：这会丢修改。先看清楚。

6.2 回滚单个文件

git restore wiki/concepts/llm-wiki.md

6.3 回看历史版本

git log --oneline
git show <commit>:wiki/concepts/llm-wiki.md

这对知识库特别有用。

你可以看到某个概念是怎么演化的。

---

7. 不要轻易删除页面

Wiki 里删除比新增危险。

建议规则：

1. 先标记 archived；
2. 保留指向主页面的链接；
3. lint 确认没有重要入链；
4. 人工决定是否删除。

Archived 页面示例：

---
type: concept
status: archived
merged_into: wiki/concepts/llm-wiki.md
---

# Agent Maintained Wiki

> This page has been merged into [[wiki/concepts/llm-wiki]].

这样不会断链。

---

8. Git + log.md 的分工

很多人会问：

有 Git 了，为什么还要 log.md？

分工不同。

工具	解决什么
Git	文件级历史、diff、回滚
log.md	知识操作时间线、人类可读上下文

Git 记录：

M wiki/concepts/llm-wiki.md

log 记录：

## [2026-04-25] query | LLM Wiki vs RAG

- Created synthesis comparing LLM Wiki and RAG.
- Updated concept page with boundary conditions.

两者都需要。

---

9. 给 Agent 的 Git-aware prompt

在开始前，请先检查当前工作区状态。

要求：
1. 如果存在未提交修改，先列出，不要覆盖。
2. 本次只处理我指定的任务。
3. 修改结束后，列出新增和更新文件。
4. 不要运行 git commit，除非我明确要求。

为什么不让 Agent 自动 commit？

新手阶段最好自己 commit。

等你熟了，可以让 Agent 生成 commit message。

---

10. 推荐 commit message 风格

init llm wiki structure
ingest karpathy llm wiki
add concept pages for ingest query lint
add synthesis llm wiki vs rag
lint wiki index and missing sources
archive duplicate concept agent-maintained-wiki

格式：

<action> <object>

常用 action：

• init
• ingest
• add
• update
• lint
• archive
• fix

---

11. 练习

1. 在你的 Wiki 根目录运行 git init。
2. 提交初始结构。
3. ingest 一篇文章。
4. 查看 git status --short。
5. 查看 git diff。
6. 提交：

git add .
git commit -m "ingest karpathy llm wiki"

7. 让 Agent 做一次 query 写回。
8. 再看 diff。

---

小结

Git 让 LLM Wiki 有了工程纪律。

你可以：

• 看 Agent 改了什么；
• 回滚错误；
• 分支处理大改动；
• 审查知识演化；
• 保留长期历史。

没有 Git，LLM Wiki 很容易变成“AI 帮我写了一堆 Markdown”。

有 Git，它才像一个真正可维护的知识项目。

下一篇讲搜索：当 index.md 不够时怎么办。

---

参考资料

• Karpathy: LLM Wiki