| name | wikillm |
| description | Compiles raw documents into a structured, cross-linked Chinese Wiki knowledge base. Use when ingesting raw materials, answering questions about the wiki, or maintaining the wiki structure. |
| license | MIT |
| metadata | {"version":"3.0","author":"WikiLLM Project"} |
WikiLLM Skill
基于可信来源(raw/)编译事实知识库。
系统架构
wikillm/
├── raw/ # 【输入层】事实来源(不可变)
├── ideas/ # 人的动态输入(按项目/置信度分,可变)
├── thinking/ # 【草稿层】模型思考(按主题分,临时,完成后编译并删除)
├── wiki/ # 【输出层】编译后的知识库(可检索)
│ ├── concepts/ # 从 raw 编译 → "是什么"
│ ├── practices/ # 从 raw 编译 → "怎么做"
│ ├── queries/ # 会话研究 + 来源核查 → "事实"
│ ├── visual/ # 可视化内容
│ └── assets/ # 图像和资源文件
└── projects/ # 从 ideas + wiki 综合的项目规律(ideallm skill 处理)
三层隔离
| 层 | 目录 | 可检索 | 来源要求 | 生命周期 |
|---|
| 输入层 | raw/ | 编译时读取 | 外部素材,只读 | 永久 |
| 草稿层 | thinking/ | 不检索 | 无要求 | 主题完成后编译进 wiki 并删除 |
| 输出层 | wiki/ | Q&A 和 Linting 时检索 | 必须有来源支撑 | 永久 |
功能一览
1. 增量编译(raw/ → wiki/)
触发条件(满足任一即触发):
- 用户明确说"wiki编译"
- raw/ 哈希变化(新增或修改文件)
- thinking/ 编译完成(有新内容落入 wiki/,顺势重新综合)
编译规则:
- 扫描 raw/ 目录,哈希对比检测新增/修改文件
- 多模态解构:大文档完整阅读、图片 OCR 转 Mermaid
- 非线性重构重写为中文化 wiki 文章
- 按内容性质分目录:concepts/(是什么)、practices/(怎么做)
- 资源同步:raw/images/ → wiki/assets/
2. thinking/ 管理(对话 → 草稿 → wiki)
话题生命周期:
- 话题开始(自动检测):对话中产生有价值思考 → 自动在 thinking/ 下创建或追加子目录,子目录名用 kebab-case 代表主题
- 话题结束(两种方式):
- 用户明确说"话题结束" → 立即触发编译
- 用户未说"话题结束"但对话主题已切换(问题方向改变、转向 Q&A 或其他操作)→ 自动检测到话题切换,对前一话题触发编译
- 同一 skill 会话可产生多个话题,按主题分割为独立的有意义片段
写入规则:
- 对话中产生有价值思考 → 写入 thinking/ 按主题分的子目录
- 子目录名使用 kebab-case,代表主题
- 内容随意写:草稿、推理链、试错记录、对比分析均可
- 无来源要求,无格式要求
编译流程(话题结束时触发):
- 阶段一:价值判断 — 逻辑是否自洽?是否有增量贡献?值得保留?
- 阶段二:佐证核查 — 回 raw/ 查找佐证,有佐证才编译进 wiki
- 佐证通过 → 编译进 wiki/(concepts/practices/queries/)
- 无法佐证 → 留在 thinking/,不编译
- 编译完成后删除 thinking/ 子目录
3. Q&A(基于 wiki 的知识查询)
- 检索范围:raw/ + wiki/,不含 thinking/
- 回答后提供"参考依据",列出支撑结论的 wiki 文档
4. queries/ 会话沉淀
- Q&A 中产生有价值且经来源核查的结论 → 写入 wiki/queries/
- 必须有 wiki/ 或 raw/ 中的具体来源支撑,模型凭记忆的不算
- 视同事实,与 concepts/practices 平级
5. 网络化链接
- Wikilink 格式规范(kebab-case 文件名)
- 双链注入(Glossary 术语自动包裹)
- 反向链接(文末"相关研究"模块)
- 动态索引更新
6. Linting(健康检查)
- 术语一致性检查
- 孤岛页面扫描
- thinking/ 停留检查(超过 30 天提示)
- thinking/ 编译残留检查
- queries/ 来源核查
- raw/ 更新时发布补丁
任务路由(首先阅读本节!)
在执行任何操作前,先判断当前任务属于以下哪个场景:
注意:ideas/ 和 projects/ 的管理由 ideallm skill 处理,不属于本 skill 范围。
快速开始
核心逻辑
- 人工不直接编写 Wiki,仅负责投放素材和发起查询
- LLM 负责理解、重写、链接与维护
thinking/ 是模型的草稿纸,Q&A 时不检索
wiki/queries/ 的内容必须有来源核查,视同事实
- 可信度由目录位置决定,不使用额外元数据标注
- 适配工具:Obsidian(IDE 前端)
详细文档