second-brain

Second Brain — 入门向导

使用 LLM Wiki 模式设置新的 Obsidian 知识库。大模型将担任图书管理员，阅读原始资料，将其整理成结构化、相互关联的 Wiki，并随着时间推移持续维护。

向导流程

引导用户完成以下 5 个步骤。每次只问一个问题。每个步骤都有合适的默认值，用户可以接受默认值，也可以提供自己的值。

步骤 1：知识库名称

询问：

“你想给知识库取什么名字？这将作为文件夹名称。” 默认值：second-brain

接受用户提供的任何名称。此名称将作为文件夹名称以及 Agent 配置中的标题。

步骤 2：知识库位置

询问：

“你想把它创建在哪里？请提供路径，否则我将使用默认路径。” 默认值：~/Documents/

接受任何绝对路径或相对路径。将 ~ 解析为用户的主目录。最终知识库路径为 {location}/{vault-name}/。

步骤 3：领域／主题

询问：

“这个知识库的主题是什么？这有助于我设置相关标签并描述知识库的用途。”

示例：“AI 研究”“金融科技初创公司的竞争情报”“个人健康与健身”

接受自由文本。使用该内容来：

• 为 Agent 配置编写一行领域描述
• 生成 5-8 个领域专属的建议标签

步骤 4：Agent 配置

自动检测正在运行此技能的 Agent。明确说明：

“我正在 [Agent Name] 中运行，因此我会为此知识库生成 [config file]。”

然后询问：

“你还会使用其他想要生成配置文件的 AI Agent 吗？可选项：Claude Code、Codex、Cursor、Gemini CLI——也可以跳过。”

跳过自动检测到的 Agent。为所有选中的 Agent 生成配置。

Agent 检测逻辑：

• 如果正在使用 CLAUDE.md 约定，或 Skill 工具属于 Claude Code → Claude Code
• 如果环境表明正在使用 Codex → Codex
• 如果工作目录中存在 .cursor/ → Cursor
• 如果正在使用 GEMINI.md 约定 → Gemini CLI
• 如果无法确定，询问用户正在使用哪个 Agent

步骤 5：可选 CLI 工具

询问：

“这些工具可以扩展大模型使用知识库的能力。全部为可选项，但建议安装：”

1. summarize — 从 CLI 总结链接、文件和媒体
2. qmd — 适用于 Wiki 的本地搜索引擎（随着内容增多会很有帮助）
3. agent-browser — 用于网络研究的浏览器自动化

“全部安装、选择特定工具（例如‘1 和 3’），还是跳过？”

向导完成后：搭建知识库

收集完所有答案后，按顺序执行以下步骤：

1. 创建目录结构

运行入门脚本，并传入完整的知识库路径：

bash <skill-directory>/scripts/onboarding.sh <vault-path>

此操作会创建所有目录以及初始的 wiki/index.md 和 wiki/log.md 文件。

2. 生成 Agent 配置文件

对于每个选中的 Agent，从 <skill-directory>/references/agent-configs/ 读取对应模板：

Agent	模板	输出文件	输出位置
Claude Code	claude-code.md	CLAUDE.md	知识库根目录
Codex	codex.md	AGENTS.md	知识库根目录
Cursor	cursor.md	second-brain.mdc	<vault>/.cursor/rules/
Gemini CLI	gemini.md	GEMINI.md	知识库根目录

对于每个模板，替换占位符：

• {{VAULT_NAME}} → 步骤 1 中的知识库名称
• {{DOMAIN_DESCRIPTION}} → 根据步骤 3 的内容提炼的一行描述
• {{DOMAIN_TAGS}} → 根据步骤 3 中的领域生成 5-8 个相关标签，并以项目符号列表的形式列出
• {{WIKI_SCHEMA}} → 读取 <skill-directory>/references/wiki-schema.md，并插入从 ## Architecture 开始的全部内容

将生成的配置写入知识库。

3. 更新 wiki/log.md

追加设置记录：

## [YYYY-MM-DD] setup | Vault initialized
Created vault "{{VAULT_NAME}}" for {{DOMAIN_DESCRIPTION}}.
Agent configs: {{list of generated config files}}.

4. 安装 CLI 工具（如果已选中）

对于用户在步骤 5 中选择的每个工具，运行安装命令：

• summarize：npm i -g @steipete/summarize
• qmd：npm i -g @tobilu/qmd
• agent-browser：npm i -g agent-browser && agent-browser install

每次安装后，使用 <tool> --version 验证。分别报告每个工具安装成功或失败。

5. 打印摘要

向用户展示：

1. 创建的内容 — 目录树和配置文件
2. 必须完成的下一步 — 安装 Obsidian Web Clipper 浏览器扩展：

   安装 Obsidian Web Clipper，轻松将网页文章保存到你的知识库： https://chromewebstore.google.com/detail/obsidian-web-clipper/cnjifjpddelmedmihgijeibhnjfabmlf

3. 如何开始 — 在 Obsidian 中打开知识库文件夹，将文章剪藏到 raw/，然后运行 /second-brain-ingest

参考文件

此技能随附以下文件，可在 <skill-directory>/references/ 中找到：

• wiki-schema.md — 规范的知识库规则（所有 Agent 配置的唯一事实来源）
• tooling.md — CLI 工具详情、安装命令和验证步骤
• agent-configs/claude-code.md — CLAUDE.md 模板
• agent-configs/codex.md — AGENTS.md 模板
• agent-configs/cursor.md — Cursor 规则模板
• agent-configs/gemini.md — GEMINI.md 模板

后续步骤

设置完成后，用户的工作流如下：

1. 剪藏文章 — 使用 Obsidian Web Clipper 将文章剪藏到 raw/
2. 摄取来源 — 使用 /second-brain-ingest 将原始文件处理为知识库页面
3. 提出问题 — 使用 /second-brain-query 搜索并综合知识库内容
4. 健康检查 — 使用 /second-brain-lint，每摄取 10 次后或每月运行一次