llm-wiki-ops

LLM Wiki 运维技能

在飞书知识库中运维 LLM Wiki——基于 Karpathy 的 LLM Wiki 模式：LLM 把原始资料持续编译成互相链接的持久化 wiki。

第一步：检测绑定状态

每次使用本技能前，必须先检测知识库绑定状态。

1. 读取本技能目录下的 config/wiki-binding.json。
2. 如果文件存在且包含有效的 space_id 和 nodes，则视为已绑定，直接进入运维模式。
3. 如果文件不存在、为空或缺少关键字段，则视为未绑定，进入初始化流程（见 references/init.md）。

绑定文件路径：<skill_dir>/config/wiki-binding.json

已绑定：直接运维

绑定后，所有操作基于 wiki-binding.json 中的节点 token 和 doc_id 执行。无需再让用户提供知识库地址。

核心操作

1. Ingest（入库）

原始资料入库：

1. 读取用户提供的资料文件（全文，不跳过）。
2. 在「原始资料」区创建资料卡文档，保留原文链接。
3. 从资料中提取值得沉淀的实体/概念/方法论，在「词条」区创建词条文档。
4. 每个新词条必须同时建立与已有词条的双链关系（见下方「双链规则」）。
5. 更新「索引」文档（A-Z 排序，先英文后中文）。
6. 在「更新日志」追加 ingest 条目。

文章入库：

1. 判断是成稿还是草稿，分别放入「我的文章/成稿」或「我的文章/草稿」。
2. 清理文章中的无关内容（如视频播放器 UI 文字）。
3. 从文章中提取有价值的概念/实体创建词条（词条来源标注文章标题）。
4. 更新索引和日志。

详细流程见 references/ingest.md。

2. Query（查询）

1. 先读「索引」定位相关词条和资料卡。
2. 深入阅读相关文档。
3. 综合出带引用的答案。
4. 有价值的答案（比较、分析、新连接）归档回 wiki 成为新页面，并更新索引与日志。

详细流程见 references/query.md。

3. Lint（体检）

定期检查：

• 页面间矛盾、过期论断
• 孤儿页（无入链的词条）——发现后立即补全双链
• 提到但缺页的概念
• 缺失的交叉引用
• 事实标注是否完整（每条事实是否标注来源）
• 索引与实际词条是否一致

结果记录到更新日志，类型为 lint。详细流程见 references/lint.md。

4. 词条管理

• 新建词条：必须包含定义、关键事实（标注来源）、与其他词条的关系（双链）、来源四个部分。
• 更新词条：只改被点名的范围，保留未要求改动的内容。
• 删除词条：需用户明确授权，删除后更新索引和相关词条的双链。

词条模板见 references/entry-template.md。

5. 索引与日志维护

• 索引：每次入库/删除后必须更新。按 A-Z 字母排序，每个字母下先英文后中文。包含原始资料、我的文章（成稿+草稿）、词条三个区域。
• 更新日志：追加式记录，不修改历史。条目格式：## [YYYY-MM-DD] <动作> | <主题>，动作取值：ingest/query/lint/init/update。

词条文档规范（强制）

每篇词条文档必须包含以下结构：

1. 定义：一句话定义该实体/概念。
2. 关键事实：列出从资料/文章中提取的事实。
3. 与其他词条的关系：说明与其他词条的关联，必须使用飞书文档双链链接。
4. 来源：标注来源文件名或文章标题。

事实与来源规则（强制）

• 所有事实必须来自用户提供的资料和文章，禁止编造。
• 每条事实必须标注来源，格式：（来源：<文件名/文章标题>）。
• 资料里没有的信息，明确写「暂无资料」，不得臆造。

双链规则（强制）

• 每个词条的「与其他词条的关系」部分必须使用飞书文档链接（[词条名](https://<tenant>.feishu.cn/docx/<doc_id>)），不得使用纯文本。
• 禁止产生孤儿词条：每个新词条至少链接到 1-2 个已有词条；被链接的词条也应在关系部分回链。
• 关系描述要具体，不能只写“相关”，要说明是什么关系（对比、基于、同属、被采用等）。
• 绑定文件 wiki-binding.json 中不记录每个词条的 doc_id；查询时通过索引或 wiki 节点列表获取。