用途：基于真实执行产物复盘并改进 Skills/Workflows，使技能链在使用中更稳定。
输入：只需传入路径 run_dir，例如 runs/<workflow>/active/<run_id>/，或 openspec/changes/<change-id>/。
输出：improvements.md，即改进建议，可直接转为变更任务；可选输出对相关 SKILL.md 的最小补丁，只改必要之处。
处理流程：读取 logs/state.json 与 logs/events.jsonl，提取失败点（错误类型、频率、缺失上下文）、时间瓶颈（重复步骤、无效搜索、上下文过多）、人工确认点（是否过早、过晚或缺失）；检查产物契约，包括每步是否有持久化输出、是否只传路径而非内容、命名或路径是否不一致；按收益排序输出改进建议，涵盖提示词/触发词优化、I/O 契约补全（补充必填字段、修正产物文件名）、错误处理与拒绝策略，以及仅在必要时建议新增确定性脚本。
输出模板建议：概述本次运行的核心问题；Top Issues 按高到低排列，每条包含症状、根因、修复建议、相关技能、建议改动点；建议最小变更清单按文件列出。
适用场景：需要对已有技能或工作流做数据驱动复盘、定位反复出现的执行问题、优化提示词与产物契约时使用。
限制：资料未提供具体安装命令、收费方式、支持平台或效果数据；使用前需确保存在对应的 runs/ 或 OpenSpec 目录及日志文件。