1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | second-brain-os |
| 作者/维护者 | Yaroslav “Yarchi” Rudenko(GitHub: undefined-ui,个人开发者) |
| 来源链接 | https://github.com/undefined-ui/second-brain-os |
| 许可证 | MIT(GitHub API 获取) |
| GitHub Stars | 567(GitHub API 获取) |
| Forks | 97(GitHub API 获取) |
| 最新版本 | 无正式发布版本,main 分支持续滚动更新(GitHub API:无 releases/tags) |
| 安装方式 | git clone 仓库后复制 skills/、commands/、agents/、scripts/、vault-template/ 到本地 Obsidian 库 |
2. 功能介绍与亮点
second-brain-os 是一套让 AI agent 帮你维护个人知识库的完整工作流:把散落的文章、转录稿、聊天记录等原始材料摄取(ingest)成互相链接的 wiki 页面,并随着内容增多不断更新既有页面而非无序堆叠。
核心亮点:
- 18 个 agent skills 覆盖完整生命周期:摄取、写作、查询、审阅、去重合并、发布前检查、隐私审计、指标追踪、知识图谱导出、改主意时的矛盾调和等,每个 skill 职责单一、边界清晰。
- “矛盾即记录,不覆盖”的设计哲学:新材料与既有页面冲突时保留两种立场并标注日期来源,而非简单覆写。
- 内置发布前隐私审计:
second-brain-publish、second-brain-privacy两个 skill 专门检查凭据泄露、他人隐私信息、机密工作内容是否会随发布外泄。 - 77 页配套指南,从概念、搭建到故障排查逐节展开,另附知识图谱、agent harness 等 5 个延伸阅读专题。
- 零付费依赖,除 Obsidian(可选,仅作图谱查看器)外无强制第三方工具。
3. 适用场景
所属分类:内容创作与知识管理
适合读得多、记不住的人群——研究者、工程师、写作者、每周看大量技术视频却记不住内容的学习者。典型场景:把零散的读书笔记、会议转录、文章剪藏交给 agent 定期摄取整理,形成越用越聪明的个人知识图谱;定期让 agent 做知识库健康度体检(孤立页面率、平均连接度);在把笔记公开发布前先做隐私与泄露审计。不适合团队 wiki 或 Notion 替代场景,也不会帮从不更新的库自动变丰富。
4. 跨 Agent 兼容性
- Claude Code:原生支持——README 明确以 Claude Code 为主要运行环境,skills 直接复制进
.claude/skills/即可被发现 - Codex:需适配——skills 本身是纯 Markdown 指令、无 Claude 专属 API 调用,但 Codex 不会自动扫描技能目录,需手动在会话中引用 SKILL.md 路径
- OpenClaw:未验证——仓库未提及,按其技能加载机制推测需手动放置到位并引用
- Hermes Agent:需适配——Hermes 支持按路径扫描子目录发现 SKILL.md,但需先将
skills/放入其扫描路径
判断依据:全部 skill 均为不依赖特定 agent API 的纯 Markdown 指令文件,README 明确写“适用于 Claude Code 及任何能读文件的 agent”。
5. 推荐理由
比起单一功能的笔记类 skill,second-brain-os 把“摄取—链接—审阅—发布—维护”整条知识管理流程拆成 18 个职责明确的 skill 协同工作,且专门设计了隐私审计与矛盾调和这类容易被忽视但后果严重的环节。文档体量与维护频率(近日仍在持续提交)在同类中少见,适合想认真搭建长期知识库、而不只是记单条笔记的用户。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | GitHub 567 stars,2026-09-07 建仓、19 天内增长明显,但作者为个人开发者、暂无独立第三方媒体报道或社区讨论佐证 |
| 可用性 | 8 | 文档详尽(77 页指南)、近期持续维护;核心安装为几条复制命令,完整体验需按 9 步指南配置 Obsidian 与 MCP,故未到“一条命令即用” |
| 安全性 | 8 | 见下方检查清单 |
安全检查清单: ① Shell 命令:仅本地 Python 脚本(vault_stats.py 等)统计文件与链接,无 shell 执行需求,范围明确 ② 联网外发:抽查全部脚本源码未发现任何网络请求代码,MCP 连接为用户自行可选配置 ③ 凭据:核心功能不要求任何 API Key ④ 未发现可疑指令或 prompt injection 迹象,反而内置隐私审计与发布前泄露检查 ⑤ 作者信誉:个人开发者、无造假迹象 ⑥ License 明确(MIT)⑦ 近日仍有提交,维护活跃
7. 跟同类 Skills 相比的优势
| Skill | 定位 | 与 second-brain-os 的差异 |
|---|---|---|
| obsidian-second-brain | 让 Obsidian 笔记库自我改写、调和矛盾,零 API Key 依赖 | 聚焦“自我改写”单点能力,未拆分出发布审计、隐私审计等专项 skill |
| claude-obsidian | 自我组织的 Obsidian AI 第二大脑,自动摄取整理笔记 | 功能定位相近,但未见配套的多章节图文指南与工程脚本(图谱导出、指标追踪) |
| obsidian-wiki | 基于 Karpathy LLM Wiki 理念的可安装知识库框架 | 侧重理念落地,覆盖 skill 数量与发布前安全检查环节均少于 second-brain-os |
| obsidian-skills | Obsidian 联合创始人亲自维护,覆盖笔记核心格式与官方 CLI | 官方出品、格式层面更权威,但不含摄取/审阅/发布这类工作流层 skill |
second-brain-os 的差异化在于把知识管理拆成完整的 18 步工作流并配齐隐私与发布环节,而非只做笔记自组织这一个动作。
8. 用户评价
该技能目前在第三方平台(Reddit、Hacker News、具名技术博客)尚无独立验证的用户评价;仓库自身的 GitHub Issue 区留言暂无具体使用反馈内容。
9. 其他补充
仓库额外附带 5 个“tracks”延伸专题(知识图谱构建、agent harness 设计、循环工程、评测工程等),每个专题都配一个可在一个晚上完成的动手练习,属于知识库主题之外的加分内容。
10. 安装使用方式
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
cp -r second-brain-os/scripts ~/brain/scripts
cd ~/brain && claude
安装后建议按仓库 docs/02-setup/ 下的九步指南依次配置 Obsidian、CLAUDE.md 与知识库两层结构;MCP 连接为可选步骤,跳过不影响基础摄取与查询功能。Windows 用户需用 python 代替 python3(后者常被 Microsoft Store 占位程序劫持)。
11. 注意事项
- 完整体验依赖 Obsidian 作为图谱查看器,纯命令行场景下部分功能(图谱可视化)价值打折
- 个人开发者维护的项目,无正式版本号,需自行关注 main 分支变更
- 知识库随内容增长后,摄取与关联工作量会上升,需按指南定期做健康度检查与维护排期