SuperAPI AI 工具集

gsd-remove-phase

办公与效率

查看项目

更新于 10-16 06:27

技能介绍

用途

gsd-remove-phase 用于从项目路线图中干净地移除一个未来阶段。其定位是删除已经决定不再执行的工作,而不在上下文中留下“已取消”或“已延后”之类的标记。执行结果包括三部分:删除指定阶段、对后续所有阶段重新编号、产生一次 git 提交作为历史记录。

主要能力

  • 删除路线图中的未来阶段。
  • 对后续阶段重新编号。
  • 以 git 提交记录本次变更。
  • 提供 Codex 技能适配层,用于在 Codex 环境下调用该技能。

使用方式

该技能通过提及 $gsd-remove-phase 来调用。用户在该指令之后输入的所有文本被视为 {{GSD_ARGS}};如果没有提供参数,则将 {{GSD_ARGS}} 视为空值。

路线图与状态在工作流内解析,通过 init phase-op 与定向读取完成。执行上下文指向工作流文件:@/mnt/local-analysis/workspace-hub/.codex/get-shit-done/workflows/remove-phase.md。

Codex 技能适配说明

技能调用:通过 $gsd-remove-phase 触发,其后文本作为 {{GSD_ARGS}}。

AskUserQuestion → request_user_input 映射:GSD 工作流使用 Claude Code 的 AskUserQuestion 语法,在 Codex 中翻译为 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 映射:GSD 工作流使用 Claude Code 的 Task(...) 语法,翻译为 Codex 协作工具: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)。

适用场景

适用于已经明确决定放弃某个未来阶段,并希望保持路线图连续、编号不留空隙、同时保留可追溯的 git 历史记录的情况。

限制

现有资料中未提供可移除阶段的具体条件、参数格式、编号起始规则、对已完成或当前阶段的影响、冲突处理方式以及失败情况的处理说明,这些内容暂未提供。