目的：实现灵活的阶段重组（跨里程碑移动和里程碑内重新排序）。输出：阶段移动/重新排序、目录重命名、ROADMAP.md 更新、STATE.md 更新、git 提交为历史记录。 **支持的操作：** * 跨里程碑移动：`/kata-move-phase 3 to v1.6.0` * 在里程碑内重新排序：`/kata-move-phase 3 before 1` 或 `/kata-move-phase 3 after 1` @.planning/ROADMAP.md @.planning/STATE.md **从第二个参数检测操作类型：** * `"to"` \+ 里程碑版本 → 跨里程碑行动 * `"before"` 或 `"after"` \+ 目标阶段编号 → 在里程碑内重新排序 **跨里程碑举措：** * `/kata-move-phase 3 至 v1.6.0` **在里程碑内重新订购：** * `/kata-move-phase 3 before 1` → 第 3 阶段占据位置 1，一切都向上移动 * `/kata-move-phase 3 after 1` → 阶段 3 占据位置 2，阶段 2+ 向上移动 **验证：** * 如果没有参数或缺少第二个参数：错误：需要相数和操作用法：/kata-move-phase <阶段> 到 <里程碑> /kata-move-phase <阶段> 之前|之后 <位置> 退出。 * 如果第二个参数不是“to”、“before”或“after”：错误：无效操作“{arg}” 预计：至、之前或之后退出。存储：PHASE_NUM、OPERATION（移动|重新排序）以及 TARGET_MILESTONE 或 POSITION+TARGET_POSITION。如果 ROADMAP.md 存在，请检查格式并自动迁移（如果旧）：如果 [ -f .planning/ROADMAP.md ];那么节点脚本/kata-lib.cjs check-roadmap 2>/dev/null FORMAT_EXIT=$? 如果 [ $FORMAT_EXIT -eq 1 ];那么 echo“检测到旧的路线图格式。正在运行自动迁移...” 菲菲 **如果退出代码 1（旧格式）：** 在自动模式下调用 kata-doctor：技能（“kata-doctor”，“--auto”）迁移完成后继续。 **如果退出代码为 0 或 2：** 静默继续。 cat .planning/STATE.md 2>/dev/null cat .planning/ROADMAP.md 2>/dev/null 从 ROADMAP.md 解析当前里程碑版本。使用“当前里程碑：”标题或“🔄”线标记： VERSION=$(grep -E "当前里程碑:|🔄" .planning/ROADMAP.md | grep -oE 'v[0-9]+\.[0-9]+(\.[0-9]+)?' | head -1 | tr -d 'v') 1. 在当前里程碑中搜索“#### Phase {N}:”标题 2. 使用通用阶段发现（使用填充和未填充的名称搜索活动/待定/已完成，回退到平面） 3. 如果未找到：`错误：在路线图中未找到阶段 {N}` \+ 列出可用阶段。出口。 1. **必须处于待处理状态/**（未激活或已完成）。如果不是：“错误：阶段 {N} 处于 {state}/ 并且无法移动”。出口。 2. **不得有SUMMARY.md 文件**（无执行计划）。如果发现：“错误：阶段 {N} 已完成工作”。出口。 1. 目标里程碑标题必须存在于 ROADMAP.md 中。如果没有：`错误：未找到里程碑 {target}`\+ 列表可用。出口。 2. 目标必须与源不同。如果相同：`错误：阶段已在 {milestone} 中。使用之前/之后重新排序。` 退出。验证目标位置阶段是否存在于同一里程碑中： 1.目标位置阶段必须存在于当前里程碑内的ROADMAP.md中 2. 目标可以是任何状态（活动、待定、已完成），因为我们正在重新排序路线图列表 3. 正在移动的阶段必须处于待处理状态（已在 validate_phase_movable 中验证）计算有效目标位置： * `N` 之前 → 目标位置 = N （相位占据位置 N，N+ 处的所有内容都向上移动） * `N 之后` → 目标位置 = N+1 （相位处于位置 N+1，N+1+ 处的所有内容都向上移动）如果未找到目标位置相位：错误：在当前里程碑中未找到阶段 {target_position} 可用阶段：[列出阶段编号] 退出。显示计划的重新订购并等待确认：重新排序阶段 {N}：{Name} 当前订单：第一阶段：{名称} 第 2 阶段：{名称} 第三阶段：{名称} 新订单：第 1 阶段：{name}（是第 3 阶段）第 2 阶段：{name}（是第 1 阶段）第 3 阶段：{name}（是第 2 阶段）这将重新编号所有阶段目录并更新 ROADMAP.md。继续？（是/否）等待确认。更新 ROADMAP.md 以反映新的阶段顺序： 1. 提取当前里程碑内的所有阶段部分 2. 将动相部分从当前位置移除 3.插入目标位置 4. 按顺序对里程碑中的所有阶段标题重新编号（1、2、3...） 5. 更新里程碑内的所有引用： * 阶段标题：`#### 阶段 {旧}：` -> `#### 阶段 {新}：` * 阶段列表条目 * 进度表行 * 计划参考：`{old}-01:` -> `{new}-01:` * 依赖项引用：`取决于：阶段 {old}` -> `取决于：阶段 {new}` * 十进制相位参考（如果有）编写更新的 ROADMAP.md。重命名里程碑中的所有阶段目录以匹配新编号。使用三遍方法来避免碰撞： 1. **第 1 步：** 将重新排序阶段移至临时名称 (`tmp-{slug}`) 2. **第 2 步：** 按顺序对所有剩余阶段重新编号。处理订单事宜： * 阶段向下移动（较高->较低）：首先处理最低的 * 阶段向上移动（较低->较高）：首先处理最高的 * 对于每个：查找跨状态子目录，重命名目录和内部文件 3. **第 3 步：** 将临时目录移动到其最终编号位置，重命名内部文件处理小数相位：它们遵循其父整数相位并相应地重新编号。查找目标里程碑中的下一个阶段编号：解析 `#### Phase N:` 标题，取最高值 + 1（如果为空则取 1）。格式为两位数填充。显示：源里程碑、目标里程碑、新阶段编号、目录重命名、源中要重新编号的阶段数。等待确认。从 ROADMAP.md 中的源里程碑中删除阶段部分，并对剩余阶段重新编号以缩小差距。遵循与 kata-remove-phase 相同的重新编号方法： * 阶段标题、列表条目、进度表行 * 计划参考 (`{old}-01:` -> `{new}-01:`) * 依赖项引用（`取决于：阶段 {old}` -> `阶段 {new}`） * 十进制相位参考将阶段部分插入 ROADMAP.md 中计算的目标编号处的目标里程碑中。保留目标、要求、成功标准。删除或记下不再适用的跨里程碑依赖关系引用。将待定/中的阶段目录重命名为新编号。重命名里面的所有文件（PLAN.md、RESEARCH.md 等）以匹配。通过将小数相位 (N.1、N.2) 与父级一起移动来处理小数相位，重新编号为 NEW_NUM.1、NEW_NUM.2。重新编号源里程碑中发生变化的阶段的目录。处理升序（向下移动）。对于每个：查找跨状态子目录，重命名同一状态内的目录和内部文件。 **对于跨里程碑的举动：** 1.添加路线图演变说明： - **阶段 {N} 从 {source_milestone} 移至 {target_milestone}** 作为阶段 {NEW_NUM} 2. 如果源里程碑是当前里程碑，则更新总阶段计数 3. 重新计算进度百分比 **重新订购：** 1.添加路线图演变说明： - **阶段 {N} 在 {里程碑} 中的{之前|之后} 阶段 {M}** 重新排序 2. 阶段数不变（相同里程碑，相同阶段） **这两项操作：** 如果需求引用受影响的阶段，则更新 REQUIREMENTS.md 可追溯性。更新可追溯性表中所有重新编号阶段的阶段编号。 COMMIT_PLANNING_DOCS=$(节点脚本/kata-lib.cjs 读取配置“commit_docs”“true”) git check-ignore -q .planning 2>/dev/null && COMMIT_PLANNING_DOCS=false **如果`COMMIT_PLANNING_DOCS=false`:** 跳过 git 操作 **如果`COMMIT_PLANNING_DOCS=true`（默认）：** git add .planning/ # 跨里程碑举措： git commit -m“杂务：将阶段 {N} 移至 {target_milestone}” # 重新排序： git commit -m“琐事：重新排序阶段{N} {之前|之后} {M}” <反模式> * 不要移动活动或已完成的阶段（只能移动/重新排序待处理的阶段） * 不要随着已执行的计划移动阶段（SUMMARY.md 存在） * 不要移动到同一个里程碑（而是使用重新排序） * 不要重新排序到相同位置（无操作） * 不要忘记小数相位（它们与父整数相位一起移动） * 如果 commit_docs 为 false 则不提交 * 移动或重新排序后不要在阶段编号中留下间隙 * 不要修改源里程碑和目标里程碑之外的阶段 * 如果没有两次临时方法，请勿重命名目录（避免重新排序期间发生冲突） <边缘情况> **阶段有 PLAN.md 文件，但没有 SUPPLY.md：** * 允许。作为移动/重新排序的一部分，重命名目录内的计划文件。 * 更新计划前沿阶段参考资料。 **目标里程碑为空（无阶段）：** * 第一阶段变为阶段 1。 * `calculate_destination_number` 处理此问题（当 HIGHEST 为空时，NEW_NUM=1）。 **源里程碑的最后一个阶段被删除：** * 源里程碑中无需重新编号。 * ROADMAP.md 中的源里程碑部分仍然有其标题。 **移动整数相位下的小数相位：** * 查找属于移动的整数相的所有小数相（N.1，N.2）。 * 与家长一起移动它们。 * 在目的地重新编号为 NEW_NUM.1、NEW_NUM.2。 **阶段目录尚不存在：** * 阶段可能位于 ROADMAP.md 中，但未创建目录。 * 跳过目录操作，仅继续进行 ROADMAP.md 更新。 * 完成摘要中的注释：“没有要移动的目录（尚未创建阶段）” **重新排序：移动到相邻位置：** * 当阶段位于位置 N 时，“N+1 之前”或“N-1 之后”是无操作。 * 检测并报告：“相{N}已位于该位置。” **重新排序：里程碑中只有两个阶段：** *交换位置。两个目录和所有参考文献都重新编号。 **跨里程碑移动**在以下情况下完成： * 源阶段已验证为待定/未启动 * 目标里程碑已验证为现有且与源不同 * 从 ROADMAP.md 中的源里程碑中删除了阶段部分 * 剩余源相重新编号以缩小差距 * 将阶段部分添加到具有正确编号的目标里程碑中 * 阶段目录重命名以匹配新编号 * 目录内的文件已重命名 ({old}-NN-PLAN.md -> {new}-NN-PLAN.md) * 小数相位随父级移动（如果有） * 源目录重新编号（如果阶段发生变化） * STATE.md 更新了路线图演变说明 * 通过描述性消息提交的更改 * 源或目的地的阶段编号没有间隙 **重新订购**在以下情况下完成： * 阶段已验证为待定/未启动 * 目标位置已验证为存在于同一里程碑中 * ROADMAP.md 中的阶段部分重新排序 * 里程碑中的所有阶段均按顺序重新编号 * 所有阶段目录重命名（两遍临时方法） * 目录内的文件重命名以匹配新数字 * 小数阶段与父级一起重新编号（如果有） * STATE.md 更新了路线图演变说明 * 通过描述性消息提交的更改 * 阶段编号没有间隙 **两项操作：** 用户通知所有更改。

型移动阶段

包含技能