Initial commit: company-kb framework

- 完整的知识库框架（P0-P5 路线图）
- 12篇治理文档
- 工具脚本（kb-init.sh, kb-lint-fm.py, feishu-sync.py, kb-bot）
- 7个 Claude 命令
- 示例项目和测试项目（wanniu-l1）
- 契约文件（meta/kb-contract.yaml）

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

docs/05-路线图.md

@@ -0,0 +1,122 @@
+# 05 · 路线图
+
+> P0→P5 分阶段作战图。每阶段可独立交付/验收/止步；**后阶段是生长而非重做**。frontmatter/type 契约从 P0 到 P5 稳定不变。
+> 反过度工程铁律：编译层、向量库按**信号触发**延后，不预建。
+
+---
+
+## 阶段总览
+
+| 阶段 | 目标（一句） | 进入下阶段信号 |
+|---|---|---|
+| **P0 骨架+规范** | 定死唯一真相源物理形态 + 录入契约 + 命令雏形 | 任一成员照规范建合规文档、`/kb-check` 通过、CC 能读到并引用 |
+| **P1 首个项目闭环** | 一个在跑项目资料全汇入、CC 可溯源问答 | 该项目问答稳定、同事认可价值，产生复制到第 2/3 个项目的需求 |
+| **P2 多项目+飞书导入** | 扩到多项目 + `feishu-pull.py` 半自动增量导入 | 项目数 ≥3、飞书成主要文档源、公司级非项目知识无处安放 |
+| **P3 全公司领域+Obsidian 成熟** | 加 `company/`/`domains/` 分区 + Obsidian 编辑成团队习惯 | 库覆盖主要知识、录入成习惯，产生「让 AI 主动编译/问答/喂 agent」需求 |
+| **P4 处理层/编译+下游 agent** | 启用 llm-wiki 全量编译 + 下游 agent 消费接口 | **信号触发点：`_index` 首读定位失效 + 摄入悖论显现** |
+| **P5 规模化（向量库）** | 向量库仅当**导航层**替代 index.md，编译层零改动 | 终态 |
+
+---
+
+## P0 · 骨架 + 规范
+
+**目标**：定死唯一真相源物理形态 + 录入契约 + 命令雏形。
+
+**交付物**：
+- 目录骨架（`projects/` `entities/` `concepts/` `questions/` `meta/` `tools/` `.claude/commands/`）+ `.gitignore`。
+- `meta/kb-contract.yaml`（机器可读契约：types 数组含 active/reserved 标记 + 字段必填矩阵 + status/source enum）。
+- `CONVENTIONS.md` + `CLAUDE.md`（项目级）+ `docs/04~07`。
+- `tools/kb-init.sh` + `tools/kb-lint-fm.py`。
+- `projects/_example/`（OKF 完整示例，照抄即合规）。
+- `.claude/commands/`（`/kb-new` `/kb-ingest` `/kb-ask` `/kb-save` `/kb-check` `/kb-status`）。
+
+**验收**：任一成员照规范建一页合规文档 → `/kb-check` 通过 → CC `cd` 进目录能读到并在回答中引用（带 source_link）。
+
+**止步点**：若只需「可溯源 markdown + CC 检索」，停在 P0/P1 完全合理。
+
+---
+
+## P1 · 首个项目闭环
+
+**目标**：把一个在跑项目的资料全部汇入，CC 能可溯源回答「进展如何 / 为何这么定 / 需求方要什么」。
+
+**交付物**：
+- 选一个真实在跑项目 → `/kb-new <代号>` 建骨架。
+- 全部相关资料（决策/聊天/文档）汇入，frontmatter 合规。
+- CC 问答稳定，每条结论挂 `source_link`。
+
+**验收**：该项目三类问题（进展 / 决策依据 / 需求）问答稳定准确，同事认可价值。
+
+**进入 P2 信号**：产生「复制到第 2/3 个项目」的需求。
+
+---
+
+## P2 · 多项目 + 飞书导入
+
+**目标**：扩到多项目 + `feishu-pull.py` 半自动增量导入。
+
+**交付物**：
+- 复制 P1 模式到 ≥3 个项目。
+- `tools/feishu-pull.py` 上线，半自动单向导出飞书文档到 `projects/*/docs/`，AI 自动补 frontmatter。
+- `meta/ingest-manifest.json` 台账记录 hash 去重。
+- **飞书双向前端**（见 `docs/08`）：
+  - 群机器人能问能答（`tools/kb-bot/`，长连接无公网）：群 @机器人 → `/kb-ask` → 带溯源回复。
+  - 飞书呈现双载体（`tools/feishu-render.py`）：云文档（叙事）+ 多维表格 Bitable（结构，可筛选/看板）。
+- NAS 投递区扫描（`tools/nas-pull.py`，编译链接模式）。
+
+**验收**：飞书成为主要文档源；群里 @机器人 问答稳定带溯源；多维表格全库总览可用。
+
+**进入 P3 信号**：项目数 ≥3、飞书成主要文档源、**公司级非项目知识无处安放**。
+
+---
+
+## P3 · 全公司领域 + Obsidian 成熟
+
+**目标**：加 `company/`/`domains/` 分区 + Obsidian 编辑成团队习惯。
+
+**交付物**：
+- 新增公司级分区（`company/`/`domains/`），承接非项目知识。
+- 视需要激活 `entity`/`concept` type 并建目录。
+- Obsidian 成为团队日常编辑器，`docs/obsidian-setup.md` 插件清单落地（Dataview 等）。
+
+**验收**：库覆盖主要知识、录入成习惯。
+
+**进入 P4 信号**：产生「让 AI 主动编译/问答/喂 agent」的需求。
+
+---
+
+## P4 · 处理层 / 编译 + 下游 agent
+
+**目标**：启用 llm-wiki 全量编译（生成互链 wiki + hot/index）+ 下游 agent 消费接口。
+
+**交付物**：
+- llm-wiki 全量 raw→wiki 编译层启用，产物由**单一执行者**生成并提交（`wiki/`/`hot.md`/`index.md` 仍 gitignore 或按约定提交，避免并发冲突）。
+- 下游 agent 消费接口（frontmatter 过滤 + CC 子 agent）。
+
+**验收**：编译产物可用，下游 agent 能按 `type`/`status` 过滤消费。
+
+**★ 信号触发点**：`_index` 首读定位失效 + 摄入悖论显现——**在此之前坚决不启用全量编译**。
+
+---
+
+## P5 · 规模化（向量库）
+
+**目标**：向量库仅当**导航层**替代 `index.md`，卡帕西编译层与 type 契约原样保留。
+
+**★ P5 向量库红线（唯一硬触发点）**：
+> `~100 源 / 几百页` **且** 出现 `index 首读定位不准` / `摄入悖论`。
+> 在此之前——**任何「要不要上 RAG」的默认答案是「不」**。
+
+**交付物**：
+- 向量库只做「找到相关页」的导航层，替代 `index.md` 首读定位。
+- 编译层零改动，type 契约原样保留。
+
+**验收**：向量库导航准确率优于 index.md 首读定位，且未触碰 frontmatter/type 契约。
+
+---
+
+## 生长机制（预留，不落地）
+
+生长机制降为**预留接口说明**，不落地 `/kb-grow` 命令与监控脚本：
+- 仅保留 `meta/stats.md` 人工可读源计数作红线观察点。
+- **不预建**密度/熵增监控。到 P5 红线时再启用向量库导航层，接口预留。