84f7950589
- 完整的知识库框架（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>
123 lines
5.8 KiB
Markdown
Executable File
123 lines
5.8 KiB
Markdown
Executable File
# 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 红线时再启用向量库导航层，接口预留。
|