用途:状态机式的阶段转换技能,在阶段满足完成条件后将其标记为完成、提取经验教训并推进到下一阶段,必要时创建下一阶段目录。
主要能力:校验阶段完成条件(任务全部 completed 或 skipped、verification.json 判定非 FAIL、无未解决的关键缺口),并检查 review.json 与 UAT 状态给出警告;更新 index.json 状态与完成时间;从验证缺口、评审反馈、任务摘要中提取经验并追加到 .workflow/specs/learnings.md;初始化下一阶段并更新 state.json 的 current_phase 与 phases_completed;最后输出转换报告。
使用方式:$maestro-phase-transition "" 转换当前阶段;$maestro-phase-transition "2" 指定阶段号;$maestro-phase-transition "3 --force" 跳过缺口检查强制转换。阶段号省略时取 state.json 中的 current_phase。常用命令包括 cat .workflow/state.json 读取状态,mkdir -p .workflow/phases/{NN+1}-{next_slug} 创建下一阶段目录。
错误与警告:E001 无法确定阶段号;E002 阶段未通过验证,先运行 maestro-verify;E003 存在未解决关键缺口;W001 仅警告可确认继续;W002 存在 UAT 测试失败;W003 代码评审为 BLOCK;W004 尚未运行评审。
限制:必须保证 state.json 与 index.json 一致;除非使用 --force,否则不做验证即拒绝转换;出现警告时需用户确认;经验提取为强制步骤。相关技能名称与后续命令如 maestro-plan、manage-status、maestro-verify、quality-review 保留原文。