SuperAPI AI 工具集

setup-brain

办公与效率

查看项目

更新于 10-18 19:21

技能介绍

用途

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 的支持。