SuperAPI AI 工具集

gsd-progress

办公与效率

查看项目

更新于 10-16 06:27

技能介绍

用途

gsd-progress 是一个工作流技能,主要用于在继续工作之前提供项目的情境感知(situational awareness)。根据描述,它能够检查项目进度、展示上下文,并路由到下一步动作,即在“执行(execute)”与“规划(plan)”之间进行选择。

主要能力

  • 检查项目进度:展示当前项目所处状态。
  • 展示上下文:提供继续工作所需的相关背景信息。
  • 路由下一步动作:根据当前状态,将用户引导至执行或规划流程。

使用方式

该技能通过提及 $gsd-progress 来调用。调用时,$gsd-progress 之后的所有用户文本会被视为 {{GSD_ARGS}};如果没有任何参数,则将 {{GSD_ARGS}} 视为空。

技能内部附带了一套 codex_skill_adapter 适配层,用于处理不同环境之间的语法映射:

  • 技能调用(Skill Invocation):由 $gsd-progress 触发。
  • AskUserQuestion → request_user_input 映射:GSD 工作流使用 AskUserQuestion(Claude Code 语法),需转换为 Codex 的 request_user_input。参数映射包括 header 到 header、question 到 question,选项格式由“Label”与描述转换为 {label: "Label", description: "description"},并根据 header 生成 id(小写、空格替换为下划线)。批量调用时,AskUserQuestion([q1, q2]) 转换为单个 request_user_input,并在 questions[] 中包含多个条目。多选场景下,由于 Codex 没有 multiSelect,改用顺序单选,或提供编号的自由文本列表要求用户输入逗号分隔的数字。在 Execute 模式下,若 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) 关闭代理。

执行上下文

技能引用了一个执行上下文文件:@/mnt/local-analysis/workspace-hub/.codex/get-shit-done/workflows/progress.md。

适用场景

适用于需要在迈出下一步之前了解项目整体状况、并决定应进入执行还是规划环节的开发与项目管理工作流。

限制

除上述适配层与执行上下文引用外,关于该技能的具体实现细节、支持的平台、是否收费、价格等信息暂未提供。