用途:Project Brain 为 AI 智能体提供跨会话记忆,让新会话的智能体能接续上一次的进度,并在关闭前保存学到的东西。设计原则类似专业人员使用笔记本:开工前打开(LOAD),结束后写小结(SAVE),笔记本在会话之间保留。
主要能力:LOAD 模式读取脑文档、解析结构化上下文并给出简明简报;SAVE 模式收集会话上下文,创建或增量更新脑文档。脑文档是 Markdown 文件,记录项目状态、会话历史、架构决策和后续步骤,标准格式为 v2.0,同时可读取 v1.0 与自由格式文档。技能采用模块化 assets 架构,含 modes、helpers、templates 等目录。
使用方式:在会话开始说“Load the project brain.”触发 LOAD;结束时说“Save the session to the brain.”触发 SAVE。LOAD 会解析脑目录、扫描已有文档、读取并解析后给出简报;SAVE 会判断是新建还是更新、收集会话数据、与用户确认后写入或合并。脑目录 {brain_dir} 每会话解析一次:可从用户消息中的文件路径提取、自动扫描 .agents/project-brain/,或通过 AskUserQuestion 询问用户。模式不明确时会询问要加载还是保存。可按模式只读取对应 assets,避免浪费上下文。
规则与限制:共七条规则,包括不得编造、写入前必须由用户确认、增量而非破坏性写入(累积上下文仅追加、会话日志仅前插)、格式向后兼容、路径只解析一次、对话与脑文档语言分离(对话跟随用户语言,文档内容始终英文)、未解析目录不得静默使用默认值。限制:仅处理 .md 文件,不解析 yaml、json 等;每项目一份脑文档,不递归读取文件夹;不做内容综合,文档过时则简报同样过时;Obsidian 集成仅限 LOAD,SAVE 总是写文件系统,需同步可用 obsidian 技能;会话日志超过 15 条会被压缩归档到 {brain_dir}/archive/;没有自动保存,SAVE 必须显式触发。可与 sprint-forge、obsidian、universal-planner 等技能配合使用。收费、价格等信息暂未提供。