reflect 用于在对话结束时回顾整个过程,把值得保留的经验持久化。适用时机包括:收尾阶段、发生错误或收到纠正之后,或本次对话获得了重要的代码库知识。
主要流程如下:先读取 brain/index.md,了解已有笔记;再扫描对话,提取错误与纠正、用户偏好与工作流模式、获得的代码库知识(架构、陷阱、模式)、发现的工具或库怪癖、所做决策及其理由、技能执行或委派中的摩擦、可自动化或编码的重复手动步骤。跳过琐碎或已有记录的内容。然后把每条经验路由到合适位置,并在新增或删除 brain 文件时更新 brain/index.md。
路由方式:先做结构性检查,思考能否用 lint 规则、脚本、元数据标记或运行时检查来承载;若能,则优先写入结构,跳过 brain 笔记。brain 文件用于记录代码库知识、原则和陷阱,是默认去向,遵循一文件一主题、文件名即主题 slug、用 [[wikilinks]] 组织目录与索引等约定。若经验涉及某个技能本身的工作方式、提示词或边界情况,则直接更新对应技能文件。无法在反思期间完成的后续工作(缺陷、较大重写、工具缺口)则记为待办或积压项。最后输出一份 Reflect Summary,列出 brain 文件、技能文件、结构性规则以及待办项的变动。