Obsidian Mind：让 Claude Code 拥有持久记忆的 Obsidian 保险库

项目地址：breferrari/obsidian-mind

今日Star：462（+0）| Forks：37 | License：MIT

核心定位：用 Obsidian 给 Claude Code 构建一个「外脑」，让 AI 代理的记忆跨会话持久化

学习目标

读完本文后，你应该能够：

1. 理解 Claude Code「遗忘问题」的本质及其对 AI 协作效率的影响
2. 掌握 Obsidian Mind 的核心设计理念：Vault-first Memory + 生命周期钩子
3. 熟练使用 15+ Slash 命令完成日常工作流（晨会、复盘、1:1 记录等）
4. 理解 9 个子代理的分工与协作机制
5. 搭建个人 Performance Graph，将工作笔记链接到能力框架
6. 使用 /vault-upgrade 从旧保险库迁移内容

一、问题：Claude Code 的「遗忘症」

Claude Code 非常强大，但每次会话都从零开始——没有你的目标上下文、没有团队信息、没有你的工作模式。你需要反复解释相同的事情，半年前做出的决策早已忘记。知识无法积累，经验无法复利。

这是一个根本性限制：AI 代理的上下文窗口是有限的，而人类的工作和思考是连续递增的。

二、解决方案：给 Claude 一个「外脑」

Obsidian Mind 的核心思想很简单：把 Claude Code 的「记忆」外部化到一个 Obsidian 保险库中，让每次新会话都能加载历史上下文。

核心理念

Folders group by purpose. Links group by meaning. 笔记归属于一个文件夹（它的「家」），但通过链接连接到多个笔记（它的上下文）。 Claude 自动维护这张图谱——将工作笔记与人、决策、能力自动关联。

工作示意

你：「start session」
Claude：（读取 North Star、检查活跃项目、扫描近期记忆）
Claude：「你在做 Project Alpha，被 BE 合约阻塞。上次会话你决定拆分 coordinator。
        你和经理的 1:1 在明天——简报已准备好。」

这就是 Vault-first Memory 的威力：会话之间无缝衔接，上下文自动累积。

三、核心技术：5 个生命周期钩子

Obsidian Mind 通过 5 个生命周期钩子实现自动化路由：

实际效果

你只需要正常说话，钩子自动处理路由：

你："/dump 刚和 Sarah 做了 1:1，她对 auth 工作满意但希望在上线前加错误监控。
    还有，Tom 说缓存迁移推迟到 Q2 了——我们决定先专注 API 合约。决策：推迟 Redis 迁移。
    成就：Sarah 称赞了 auth 架构。"

Claude：→ 更新 org/people/Sarah Chen.md 加入会议上下文
      → 创建 work/1-1/Sarah 2026-03-26.md 含关键要点
      → 创建决策记录：「推迟 Redis 迁移到 Q2」
      → 在 perf/Brag Doc.md 添加：「经理称赞 auth 架构」
      → 在 work/active/Auth Refactor.md 添加错误监控任务

四、15+ Slash 命令详解

Obsidian Mind 定义了 15+ 个命令，覆盖完整工作流：

日常命令

会议与事件

复盘与绩效

保险库维护

编辑命令

五、9 个子代理：专业化分工

Obsidian Mind 内置 9 个子代理，运行在隔离的上下文窗口中：

六、Performance Graph：绩效图谱

Obsidian Mind 的保险库同时也是一个绩效追踪系统：

工作原理

1. 能力笔记（perf/competencies/）定义你的能力框架——每个能力一篇笔记
2. 工作笔记在它们的 ## Related 部分链接到能力，并标注展示了什么
3. 反向链接自动累积——复盘准备变成阅读每个能力笔记的反向链接面板
4. Brag Doc 按季度聚合成就，带有到证据笔记的链接

证据流

/peer-scan <同事> 
→ 深度扫描同事的 GitHub PR
→ 将结构化证据写入 perf/evidence/

/review-brief manager
→ 汇总所有内容生成完整复盘简报：
  - 成就条目
  - 决策
  - 事件
  - 能力证据
  - 1:1 反馈

七、保险库结构

Obsidian-Mind/
├── Home.md              # 入口——嵌入 Base 视图、快速链接
├── CLAUDE.md            # 操作手册——Claude 每次会话都读取
├── vault-manifest.json  # 模板元数据——版本、结构、模式
├── brain/               # 🧠 核心记忆
│   ├── North Star.md    # 目标——每次会话都读取
│   ├── Memories.md      # 记忆主题索引
│   ├── Key Decisions.md # 关键决策及理由
│   ├── Patterns.md      # 跨工作观察到的模式
│   └── Gotchas.md       # 犯过的错误及原因
├── work/                # 工作笔记
│   ├── active/         # 活跃项目（保持 1-3 个）
│   ├── archive/YYYY/   # 按年归档的完成工作
│   ├── incidents/       # 事件文档
│   └── 1-1/            # 1:1 会议笔记
├── org/                 # 组织知识
│   ├── people/         # 每人一篇笔记
│   └── teams/          # 每团队一篇笔记
├── perf/                # 绩效追踪
│   ├── Brag Doc.md     # 成就日志
│   ├── competencies/   # 能力笔记
│   └── evidence/       # PR 深度扫描证据
├── reference/           # 代码库知识、架构图
├── thinking/           # 草稿——推广后删除
├── templates/          # Obsidian 模板
├── bases/              # 📊 动态数据库视图
│   ├── Work Dashboard  # 活跃项目仪表板
│   ├── Incidents       # 事件列表
│   ├── People Directory # 人物目录
│   └── Competency Map  # 能力地图
└── .claude/            # Claude Code 配置
    ├── commands/       # 15+ Slash 命令
    ├── agents/         # 9 个子代理
    └── hooks/          # 5 个生命周期钩子

八、快速上手

1. 克隆模板

git clone https://github.com/breferrari/obsidian-mind.git ~/obsidian-mind
cd ~/obsidian-mind

2. 打开为 Obsidian 保险库

在 Obsidian 中打开文件夹作为保险库。

3. 启用 Obsidian CLI

Settings → General → 启用 Obsidian CLI（需要 Obsidian 1.12+）

4. 启动 Claude Code

cd ~/obsidian-mind
claude

5. 填写你的 North Star

编辑 brain/North Star.md，填写你的目标——这为每次会话奠定基础。

6. 开始工作

正常谈论你的工作，钩子自动处理路由。

九、升级现有保险库

已有旧版 obsidian-mind 或任何 Obsidian 保险库？使用 /vault-upgrade 迁移：

# 1. 克隆最新 obsidian-mind
git clone https://github.com/breferrari/obsidian-mind.git ~/new-vault

# 2. 在 Claude Code 中打开
cd ~/new-vault && claude

# 3. 运行升级，指向旧保险库
/vault-upgrade ~/my-old-vault

Claude 会：

1. 检测你的保险库版本（v1–v3.2，或识别为非 obsidian-mind 保险库）
2. 清点每个文件——分类为用户内容/脚手架/基础设施/未分类
3. 呈现迁移计划——你精确看到将被复制、转换和跳过的内容
4. 执行在你批准后——转换 frontmatter、修复 wikilinks、重建索引
5. 验证——检查孤儿笔记、断链、缺失 frontmatter

旧保险库永远不会被修改。使用 --dry-run 预览计划而不执行。

十、可选：QMD 语义搜索

对于跨保险库的语义搜索（找到「我们对缓存的决定」即使笔记标题是「Redis 迁移 ADR」）：

npm install -g @tobi/qmd
qmd collection add . --name vault --mask "**/*.md"
qmd context add qmd://vault "Engineer's work vault: projects, decisions, incidents, people, reviews, architecture"
qmd update && qmd embed

如果未安装 QMD，一切仍然正常工作——Claude 回退到 Obsidian CLI 和 grep。

十一、定制指南

这是起点，适应你的工作方式：

十二、总结

Obsidian Mind 解决了一个根本问题：AI 代理的上下文窗口是有限的，而人类的知识和经验是连续递增的。

通过将 Claude Code 的「记忆」外部化到 Obsidian 保险库，结合 5 个生命周期钩子的自动化路由、15+ Slash 命令的便捷操作、以及 9 个子代理的专业分工，Obsidian Mind 构建了一个：

1. 持久化记忆系统——跨会话无缝衔接
2. 自动分类引擎——自然语言输入，自动路由到正确位置
3. 绩效追踪图谱——工作笔记自动链接到能力框架
4. 团队知识库——人物、团队、决策、事件全面关联

如果你重度使用 Claude Code，Obsidian Mind 是将 AI 协作效率提升一个数量级的关键工具。

相关链接：

• GitHub：https://github.com/breferrari/obsidian-mind
• Obsidian：https://obsidian.md
• Claude Code：https://docs.anthropic.com/en/docs/claude-code
• QMD（可选语义搜索）：https://github.com/tobi/qmd