second-brain

用途

Second Brain 技能用于捕获、编译、查询、检查和连接个人知识库（Second Brain）。它封装了 Karpathy LLM Wiki 工作流，作用于已有的 Obsidian 仓库或任意基于 Markdown 的仓库。仓库中的 CLAUDE.md 是权威 schema，技能负责编排用户此前手动执行的操作。

三层结构

raw/：未处理的原始素材，包括文章、摘录、想法、脑暴、推文等。按类型前缀命名（article-、idea-、highlights-、braindump-、note-、resource-、tweet-）。永不删除，是事实来源。
wiki/：AI 编译的主题页面。每个概念一页，而非每个来源一页。通过 [[wikilinks]] 互相链接，根目录有 INDEX.md。
outputs/：查询生成的产物，如研究摘要、分析、幻灯片。按描述性名称命名。

在 wiki 操作期间应保持不动的文件夹：Projects/、Daily/、Templates/、Inbox/、Notes/、Tasks.md、Kanban.md、Home.md。

使用方式

第一步：加载仓库配置与 schema

读取 references/vault-config.md 获取仓库路径（默认：${SECOND_BRAIN_VAULT:-$HOME/Documents/SecondBrain}/）。读取 <vault>/CLAUDE.md 获取权威 schema。若存在，优先于 references/schema.md。若不存在，回退到 references/schema.md。

第二步：解析模式

调用方式与模式对应：

/sb capture、/second-brain capture、"capture this"、"save this to my brain" → capture
/sb compile、"compile the wiki"、"process raw notes" → compile
/sb query <question>、"ask my brain X"、"what does my brain say about Y" → query
/sb lint、"lint the wiki"、"health check my brain" → lint
/sb connect、"find connections"、"suggest wikilinks" → connect
/sb search <term>、"search my notes for X" → search

第三步：运行模式

capture

输入：URL、粘贴文本、文件路径或截图。根据内容检测类型：URL → article-；带引用摘录的粘贴文本 → highlights-；用户自己的想法/脑暴 → braindump- 或 idea-；单条推文/X 帖子 → tweet-；PDF、视频、播客 → resource-；快速参考（食谱、命令、事实）→ note-。若不确定则询问。生成描述性文件名：<type>-<kebab-case-topic>.md。使用来源标题或主题，而非 URL slug。在顶部添加元数据：source: <URL if applicable>、captured: YYYY-MM-DD。保存到 <vault>/raw/。若来源是 URL，抓取文章内容并保存可读文本，而非仅保存 URL。报告路径和一行摘要。此处不编译进 wiki——capture 是快速录入，编译是单独的、有意的过程。

compile

昂贵但有价值的操作。将未处理的 raw 文件处理为 wiki 页面。查找未处理的 raw 文件：在 wiki/*.md 中 grep Sources 部分；未列出的 raw 文件即未处理。读取每个未处理的 raw 文件及现有 wiki/INDEX.md。对每个 raw 文件：提取关键概念、事实、见解；默认合并到已有 wiki 页面（若主题重叠），仅当概念无处可放时才创建新页面；每个概念一页，而非每个来源一页；为每个相关概念使用 [[wikilinks]]；在 wiki 页面的 ## Sources 部分添加 raw 文件，并附一行说明从中提取了什么。更新 wiki/INDEX.md：在对应分类下添加新页面（Creative / Health & Longevity / Faith & Personal Growth / Business / Personal Growth / Tech / Hobbies / Sci-Fi / Pets——或按需新建分类）；每条一行：- [[Page Name]] — brief description。每个 wiki 页面必须有 Connections 部分。若新页面没有连接，保存前先找到一个。质量优于数量。若页面少于 100 词，暂缓该 raw 文件并询问用户是否应合并到相邻页面。输出：创建/更新的页面列表、合并情况、暂缓待澄清的内容。

query

仅使用 wiki/raw 语料回答问题。与 deep-research（走外部）不同。读取 wiki/INDEX.md 识别可能相关的页面；读取这些页面并沿 [[wikilinks]] 遍历 1–2 跳；组织答案：按名称引用 wiki 页面，如 "Per [[Microplastics Detox]]..."；若 wiki 自相矛盾，呈现双方；若 wiki 不含答案，说明并提供运行 /deep-research 扩展。保存到 outputs/<YYYY-MM-DD>-<question-slug>.md，包含：原始问题、答案、查阅的 wiki 页面列表。在聊天中显示答案及保存输出的路径。可选渲染：若传入 --render pdf 或 --render html，通过 pandoc 使用共享样式表输出。

lint

对 wiki 做健康检查。检查：孤立页面（wiki/*.md 不在 INDEX.md 中）；连接孤立（页面没有指向其他页面的 [[wikilinks]]）；未处理 raw（raw 文件未列在任何 wiki 页面的 Sources 下）；过时页面（最近来源超过 6 个月且主题易变，如 AI、营销、金融、健康方案）；主题缺口（在 3+ 页面中提及但无专属页面的概念）；矛盾（wiki 页面提出相反主张而未标记）；缺失连接（明显相关主题的页面之间没有 [[wikilink]]，建议 /sb connect）。输出：按优先级排序的列表，最重要的在前（结构损坏优先于内容过时）。

connect

查找应链接但未链接的页面。从 INDEX.md 和页面摘要构建主题图；对每个页面，找到 2–5 个主题重叠的其他页面；检查每个候选是否已链接；建议缺失的链接——若用户批准，编辑页面将其添加到 ## Connections 部分。

search

在 wiki/ 和 raw/ 中快速 grep 某个词。返回匹配文件及匹配处周围 2 行摘录。当用户知道要找哪个页面时，比 query 更快。

与其他技能的协作

deep-research——当 query 发现 wiki 缺口时，路由到 deep-research 从外部来源扩展。deep-research 输出可捕获回 raw/ 供未来编译。

paste——将内容干净地捕获到 raw/（尤其适用于终端/CLI 捕获）。

business-brainstorm——在脑暴前检查 Portfolio of Businesses 和 Entrepreneurship & Startups wiki 页面获取相关上下文。

decide——在评分 Q34（"我们在弯曲哪些原则"）时从 Personal Philosophy / Productivity & Systems wiki 拉取原则。新增：Decision Log wiki 页面随时间累积决策的叙事形式（decide 归档是结构化形式；wiki 页面是故事）。

jab-hook——Content Ideas wiki 页面汇集钩子、框架和故事。/jab-hook 草稿从那里拉取候选。

slide-deck——在 outputs/ 中起草的内容成为幻灯片来源；演讲者备注可引用相关 wiki 页面。

pm——仓库中的 Projects/ 文件夹对 second-brain 不可访问；pm 拥有它。但 Workflow Docs wiki 页面捕获跨多个项目出现的操作模式。

质量说明

质量优于数量。更少但连接良好的 wiki 页面胜过许多单薄页面。若编译会产生单薄页面，暂缓 raw 文件待澄清。

不要抹平细微差别。若两个 raw 来源矛盾，wiki 页面应注明分歧，而非默默选边。

Connections 部分是强制的——每个 wiki 页面必须至少链接到另一个页面。

编译后永不删除 raw 文件。它们是事实来源。

在 second-brain 操作期间永不修改 Projects/、Daily/、Templates/、Notes/、Tasks.md、Kanban.md、Home.md 或 Inbox/ 中的文件。它们属于其他工作流。

技能介绍

用途