| name | kb-compile |
| description | 将 raw/ 中已导入但未编译的文件编译为 wiki 文章。当用户说"编译知识库"、"编译"、"更新 wiki"、"kb compile"时触发。
LLM 读取原始资料，按本体定义生成结构化 wiki 文章，自动维护索引和反向链接。
|
| user-invocable | true |
编译知识库
将 raw/ 中已导入但未编译的原始文件编译为 wiki 文章。
核心原则
- Wiki 文章由 LLM 生成和维护，遵循 ONTOLOGY.md 定义的实体类型和模板
- 每篇文章必须有完整的 YAML frontmatter（type, id, compiled_from, related, last_compiled）
- 使用
[[双链]] 建立文章间的关联
- 编译是增量的：只处理 RAW-REGISTRY.md 中 status=pending 的条目
执行步骤
Step 1: 检查待编译条目
- 读
index/RAW-REGISTRY.md，找所有 status=pending 的条目
- 如果没有待编译条目，告知用户"没有待编译的文件，如有新文件请先运行 /kb-ingest"，结束
Step 2: 加载上下文
- 读
index/ONTOLOGY.md 了解实体类型定义和文章模板
- 读
index/MASTER-INDEX.md 了解现有 wiki 文章概况
- 读
index/TOPIC-MAP.md 了解主题分组
Step 3: 逐个编译
对每个待编译条目：
- 读取源文件：读原始文件。如果是非文本格式（PDF/Excel/图片/Word），读
raw/.extracted/ 下的提取文本
- 判断操作：
- 如果源文件内容对应一个新概念 → 创建新 wiki 文章
- 如果源文件内容补充已有文章 → 更新已有文章
- 如果源文件是综合性的 → 可能创建多篇文章
- 生成文章：按 ONTOLOGY.md 的模板生成 wiki 文章
- 必须包含完整 frontmatter
compiled_from 字段指向原始文件路径last_compiled 填当天日期- 在正文中用
[[双链]] 链接相关文章
- 存放到 ONTOLOGY.md 指定的对应目录（如 concept 存
wiki/concepts/）
- 更新索引：
- 在
index/MASTER-INDEX.md 中添加/更新条目（路径 + 类型 + 一句摘要）
- 在
index/TOPIC-MAP.md 中将文章归入合适主题
- 在
index/RAW-REGISTRY.md 中将该条目状态改为 done，填写编译产物路径
Step 4: 输出编译摘要
- 报告：编译了 N 个文件，创建 M 篇新文章，更新 K 篇已有文章
- 列出新创建/更新的文章清单
- 提示：可运行
/kb-lint 检查知识库健康度
