用途
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,且该副本拥有独立的规划目录,从而不影响主仓库环境。
限制与暂未提供的信息
资料未提供关于收费、价格、平台支持范围、运行性能或效果保证等信息,此处不作推断。资料中也未给出具体的依赖要求、安装命令或版本兼容说明。除上述创建内容与调用约定外,其余细节暂未提供。