前言¶
把文章、剪藏和对话丢进文件夹，再靠 RAG 或临时上传提问，答案往往每次都要从原始材料里重新拼一遍，交叉引用和矛盾标注很难留下来。若希望 Agent 持续维护一套可读的 Markdown 知识层，而不是只做一次性检索，需要一套固定的工作流与目录约定。下面介绍 SkillHub 上的社区 Skill llm-wiki（坐标 @user_f2c57d7a/llm-wiki-pro，版本 1.0.0），它在对话里按 Karpathy 的 LLM Wiki 思路组织 ingest、查询与 lint。
这是什么¶
llm-wiki 是面向「个人知识库维护」的 Agent Skill，发布者为 user_f2c57d7a，来源为 community，分类为 knowledge-management。官方页面标注 requires_api_key=false，当前 SkillHub 统计为评分 100000、下载 2450、安装 101（以 SkillHub 展示为准）。
Skill 的定位是：当用户说「帮我整理笔记」「保存这些内容」「整理到知识库」「处理这个源文件」时触发，由 Agent 按 Skill 内规则维护 raw/ 与 wiki/ 分层结构，并更新 index.md、log.md 等索引文件。理念说明与 Karpathy 公开的 LLM Wiki 思路文档 对齐，由本 Skill 把流程写进 SKILL.md，而不是替代你在本机配置知识库路径与工具链。
核心功能¶
以下能力均来自已安装的 SKILL.md（1.0.0），不展开 Skill 未写明的实现细节。
三层结构¶
- Schema 规则层：
SKILL.md，以及可选的WIKI_RULES.md，约定 Agent 如何操作知识库。 - Wiki 知识层：
$VAULT_PATH/wiki/，由 LLM 维护结构化 Markdown（实体页、概念页、总结、对比、问答记录等），人类以阅读为主。 - Raw 源层：
$VAULT_PATH/raw/，存放未改动的原始材料（文章、论文、数据、聊天记录、网页剪藏等）。
关键文件¶
| 文件 | 作用 |
|---|---|
index.md |
内容目录，按分类列出页面；每次 ingest 后由 LLM 更新 |
log.md |
仅追加的时间线，记录操作 |
health/*.md |
Lint 产生的健康检查报告 |
三种操作¶
Ingest（摄入）
对应整理、保存、处理源文件等意图。Skill 规定的步骤包括：将原始文件保存到 raw/YYYY/MM/DD/；读取 index.md 并扫描相关页面；分析并整合到 Wiki；更新 index.md 与 log.md；并进行 Git 同步（需你本地已配置仓库与权限）。
Query（查询）
用户提问时，Agent 先查 index.md 定位页面，再综合回答并带引用；若答案有长期价值，可写回为新 Wiki 页。
Lint（健康检查）
定期或按需检查：页面间矛盾、过期声明、孤儿页、缺失概念页、应链未链的交叉引用、可补全的数据缺口等，结果写入 health/*.md。
页面约定（节选）¶
- Wiki 页位于
wiki/下。 - Skill 要求页面包含
#openclaw标签，底部附源文件链接形如[来源](raw/YYYY/MM/DD/filename.md)。 - 新知识点需用
[[页面名]]关联至少两个已有相关页；新旧矛盾需标注，不直接覆盖旧表述。
安装与启用¶
官方 SkillHub 页给出的安装指引是：阅读 SkillHub 安装文档，安装坐标 @user_f2c57d7a/llm-wiki-pro。
安装 SkillHub CLI（若尚未安装）¶
command -v skillhub && skillhub --version
未安装时可执行完整安装（文档中的推荐方式）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装 llm-wiki-pro¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 且可能不被识别。SkillHub 文档列出的常见路径如下：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
在 Cursor 中的示例：
skillhub install llm-wiki-pro --namespace user_f2c57d7a --dir ~/.cursor/skills/
等价坐标写法为 @user_f2c57d7a/llm-wiki-pro。安装完成后按你所用客户端的要求刷新或重启 Agent，使 Skill 被加载。
运行依赖（OpenClaw 元数据）¶
SKILL.md 的 front matter 中，OpenClaw 相关元数据声明：
- 需要可执行文件：
zk - 需要环境变量：
VAULT_PATH（知识库根目录）
若你不在 OpenClaw 生态下使用，仍需自行把 VAULT_PATH 指到实际 vault，并保证 raw/、wiki/ 与索引文件路径与 Skill 描述一致；zk 是否必需取决于你选用的宿主与配套工具，以你环境中的 Skill 加载结果为准。
典型用法¶
下列示例复述官方触发语与流程，便于在 Agent 中复现。
1. 摄入一段新材料
对 Agent 说：
帮我整理笔记：把下面内容保存到知识库并按 LLM Wiki 流程处理这个源文件。
Agent 应按 Skill 将原文落入 raw/YYYY/MM/DD/，更新或新建 wiki/ 下页面，刷新 index.md 与 log.md。
2. 基于 Wiki 提问
根据知识库回答：XXX 概念和 YYY 实验结论是否一致？请引用 wiki 页面。
期望行为是先读 index.md 再读相关页，综合回答；有价值时可沉淀为新页面。
3. 健康检查
对当前知识库做一次 lint，把问题写到 health 目录。
对应 Skill 中的矛盾、孤儿页、缺失链接等检查项。
适用场景与注意¶
适合谁
需要长期积累、可交叉引用的个人研究笔记或阅读库，愿意用 Markdown + 目录约定换「每次问答从零检索」的模式；能接受 Raw 只增不改、Wiki 由 Agent 维护。
限制与注意
- 本 Skill 是工作流与规范，不自带托管服务；
VAULT_PATH、Git、Obsidian 或其它阅读器需自行准备。 - Ingest 流程写明 Git 同步，未配置 Git 时该步会失败或需你手动处理，安装前宜先建好仓库。
- 页面规范中的
#openclaw等标签来自 Skill 原文，若宿主不识别标签语义，仍以目录与链接约定为准。 - 社区 Skill（
user_f2c57d7a），升级与行为变更以 SkillHub 上llm-wiki-pro包为准。
结尾¶
llm-wiki 把 Karpathy LLM Wiki 的「Raw + 持久 Wiki + 规则层」拆成 Agent 可执行的 ingest、query、lint 三类操作，适合把「整理笔记」类口语意图落到固定目录与索引文件上。安装与说明见 SkillHub：llm-wiki 技能页，API 坐标入口：https://api.skillhub.cn/user_f2c57d7a/llm-wiki-pro。
