用途:brain 为整个工作流提供跨会话的持久记忆,所有智能体、技能和会话都会读取它,因此内容质量直接影响下游表现。写入前应先自问内容是否真正改善系统运作,答案不明确就不要写。
主要能力与结构:知识库位于 brain/,包含 index.md(根入口,链接一切)、principles.md(principles/ 的索引)、principles/(工程与设计原则)、codebase/(项目专属知识与坑)、plans/(功能计划)。规则包括:一个文件一个主题,如 brain/codebase/deploy-gotchas.md;维护既有索引入口;新增顶层分类时为其添加仅含链接的索引入口;每个文件都必须能从 index.md 到达;文件名小写并用连字符。
使用方式:写入前先读 brain/index.md,再读主题相关入口,例如原则更新读 brain/principles.md;尚无专用索引的目录可直接扫描邻近文件,尽量编辑已有笔记。链接格式为 [[section/file-name]],解析顺序为同目录、相对路径、库根,标题锚点会被剥离。写作风格:多用要点、少用散文、无前言,使用带 # 标题的纯 markdown,不用 Obsidian frontmatter,笔记控制在约 50 行内,过长则拆分。写完后更新 index.md 及相关入口,索引只放链接、便于浏览。
适用场景与限制:适合沉淀可复用的持久知识。判断标准是“我是否会在另一个任务的提示词里用到它”,是则写入 brain/;仅属某计划则更新该计划文档;属技能问题则直接改技能文件;需后续跟进则记 todo。维护上应删除过时或被涵盖的笔记,新增前先合并重叠内容。资料未提供安装命令、收费、平台或效果等信息。