知识库 / 笔记

五个 AI 共用一个知识库的规则

工作区与知识库怎么分工、开工与收工协议、并行比稿、子文件夹规范

知识库规则（Claude Code / Claude Cowork / Codex / DeepSeek Harness 共同遵守）

本文件是四个 AI 工具共用的契约。任何工具在任何文件夹里开工，只要任务涉及本库的主题，都按这里执行。 本库位置：~/Documents/我的知识库/（同时是 Obsidian 库）。

1. 工作区 与 知识库 是两回事

工作区（各工具各干各的）                         知识库（共用一份）
─────────────────────────────                  ─────────────────────────
claude code new/卓望/      ← Claude Code 草稿     ┐
CODEX项目/拓维卓望/        ← Codex 草稿           ├─ 收工写入 ─▶ 我的知识库/
deepseek harness/          ← DSH 草稿             │                 ├── INDEX.md   ← 路由表
我的知识库/_草稿-cowork/   ← Cowork 草稿(git忽略) ┘                 ├── 卓望工作相关/
                                    ▲                              ├── 求职相关/
                                    └──── 开工先读 ─────────────────┴── …各主题/

2. 什么该进知识库（沉淀清单）

进 不进
用户确认过的业务规则、偏好、边界 未确认的猜测、讨论过程
项目总结、复盘、踩坑经验 中间版草稿、比稿的落选版
进度到哪一步、下一步是什么 一次性素材、临时数据
定稿交付物（复制一份，文件名带「定稿」） 脚本、venv、node_modules、二进制工具
稳定的流程 / SOP / 检查清单 账号、密码、密钥、Token（任何情况都不进）

3. 开工协议（每个工具、每次任务）

  1. 读本库 INDEX.md，找到任务对应的主题子文件夹。
  2. 读该主题的 主档（主题名.md）和 进度（进度.md，如有）。
  3. 主题有自己的 流程/（如卓望），按其 INDEX.md 路由到具体流程文件。
  4. 没有对应主题 → 告诉用户「知识库里没有这个主题的记录」，问是否新建子文件夹。
  5. 读完才能开始产出。不得跳过。

4. 收工协议 —— 必须主动提醒用户（用户自己可能判断不了）

每次任务结束前，工具必须输出一段「知识库沉淀提醒」，格式固定：

📥 知识库沉淀提醒
本次任务产生了以下可能需要共享的内容：
1. [结论/规则] ……  → 建议写入 `主题/主档.md` 的「xx」节
2. [进度]       ……  → 建议更新 `主题/进度.md`
3. [定稿]       ……  → 建议复制到 `主题/交付物/xxx-定稿.html`
4. [经验/坑]    ……  → 建议写入 `主题/主档.md` 的「经验」节
5. [上站]       ……  → 适合放到个人主页 cosmoswong.com 的哪个板块（作品集/工具箱/旅游/健身/收藏）
（没有的项写「无」）
要我现在写入吗？（是 / 只写第 N 项 / 都不写）

判断触发的标准（有一条就要提）：

用户回复后再写入；写入时修订原条目而非堆叠，与现有规则冲突则保留最新确认结论并注明替代关系。 纯问答、闲聊、没有任何新结论的任务：提醒可以简化为一句「本次无需沉淀」。

5. 并行比稿规则

用户经常让多个工具各做一版来对比。规则：

6. 子文件夹规范（防乱）

每个主题一个子文件夹，结构统一：

主题名/
├── 主题名.md     ← 主档：稳定知识、规则、偏好、经验（必有）
├── 进度.md       ← 做到哪了、下一步（有进行中的项目才建）
├── 流程/         ← 该主题专属 SOP（需要时才建，入口 INDEX.md）
└── 交付物/       ← 定稿成品（需要时才建）

7. Git 与备份

8. 冲突优先级

用户当前明确指令 > 本库主档 > 任何工具自己的记忆 / 历史材料 / 其他副本。

9. ChatGPT 网页版（通过 GitHub 插件读仓库）

ChatGPT 没有文件系统，读不到本地；但 GitHub 插件已连接（2026-09-15 验证能读私有仓库 my-knowledge-base），所以它读的是 GitHub 上最后一次 push 的版本，不再需要手动上传快照。

✅ 2026-09-20 已核实（本条取代上面的疑问）：ChatGPT 的 GitHub 连接器可用，读的是仓库最新版。实测两处：① 「我的知识库」Project 答出 INDEX 的 7 个主题（含当天新建的「网络内容收藏」）；② 「卓望」Project 直接引用当天提交 a66d0d3。因此：新版指令（见 给ChatGPT的Project指令.md §二/§三）已生效，旧的「手动上传快照」指令已停用；Project「文件 / Files」里的旧快照应清理，避免两份并存；「收工必 push」依然是 ChatGPT 能看到新内容的唯一前提。

10. 四工具是怎么「自动知道」本库存在的（同步自查）

各工具能自动遵守本库规则，靠的是写在全局入口文件里的几行话，不是靠记忆。改动这些文件前先看本表：

工具 全局入口（自动读，不在本库内） 说明
DeepSeek Harness ~/.dsh-rc9-clean/memory/知识库规则.md 全局记忆，每次会话开头自动注入
Claude Code / Claude Cowork ~/.claude/CLAUDE.md 用户级规则，Claude 启动自动读
Codex ~/.codex/AGENTS.md 中的「个人知识库（四工具共用）」段 Codex 自己的全局规则文件，该段与上面两份同源
ChatGPT 网页版 无本地入口，只读 GitHub 只能看到最后一次 push 的版本，且写不了仓库

铁律：

同步自查（只读，随时可跑）

for d in "$HOME/Documents/我的知识库" "$HOME/Documents/我的知识库/卓望工作相关/卓望"; do
  echo "--- $d"
  git -C "$d" status -sb | head -1
  echo "未提交文件数: $(git -C "$d" status --porcelain | wc -l | tr -d ' ')"
  l=$(git -C "$d" rev-parse HEAD); r=$(git -C "$d" ls-remote origin main 2>/dev/null | cut -f1)
  [ "$l" = "$r" ] && echo "与 GitHub 一致: $l" || echo "⚠️ 不一致 本地=$l 远程=$r"
done
diff -q "$HOME/.dsh-rc9-clean/memory/知识库规则.md" "$HOME/.claude/CLAUDE.md" \
  && echo "两份全局规则一致" || echo "⚠️ 两份全局规则不一致"

判断标准：两个库都显示「与 GitHub 一致」+「未提交文件数: 0」，且两份全局规则一致 → 四个工具看到的是同一份最新内容；任何一条不满足，先修它再开工/收工。

11. 状态一致性：谁做完谁回写（跨 AI 看板自愈）

要解决的问题（真实发生过）：某个工具（如 Claude）把一件事做完并交付了，但它没有回写 进度.md；于是另外几个工具（Codex／DSH／ChatGPT）下次开工还看到「进行中」或「断的」，重复劳动、或基于过时前提推进。

规则：

  1. 完成即回写，不要等「收工」：任务一旦完成、交付、或被用户确认，就由实际完成它的那个工具立刻更新对应 进度.md 的那一条（状态／下一步／最近经手／更新日期），然后 commit + push。
  2. 本地 commit ≠ 别人知道：连不上 GitHub 的工具（如 Cowork）必须明确写出「本机已 commit、待 push」，交由 Claude Code / Codex / 用户执行 push。
  3. 只写状态，不写流水账：看板写「现在什么状态 + 下一步可执行动作」；过程、草稿留在各自工作区。
  4. 发现不一致，任何工具都可当场更正：同一份文件前后矛盾时（例：前面写「已选定某方案」，后面还写「待对比选一版」），以时间较新的结论为准；更正时在差异处注明「谁在何时更正」，不必等原作者。
  5. 同一时刻只由一方写入（配合第 5 条并行比稿规则），避免互相覆盖；有未提交改动或冲突时先停下报用户。
  6. 判断标准（与卓望看板一致）：「如果另一个工具明天开工不知道这件事，会不会做错？」会 → 必须回写。

闭环范例（2026-09-20 实跑通过）：ChatGPT 读公开仓库 → 发现 4 处看板与事实不符（旧口径未更新、已完成未回写、已交付未归位、上线状态过期）→ 报给用户 → 用户拍板 → DSH 单独写入并 push → 下一轮 ChatGPT 读到修正版。 职责分工：读的人负责发现，干活的人负责回写，用户负责拍板。

用户可复用的一句话（直接触发回写）：

「这件事已经完成／我已经交付了，请把进展回写到知识库对应的 进度.md，并 push。」

⭐ 最简触发词（用户不用保存、不用背长句）：用户对任何工具说「同步一下」／「回写进度」／「这事做完了」／「我已经交付了」中任意一句，即等于下达「回写」指令 → 立刻执行上文流程（写 进度.md + commit + push），不得只口头答应。

补充：各工具的会话日志在本机可读（方法见 个人学习ai 相关/进度.md），可用来核对「对方到底做到哪了」；但日志只是过程，权威状态仍以 进度.md 为准。

12. 各工具的「全局启动规则」正文（可复制，防丢失）

本库能做到"AI 一开工就知道有知识库"，靠的是每个工具安装目录里的一份全局规则文件（位置见第 10 条）。这份文件不在 git 里（属于各工具本机配置），因此把正文抄在这里存档：换电脑、装新工具、或某份被改坏时，照下面整段复制即可恢复。

三处内容必须完全一致（2026-09-20 起为下列 4 条）：

工具 安装位置
Claude Code / Claude Cowork ~/.claude/CLAUDE.md
DeepSeek Harness ~/.dsh-rc9-clean/memory/知识库规则.md
Codex ~/.codex/AGENTS.md 里的「个人知识库（四工具共用）」那一段 
# 个人知识库（四工具共用）

- 位置：`~/Documents/我的知识库/`
- 任务涉及知识库里的任何主题（卓望/咪咕/福利中心、求职/简历、Claude 搭建、DSH/AI 工具，或用户提到"知识库""之前做过"）时：
  1. **开工先读** `知识库规则.md` → `INDEX.md` → 对应主题主档与 `进度.md`，读完再动手。
  2. **收工前必须输出「📥 知识库沉淀提醒」**（格式见 `知识库规则.md` 第 4 节），列出本次可沉淀的结论/进度/定稿/经验，问用户是否写入。用户自己判断不了什么该共享，这一步不能省。
  3. 草稿、比稿版本留在当前工作区；只把用户确认的结论和定稿写进知识库。
  4. **做完／交付就要回写，不要等收工**：本次推进了某个项目，就立刻把状态写进对应 `进度.md` 并 push —— 否则其他工具看到的还是旧状态、还以为这事没做完。**谁做完谁回写**（见 `知识库规则.md` 第 11 节）。
  5. **听到这些词就直接执行回写**：用户说「**同步一下**」「**回写进度**」「**这事做完了**」「**我已经交付了**」中任意一句时，立刻执行第 4 条（把当前进展回写到对应 `进度.md` + commit + push），不要追问、不要只口头答应。
- 知识库里没有对应主题 → 告诉用户并问是否新建子文件夹（按规则第 6 节结构），新建后登记 `INDEX.md`。

改动任一处后，用 diff 核对三处是否一致（第 10 条的自查命令已含 Claude↔DSH 这一对）。

13. 上传内容的标题与说明语言

本规则适用于 ChatGPT、Claude Cowork、Claude Code、Codex、DeepSeek Harness，以及后续接入本知识库的其他 AI 工具。