| name | reflect |
| description | 用户触发 /ezfl:reflect 或要求查看度量 / overrides / 改进建议时必须使用本 skill。聚合 .harness/metrics/ 与 .harness/overrides.log,输出回顾报告。 |
reflect
禁止凭空捏造度量数据或跳过 .harness/metrics 聚合环节。若不存在度量数据(尚未运行过 audit),必须明确告知用户,禁止生成空报告或编造内容。
启动时必须先输出:[easy-flow] 进入阶段: reflect — 使用 easy-flow:reflect skill。
Overview
度量回顾 skill。聚合 .harness/metrics/ 下的历史数据,分析趋势,生成改进建议。
触发模式
/ezfl:reflect — 输出当前项目度量概览
/ezfl:reflect monthly — 输出月度回顾报告
数据源
.harness/metrics/*-metrics.json — 各次 audit 的 scorer 结果(全局聚合视图:含 ship 阶段从 worktree 合回的历史,跨 change 趋势分析直接 glob 用)。稳定契约:本路径是 reflect 全局视图的唯一数据源;archive 子目录下的 metrics 副本仅供"按 change_id 回看",不可视为冗余而清理顶层目录——否则破坏跨 change 趋势分析。每个 metrics JSON 顶层带 change_id 字段(v0.3.7 起),reflect 可按 change 归因分桶;缺失或为空字符串视为"未归因",单独一桶展示
.harness/overrides.log — 所有 override 记录(team 模式;含 ship 合回的 worktree override 追加)
.harness/workflow.yaml — 全局工作流游标(active_changes 列出未 ship 的 change,每项含 phase / worktree_path / started_at)
.harness/changes/<change_id>/state.yaml — 进行中 change 的业务档案(design→audit 各阶段产物)
.harness/archive/<change_id>/ — 已 ship 完成的单 change 完整快照(可选追溯入口):
state.yaml — 该 change 的 design→ship 终态档案
metrics/*-metrics.json — 该 change 期间产生的 metrics 副本
overrides.log — 该 change 期间产生的 override 切片
pre_design.md — 设计阶段产出(含 worktree 内修订)
跨 change 趋势分析仍走数据源 1(顶层 metrics/),不必遍历 archive/*;archive 仅供"按 change_id 回看单次变更"。
输出内容
- Scorer 趋势:每个 scorer 的历史得分曲线(最近 N 次)
- Override 分析:频率、理由分布、是否有反复违规
- Constitution 合规:违规次数和分布
- 改进建议:基于低分项和频繁违规提出 2-3 条可操作建议
- 团队健康度(team 模式):阻塞频率、响应时间
约束
- 度量计算为
[MACHINE_VERIFIED]
- 改进建议为
[LLM_SELF_CHECK]