第二大脑仓库Anasemad76/obsidian-agent-second-brain

Obsidian Agent Second Brain

License: MIT
Obsidian
DeepSeek Harness

一个可克隆的个人第二大脑 —— Obsidian 仓库 + AI agent 技能。你拥有的纯 markdown。无数据库。无供应商锁定。

克隆 → 说 “Run onboarding” → AI 会问几个问题，并在几分钟内设置好你的仓库。

问题

- ChatGPT / Claude 聊天会忘记上下文，回答也会消失在历史记录中
- 仅使用 Obsidian / Notion 可以存储笔记，但不会为你完成工作
- 复杂的 PKM 系统需要数周才能设置好，而且永远不会被使用

解决方案

连接两个简单的部分：

| 部分 | 作用 |
|---|---|
| Obsidian 仓库 | 你的记忆 —— 磁盘上的纯 .md 文件 |
| AI agent | 读取你的笔记，运行技能，并将归档输出写回 |

你在 inbox/ 中捕捉杂乱的想法，将好的内容提升到 memory/，并运行每周简报和决策备忘录。一切都保存在无需 AI 也能打开的文件中。

工作原理

YOU                         OBSIDIAN VAULT              AI AGENT
───                         ──────────────              ────────
Answer onboarding    →     north-star.md        ←     onboarding skill
Brain dump ideas       →     inbox/               ←     brain-dump skill
Approve structure      →     memory/            ←     vault-structure skill
Review promoted notes  →     memory/projects/   ←     promote-notes skill
Weekly priorities      →     memory/weekly/     ←     weekly-brief skill

主要 agent： DeepSeek Harness（开源）
也适用于： Claude Code、Cursor，以及任何读取 AGENTS.md + .agents/skills/ 的 agent

快速开始

1. 克隆

git clone https://github.com/Anasemad76/obsidian-agent-second-brain.git
cd obsidian-agent-second-brain

2. 在 Obsidian 中打开

Obsidian → Open folder as vault → 选择此文件夹。

3. 在 AI agent 中打开

| Agent | 设置 |
|---|---|
| DeepSeek Harness（推荐） | npx @deepseek-ai/dsh web → 选择此文件夹作为工作区 |
| Claude Code | 打开文件夹 → 说 Run onboarding |
| Cursor | 打开文件夹 → 说 Run onboarding |

完整设置：SETUP.md

4. 运行 onboarding

Run onboarding

agent 会询问你的姓名、角色和目标，然后创建：

- north-star.md —— 你的一句话目标
- inbox/brain-dump.md —— 初始捕获文件
- 个性化的 AGENTS.md —— 你的个人资料部分

5. 扩展你的大脑

| 说这个 | 技能 | 结果 |
|---|---|---|
| Help me brain dump | brain-dump | 原始笔记 → inbox/ |
| Propose vault structure | vault-structure | 组织好的 memory/ 文件夹 |
| Promote my best ideas | promote-notes | 清理 memory/ 中的笔记 |
| Weekly brief | weekly-brief | 优先级 → memory/weekly/ |
| Decision memo for … | decision-memo | 选项 → memory/decisions/ |

仓库布局

obsidian-agent-second-brain/
├── AGENTS.md                 # 代理指令（模板 → 个性化）
├── north-star.template.md    # 模板（引导流程会创建 north-star.md）
├── inbox/                    # 原始收集内容
├── memory/                   # 长期沉淀的知识
│   ├── people/
│   ├── projects/
│   ├── concepts/
│   ├── decisions/
│   └── weekly/
├── projects/                 # 进行中的活跃工作
├── examples/                 # 演示笔记（不是你的数据）
├── .agents/skills/           # 6 个代理技能
│   ├── onboarding/
│   ├── brain-dump/
│   ├── vault-structure/
│   ├── promote-notes/
│   ├── weekly-brief/
│   └── decision-memo/
└── weekly-ritual.md          # 每周维护清单

技能

| 技能 | 作用 |
|---|---|
| onboarding | 首次问答式设置——先运行这个 |
| brain-dump | 捕捉杂乱想法，不必过度编辑 |
| vault-structure | 根据你的倾倒内容提议并创建 memory/ 文件夹 |
| promote-notes | 将重要想法从 inbox → memory（需批准） |
| weekly-brief | 为本周排出优先级 |
| decision-memo | 选项、权衡、建议——归档为一条笔记 |

技能是 .agents/skills/ 中的纯 markdown。可编辑它们以匹配你的工作流。

如何与 AI 日常配合使用

引导流程完成后，你不只是运行技能。你给代理一份工作。它会读取你的仓库并产出一个文件，而不是一个会消失的聊天。

规划你的工作

Read north-star.md and my notes in memory/ and projects/.
What are my top 3 tasks today? Write them to projects/today.md with a next step for each.

I have 2 hours tonight. Based on my notes, what should I work on first and why?

完成工作（基于你的上下文起草）

Read memory/projects/ for my current app.
Draft a short update I can send: what shipped, what's blocked, what's next.
Save it to projects/weekly-update.md.

Based on my notes about this API, list 5 next backend tasks ranked by impact vs effort.
File them under projects/.

会议之后或想法杂乱时

Here are messy notes from a call:
[paste]

Turn them into action items and owners. Update the matching project note in memory/.
Don't delete the original — also append a capture to inbox/.

I just thought of this: [paste].
Dump it into inbox/, then tell me if it belongs in a project, a decision, or later.

做决定（并保留答案）

Use decision-memo skill.
Decision: should I add Redis now or keep it simple until we have real load?
Read my project notes first. File the memo under memory/decisions/.

每周重置

运行 weekly-brief 技能。使用 north-star.md、inbox/ 和 memory/。
为下周的优先级排序。归档到 memory/weekly/。

模式始终如一：你的笔记 + 一个目标 → 在 vault 中归档的结果。

隐私

个人文件默认被 gitignore 忽略：

- north-star.md
- inbox/brain-dump.md
- 你在 memory/ 下提升的笔记

演示内容仅存在于 examples/ 中。除非你选择提交，否则你的 vault 会保留在你的机器上。

我为什么构建这个

我想要一个简单、开放、对初学者友好的第二大脑——而不是一个包含 30 个技能的企业级系统。这个模板：

- 小到可以一口气读完
- 可与开源的 DeepSeek Harness 和廉价模型配合使用
- 与 Claude Code / Cursor 兼容，适合已经使用这些工具的人
- 纯 markdown——随时更换 AI，保留你的笔记

文档

- SETUP.md — DeepSeek Harness、Claude、Cursor 设置
- weekly-ritual.md — 每周维护习惯
- CLAUDE.md — 供 Claude Code 用户参考的指引

贡献

欢迎提交 issue 和 PR。请保持模板小巧且对初学者友好。

许可证

MIT — 随你如何使用。