📌 Skill 基础信息
- Skill 名称:setup-brain
- 简称:AI Brain Starter
- 来源:社区第三方(mycelium-hq)
- 运行宿主:仅限 Claude Code 桌面端应用
- 核心定位:通过交互式对话快速搭建或升级基于 Obsidian 的 AI 增强型个人知识库(第二大脑),集成记忆管理、自动化工具与日记系统。
🧩 内部核心组成
模块化阶段架构
采用 25 个严格顺序执行的阶段(Phase 0-24),每个阶段对应独立文件,涵盖从环境准备到高级功能集成的全流程。
核心组件
| 类型 | 名称/命令 | 功能简述 |
|---|---|---|
| 斜杠命令 | /setup-brain | 启动全流程交互式配置 |
| 诊断命令 | /diagnose | 检查常见故障点并提供修复方案 |
| MCP 工具 | 多种外部工具连接 | 集成邮箱、日历、Slack 等外部服务 |
| 模板文件 | CLAUDE.md 模板 | 生成智能记忆配置文件 |
| Obsidian 规则模板 | 设置知识库自动化规则 | |
| 团队周报技能模板 | 生成团队协作周报模板 | |
| Hooks 钩子 | 会话钩子、面板触发钩子 | 实现上下文自动路由与触发机制 |
| 规则约束 | 严格阶段顺序 | 禁止跳跃执行,确保完整性 |
目录结构
phases/ # 25个阶段执行文件
templates/generated/ # 各类生成模板
scripts/ # 辅助脚本(如安装遥测)
🛠 安装与启用方式
- 安装命令:
```bash
skills install --user mycelium-hq/ai-brain-starter
```
- 前置依赖:
- Git
- Obsidian 应用
- Claude Code 桌面端(必须)
- 启动方式:
- 安装后自动进入交互流程
- 或手动输入 /setup-brain 启动
- 升级检查:
- 自动检查 GitHub 版本更新
- 支持一键拉取最新代码
📋 标准工作流
- 环境检测(Phase 0):
- 自动安装必备效率工具(brew、python、node等)
- 配置 Graphify 和 MCP 服务
- 用户访谈(Phase 1):
- 语言选择(强制询问,不依赖系统默认)
- 模式识别(新建/加入/升级)
- 知识库构建(Phase 2-4):
- 安装 Obsidian 插件
- 创建文件夹结构和解析器
- 生成个性化的 CLAUDE.md 记忆文件
- 高级功能集成(Phase 5-23):
- 上下文笔记和会话钩子设置
- 日记系统搭建(包含地板框架和顾问面板)
- 外部工具连接(邮箱、日历等)
- 数据导入规则和备份设置
- 每周/每月洞察报告生成
- 收尾测试(Phase 24):
- 完整功能测试
- 使用指南交付
- 多语言支持的手把手教程
⚠️ 关键限制、缺陷、注意事项
- 平台限制:
- 仅支持 Claude Code 桌面端应用
- Web 版 Claude 和只读环境无法运行
- 资源消耗:
- 完整安装需要较长时间(25个阶段顺序执行)
- 阶段 23.5 的 graphify 操作 Token 消耗较大(可选)
- 适用项目:
- 适合:个人知识管理、团队协作知识库、长期学习项目
- 不适合:简单笔记需求、临时项目、无需AI增强的场景
- 已知坑点:
- Windows PowerShell 可能存在解析错误(需重新运行 bootstrap.ps1)
- 现有知识库的文件夹冲突需要手动处理
- 必须全程保持网络连接
- 生产环境:
- 可用于生产环境,但建议先测试再部署
- 具备故障诊断和恢复机制(/diagnose 命令)
✅ 适用场景 & ❌ 不适合场景
✅ 适用场景
- 个人用户:希望建立终身受用的AI增强知识系统
- 内容创作者:需要系统化管理和连接知识碎片
- 研究学者:进行跨领域知识整合和模式发现
- 团队协作:建立共享知识库和自动化周报系统
- 初学者:希望一键获得最佳实践的知识管理方案
❌ 不适合场景
- 临时笔记需求:只需要简单记录,无需系统化建设
- 低配置设备:无法运行Claude Code桌面端的环境
- 拒绝交互访谈:不希望参与配置过程的用户
- 极度隐私需求:不愿连接任何外部服务的场景
- 已有成熟体系:已有固定工作流且不愿改变的用户
如何安装
skills install --user mycelium-hq/ai-brain-starter通用安装教程:在哪里输入上面的命令
上面的命令本质是在「终端 / 命令行」中调用技能管理器,把该 Skill 下载并注册到你的 AI 工具。各主流工具打开终端的位置不同,按下面操作即可:
- 打开工具自带的终端面板,或系统终端(macOS「终端」、Windows「PowerShell」、Linux「Terminal」)。
- 把上面的安装命令复制进去,回车运行,等待下载与注册完成。
- 重启或重新加载 AI 工具,让新安装的 Skill 被识别。
- 新建对话并触发:直接描述用途,或通过该工具的技能 / 斜杠菜单选中此 Skill。
Claude 桌面版(macOS / Windows)
桌面版没有内置命令行,Skill 需通过 Claude Code CLI 安装。打开系统终端,先执行 npm install -g @anthropic-ai/claude-code,再运行上面的安装命令;完成后完全退出并重新打开 Claude。
Claude Code(终端 CLI)
直接在项目目录的终端里运行上面的命令即可。也可先输入 claude 启动交互界面,再在对话中引用该 Skill(/ 斜杠菜单或直接描述用途)。
VS Code(含 GitHub Copilot)
打开终端面板:菜单「终端 → 新建终端」,或快捷键 Ctrl+`(macOS 为 ⌃+`)。在终端里运行上面的命令;装完后执行「重新加载窗口」(Ctrl+Shift+P → Reload Window),让 Copilot 等扩展识别新技能。
Cursor
底部「终端」面板(Ctrl+`)即是内置终端。粘贴运行上面的命令,完成后在命令面板执行「Reload Window」刷新,再开始对话。
Windsurf
底部「终端」面板运行命令;也可直接使用其内置 Agent 终端,在对话侧执行安装。
其他工具(ChatGPT、本地脚本等)
不支持本地终端的产品,可先在本机终端完成安装,再在对话中描述该 Skill 的能力让其调用;不同工具的命令格式请以其官方文档为准。
风险提示
自动扫描未发现高危命令、隐私抓取或数据外传行为。仍建议安装前快速浏览仓库代码。
Aitishiku.com