技能包

Second Brain OS：用 Claude Code 搭一个自我整理的知识库

最适合用 Claude Code 把零散文章自动整理成互链知识库：安装需在终端 clone 仓库并复制 vault 与 skills，且只有完成链接才算摄取成功，不想动手配置的人不适合。

官方来源 · undefined-ui/second-brain-os

安装

git clone https://github.com/undefined-ui/second-brain-os.git && cp -r second-brain-os/vault-template ~/brain && mkdir -p ~/brain/.claude && cp -r second-brain-os/skills ~/brain/.claude/skills && cp -r second-brain-os/commands ~/brain/.claude/commands && cp -r second-brain-os/agents ~/brain/.claude/agents && cd ~/brain && claude

适合谁

  • 适合想用 Claude Code 搭建一个自我整理的知识库的人：你平时收集文章、笔记，希望它们被自动提取、建立双链并保持整洁，而不是堆成一堆没人再看的文件。
  • 它提供完整指南、初始 vault、agent skills 与脚本，围绕 markdown 文件、wikilink 和 SKILL.md 运行；也适用于任何会读文件的 agent。Obsidian 只是图谱查看器，不是依赖。
  • 不适合的情况：如果你想要一个即装即用的图形化笔记软件而不愿在终端里 clone 仓库、复制目录、运行 agent，这套流程不合适。官方证据未说明它支持哪些具体 agent 之外的客户端、支持哪些文本语言、以及是否有付费或账号要求以外的限制——免费、无需注册，但其他边界未知。

3 分钟完成第一次尝试

官方给出的主路径是在终端安装到本地 ~/brain，再在该目录启动 Claude Code：

  1. 前提：已安装 git、Claude Code（agent），建议同时装 Obsidian 以便查看图谱。
  2. 在终端执行官方安装命令，把初始 vault 与 skills、commands、agents 一起复制到 ~/brain/.claude：
git clone https://github.com/undefined-ui/second-brain-os.git
cp -r second-brain-os/vault-template ~/brain

mkdir -p ~/brain/.claude
cp -r second-brain-os/skills   ~/brain/.claude/skills
cp -r second-brain-os/commands ~/brain/.claude/commands
cp -r second-brain-os/agents   ~/brain/.claude/agents

cd ~/brain && claude
  1. 副作用与确认点：以上命令会在你的用户目录创建 ~/brain 并写入文件；如目标已存在，先自行确认是否覆盖。
  2. 触发一个低风险首次任务：把一篇文章保存/剪切为 raw/ 目录下的文件，然后在 Claude Code 中输入 /ingest。这是官方核心工作流：agent 会摄取、提取、建立链接并清理 raw 材料，整理成互链的 wiki。它会读写 vault 内的 markdown 文件；是否执行命令或访问网络，官方证据未说明，按未知处理。若文章含敏感内容，先脱敏再放入 raw/。
  3. 成功信号：raw/ 中的文章被整理成 vault 内带 wikilink 的笔记页面；官方规则是 "Nothing is ingested until it is linked"——同一轮里没有完成链接就等于摄取未完成。所以检查新页面里是否真的出现了指向其他笔记的链接，这是判断该轮 /ingest 是否结束的标准。官方证据未说明 /ingest 内部包含哪些检查 pass 或对不同文本类型是否有不同流程，这些不得假设。

使用案例

案例一：文章收藏入库。你平时用浏览器剪藏文章但从不回看。场景：把一篇文章剪藏保存到 ~/brain/raw/，在 Claude Code 中运行 /ingest。它会走官方的 ingest 工作流——提取要点、链接到已有笔记并清理。可期待结果：raw 文件被转化为链接化的 wiki 页面；若你发现新页面缺少链接，按官方规则该轮摄取视为未完成，可要求 agent 补齐链接。

案例二：用 Obsidian 查看知识图谱。场景：完成几次 ingest 后，想确认笔记之间的连接。做法：用 Obsidian 打开 ~/brain 这个 vault（Obsidian 是官方说明的图谱查看器），浏览笔记与 wikilink 形成的图。可确认的部分：vault 是纯 markdown 与 wikilink，Obsidian 能直接打开并显示图谱；官方未说明更深的自动联动或同步行为，不要期待超出查看器之外的集成。

使用边界

  • 文件访问：安装与运行会在本地创建和修改 markdown 文件（~/brain、raw/、.claude 目录）；这是流程的核心，而不是可选副作用。
  • 命令与网络：官方证据只给出上述 shell 安装命令；agent 在 ingest 期间是否执行其他命令或访问网络，证据未说明，属未知。
  • 确认点：在把敏感材料放进 raw/ 之前自行审查；覆盖已有 ~/brain 前自行确认。
  • 运行环境：需要本地终端、git 与一个会读文件的 agent（官方主路径使用 Claude Code）；需要 Obsidian 才能看图谱视图，但它不是依赖。除此之外官方未列出其他运行限制。
  • 未确认的关键信息：支持的 agent 名单是否只有 Claude Code（官方只说 works with Claude Code and any agent that reads files）、支持的文本语言、/ingest 之外还有哪些可用命令，均无证据，使用前可先在 skills、commands 目录中自行查看实际文件确认。