obsidian-second-brain

obsidian-second-brain

obsidian-second-brain 的路由优先入口 ——将 Karpathy 的 LLM-Wiki 模式 发展为一个会自我改写的知识库。LLM-Wiki 应用会追加新页面，而这个技能会改写现有页面：自动更新人物信息、修订主张、替换过时事实、调和矛盾，并自行综合跨来源模式——趁你安睡时完成这一切。

关键词：obsidian second brain · self-rewriting vault · obsidian-save · obsidian-ingest

一个代码库，四种 CLI（Claude Code · Codex CLI · Gemini CLI · OpenCode），同一个大脑。

何时使用此技能

• 用户想要一个能自我维护的 Obsidian 知识库，而不是静态文件柜。
• 用户想要将工作内容收录到知识库中：保存对话、摄取 URL / PDF / 音频 / 截图、记录会话、创建每日笔记、跟踪任务 / 人物 / 决策。
• 用户想让知识库自动调和矛盾并综合跨来源模式。
• 用户想要能提出质疑的思考工具：根据用户自己的历史审视某个决定、召集视角小组、揭示尚未命名的模式、关联无关领域。
• 用户想要将研究内容纳入知识库：深入阅读 X 帖子、扫描 X 趋势、带引文的网络研究、知识库优先的深度研究、基于来源的 NotebookLM 综合、YouTube / 播客转录文本。
• 用户想在 Claude Code、Codex CLI、Gemini CLI 或 OpenCode（包括 Hermes 等开源模型）上安装第二大脑技能。
• 用户想扫描代码库，并将持续维护的架构笔记写入知识库（/obsidian-architect）。

如果实际任务范围更窄，请转至：

• obsidian — Obsidian 插件开发、CLI 自动化、URI 交接、JSON Canvas、Bases 内容模式。
• llm-wiki — 底层原始 / wiki Markdown 层、来源摘要、查询归档、lint 检查。
• okf — 将知识库导出为可移植、与供应商无关的 Open Knowledge Format 捆绑包。
• notebooklm — 在知识库工作流之外，独立进行基于来源的 NotebookLM 查询。
• scrapling — 当你只需要提取原始内容而非摄取到知识库时，使用自适应网页抓取。

在 jeo 中调用 — $ 入口

在 jeo-code（jeo）中，技能只能通过 $ 入口加载，不能通过输入 /slash 加载。aliases: frontmatter 仍会将全部 45 个名称发布到 jeo skills、技能选择器和 Shell 自动补全中，供用户发现；但实际触发方式是：

$obsidian-second-brain <command-or-intent> [args]

$obsidian-s（或任何无歧义的前缀）也能解析；单独使用 $obsidian 不行—— 它会精确匹配另一个独立的 obsidian 技能。技能标记之后的所有内容都会作为 意图传递给此文件。请按以下规则确定性地分派意图：

1. 显式命令 — 如果意图的第一个词与 45 个命令名之一匹配 （可带或不带前导 /，可带或不带 obsidian- 前缀），则运行该 精确命令，并将该行其余部分作为参数。以下所有写法都会路由到 /obsidian-ingest：

   $obsidian-second-brain /obsidian-ingest https://example.com/post
   $obsidian-second-brain obsidian-ingest https://example.com/post
   $obsidian-second-brain ingest https://example.com/post
   

   更多示例：

   $obsidian-second-brain save                    → /obsidian-save
   $obsidian-second-brain reconcile               → /obsidian-reconcile
   $obsidian-second-brain challenge "migrate to X" → /obsidian-challenge
   $obsidian-second-brain research-deep "rag eval" → /research-deep
   $obsidian-second-brain world                   → /obsidian-world
   $obsidian-second-brain x-read <url>            → /x-read
   

   保持原样、不添加 obsidian- 前缀的名称：create-command、 idea-discovery、notebooklm、podcast、research、research-deep、 vault-deep-synthesis、x-pulse、x-read、youtube。

2. 自然语言意图 — 如果第一个词不是命令名，则按照下方第 1 步（层级 → 命令） 对请求进行分类，并在执行前说明路由，例如 $obsidian-second-brain save everything from this chat → “Operations → /obsidian-save”。

所选命令的行为、AI 优先的知识库规则和传播机制与斜杠版本完全相同——只有触发方式（$ 而非 /）不同。完整命令表见 references/commands.md。

说明

步骤 1 — 将请求归类到 4 个层级之一

此技能分为四个层级，另有一个始终运行的自动化层。先选择层级，再选择命令。完整命令表见 references/commands.md。

层级	用途	在用户想要以下内容时选择…
1 · 运维（28 个命令）	Claude 记忆	保存、摄取、协调、导出、每日笔记、任务、人员、决策、日历、项目／知识库维护、架构笔记
2 · 思考工具（7 个命令）	Claude 与你共同思考	挑战一个想法、召集讨论小组、发现模式、连接不同领域、深度综合某个主题、排列后续方向、将一个想法发展为项目
3 · 上下文引擎（1 个命令）	Claude 了解你是谁	使用渐进式令牌预算加载身份和状态（/obsidian-world）
4 · 研究工具包（7 个命令）	Claude 获取知识	阅读／追踪 X、网络研究、知识库优先的深度研究、NotebookLM、YouTube、播客
始终运行	知识库持续更新	后台 Agent（压缩后）+ 4 个定时 Agent（早晨／每晚／每周／健康检查）+ 保存提醒

执行前明确说明处理路径，例如 “运维 → /obsidian-ingest” 或 “研究 → /research-deep（知识库优先）”。

步骤 2 — 每次写入都遵守 AI 优先知识库规则

这是核心原则，适用于每次笔记写入，无论使用哪种模型：

• 每篇笔记都以 ## For future Claude 前言开头（说明这篇笔记是什么、为何重要以及如何使用）。
• Frontmatter 用于 大模型检索，而非人工审核（类型、标签、时效标记、原样保留的来源）。
• 重写，不要追加：当来源补充了深度信息或与某个页面矛盾时，重写该页面并记录原因。
• 双时态事实：记录事实何时成立，以及知识库何时获知该事实（“你在星期二相信 X；星期三摄取 Y 后，你转而相信 Z。”）。
• 双输出规则：每个回答还要更新相关页面。
• raw/ 不可修改——原始来源绝不编辑，只能在 wiki/ 中进行摘要／重写。

步骤 3 — 运行匹配的命令并传播更新

对于高杠杆工作流：

• /obsidian-save — 从对话中提取每项决策、人员、任务和想法，并将其分别写入相应笔记。
• /obsidian-ingest <url|file|image|audio> — 将原始内容保存到 raw/（不可修改），然后重写 5–15 个实体／概念页面，解决矛盾，创建综合页面，并更新 index.md / log.md / 每日笔记。
• /obsidian-reconcile — 查找整个知识库中的矛盾并解决，同时记录原因。
• /obsidian-synthesize — 发现未命名的跨来源模式并撰写综合页面。
• /obsidian-challenge — 在知识库中搜索该主题过去的失败／反转决策，并用用户自己的话提出质疑。
• /research-deep <topic> — 先扫描知识库、找出空白，再仅通过 Perplexity（网络）+ Grok（X）或无需密钥的免费来源填补空白，随后将更新传播到相关人员／项目／想法中。知识库优先意味着不会对你已知的内容重复研究。

第 4 步 — 按需为目标 CLI 安装／构建

各 CLI 的安装路径不同；vault 行为一致。完整矩阵和 research-toolkit 密钥表见 references/install.md。

• 插件（推荐用于此 jeo-skill 入口）： npx skills add https://github.com/akillness/jeo-skills --skill obsidian-second-brain（或运行 bash scripts/install.sh）。
• jeo-code（jeo）： 自动发现。通过 $ 入口调用 — $obsidian-second-brain <command-or-intent>（参见 在 jeo 中调用）；aliases: frontmatter 中的 45 个名称会显示在 jeo skills／选择器／自动补全中，供用户发现，但 jeo 不会通过输入 /slash 加载技能。JEO=1 VAULT=<dir> bash scripts/install.sh 还会注册一个建议性的写入时 AI 优先验证器，作为 post-turn hook（使用 jq 合并并备份、仅追加、幂等；使用 UNINSTALL=1 移除）。Claude 专属的 / 调色板、SessionStart 加载器和 PostCompact Agent 未移植 — jeo 不支持这些 hook 事件。
• 上游 Claude Code： 运行 curl -fsSL https://raw.githubusercontent.com/akillness/obsidian-second-brain/main/scripts/quick-install.sh | bash，然后运行 /obsidian-init。
• 上游 Codex / Gemini / OpenCode： 运行 git clone，然后运行 bash scripts/build.sh --platform <codex-cli|gemini-cli|opencode>，并将 dist/<platform>/ 复制到 vault 中。Codex 需要运行 bash scripts/install-codex-wrappers.sh 来安装命名命令的包装脚本。
• Research toolkit（可选）： 运行 cp .env.example ~/.config/obsidian-second-brain/.env，添加密钥，然后运行 uv sync。或者运行 bash scripts/install.sh，并在 research 提示中回答“y”。/research + /research-deep 无需密钥即可使用。

第 5 步 — 按需设置自动化，让 vault 保持活跃

• 后台 Agent：每次上下文压缩后触发（PostCompact → 无头 claude -p → 更新 vault）。
• 计划任务 Agent：morning（每天上午 8 点创建每日笔记 + 处理逾期事项）、nightly（晚上 10 点进行整合：关闭 + 对账 + 综合 + 修复孤立项 + 重建索引）、weekly（周五下午 6 点回顾）、health（周日晚上 9 点审计）。
• 保存提醒：对话交流达到 10 轮以上，或用户说“完成”／“谢谢”时，提醒使用 /obsidian-save。

vault 布局、预设（高管／构建者／创作者／研究者）和 Agent 详情见 references/vault-architecture.md。

完整性防护

• 绝不捏造 vault 事实、引文或研究来源。研究笔记须逐字记录来源，并标注时效信息 (as of YYYY-MM, source.com)。
• 优先改写而非追加，但绝不悄然删除相反主张 — 应进行对账并保留审计轨迹（双时态事实）。
• 遵守 raw/ 不可变规则 — 原始来源为只读。
• 开源模型遵循指令的可靠性不如 Claude。 对综合密集型命令（/obsidian-architect、/obsidian-reconcile、/research-deep），优先使用 Claude 或 hermes-4-405b；每次写入仍须遵守 vault 的 AI 优先规则。
• API 密钥保留在本地 — 存放于 ~/.config/obsidian-second-brain/.env，设置权限 chmod 600，绝不提交。

参考文件

• references/commands.md — 按层分类的全部 45 个命令，含触发条件和功能说明。
• references/install.md — 4 种 CLI 的安装矩阵、Hermes／开源模型设置、research-toolkit 密钥表。
• references/vault-architecture.md — vault 布局、预设、后台与计划任务 Agent、vault 的 AI 优先规则。

上游：akillness/obsidian-second-brain （源自：eugeniughelbur/obsidian-second-brain，MIT）。