关于 reflect
reflect 是用于复盘对话并保存有效经验的 Agent 技能，可将内容归入 brain 文件、技能文件或结构化检查，避免重复记录。
主要功能
- 01从对话中提取可复用经验
- 02将记录分流到 brain、技能或检查
- 03跳过琐碎或已有内容
- 04更新 brain 索引
- 05使用 Tasks 跟踪步骤
适用场景
- 01记录新的代码库模式和工具问题
- 02整理用户偏好与决策
- 03发现边缘情况后改进技能
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/reflect确认已加载。
详细介绍
Reflect
回顾对话并沉淀经验——写入 brain/、技能文件，或通过结构化约束落实。
流程
使用 Tasks 跟踪进度（每个步骤调用一次 TaskCreate，使用 TaskUpdate 将状态设为 in_progress/completed）。
- 阅读
brain/index.md，了解已有笔记 - 扫描对话，查找：
- 犯过的错误及收到的纠正
- 用户偏好和工作流模式
- 获得的代码库知识（架构、易错点、模式）
- 发现的工具/库特性
- 已作出的决定及其理由
- 技能执行、编排或委派中的摩擦
- 可自动化或编码的重复手动步骤
- 跳过琐碎内容或现有 brain 文件已记录的内容
- 将每条经验归入合适的目标位置（见下文“归类”）
- 如有新增或删除 brain 文件，更新
brain/index.md
归类
并非所有内容都该写入 brain。应将每条经验归入影响最大的目标位置。
结构化约束检查
将经验归入 brain/ 之前，先确认：是否可以将其实现为 lint 规则、脚本、元数据标记或运行时检查？如果可以，就通过结构化方式落实，而不写入 brain 笔记。参见 brain/principles/encode-lessons-in-structure.md。
Brain 文件（brain/）
代码库知识、委派原则、易错点——任何有助于后续会话的内容。默认归入此处。编写规范请使用 brain 技能。
- 每个文件聚焦一个主题。文件名使用主题 slug。
- 在带有索引文件的目录中分组，使用
[[wikilinks]]。 - 索引文件中不内嵌内容。
技能改进（.agents/skills/<skill>/）
如果经验与某项特定技能的工作方式（流程、提示词或边缘情况）有关，请直接更新该技能。有效技能内容的编写指南请使用 skill-creator 技能。
编排工作流改进
如果会话暴露出系统性的编排问题，请归入：
- Brain 原则（新的委派启发式）→
brain/delegation/ - 技能机制变更（监控循环、审查步骤）→ 相关技能文件
- 新的技能机会（可编码的重复工作流）→ 在总结中告知用户
待办事项（brain/todos.md）
记录无法在反思过程中完成的后续工作——错误、非简单的重写、工具缺口。使用 todo 技能登记。
总结
## Reflect Summary
- Brain: [files created/updated, one-line each]
- Skills: [skill files modified, one-line each]
- Structural: [rules/scripts/checks added]
- Todos: [follow-up items filed]
评论
支持 Markdown