AI 协作约定
本文档是 AI Agent（Hermes）与你协作时必须遵守的规则。它不是给我看的——它存在 wiki 里，是因为 wiki 本身是我的"操作手册"。任何一次新会话开始时，我都应该主动读这份文档。
1. 我的身份
我是 world-map 项目的协作者，不是旁观者。~/world-map/ 同时是：
- 你的知识库——你阅读、思考、决策的载体
- 我的协作记忆——我读什么、按什么结构写、什么时候该停下，都由这份 wiki 决定
这意味着我对 wiki 有写权限，但写入动作必须可追溯、可回滚。
2. 写权限的边界
| 我可以 | 我必须先问 |
|---|---|
| 在现有 group 下新增/修改文章 | 改变 L 层骨架（新增/合并/拆分 L 层） |
| 改 sidebar 文本/链接 | 改顶部 nav |
| 写"源典精读"笔记 | 删任何一篇已存在的文档 |
| 在 meta/ 下写演进日志 | 把多文档合并成单文档 |
| 提议骨架重构（写入 evolution-log） | 任何"破坏性"操作 |
"破坏性"的判定标准：任何会让 6 个月后的我（或你）打开 wiki 发现找不到某条曾经存在的笔记的操作。
3. 阅读流程（每本新书）
按你定的三层法：
1. AI 初读：提目录、核心论点、概念图谱
2. 你核对骨架、增删（这是哲学的"过滤"环节）
3. AI 按你定的优先级逐章精读 + 写 wiki
4. 遇到抽象概念用 browser-research skill 展开
5. 每章写完，wiki 验证 build 零死链
6. 下钻深度超 3 层 → 触发刹车，回退第 1 步的产物不是直接写进 wiki，而是先发给你看，结构是：
- 全书目录（章/节级）
- 核心论点（3–5 条，每条不超过一行）
- 概念图谱（mermaid mindmap 或 graph）
- 与本项目骨架的映射（"这本书的 X 对应我们 L1 的 Y"）
- 我建议的精读顺序 + 你可能要加进来的章节
第 3 步的草稿机制：
所有源典精读、跨 L 层大改、可能引发"破坏性操作"的内容，先写到 meta/ai-collaboration/drafts/：
meta/ai-collaboration/drafts/
ch01-introduction.md ← 草稿区（不计入正式 sidebar）
refactor-skeleton-L3.md ← 重构提案草稿
cross-L-mapping.md ← 跨层映射草稿
...草稿 → 正式：你审过后，AI 用 git mv 归位到目标路径，同一次 commit 完成"位置迁移 + 状态从 draft 变 mature"。
为什么需要草稿区：
- 源典精读容易写出"长内容"——直接 commit 进正式位置会污染骨架
- 草稿区是 AI 的"工作台"，正式位置是"陈列柜"——分工明确
- 草稿可以半途而废，不会留下"半成品"在正式 sidebar 让人误以为是成熟内容
草稿命名约定：
- 源典精读：
chXX-name.md（如ch01-introduction.md） - 重构提案：
refactor-<short-desc>.md - 跨层映射：
cross-<topic>.md - 其他：
draft-<short-desc>.md
草稿 commit 规范：
- 草稿入草稿区：
drafts(cybernetics): ch01 草稿（独立 commit，与正式内容分开） - 草稿归位：
feat(meta-source): ch01 归位 + 草稿删除（用git mv）
4. 骨架自举规则
骨架是演化的，不是预设的。触发条件：
| 触发 | 动作 |
|---|---|
| 新书精读发现新维度，现有 L 层装不下 | AI 提议新增/合并/拆分 L 层 → 写入 meta/evolution-log.md → 等用户审批 |
| 某篇文章长出来后发现属于一个不存在的"主题" | AI 在该 group 下新建 group → 写入 evolution-log → 通知用户 |
| 用户主动提出重构 | 直接执行 |
| 任何 L 层 sidebar 增删 | 直接执行，evolution-log 记一笔 |
核心约束：骨架重构不删旧文件。新结构上线后，旧文件以 _archive/ 前缀归档至少 30 天，让用户回查。
5. 内容质量约束
每篇写满的文档必须满足：
- 开头一句：用一句话说清这篇文档解决什么问题（不是"什么是 X"）
- 核心结构：表格优先于段落，mermaid 优先于纯文字
- 末尾"相关链接"：必填，链到本 L 层的相邻文档
- 置信度标注：转述的观点加
> 置信度：★★★★☆（来源 Vernon IDDD Ch.X），AI 自身推断标> 置信度：★★★☆☆（综合推断） - 不要写"什么不是"——只说"是什么"和"怎么做"
6. 刹车规则
下钻深度超过 3 层未到达"可操作的方法论" → 这个概念可能不是当前阶段该学的。
回退动作：
- 停止继续下钻
- 把当前下钻到的概念标记未完成写入 evolution-log
- 回退到上一层，询问用户："这个概念要不要单独成一篇（推迟处理）/ 暂时跳过（放弃）"
7. 构建验证
每次写完/改完文档：
bash
cd ~/world-map && npx vitepress build必须看到 build complete in X.XXs. 才算完成。出现 dead link → 立即修复。