用途
reflect 扮演自我改进编排器（self-improvement orchestrator）角色：把一段日期范围转化为一份 reflect 计划（包含目的、日期范围和信号视角），经用户批准后，生成并运行一个动态工作流，完成日志挖掘、聚类、建议、验证和报告。其定位是咨询性（advisory），自身从不编辑或创建制品，只报告建议，由人工应用。
主要能力
- 信号视角挖掘：默认启用全部六个视角——friction（工具错误、用户中断与拒绝、重试循环、高开销回合）、conversation（缺乏结构化痕迹的低效对话）、router（各角色模型配置过多或不足）、capability（无技能或子代理负责的重复性多步工作，倾向 create）、guardrail（重复出现的错误与未防护的危险操作，倾向权限规则、钩子或规则）、instruction（失效、被忽略、臃肿或含糊的 CLAUDE.md / AGENTS.md 规则）。
- 聚类、建议、验证、报告：由动态工作流依次完成，建议必须可追溯到会话日志记录，指向代码时还需给出 file:line。
- 优先级：优先 improve，仅在没有现存制品适用时才 create。
- 报告内容：按制品面（surface）的排名、按面分组的已验证建议（含改动、标签、证据、层级）、验证中丢弃的数量，以及总体和各维度评分，并点名每个未通过维度。
使用方式
- 日期范围通过参数 $ARGUMENTS 传入，默认“昨天”；启动前解析为绝对 ISO 的 since / until。
- 日志根目录解析为本项目会话日志目录（Claude home 下 projects/<slugified-cwd>/），并确认范围内有会话；没有则说明并停止。
- 计划写入 .start/reflect/[name]/reflect.md，并创建 .tracker/ 目录；在聊天中展示完整计划（目的、ISO 日期范围、视角、目标范围、咨询性质），请用户 Approve 或 Refine；批准后置为 approved。
- 为每个视角创建 mine 任务，例如： node ${CLAUDE_PLUGIN_ROOT}/scripts/task.js create --home .start/reflect/[name] --type mine --name "{lens}"
- 直接以 Workflow 工具调用内联脚本运行动态工作流（不要先加载工作流编写参考或通过 shell 命令拼装脚本，否则会在启动前停滞）；需阅读 reference/workflow.md、reference/surfaces.md 及各 agent 参考。
- 按阶段选择模型与投入：结构化挖掘可用更小更快模型；对话阅读、能力缺口识别、指令审计、聚类、验证、评分需最强模型；验证或评分阶段的模型不得弱于其评判的阶段；不确定时省略 model 以继承会话模型。
- 工作流返回后展示报告，将 reflect.md 置为 review，并请用户选择：在分支上应用某条建议｜深化某个视角｜将报告持久化到 docs/research/｜完成。应用时若目标存在 evals/evals.json 则先运行并展示结果。
适用场景
适用于维护项目 harness 的场景，范围限于 git 跟踪的项目制品：plugins/ 下的技能、子代理和输出样式；项目 CLAUDE.md / AGENTS.md；项目 .claude/settings.json 中的护栏（权限规则、钩子）及 CLAUDE.md 规则。
限制
- 不处理用户全局 ~/.claude/ 文件和其他项目的日志。
- 不在工作流之外进行挖掘、起草、验证或撰写报告。
- 除非用户要求，否则不应用建议；应用时需在分支上逐条进行。
- 写入 .start/reflect/ 为预授权操作。