前言¶
做研究或長期跟一個技術領域時，常見做法是每次提問都讓模型重新搜資料、重新總結。筆記散落在聊天窗口、書籤和零散文檔裏，過幾天再問同一主題，上下文又要從頭拼。傳統 RAG 能在單次查詢裏檢索片段，但很少把「已經整理好的結論」和「頁面之間的引用關係」長期留在倉庫裏。
下面介紹 SkillHub 上的 hermes-llm-wiki（座標 @user_38654c53/hermes-llm-wiki）。它把 Andrej Karpathy 的 LLM Wiki 思路寫成 Agent Skill：用一層不可變的原始來源、一層可編輯的 Wiki 頁面，再加 SCHEMA.md 約束命名、標籤和更新策略，讓人負責選來源和定方向，Agent 負責摘要、交叉引用、歸檔和一致性檢查。
這是什麼¶
hermes-llm-wiki 是社區來源（community）的知識管理類 Skill，SkillHub 分類爲 knowledge-management，當前頁面版本爲 1.0.0，發佈者座標爲 user_38654c53（SkillHub 頁面作者顯示爲 zhuyuanwei）。包內 SKILL.md 由 Hermes Agent 維護，許可證 MIT，並標註內部技能名 llm-wiki、文檔版本 2.0.0（與 SkillHub 列表版本號不一致，以你安裝到的包爲準）。
官方簡介：Karpathy’s LLM Wiki — build and maintain a persistent, interlinked markdown knowledge base. Ingest sources, query compiled knowledge, and lint for consistency.
標籤側註明 requires_api_key=false，不依賴額外 API Key 即可按 Skill 流程操作本地 Markdown 目錄。
核心功能¶
Skill 激活後，Agent 按文檔約定操作 Wiki 目錄（默認 ~/wiki，見下文配置），主要能力如下。
三層目錄結構¶
Wiki 是普通文件夾，可用 Obsidian、VS Code 等打開，無需專用數據庫：
- Layer 1 —
raw/：原始來源（文章、論文 PDF、轉錄、附件），只讀不改。 - Layer 2 —
entities/、concepts/、comparisons/、queries/：Agent 維護的互聯頁面，使用[[wikilinks]]。 - Layer 3 —
SCHEMA.md：領域範圍、命名、標籤 taxonomy、何時新建/拆分頁面、矛盾如何處理。
根目錄還有 index.md（分類型目錄 + 一行摘要）和 log.md（按時間追加的操作日誌，過大時按年輪轉）。
四類核心操作¶
- 初始化：創建上述結構，根據用戶領域編寫
SCHEMA.md、index.md、log.md。 - Ingest（攝入）：URL/文件/粘貼文本 → 落入
raw/→ 對照已有頁面避免重複 → 按閾值創建或更新 Wiki 頁 → 更新index.md與log.md。 - Query（查詢）：先讀
index.md（大庫可再全文搜索），讀取相關頁面後綜合回答，並把值得保留的對比或深度結論寫回queries/或comparisons/。 - Lint（檢查）：掃描孤立頁、斷鏈、索引遺漏、frontmatter 與標籤不合規、陳舊內容、矛盾陳述、超長頁面等，並寫入 lint 報告與日誌。
會話恢復（每次應先做）¶
對已有 Wiki，Skill 要求在任何寫入前先閱讀 SCHEMA.md、index.md 和 log.md 最近約 20–30 條記錄，以減少重複建頁和漏鏈。
與 Obsidian 的配合¶
[[wikilinks]] 與 YAML frontmatter 可直接在 Obsidian 中使用；文檔還說明可與 Obsidian 相關 Skill 共用同一路徑（如設置 OBSIDIAN_VAULT_PATH），以及在無圖形界面的機器上用 obsidian-headless 做 Sync（需 Node.js 22+ 與 Obsidian Sync 賬號）。
安裝與啓用¶
安裝 SkillHub CLI（若尚未安裝）¶
command -v skillhub && skillhub --version
未安裝時可按 SkillHub 官方說明執行：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安裝 hermes-llm-wiki¶
安裝時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 可能不會被識別。SkillHub 頁面給出的安裝提示爲：參考 SkillHub 安裝文檔，安裝座標 @user_38654c53/hermes-llm-wiki。
在 Cursor 下示例：
skillhub install @user_38654c53/hermes-llm-wiki --dir ~/.cursor/skills/
其他常見路徑（摘自 SkillHub 安裝文檔）：Claude Code 爲 ~/.claude/skills/；Codex 爲 ~/.codex/skills/ 或項目下 .agents/skills/。安裝後按你所用客戶端要求刷新或重啓 Agent，使 Skill 被加載。
配置 Wiki 路徑¶
Skill 內說明 Wiki 目錄通過 Hermes 配置項 skills.config.wiki.path 設置，默認 ~/wiki：
# ~/.hermes/config.yaml（Hermes Agent 環境）
skills:
config:
wiki:
path: ~/wiki
在支持 Skill 配置注入的客戶端中，加載後應查看 [Skill config: ...] 中的實際路徑。未配置時使用默認 ~/wiki。
典型用法¶
以下步驟來自 Skill 文檔，可在對話中直接觸發（例如「創建 wiki」「把這篇 URL 攝入 wiki」「根據 wiki 回答……」「lint 一下 wiki」）。
1. 新建 Wiki¶
- 確認路徑（配置、環境變量或詢問用戶，默認
~/wiki）。 - 創建
raw/子目錄與entities/等 Layer 2 目錄。 - 詢問領域範圍，寫入定製化
SCHEMA.md。 - 初始化
index.md、log.md，並建議首批要攝入的來源。
2. 攝入一條來源（概要）¶
WIKI="${wiki_path:-$HOME/wiki}"
Agent 側典型順序：用 web_extract 等抓取 URL/PDF → 保存到 raw/articles/ 或 raw/papers/ → 搜索 index.md 與現有頁面 → 按 SCHEMA.md 閾值新建或更新頁面（每頁至少 2 條出站 [[wikilinks]]）→ 更新 index.md 與 log.md → 向用戶列出變更文件。
3. 查詢¶
讀 index.md 定位頁面 → read_file 閱讀 → 綜合回答並引用 [[page-name]] → 若答案值得長期保留，寫入 queries/ 或 comparisons/ 並記日誌。
4. 在 Wiki 內搜索（示例）¶
WIKI="${wiki_path:-$HOME/wiki}"
# 按內容檢索（由 Agent 調用 search_files 等工具）
search_files "transformer" path="$WIKI" file_glob="*.md"
5. Lint¶
對 entities/、concepts/ 等目錄做鏈接圖、索引對齊、frontmatter 與標籤 taxonomy 校驗，按嚴重程度輸出修復建議，並在 log.md 追加 lint 記錄。
適用場景與注意¶
適合誰：需要長期維護某一領域知識、希望筆記可版本管理、可人工審閱，且願意用 Markdown + 雙鏈而不是單獨向量庫的人；AI/ML 研究筆記、技術資料聚合、個人知識庫等都在 Skill 中文說明中有列舉。
限制與坑（均來自 Skill 文檔）：
- 不要修改
raw/內文件；糾錯寫在 Wiki 頁。 - 跳過「先讀 SCHEMA / index / log」容易導致重複頁面和漏交叉引用。
- 新建頁需滿足閾值，且必須維護
index.md、log.md，否則導航會退化。 - 標籤只能使用
SCHEMA.md中已聲明的 taxonomy；矛盾信息應標註來源與日期，而非靜默覆蓋。 - 大規模更新（例如一次 ingest 影響 10+ 頁）前應先與用戶確認範圍。
- Skill 描述的工具名（如
web_extract、search_files、execute_code）取決於宿主 Agent 是否提供同名能力；在 Cursor 中應映射爲當前環境可用的抓取與搜索工具。
SkillHub 統計（抓取時）：評分 100000，下載 1671，安裝 75。
結尾¶
hermes-llm-wiki 把「一次提問、一次檢索」變成「持續整理、可查詢、可審計」的本地 Wiki：來源 immutable、知識頁可複利、lint 兜底一致性。若你要在 Agent 裏落地 Karpathy 式 LLM Wiki，可從 SkillHub 安裝該座標並按文檔初始化 ~/wiki（或你配置的路徑）。
