用途
该技能用于在已有的阶段(phase)规划之间插入紧急工作。当执行过程中发现需要临时插入的紧急任务时,可以用小数编号(例如 72.1、72.2)来表示插入的阶段,从而避免对整个路线图重新编号,同时保留原规划阶段的逻辑顺序。
调用方式
该技能通过提及 $gsd-insert-phase 来调用。触发词之后的所有用户文本会被作为 {{GSD_ARGS}} 处理;如果没有提供参数,则将 {{GSD_ARGS}} 视为空。
路线图与状态在工作流内部通过 init phase-op 以及针对性的工具调用来解析。执行上下文引用的工作流文件为:@/mnt/local-analysis/workspace-hub/.codex/get-shit-done/workflows/insert-phase.md。
Codex 适配规则
资料中提供了一组 codex_skill_adapter 适配说明,用于在 Codex 环境中执行 GSD 工作流:
AskUserQuestion → request_user_input 映射
GSD 工作流使用 AskUserQuestion(Claude Code 语法),需翻译为 Codex 的 request_user_input:
- header → header
- question → question
- 选项格式 "Label" — description → {label: "Label", description: "description"}
- 由 header 生成 id:转小写,空格替换为下划线
- 批量调用:AskUserQuestion([q1, q2]) → 单个 request_user_input,在 questions[] 中包含多个条目
- 多选变通:Codex 没有 multiSelect,可使用连续的单选,或提供一个带编号的自由文本列表,要求用户输入以逗号分隔的编号
- 执行模式回退:当 request_user_input 被拒绝(执行模式)时,提供一个纯文本编号列表并选取合理的默认值
Task() → spawn_agent 映射
GSD 工作流使用 Task(...)(Claude Code 语法),需翻译为 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) 关闭代理
适用场景
适用于按阶段推进的项目或路线图管理,尤其是在执行过程中出现需要优先处理的紧急工作时,希望在不动原编号体系的前提下插入新阶段。
限制
资料中未提供关于收费、价格、平台依赖、具体效果指标或其他使用步骤的信息,暂未提供。