前言¶
把文章、剪藏和對話丟進文件夾，再靠 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。
