用途:在产品功能变更后,更新已有流程定义,使其与当前产品状态一致。用法为 /flow-update <flow-name> <what changed>,第一个词是流程名或文件名 slug,其余描述变更内容,例如 /flow-update dmarc-setup The DMARC wizard now has 4 steps instead of 3。
主要能力:先加载已有流程(ls .flowchad/flows/{name}.yml,精确匹配优先再模糊匹配),读取完整 YAML 并解析 name、context、steps、tags、priority;若流程不存在则列出可用流程让用户选择。随后理解变更,判断新增/删除步骤、选择器变化、预期变化及改动范围,并通过 git log 与 grep 扫描相关代码、读取组件页面、检查选择器是否仍存在。接着起草更新:必要时改 name、更新 context 前置条件、增删或修改步骤与 expect、更新 tags 和 priority,对代码中找不到的选择器标注 # VERIFY: not found in code。之后以 before/after diff 只展示变化部分,并询问是否应用。确认后写回同一 YAML 文件,若场景变化较大建议重命名文件,并提示运行 /flow-walk {name} 验证。
适用场景:功能改动后同步流程定义,如向导步骤数变化、支付方式切换、新增表单字段等。
限制:选择器在代码中消失且无明确替代时,标注 # BROKEN: selector removed, needs manual fix,不猜测;流程重命名需新建文件并删除旧文件;一次变更影响多个流程时需逐个更新。