用途:在 Coordinator 中闭合“工作流实际使用情况”与“现有配置”之间的反馈回路,帮助了解哪些工作流被频繁使用、哪些阶段被跳过,并据此提出新的命名工作流配置建议。
主要能力:读取 .work-state/coordinator/<project-slug>/profile-usage.jsonl(由 profile-usage PostToolUse 钩子追加写入),每行包含 {ts, workflow, type, complexity, stage, branch}。若文件为空或缺失,则报告“no telemetry yet”并停止。随后聚合:每个工作流的激活次数、type × complexity 频率、阶段到达情况(哪些阶段执行、哪些被跳过)、近期趋势(最近 N 次与之前对比)。将汇总结果以带日期的表格形式写入或更新 profile-stats.md。针对现有配置处理起来较别扭的反复出现的任务形态,提出新的命名配置建议,每条建议附具体阶段草图和证据(计数)。
使用方式:通过 /coordinator-stats 触发。相关文件包括 commands/coordinator-stats.md 与 hooks/profile-usage.sh。
限制与边界:只写入 profile-stats.md,绝不修改已发布的 workflows/*.json;建议不会被自动创建,采纳建议需用户单独执行。