wiki-maintainer

维护 llm-wiki 知识库，支持新来源导入、内容查询、健康检查及批量处理，确保信息准确和结构完整。

Install

openclaw skills install @xiehanlin/wiki-maintainer

SKILL.md — wiki-maintainer

维护 llm-wiki 知识库的标准操作程序。

适用场景： 用户要求 ingest 来源、提问、从 wiki 中查找信息、执行 lint 检查。

目标 wiki： /Users/clax/Documents/doc_synced/llm-wiki/

读取引擎

每次操作前，读取目标 wiki 的 AGENTS.md 和 index.md 了解当前状态。

操作一：Ingest（新来源）

当用户提供了新的文档/文章/笔记，需要纳入知识库时：

Step 1 — 判断来源类型

纯文本内容（直接粘贴的文字）：存入 raw/sources/<slug>.md
网络文章：用 jina fetch 抓取，存入 raw/sources/<slug>.md
文件路径：复制到 raw/ 对应子目录

Step 2 — 生成摘要页

根据 AGENTS.md 的 Source 摘要页模板，写 wiki/sources/<slug>.md：

提取核心观点（3-5 条）
记录关键细节/引述
标注与现有 wiki 内容的关联
列出待探索问题

Step 3 — 更新 Entity / Concept 页面

扫描摘要中出现的具名实体和概念：

已存在 → 追加新信息，更新 updated 日期
不存在 → 按模板新建页面

Step 4 — 必要时创建 Synthesis

如果新来源涉及跨多个已有页面的主题：

新建或更新 wiki/syntheses/<topic>.md
标注矛盾点、共识点

Step 5 — 更新 index.md

在对应类别添加新条目
更新 更新时间
更新计数

Step 6 — 记录 log.md

markdown

## [YYYY-MM-DD HH:MM] ingest | <来源标题>
<简要描述：新增了哪些页面，有什么重要发现>

Step 7 — 向用户汇报

text

✅ Ingest 完成：<来源标题>
📄 新建摘要：wiki/sources/<slug>.md
🔗 关联实体：entity/xxx, entity/yyy
💡 值得关注：<1-2 个亮点>

操作二：Query（提问）

当用户向 wiki 提问时：

Step 1 — 读 index.md

找到与问题相关的页面列表。

Step 2 — 读取相关页面

读取最相关的 3-5 个 wiki 页面（entities/concepts/sources）。

Step 3 — 回答

综合 wiki 内容生成答案，适当使用 [[wiki/...]] 链接。

Step 4 — 可选：存回 wiki

如果答案有价值（系统性分析、对比、新发现），生成 wiki/builds/<slug>.md：

标题为问题本身
内容为答案
附上来源依据

Step 5 — 记录 log.md

markdown

## [YYYY-MM-DD HH:MM] query | <问题摘要>
<简要描述答案亮点>

操作三：Lint（健康检查）

当用户要求检查 wiki 健康状态，或每累积 10 次 ingest 后自动触发：

Step 1 — 运行工具

bash

bash /Users/clax/Documents/doc_synced/llm-wiki/tools/lint.sh

Step 2 — 读取结果并修复

常见问题及处理：

orphan pages：添加引用或在 index.md 标注"待关联"
来源未同步：立即 ingest 缺失的来源
frontmatter 缺失：补充完整
index 过期：重新生成 index.md

Step 3 — 报告

向用户报告检查结果和修复动作。

操作四：Batch Ingest（批量导入）

当 raw/ 中有多个待处理来源时：

逐个处理（不要并行），每处理完一个汇报一个
最后做一次整体 lint
统一更新 index.md

页面模板速查