eugeniughelbur/obsidian-second-brain
GitHub: eugeniughelbur/obsidian-second-brain
将 Obsidian 笔记库转化为由 Claude 驱动的自治第二大脑,解决会话不连续与知识碎片化问题。
Stars: 152 | Forks: 23
obsidian-second-brain
你的 Obsidian 知识库是累赘。这项技能让它活起来。
25 条命令 · 自重写知识库 · 自动综合 · 与你辩论的思考工具 · 4 个定时代理 · 4 种角色预设
查看演示 ·
所有命令 ·
安装 ·
预设 ·
讨论
## 问题
你每天使用 Claude。每次会话都从头开始。你需要重新解释一切。对话结束,一切消失。
你在 Obsidian 中做笔记。数百个文件静静地躺在那里。你因为六个月前做过某个决定而再次做出同样的决定。想法在每日笔记中腐烂。没有人连接这些点。
**两种强大的工具。完全脱节。**
## 安装后会发生什么
**会议结束后:** `/obsidian-save`
Claude 提取每一个决策、人、任务和想法,并将它们保存到正确的笔记中。你什么都不用做。
**你录制了一段语音备忘录:** `/obsidian-ingest meeting.m4a`
Claude 使用 Whisper 转写,识别说话人,提取每一个承诺和行动项,并分发到实体页面、看板板和每日笔记中。
**你截了一张白板照片:** `/obsidian-ingest photo.png`
Claude 读取图像,提取文本和结构,创建概念笔记,并链接到相关项目。一张照片变成知识。
**你找到一个很棒的视频:** `/obsidian-ingest https://youtube.com/...`
Claude 不会只总结成一个笔记。它会**重写**你的现有页面。人们得到更新。矛盾得到解决。模式触发新的综合页面。一个 URL 进入。你的知识库变得更智能。
**在做重要决定之前:** `/obsidian-challenge`
Claude 在你的知识库中搜索同一主题过去的失败和反复的决定。用你自己的话提出反对意见。你的知识库让你负责。
**你想看到大局:** `/obsidian-visualize`
Claude 生成你整个知识库的可视化画布。中心是枢纽节点,按类型着色,孤儿笔记高亮。在 Obsidian 中打开它,看到你知识的结构。
**你去睡觉时:** 夜间代理运行 5 个阶段——结束一天、解决矛盾、综合跨源模式、修复孤儿笔记并重建索引。醒来时你的知识库更聪明。
**你开始新的一天:** `/obsidian-daily`
Claude 将你的日历事件、逾期任务和夜间变更提取到今天的笔记中。你的早晨从已知信息开始。
**你永远不需要打开 Obsidian。** 所有事情都通过 Claude 完成。
## 之前与之后
| | 没有这项技能 | 拥有这项技能 |
|---|---|---|
| 保存决策 | 复制粘贴或丢失 | 自动保存到正确的项目笔记 |
| 每日笔记 | 自己写,一半时间会被忘记 | 自动创建 |
| 寻找模式 | 重读数十个笔记 | `/emerge` 为你发现它们 |
| 挑战自己 | 没有人反驳 | `/challenge` 用你自己的历史反驳你 |
| 会话连续性 | 每次都要重新解释 | `/world` 在 10 秒内加载完整上下文 |
| 摄入内容 | 阅读后忘记 | `/ingest` 从一个来源(URL、PDF、音频、截图)重写 5-15 个知识库页面 |
| 矛盾 | 你不知道它们存在 | `/reconcile` 自动解决它们 |
| 综合 | 你手动连接点 | `/synthesize` 自动跨源寻找模式 |
| 共享知识库数据 | 只有 Claude 能读 | `/export` 给任何 AI 工具提供干净的快照 |
| 事实随时间变化 | 旧信息被覆盖 | 双时态事实记录它何时为真 以及 知识库何时学会它 |
| 启动新会话 | 重新解释你是谁 | `CRITICAL_FACTS.md` 在约 120 个令牌内加载你的身份 |
## 工作原理
```
+------------------------------------------+
| |
| LAYER 1: Operations (20 commands) |
| Claude remembers everything |
| |
+------------------------------------------+
| |
| LAYER 2: Thinking Tools (4 commands) |
| Claude thinks with you |
| |
+------------------------------------------+
| |
| LAYER 3: Context Engine (1 command) |
| Claude knows who you are |
| |
+------------------------------------------+
| |
| ALWAYS ON |
| Background agent + 4 scheduled agents |
| Auto-synthesis + save reminders |
| |
+------------------------------------------+
```
**第一层**保存、组织、摄入、解决矛盾、导出并维护你的知识库。
**第二层**挑战你的想法,揭示隐藏模式,连接不同领域,并将想法升级为项目。
**第三层**加载你的身份和当前状态,使每个会话从上一个会话结束处继续。
**始终在线**在不需你动手的情况下保持知识库活跃。
## 24 条命令
### 操作 —— Claude 会记住
| 命令 | 作用 |
|---|---|
| `/obsidian-save` | 保存对话中的所有内容——决策、任务、人员、想法 |
| `/obsidian-ingest` | 放入一个 URL、PDF、音频文件或截图。知识库会**重写**自己。每个来源影响 5-15 页。 |
| `/obsidian-synthesize` | 自动跨来源寻找模式并写入综合页面 |
| `/obsidian-reconcile` | 查找矛盾并解决它们。知识库维护自己的真相。 |
| `/obsidian-export` | 导出可被任何 AI 工具读取的干净 JSON/Markdown 快照 |
| `/obsidian-daily` | 创建或更新今天的每日笔记 |
| `/obsidian-log` | 记录工作会话并将其链接到各处 |
| `/obsidian-task` | 将任务添加到正确的看板并设置优先级和截止日期 |
| `/obsidian-person` | 创建或更新人物笔记 |
| `/obsidian-decide` | 将决策记录到正确的项目笔记 |
| `/obsidian-capture` | 零摩擦想法捕获 |
| `/obsidian-find` | 带有上下文的智能搜索 |
| `/obsidian-recap` | 某天、一周或一个月的摘要 |
| `/obsidian-review` | 结构化每周或每月回顾 |
| `/obsidian-board` | 看板视图及更新 |
| `/obsidian-project` | 包含看板和每日链接的项目笔记 |
| `/obsidian-health` | 知识库审计——矛盾、空白、陈述过时、孤儿笔记 |
| `/obsidian-adr` | 决策记录——知识库知道为何这样构建 |
| `/obsidian-visualize` | 生成可视化画布地图——查看你的第二大脑的形状 |
| `/obsidian-init` | 生成 `_CLAUDE.md`、`index.md`、`log.md` |
### 思考 —— Claude 与你一起思考
| 命令 | 作用 |
|---|---|
| `/obsidian-challenge` | 你的知识库用你自己的历史来反驳你的想法 |
| `/obsidian-emerge` | 从 30 天的笔记中浮现你从未命名过的模式 |
| `/obsidian-connect [A] [B]` | 连接两个不相关的领域以激发新想法 |
| `/obsidian-graduate` | 将一个想法片段升级为包含任务、人员和看板条目的完整项目 |
### 上下文 —— Claude 认识你
| 命令 | 作用 |
|---|---|
| `/obsidian-world` | 加载身份 + 状态,采用渐进式令牌预算(L0-L3) |
查看思考工具的实际效果
**`/obsidian-challenge`**
你:*“我想用 Rust 重写 API。”*
Claude 找到你 2025 年的事后总结,其中 Rust 重写失败了。找到你提交的决定日志,承诺两年使用 TypeScript。它说:*“你的笔记显示这已经失败过。你仍然要继续吗?”*
**`/obsidian-emerge`**
Claude 扫描 30 篇每日笔记。你在 4 个无关项目中提到了“入职摩擦”。
*“入职摩擦是你所有项目的瓶颈。你从未给它命名。”*
**`/obsidian-connect "distributed systems" "cook"`**
追踪你图谱中的两个簇群。找到共享概念:准备和负载分配。生成 3 个可操作的交叉领域想法。
**`/obsidian-graduate`**
三周前的一个想法。Claude 读取它,找到相关项目和人员,生成包含目标、阶段、任务和看板条目的完整规范。想法被打上 `graduated` 标签。
查看 /obsidian-ingest 的实际效果
```
/obsidian-ingest https://youtube.com/watch?v=example
```
1. 保存原始内容到 `raw/videos/`(不可变)
2. 用新上下文重写实体页面
3. 如果来源增加深度或矛盾,重写概念页面
4. 创建综合页面(当模式出现时)
5. 解决矛盾并记录原因
6. 更新 `index.md`、`log.md` 和每日笔记
**一个 URL 进入。知识库自我重写。**
## 知识库是活的
传统知识库是文件柜。你放进去东西,它们就躺在那里。
这个知识库会随着每一次输入自我重写:
- **摄入一个来源**——现有页面被重写,矛盾被解决,模式被综合
- **保存一次对话**——实体、概念和决策分发到整个知识库
- **提出一个问题**——双输出规则意味着每个答案也会更新页面
- **一个事实发生变化**——双时态事实记录它何时为真 以及 知识库何时学会它。“你周二相信 X。周三摄入 Y 后,你转向 Z。”完整的审计追踪。
- **什么都不做**——后台代理和定时代理在你睡觉时维护它
- **等待一周**——自动综合跨来源模式并写入连接页面
一周后的知识库与你刚开始时完全不同。
## 选择你的预设
在启动时选择你的角色。每个预设会创建定制的文件夹结构、模板和看板。
| 预设 | 适用对象 | 看板风格 |
|---|---|---|
| **executive** | 创始人、运营者、经理 | OKR / 季度 / 每周 |
| **builder** | 开发者、工程师、架构师 | 待办 / 冲刺 / 完成 |
| **creator** | 作家、YouTuber、营销人员 | 想法 / 草稿 / 发布 |
| **researcher** | 学者、分析师、深度研究者 | 阅读 / 处理 / 综合 |
```
python bootstrap_vault.py --path ~/my-vault --name "Your Name" --preset builder
```
没有预设?你会得到一个适用于所有人的通用知识库。
## 后台代理与定时代理
**后台代理:** 在每次上下文压缩后触发。你继续工作。知识库自我更新。
```
PostCompact -> obsidian-bg-agent.sh -> claude -p (headless) -> vault updated
```
**定时代理:**
| 代理 | 时间 | 作用 |
|---|---|---|
| `morning` | 上午 8 点 | 每日笔记 + 逾期任务 |
| `nightly` | 晚上 10 点 | 睡眠时间整合:结束一天、解决矛盾、综合、修复孤儿笔记 |
| `weekly` | 每周五 18:00 | 每周回顾 |
| `health` | 每周周日 21:00 | 知识库健康审计 |
**保存提醒:** 当对话超过 10 条或你说“完成”或“谢谢”时,Claude 会提醒你使用 `/obsidian-save`。不会丢失任何对话。
## 知识库架构
### 维基风格(默认)——LLM 优先
Claude 是读者和写作者。知识库是数据库。
```
vault/
+-- _CLAUDE.md # Operating manual
+-- index.md # Page catalog (Claude reads FIRST)
+-- log.md # Activity timeline
+-- SOUL.md # Your identity
+-- CRITICAL_FACTS.md # ~120 tokens, always loaded (timezone, manager, location)
+-- raw/ # IMMUTABLE source material
+-- wiki/ # Claude's workspace
| +-- entities/ # People, companies, tools
| +-- concepts/ # Ideas, frameworks, synthesis
| +-- projects/ # Project notes
| +-- daily/ # Daily notes
| +-- logs/ # Work session logs
| +-- reviews/ # Weekly/monthly reviews
| +-- tasks/ # Task notes
| +-- decisions/ # ADRs
+-- boards/ # Kanban boards
+-- templates/ # Note templates
```
Obsidian 风格(备选)——适合日常浏览
```
vault/
+-- Daily/, Projects/, People/, Ideas/, Knowledge/
+-- Dev Logs/, Tasks/, Reviews/, Boards/, Templates/
```
```
python bootstrap_vault.py --path ~/my-vault --name "Your Name" --style obsidian
```
## 安装
一行命令:
```
curl -sL https://raw.githubusercontent.com/eugeniughelbur/obsidian-second-brain/main/scripts/quick-install.sh | bash
```
或者两条命令:
```
git clone https://github.com/eugeniughelbur/obsidian-second-brain ~/.claude/skills/obsidian-second-brain
bash ~/.claude/skills/obsidian-second-brain/scripts/setup.sh "/path/to/your/vault"
```
然后运行:`/obsidian-init`
## 哲学
大多数第二大脑工具让你当管家。
这项技能反过来做。你思考、工作、交谈。Claude 处理记忆。然后它利用这些记忆让你思考得更好——揭示你忽略的内容,挑战你的假设,连接你从未建立的联系,并综合你未曾请求的模式。
知识库不会增长,它会进化。
**你的笔记是护城河。**
灵感来自 [Andrey Karpathy 的 LLM-Wiki](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f)。
## 作者
由 **Eugeniu Ghelbur** 构建
[](https://x.com/eugeniu_ghelbur)
[](https://www.linkedin.com/in/eugeniu-ghelbur/)
[](https://github.com/eugeniughelbur/)
[](https://ghelburlabs.substack.com/)
## 许可证
MIT
标签:AI 助理, AI 笔记, Claude Code, CLAUDE.md, Obsidian 插件, 个人知识库, 命令工具, 思考工具, 技能, 日程代理, 智能写作, 知识管理, 第二大脑, 自动化笔记, 自动综合, 自改写知识库, 角色预设, 记忆增强, 跨平台上下文, 逆向工具