SuperAPI AI 工具集

gsd-insert-phase

智能体与模型

查看项目

更新于 10-16 06:27

技能介绍

用途

该技能用于在已有的阶段(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) 关闭代理

适用场景

适用于按阶段推进的项目或路线图管理,尤其是在执行过程中出现需要优先处理的紧急工作时,希望在不动原编号体系的前提下插入新阶段。

限制

资料中未提供关于收费、价格、平台依赖、具体效果指标或其他使用步骤的信息,暂未提供。