用途
setup-brain 是一个用于搭建用户“个人大脑”(brain)文件夹的 AI 技能。它的目标是在一个统一的文件夹中,按项目组织所有工作内容,让任何未来的智能体会话都能打开该文件夹、阅读一个文件,就能知道用户是谁、在做什么、以及所有东西放在哪里。
主要能力
- 安全检查:在创建前先确认目标文件夹(默认 ~/brain),若文件夹已存在且非空,不会覆盖任何内容,只补充缺失部分。
- 简短访谈:最多用 5 个问题了解用户的名字、职业、时区、业务/产品、当前正在做的事、偏好的沟通风格、以及现有笔记存放位置。
- 创建标准结构:生成包含 AGENTS.md、CLAUDE.md、projects/、archives/、notes/(journal、ideas、todos)、prompts/、scripts/、.agents/skills/、.claude/skills/、.tmp/ 的目录树,并添加 .gitignore。
- 编写 AGENTS.md:根据访谈内容生成一份不超过 120 行的核心指南,涵盖用户信息、目录结构、项目规范、卫生规则和技能管理。CLAUDE.md 仅包含一行
@AGENTS.md导入。 - 创建初始项目:为每个业务创建中心(hub)文件夹,为当前事项创建项目文件夹,并始终创建 perso/ 中心。每个项目和中心都包含一个 About.md 文件(含状态、更新日期、描述、关键信息、当前状态),只写入用户提供的事实。
- 安装 projects 技能:创建
.agents/skills/projects/SKILL.md,提供创建、加载、归档、列出项目的管理能力,并从.claude/skills/projects链接过去。 - Git 初始化:执行 git init 并创建首次提交 "brain: initial setup",可选询问用户是否创建私有 GitHub 仓库并推送。
- 最终检查与交接:逐项检查 AGENTS.md、CLAUDE.md、目录结构、每个项目的 About.md、projects 技能安装链接、git 初始化状态,并用简短列表展示结果。
使用方式
该技能通过对话式引导使用。用户只需触发该技能,按照提示回答问题即可。技能会逐步执行检查、访谈、创建结构、写入文件、安装技能、Git 初始化、最终检查等步骤。完成后,用户可以直接对智能体说“load project X”(加载项目 X)或“create a project for Y”(为 Y 创建项目),智能体会按照规范维护文件夹整洁。
适用场景
- 希望用 AI 智能体系统化管理个人与工作事务的用户。
- 需要将多个项目、笔记、待办、提示词和脚本统一收纳到一个文件夹中的用户。
- 希望未来任何智能体会话都能快速了解上下文并延续工作的用户。
- 希望在本地建立可版本控制(Git)的个人知识库的用户。
限制
- 目标文件夹默认为 ~/brain,也可通过参数指定。
- 访谈最多 5 个问题,用户可跳过问题。
- AGENTS.md 限制在 120 行以内。
- 只写入用户明确告知的事实,不会编造链接、数字或事实;缺失信息会标记为 "To fill"。
- 是否创建并推送私有 GitHub 仓库需用户明确同意,且始终为私有。
- 技能以 Markdown 文件形式存在,依赖智能体环境对文件系统和 Git 的支持。