用途
gsd-plan-milestone-gaps 是一个 GSD(get-shit-done)工作流技能,用于在里程碑审计完成后,把审计发现的缺口转化为可执行的修复阶段。它读取 MILESTONE-AUDIT.md,将缺口按逻辑分组为阶段,在 ROADMAP.md 中创建阶段条目,并提供为每个阶段制定计划的选项。其核心价值在于:一条命令即可创建所有修复阶段,无需针对每个缺口手动调用 $gsd-add-phase。
主要能力
- 读取 MILESTONE-AUDIT.md,获取里程碑审计中识别出的全部缺口。
- 将缺口按逻辑分组为若干阶段。
- 在 ROADMAP.md 中创建对应的阶段条目。
- 提供为每个阶段制定计划的选项。
- 一次调用创建全部修复阶段,替代逐缺口手动添加。
使用方式
该技能通过提及 $gsd-plan-milestone-gaps 来调用。$gsd-plan-milestone-gaps 之后的所有用户文本被视为 {{GSD_ARGS}};如果没有参数,则将 {{GSD_ARGS}} 视为空。原始意图与当前规划状态会在工作流内部按需加载。
技能包含一个 Codex 适配层(codex_skill_adapter),用于将 GSD 工作流中使用的 Claude Code 语法映射到 Codex 工具:
- AskUserQuestion → request_user_input:参数映射为 header → header、question → question;选项格式 "Label" — description 转换为 {label: "Label", description: "description"};id 由 header 生成(小写、空格替换为下划线)。批量调用 AskUserQuestion([q1, q2]) 转换为单个 request_user_input,并在 questions[] 中包含多个条目。由于 Codex 没有 multiSelect,多选场景改用顺序单选,或提供编号的自由文本列表,要求用户输入以逗号分隔的编号。当 request_user_input 被拒绝(Execute 模式)时,回退为纯文本编号列表并选取合理的默认值。
- 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> 块自行加载上下文。并行扇出时,生成多个代理、收集代理 ID,再用 wait(ids) 等待全部完成。结果解析时,在代理输出中查找结构化标记,如 CHECKPOINT、PLAN COMPLETE、SUMMARY 等。从每个代理收集结果后调用 close_agent(id)。
执行上下文引用:@/mnt/local-analysis/workspace-hub/.codex/get-shit-done/workflows/plan-milestone-gaps.md。
适用场景
适用于使用 GSD 工作流进行里程碑管理的项目,尤其是在完成里程碑审计、需要系统性地补齐审计所发现缺口时。它帮助把审计结论直接转化为路线图中的修复阶段,减少手动逐项添加阶段的工作量。
限制
资料未提供该技能的收费、价格、平台支持范围、具体效果指标或完整使用步骤等细节,暂未提供。其行为依赖 MILESTONE-AUDIT.md 与 ROADMAP.md 等文件的存在与格式,以及 GSD 工作流环境。