An AI second brain that maintains itself. Full guide, starter vault, agent skills and scripts for a self-organizing knowledge base in Claude Code and Obsidian.

AI 第二大脑 – 由 LLM 代理驱动的个人知识库

是什么 – 一个完整的开源指南和启动套件，可将 Obsidian 仓库自动转换为一个由 LLM（Claude Code）持续进行内容摄入、链接和整理的“第二大脑”。该仓库包含：

一个 仓库模板（维基 + 项目层），可本地克隆；
18 个“技能”（LLM 驱动的工作流）和 72 个斜杠命令，用于自动化内容摄入、链接、linting、统计、图谱导出等；
6 个子代理，可按计划或按需运行；
Python 脚本，用于健康检查和图谱统计。

所有繁重工作均由 LLM 代理完成：它读取原始文件（文章、PDF、转录文本、聊天导出），提取概念，创建/更新 wiki/ 下的密集链接 Markdown 页面，并保持仓库最新。用户只需 Obsidian（作为 Markdown 查看器）和 Claude Code 运行时；直到仓库大到需要 RAG 时，才需要外部向量数据库。

为什么重要

自托管与所有权 – 你的知识保留在你控制的纯 Markdown 文件中；唯一的“云端”组件是你调用的 LLM。
自动化枯燥工作 – 链接、矛盾追踪和增量更新均自动完成，解决了经典的“我保存了但从不归档”问题。
双层架构 – 一个维基用于记录你已知的内容，一个项目文件夹用于你正在进行的工作，各自拥有独立的 CLAUDE.md 流程，确保参考资料与活跃工作分离。
渐进式扩展 – 从纯 Markdown 开始；只有当仓库达到“向量数据库阈值”时，指南才建议引入 GraphRAG。

核心组件（如 README 所述）

组件	作用
`vault-template/`	包含维基结构、项目流程、页面模板和示例 `CLAUDE.md` 文件的启动 Obsidian 仓库。
`skills/`	18 个 LLM 驱动的技能，每个实现指南中描述的一个工作流（例如：摄入 → 提取 → 链接 → lint）。
`commands/`	72 个斜杠命令，将技能暴露在 Claude Code UI 中（例如：`/ingest`、`/graph-export`）。
`agents/`	6 个子代理（其中四个只读），用于运行计划维护、健康检查或按需查询。
`scripts/`	无依赖的 Python 工具，用于链接检查、仓库统计和图谱导出。
`plugins/`	Agents Course 通过两个命令安装的 Claude Code 插件；提供上下文审计器、目标测试生成器、门控查找器、Harness 审计器、评估启动器和循环批评者。
`docs/`	65 页的《第二大脑指南》（10 个章节，77 页），以及七模块的 Agents Course 和多个关于图谱、Harness、循环等的手册。
`resources/`	作者推荐的工具、论文和其他仓库的精选列表。

如何工作（高层次流程）

剪贴 / 保存原始材料 → raw/ 文件夹（文章、PDF、聊天日志）
        │
        ▼
   Claude 代理运行相应技能
        │   – 提取概念
        │   – 在 wiki/ 下创建/更新维基页面
        │   – 链接到现有页面，记录矛盾
        ▼
   结构化维基（每页一个概念，密集的维基链接）

一个并行的项目层采用相同模式，但聚焦于当前任务，每个项目都有自己的 CLAUDE.md 流程（输入 → 处理 → 输出 → 反馈）。

快速入门（来自 README 的步骤）

git clone 仓库，并将仓库模板复制到 ~/brain。
将 skills、commands、agents 和 scripts 复制到相应的隐藏 .claude 文件夹中。
安装 Obsidian，并以复制的文件夹作为仓库打开。
设置 Claude Code（LLM 运行时），并可选地启用 MCP 以实现远程访问。
在仓库内运行 claude 以启动代理。
使用内置的 /ingest 命令（或 Web Clipper）输入新源。
通过提供的代理安排维护任务（/metrics、/health、/graph-export）。

指南详细介绍了每一步，设有专门页面用于设置、摄入、结构化、图谱处理、代理、检索、输出、维护和故障排除。

适合谁使用

研究人员、工程师、作家、学生 – 任何大量消费内容并希望无需手动归档即可组织的人。
单人用户（该仓库明确表示 不适用于团队维基或 Notion 替代品）。
习惯使用终端和 Obsidian，且可访问 Claude Code（或任何能读取文件的 LLM）的人。

许可与社区

MIT 许可证 – 可自由 fork、修改和商用。
欢迎贡献；CONTRIBUTING.md 要求提供有来源的事实更新和有理由的工具添加。

TL;DR

second-brain-os 是 Karpathy 的 LLM-wiki 模式（LLM-wiki）的完全文档化、开源实现。它提供一个现成的 Obsidian 仓库、一套 Claude-Code 技能/命令，以及逐步指南，让 LLM 自动将你的原始阅读材料转化为一个你拥有的、动态链接的知识库。

undefined-ui/second-brain-os