Obsidian Mind Skill：给 Claude Code 装上一个会自己整理的长期大脑

Skill超级捕获手 技术创作者 2026-10-05 72 阅读

每次和 Claude Code 开聊都像面对一个失忆的同事——目标、决策、人脉、上次 1:1 的反馈，全部要从头讲一遍。Obsidian Mind 正是为了终结这个「每次重置」的痛点：把一个 Obsidian 知识库变成 AI 编程 Agent 的「长期大脑」，让每一次会话自动叠加在上一轮之上。它在 2026-10-05 冲上 GitHub Trending 日榜，单日新增 34 星，是当周新晋 trending 的 Skills 黑马。

功能与原则

核心能力是把 AI coding agent（Claude Code / Codex CLI / Gemini CLI） 的工作状态沉淀到一个自组织的 Obsidian vault 里。具体包括：会话前的「北星（North Star）」与活跃项目快速加载、会话后的脑暴 dump 转结构化笔记、Slack 事故消息拉链分析与时间线生成、人脉画像与 1:1 笔记、Decision Record 自动建档，以及每日 wrap-up 的索引更新和 brag doc 自动抓取。

设计原则是 「agent 负责执行，vault 负责记忆」：不替代 agent，而是给它一个会自己生长的大脑；agent 在前台跑，Obsidian 在后台沉淀。原则还强调「ShardMind 是增量的、非承重的」——本意是增量的、非必需组件，即把 .shardmind/ 删掉，仓库本身依然按裸 git clone 形式完整可用。

认可度

  • GitHub Stars：约 4,896 星（截至 2026-10-05）
  • Forks：约 551
  • GitHub Trending 经历：2026-10-05 进入日榜 trending，单日 +34 stars
  • 下载/使用量：通过 npm 全局安装 shardmind 后一键 shardmind install github:breferrari/obsidian-mind；也可裸 git clone
  • README 多语言：英 / 日 / 中 / 韩四语 README，开发者画像偏国际化
  • 社区标签：Topics 覆盖 claude-code codex-cli gemini-cli obsidian persistent-memory second-brain，是 Obsidian 生态 × Agent 记忆的交叉点

链接

GitHub 仓库：https://github.com/breferrari/obsidian-mind

原作者

GitHub 用户名 breferrari（Bruno Ferrari）。同时是 ShardMind（Obsidian vault 模板的包管理器）的作者——Obsidian Mind 是其 ShardMind 生态的第一个明星模板，定位为「给 AI 编程 Agent 用的 Obsidian vault 模板」。开发者画像偏独立开发者 / 效率工具方向。

介绍

Obsidian Mind 是一份 Obsidian 知识库模板，目标用户不是人，而是 跑在你终端里的 AI 编程 agent。它把一个本地 vault 切成 brain/（北星、目标、信念）、work/active/（正在做的项目）、org/people/（同事与 1:1）、perf/（brag doc、复盘）、decisions/（决策记录）这几个固定分区，并提供了一组斜杠命令让 agent 边干边写：早上 /om-standup 会自动把北星、活跃项目、最近 git 改动拼成早会简报；会上 /om-dump 把口头脑暴转成结构化笔记与人脉档案；事故时 /om-incident-capture 会调 slack-archaeologist 拉完整时间线；下班 /wrap-up 会校验所有笔记链接、更新索引、让 brag-spotter 找出还没归档的成果。

最值得介绍的是它把 Obsidian CLI、Obsidian Skills、QMD 语义搜索 串成了一条端到端 Agent 记忆管线：agent 写笔记 → Obsidian CLI 渲染 → QMD 索引 → 下次 session 自动检索注入。换句话说，这是 2026 年少数把 second brain 概念从「人用 Notion/Obsidian 记笔记」真正搬到「AI agent 拥有自己的 brain」的落地项目。

特点

  • 跨 Agent 兼容：同一份 vault 同时支持 Claude Code（完整 hooks）、Codex CLI、Gemini CLI，写法、命令、记忆格式完全一致
  • 自组织而非自写：agent 不需要每次手动写笔记，slash 命令 + hook 会按固定分区自动归档
  • 人脉与决策专门成区：org/people/ 和 decisions/ 是默认目录，逼着 agent 把会议结论、人物偏好变成可检索资产
  • 可观测的「每天进展」：内置 perf/Brag Doc.md 与 work/active/ 状态追踪，解决 AI agent 工作「看不见摸不着」的盲区
  • 零 lock-in 设计：删除 .shardmind/ 与 shard-values.yaml 后，仓库仍按裸 git clone 完整运行

使用方法

前置：Node.js 22+、Obsidian 1.12+、启用 Obsidian CLI（Settings → General → Obsidian CLI）

方式一（推荐，ShardMind 一键安装）：

npm install -g shardmind
mkdir my-vault && cd my-vault
shardmind install github:breferrari/obsidian-mind

Wizard 会问你名字、团队、vault 用途、要接哪些 agent、是否启用 QMD，然后初始化 git 并把 brain/North Star.md 填好。

方式二（裸 git clone）：

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

最小示例（在 vault 目录里启动 agent）：

# 1. 打开 vault（让 Obsidian 接管渲染）
open obsidian-mind    # macOS
# 2. 启动 agent
claude               # 或 codex / gemini
# 3. 在 Claude Code 里直接说：
#    "start session"
#    "/om-standup"
#    "/om-dump Just had a 1:1 with Sarah, she wants error monitoring before release."

使用场景与人群

适用场景：
– 长期维护同一份代码库、每次 session 都要重述背景的工程师
– 多人协作的项目，需要把 1:1 反馈、事故复盘、决策记录结构化沉淀
– 希望把「GitHub 项目进度 + 同事关系 + 个人复盘」三件事合并到一个 vault 里
– 已经用 Obsidian 记笔记，但希望 agent 也能读、写、同步 同一份资料

目标用户：
– 独立开发者与外包顾问（每人维护多份 codebase，需要长期记忆）
– 工程经理 / Tech Lead（需要持续追踪团队决策与人脉）
– Obsidian 重度用户从邮件转向 Agent 工作流
– 任何被「agent 每次都问同一个背景问题」折磨的人

输入与输出案例

示例 1 — 早会自动简报

输入（用户在 Claude Code 里）：

start session

输出（agent 自动加载 vault 后回复）：

You have 2 active projects. The auth refactor is blocked on API contract.
Last session you decided to split the coordinator. Your 1:1 with Sarah is at
2pm — last time she flagged observability.

背后触发：/om-standup 读取 brain/North Star.md + work/active/*.md + org/people/Sarah Chen.md 最近 7 天笔记，拼成口语化简报。

示例 2 — 会后脑暴转结构化笔记

输入：

/om-dump Just had a 1:1 with Sarah. She’s happy with the auth work but wants
us to add error monitoring before release. Also, Tom mentioned the cache
migration is deferred to Q2. Decision: defer Redis migration. Win: Sarah
praised the auth architecture.

输出（agent 自动落盘）：
– 更新 org/people/Sarah Chen.md 增加本次会议上下文
– 新建 work/1-1/Sarah 2026-03-26.md 记录关键 take
– 创建 decisions/Defer Redis migration to Q2.md 决策记录
– 在 perf/Brag Doc.md 追加「Auth architecture praised by manager」
– 在 work/active/Auth Refactor.md 增加「error monitoring」任务

下次再开会，agent 只要 start session 就能立刻想起这些，不需要人肉复述。

GitHub: https://github.com/breferrari/obsidian-mind

评论区

0 条评论

登录后可评论。

Skill超级捕获手 72 阅读