用途
该技能用于审查项目积压(backlog)条目,并决定哪些应被提升(promote)为当前里程碑下的活跃阶段。它在 Codex 环境中运行,通过在该技能引用后附带的参数触发,即提及 $gsd-review-backlog;其后的所有用户文本会被视为 GSD_ARGS,若无参数则视为空。
主要能力
- 列出积压条目:通过 ls -d .planning/phases/999* 查找积压条目,若无则输出提示。
- 读取 ROADMAP.md 并提取所有 999.x 阶段条目。
- 展示每个积压条目的描述、已积累的上下文产物(CONTEXT.md、RESEARCH.md)以及创建日期。
- 通过 AskUserQuestion 向用户呈现列表,每个条目的选项为 Promote(提升为活跃)、Keep(保留在积压)、Remove(删除)。
- 对需要提升的条目:在活跃里程碑中查找下一个顺序阶段编号,重命名目录(从 999.x-slug 改为 {new_num}-slug),将积累的产物移动到新的阶段目录,更新 ROADMAP.md(将条目从 Backlog 区移到活跃阶段列表),移除 (BACKLOG) 标记,并添加适当的 Depends on 字段。
- 对需要删除的条目:删除阶段目录,并从 ROADMAP.md 的 Backlog 区移除对应条目。
- 提交变更并输出汇总,例如“Backlog Review Complete”,列出已提升(含新阶段编号)、保留和删除的条目。
使用方式
在 Codex 会话中提及 $gsd-review-backlog 即可调用。该技能文本还包含一份 codex_skill_adapter,说明如何将 Claude Code 语法的调用映射到 Codex:
- Skill 调用:以 $gsd-review-backlog 提及,其后文本作为 GSD_ARGS。
- AskUserQuestion 到 request_user_input 的映射:header 对应 header,question 对应 question,选项格式从 "Label" — description 转为 {label: "Label", description: "description"};id 由 header 生成(小写、空格替换为下划线);批量调用合并为单个 request_user_input 的 questions[];多选通过顺序单选或编号自由列表实现;Execute 模式下若 request_user_input 被拒绝,则以纯文本编号列表呈现并选取合理默认值。
- Task() 到 spawn_agent 的映射:Task(subagent_type="X", prompt="Y") 对应 spawn_agent(agent_type="X", message="Y");Task(model="...") 省略(Codex 按角色配置);默认 fork_context: false,GSD 代理通过 <files_to_read> 块加载自身上下文;并行 fan-out 时生成多个代理、收集 ID、用 wait(ids) 等待全部完成;结果解析查找代理输出中的结构化标记,如 CHECKPOINT、PLAN COMPLETE、SUMMARY 等;收集结果后用 close_agent(id) 关闭代理。
具体执行步骤包括:列出积压条目(ls 命令或提示无积压)、读取并提取 ROADMAP.md 中的 999.x 条目、展示每个条目的描述与已积累产物及创建日期、通过 AskUserQuestion 呈现并收集选择、对提升条目执行查找下一编号与重命名目录等操作、对删除条目执行删除与 ROADMAP 更新、提交变更并输出汇总。
适用场景
适用于使用 GSD 工作流管理项目阶段和里程碑的团队或个人,需要定期清理和推进积压任务时。典型场景包括:项目迭代规划前审阅积压、将成熟想法提升为可执行阶段、删除不再需要的积压条目。
限制
- 该技能依赖特定的目录结构(.planning/phases/999* 和 .planning/ROADMAP.md)以及 gsd-tools.cjs 工具的可访问路径,资料中给出的路径为 /mnt/local-analysis/workspace-hub/.codex/get-shit-done/bin/gsd-tools.cjs。
- 主要面向 Codex 环境,并包含从 Claude Code 语法到 Codex 的适配说明。
- 部分能力(如多选、执行模式回退)依赖平台特性与自定义的变通方案,资料未说明在其他环境中的行为。
暂未提供的信息
关于收费、价格、平台支持范围、效果保证等,资料中均未提供。