SkillMap

Oct 10, 2026

用 Obsidian Wiki 打造你的 agent 能记住的第二大脑

obsidian-wiki 把你和 agent 学到的东西编译成一个互相链接的 markdown 知识库，并用 lint、去重和会话钩子让它保持最新。

#tutorial#obsidian#productivity

你解决了一个难题，三个月后在另一个项目里又从零解决了一遍——因为答案死在了一段你永远找不到的聊天记录里。obsidian-wiki 这个 4k 星的开源项目，让你的 agent 指向一个文件夹，把学到的东西编译成由你拥有的、互相链接的 markdown。

为什么这个 Skill 重要

按 README 的说明，这个模式源自 Andrej Karpathy 的 LLM Wiki gist：把知识编译一次并保持更新，而不是永远重复问 LLM 同样的问题、每次都重跑 RAG。每个 skill 都是一个 markdown 文件，任何 agent——Claude Code、Cursor、Codex、Windsurf、Gemini CLI 等等——都能读取执行。没有运行时，没有 API key，没有厂商绑定。它是编译而不是堆积：新知识合并进已有页面，矛盾会被标记，清单（manifest）追踪每个已摄取的来源，第二次运行只处理增量。

安装

pip install obsidian-wiki
obsidian-wiki setup --vault ~/brain

这一步还会注册两个会话钩子：每个新会话开始时带着你是谁、当前打开了什么，结束时捕获一切可复用的内容。传 --no-hooks 可以跳过。uv tool install 和 pipx install 效果相同。不想碰终端？把 README 里的这句话发给你的 agent：https://github.com/Ar9av/obsidian-wiki — set up my wiki。在 Claude Code 里也可以装成插件——不需要 Python：

/plugin marketplace add Ar9av/obsidian-wiki
/plugin install obsidian-wiki@obsidian-wiki

插件只附带 skill——不带会话钩子和 CLI——且命令带命名空间，比如 /obsidian-wiki:wiki-ingest。

实战：喂养并查询你的知识库

  1. 喂它。/wiki-ingest ~/research 摄取一切文本形态的东西——文档、PDF、聊天导出、文字记录、截图、URL。/wiki-update 提炼你当前所在的仓库（能感知代码图）；/wiki-capture 保存当前对话；/wiki-history-ingest claude 挖掘你问过 Claude 的一切历史。
  2. 问它。/wiki-query what do I know about rate limiting? 会带着 [[wikilink]] 引用回答，而不是凭感觉；/wiki-digest week 回顾你这一周学到了什么。
  3. 保持诚实。/wiki-lint 标记断链、孤页和矛盾；/wiki-dedup 合并同一个概念的多个页面；/wiki-status 显示已摄取什么、枢纽页面在哪。

README 统计共 39 个 skill，知识库里的每条断言都标着 extracted、^[inferred] 或 ^[ambiguous]，让你分得清知识与猜测。

技巧

  • 一切都是磁盘上的纯 markdown：可 grep、可 diff、可推到私有仓库。没有任何东西离开你的机器。
  • 在 Obsidian 的图谱视图里打开知识库，说一句 color my graph——它会按标签、分类或可见性给节点着色。
  • 还不想正式启用？仓库的 examples/demo-vault/ 是一个 18 页的示例知识库，主题是如何构建可靠的 LLM agent。
  • 整个图谱可以导出为 graph.json、GraphML、Neo4j Cypher、Postgres SQL，或一个自包含的交互式 graph.html。
  • README 自带的基准测试（Claude Sonnet、无头模式、38 页知识库、每题跑两遍）报告装上 skill 后结构类问题提速 4.4 倍——从 81 秒降到 19 秒——正确率从 44% 升到 83%，API 成本持平。它同时说明在这个样本量下精确百分比只能作参考，而普通 agent 的失败方式本身就很有启发：它顺着 index.md 找——那个页面链接到所有页面——于是「找到」了一条毫无意义的短路径。

何时不用这个 Skill

你想要的是托管的、多设备同步的笔记服务——它刻意就是一个本地文件夹；README 提供了用于捕获网页的浏览器扩展和把知识库作为 HTTP/MCP 服务的 Docker 部署，但没有同步服务和移动客户端。另外，如果你的笔记从来不需要链接、互相矛盾或持续积累，一个普通的 markdown 文件夹就能干这个活，不需要挂上 39 个 skill。

查看 排行榜 了解更多 skill。