前言¶
做研究或长期跟一个技术领域时，常见做法是每次提问都让模型重新搜资料、重新总结。笔记散落在聊天窗口、书签和零散文档里，过几天再问同一主题，上下文又要从头拼。传统 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（或你配置的路径）。
