kb-compile

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: 逐个编译

对每个待编译条目：

1. 读取源文件：读原始文件。如果是非文本格式（PDF/Excel/图片/Word），读 raw/.extracted/ 下的提取文本
2. 判断操作：
   • 如果源文件内容对应一个新概念 → 创建新 wiki 文章
   • 如果源文件内容补充已有文章 → 更新已有文章
   • 如果源文件是综合性的 → 可能创建多篇文章
3. 生成文章：按 ONTOLOGY.md 的模板生成 wiki 文章
   • 必须包含完整 frontmatter
   • compiled_from 字段指向原始文件路径
   • last_compiled 填当天日期
   • 在正文中用 [[双链]] 链接相关文章
   • 存放到 ONTOLOGY.md 指定的对应目录（如 concept 存 wiki/concepts/）
4. 更新索引：
   • 在 index/MASTER-INDEX.md 中添加/更新条目（路径 + 类型 + 一句摘要）
   • 在 index/TOPIC-MAP.md 中将文章归入合适主题
   • 在 index/RAW-REGISTRY.md 中将该条目状态改为 done，填写编译产物路径

Step 4: 输出编译摘要

• 报告：编译了 N 个文件，创建 M 篇新文章，更新 K 篇已有文章
• 列出新创建/更新的文章清单
• 提示：可运行 /kb-lint 检查知识库健康度