用途:Maestro Phase Add 是对项目 roadmap 的单次变更操作,用于新增阶段或按指定位置插入阶段,并自动处理受影响阶段的重新编号。
主要能力:创建带初始化 index.json 的阶段目录;将阶段条目插入 roadmap.md 的正确位置;在插入时对后续阶段目录与引用自动重编号;同步更新 state.json 中的阶段引用。
用法:命令接受必填的阶段名称,可搭配 --after N 或 --before N(二者互斥)。名称同时用作标题和 slug,slug 会转为小写、空格替换为连字符并去除特殊字符。未给出位置参数时追加到末尾。
输出与限制:会生成新阶段目录、更新 roadmap.md 与 state.json。依赖 .workflow/roadmap.md 存在,否则返回 E002 并提示先运行 maestro-init;缺少阶段名返回 E001;slug 重复返回 E003。重编号按目录编号从高到低执行以避免冲突,编号固定为两位补零格式。插入时若影响到 current_phase 或 phases_completed 会同步调整。