在 Obsidian 里给你的 agent 一个持久记忆

每个 CLI agent 会话都从零开始，而你的 Obsidian 仓库就隔着一个目录，里面装的正是 agent 需要的上下文。obsidian-second-brain 把两者接通：仓库成为 agent 的记忆，agent 成为仓库的管理员。

为什么这个 Skill 重要

项目自称是 Karpathy 的 LLM Wiki 模式的进化版，差别在动词：它不追加新页面，而是重写已有页面。摄入一个来源，已有的人物、项目、概念页就会更新；矛盾通过 /obsidian-reconcile 自动调和；/obsidian-synthesize 自己写模式综合页。笔记是 AI 优先的——## For future agent 前言加 frontmatter，服务于检索而不是人类浏览。整套系统跑在一条明确的新鲜度规则 OKM（Open Knowledge Metabolism）上：每条存储的事实必须是永恒的、带日期的、或是一个指针，易变的数字带 as of 时间戳链接过去，而不是复制进来等着腐烂。一份代码发布八种构建——Claude Code、Codex CLI、Gemini CLI、OpenCode、Antigravity、Hermes、Pi 和 Grok Bot——仓库行为在各构建间完全一致。

安装

在 Claude Code 上，通过插件市场安装：

/plugin marketplace add eugeniughelbur/obsidian-second-brain
/plugin install obsidian-second-brain@obsidian-second-brain

然后在 ~/.claude/settings.json 的 env 部分告诉它仓库在哪里：

"env": { "OBSIDIAN_VAULT_PATH": "/path/to/your/vault" }

重启 Claude Code，在你的仓库里运行 /obsidian-second-brain:obsidian-init。插件命令带命名空间，每条命令都是 /obsidian-second-brain:<name>；之后用 /plugin update obsidian-second-brain 更新。前置要求很轻：git 和 Python 辅助工具用的 uv——核心仓库命令不需要任何 API key（jq 只有经典脚本安装这条备选路径才需要，那条路径换来的是不带命名空间的裸命令名）。

实战：三条命令收尾一场会议

1. 会后运行 /obsidian-save。agent 把对话里的每条决策、每个人物、每个任务和想法分别存进正确的笔记——README 的演示里一次保存产出了五张互相链接的笔记。
2. 第二天早上运行 /obsidian-daily：它把日历事件、逾期任务和隔夜变化拉进今天的每日笔记。
3. 重大决策之前运行 /obsidian-challenge。agent 在仓库里搜索同主题的过往失败和被推翻的决策，用你自己的话反驳你。

第二条循环能说明「自我重写」为什么是承重墙：/obsidian-ingest 接收 URL、PDF、音频文件或截图，每个来源触及 5–15 张已有页面——人物被更新、矛盾被调和、模式涌现时生成综合页。夜间的定时 agent 在你睡觉时继续复利：五个阶段，收束当天、调和矛盾、综合跨来源模式、修复孤立笔记、重建索引。

技巧

• 先用三条命令起步——/obsidian-init 初始化、/obsidian-save 保存、/obsidian-find 检索——再去探索完整的 47 条命令库（30 条操作、9 条思维工具、1 条上下文命令、7 条研究命令）。
• 研究工具箱对 key 是可选的：没有 Perplexity key 时 /research 回退到免费的免 key 来源（Wikipedia、HackerNews、arXiv、Reddit 等），而 /x-read、/x-pulse、/notebooklm、/youtube 需要在 ~/.config/obsidian-second-brain/.env 里配各自的 key。
• 引导时选一个角色预设——executive、builder、creator 或 researcher——bootstrap_vault.py 会创建配套的文件夹、模板和看板。
• /obsidian-health 按新鲜度策略和类型化边审计仓库——如果你通过 _meta/taxonomy.md 主动启用，还会审计标签体系；/obsidian-merge 合并近似重复的笔记，默认先试运行。
• 还没有仓库？可以引导出一个开箱即过自身健康检查的成品仓库。

何时不用这个 Skill

引力中心是 Obsidian：笔记、看板和每日页都活在一个 markdown 仓库里，日历命令因为依赖 Google Calendar MCP 而仅限 Claude Code。如果你团队的记忆存在共享 SaaS 工具里，这套系统管理的是个人仓库，不是那类系统。另外 AI 优先的笔记格式服务于检索而非阅读——如果你希望笔记读起来是给人看的散文，而这正是这个仓库有意打破的惯例——重写行为会让你觉得被侵犯。

查看 排行榜 了解更多 skill。