用途
refine-journey 是一个“精炼工程师”技能，用于评估 journey-builder 一次运行所产出的结果，找出其中暴露出的指令缺口，并通过修改项目根目录的 AGENTS.md（针对 journey-builder 技能的项目级覆盖）或向 pitfalls gist 添加平台级模式来修复这些缺口。它的目标不是修复产品本身，也不是修复 journey-builder 技能本身，而是修复指导该技能的项目级覆盖与 pitfalls。
主要能力
该技能按阶段执行一整套评估与修复流程：
- 收集证据：读取最近一次 journey-builder 运行产生的所有内容，包括 journeys/ 下的 journey 文件夹、journey.md、testability_review_.md、ui_review_.md、规格文件、生成的测试代码、screenshots/ 中的全部截图，以及仓库根目录的 AGENTS.md。
- 客观检查：执行构建检查（自动检测构建系统，xcodebuild 使用 -derivedDataPath build）、测试检查与速度测量（运行单元测试和 journey UI 测试并计时，单个测试超过 10 秒标记为速度问题）、截图审计（检查截图是否显示可用应用、是否仅含应用窗口、设计质量、步骤覆盖）、等待时间审计（检查 waitForExistence 超时是否超过 5 秒且无注释、是否有进度截图循环、连续截图间隔是否超过 5 秒）、journey 质量检查、规格覆盖逐条检查、journey 状态修正、打磨轮次质量检查以及真实结果检查。
- 评分：按标准覆盖率（35%）、测试通过率（15%）、构建（10%）、截图质量（15%）、真实结果（15%）、打磨完整性（5%）、步骤覆盖（5%）加权计算总分，测试速度仅作信息记录。
- 诊断指令失败：对每个缺口使用 5 Whys 追溯技能指令中的缺失、模糊或过弱之处，并给出具体修复与目标位置。
- 写入修复：平台特定模式写入 pitfalls gist，项目特定规则写入 AGENTS.md，遵循外科手术式编辑、具体优于抽象、必须而非应该、添加示例、反膨胀等规则。
- 输出报告与下一步：将精炼报告追加到 journey-refinement-log.md，并向用户输出本次得分、测试速度与变化、前三大失败、所做修改以及下一步应运行的命令。
使用方式
该技能以规格文件作为输入参数（$ARGUMENTS）；若未提供参数，则使用当前目录下的 spec.md。它按阶段自动执行：收集证据、运行客观检查、评分、诊断、写入修复、撰写精炼报告、告知用户下一步。下一步命令为 /journey-builder。
适用场景
适用于使用 journey-builder 技能生成 journey 测试之后，需要评估该次运行质量、定位技能指令缺口并改进项目级 AGENTS.md 或平台级 pitfalls 的场景。
限制
资料未提供该技能的收费、价格、平台支持范围或效果保证等信息。