Reflect 是一个面向 AI 代理工作流的技能,用于从当前对话中挖掘可长期复用的经验,并将这些经验路由为对现有技能的具体编辑。
用途方面,Reflect 在用户说出 reflect 或 /reflect 时触发,适合对话已经产生值得沉淀的方法、模式或修正结论的场景。若对话琐碎、与主题无关,或已由父代理正确遵循的现有技能覆盖,则应跳过;一次性的特殊情况不算学习点。
主要能力包括:第一,定位当前对话记录,通过子代理脚本按绝对路径解析会话 ID(Claude Code 使用 $CLAUDE_CODE_SESSION_ID,Codex 使用 $CODEX_THREAD_ID),并明确不检索其他项目的记录,以避免跨越工作区边界;若路径无法解析,则改用会话的紧凑摘要。第二,在同一轮中并行启动三个审查子代理,分别对应判断、工具和发散三种视角,均以只读方式运行;只读仅是在任务说明中追加一行,子代理仍保留对各自执行环境所配置 MCP 服务的访问,以便查阅对话中引用的工单、聊天线程和可观测性追踪。第三,由综合子代理通过 MCP 抽查引用,汇总各审查者的完整输出,返回「采纳/驳回/待办」三类清单。第四,执行结构性约束检查,将更适合由 lint 规则、脚本、元数据标记或运行时检查来保证的采纳项转入待办。第五,在应用前完整展示综合结果并等待用户明确批准,用户可选择子集或调整路由;待办项则无需等待,直接提交到团队的开发体验或待办追踪器。
使用方式上,各审查者与综合者需在配置文件中指定角色行和默认执行环境;文件或行缺失时使用该环境的默认模型并加以说明,配置值为 auto 或 inherit-parent 时使用调用方自身的执行环境;模型被拒绝时改用该环境默认模型并告知用户。每个子代理的推理等级与速度按相关技能的子代理章节选择。审查提示模板需原样传入,并在标记处替换为会话路径或摘要。
应用编辑时遵循严格规则:绝不修改安装在 ~/.agents/skills/ 或 ~/.claude/skills/ 下的已安装技能,因为全局更新会覆盖它;批准前需展示目标位置,即项目内以新名称保存的副本,并建立从 .claude/skills/<新名称> 指向 ../../.agents/skills/<新名称> 的符号链接;批准后复制技能文件夹、修改前置元数据中的名称并编辑副本,同时把副本中所有同级引用改写为指向 ~/.agents/skills/<名称>/ 下的已安装同级文件,并在完成前确认每个改写路径存在。不会创建 PR 或推送。
路由规则包括:琐碎的既有技能编辑(单行条目、收紧句子、修正过时事实)由父代理直接完成;实质性编辑(新增章节、模式表、超过约十行)交给技能创建技能并运行其起草/测试/迭代循环;技能未在应触发时触发,则运行描述优化循环;新技能交由技能创建流程处理,不临时自创结构;未安装技能创建技能时,遵循相关编写手册。若环境提供 SKILL.md 校验器,需在结束前对每个改动的技能运行。最后以简短列表向用户汇总已应用编辑、新建技能、已提交待办及被驳回项与理由。