用途:当用户要求运行迁移后的 gsd-review-backlog 源命令时使用,用于审查 backlog(待办)条目并将其晋升为活跃里程碑。
主要能力:列出 backlog 条目;读取 .planning/ROADMAP.md 并提取所有 999.x 阶段条目;展示每个条目的描述、已积累的上下文(CONTEXT.md、RESEARCH.md)和创建日期;通过 AskUserQuestion 让用户对每条 backlog 选择 Promote(晋升为活跃)、Keep(保留在 backlog)或 Remove(删除)。
晋升处理:在活跃里程碑中查找下一个连续阶段号,用 gsd-sdk query phase.add "${DESCRIPTION}" --raw 返回 NEW_NUM,将目录从 999.x-slug 重命名为 {new_num}-slug,把积累的工件移动到新阶段目录,更新 ROADMAP.md(从 ## Backlog 段移入活跃阶段列表、移除 (BACKLOG) 标记、添加 Depends on: 字段)。
删除处理:删除阶段目录并从 ROADMAP.md 的 ## Backlog 段移除条目。
提交与报告:使用 gsd-sdk query commit "docs: review backlog — promoted N, removed M" .planning/ROADMAP.md 提交变更,随后输出摘要“## 📋 Backlog Review Complete”,列出已晋升(含新阶段号)、保留、删除的条目。
限制:资料未提供关于权限、依赖版本、错误处理或失败回滚的额外说明;具体行为以实际命令输出为准。