SuperAPI AI 工具集

gsd-new-workspace

编程与开发

查看项目

更新于 10-16 06:27

技能介绍

用途

gsd-new-workspace 是一个用于创建隔离工作区的技能。其描述为:创建带有仓库副本和独立 .planning/ 的隔离工作区(Create an isolated workspace with repo copies and independent .planning/)。

主要面向两类场景:

  • 多仓库编排(Multi-repo orchestration):在部分仓库子集上并行工作,并使用相互隔离的 GSD 状态。
  • 特性分支隔离(Feature branch isolation):为当前仓库创建一个 worktree,并附带其自己的 .planning/ 目录。

主要能力

根据资料,该技能会创建以下内容:

  • <path>/WORKSPACE.md — 工作区清单(workspace manifest)
  • <path>/.planning/ — 独立的规划目录(independent planning directory)
  • <path>/<repo>/ — 为每个指定仓库创建的 git worktree 或 clone

使用方式

该技能通过提及 $gsd-new-workspace 来调用。调用后,所有位于 $gsd-new-workspace 之后的用户文本被视为 {{GSD_ARGS}};若没有提供参数,则将 {{GSD_ARGS}} 视为空。

创建完成后,命令的后续步骤是:cd 进入该工作区,并运行 $gsd-new-project 来初始化 GSD。

资料还说明,GSD 工作流使用 Claude Code 语法,需翻译到 Codex 对应工具,具体映射如下:

Skill 调用

  • 技能通过提及 $gsd-new-workspace 调用。
  • $gsd-new-workspace 之后的所有用户文本视为 {{GSD_ARGS}};无参数时视为空。

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 被拒绝(执行模式)时,呈现纯文本编号列表并选择一个合理的默认值。

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) 关闭。

适用场景

  • 需要在多个仓库的子集上并行推进工作时,希望各仓库使用彼此隔离的状态。
  • 希望在当前仓库上创建 worktree,且该副本拥有独立的规划目录,从而不影响主仓库环境。

限制与暂未提供的信息

资料未提供关于收费、价格、平台支持范围、运行性能或效果保证等信息,此处不作推断。资料中也未给出具体的依赖要求、安装命令或版本兼容说明。除上述创建内容与调用约定外,其余细节暂未提供。