用途
gsd-workstreams 用于管理并行工作流,支持多个里程碑任务的并发推进。通过提及 $gsd-workstreams 调用该技能,其后跟随的用户文本被视为参数 {{GSD_ARGS}}。
主要能力
技能提供以下子命令:
- list:列出所有工作流及其状态。
- create <name>:创建一个新的工作流。
- status <name>:查看单个工作流的详细状态。
- switch <name>:设置当前活动的工作流。
- progress:查看所有工作流的进度汇总。
- complete <name>:归档一个已完成的工作流。
- resume <name>:恢复某个工作流中的工作。
若未给出子命令,默认执行 list。
使用方式
第 1 步:解析子命令,确定要执行的工作流操作。 第 2 步:根据子命令执行对应操作,底层调用 gsd-tools,例如:
- list:node "$GSD_TOOLS" workstream list --raw --cwd "$CWD"
- create:node "$GSD_TOOLS" workstream create <name> --raw --cwd "$CWD"
- status:node "$GSD_TOOLS" workstream status <name> --raw --cwd "$CWD"
- switch:node "$GSD_TOOLS" workstream set <name> --raw --cwd "$CWD",并同时为当前会话设置 GSD_WORKSTREAM 环境变量
- progress:node "$GSD_TOOLS" workstream progress --raw --cwd "$CWD"
- complete:node "$GSD_TOOLS" workstream complete <name> --raw --cwd "$CWD",将工作流归档至 milestones/ 目录
- resume:将工作流设为活动状态,并建议执行 $gsd-resume-work --ws <name>
第 3 步:将 gsd-tools 返回的 JSON 输出格式化为人类可读的展示,显示名称、状态、当前阶段和进度等信息。在任何路由建议中应包含 ${GSD_WS} 标志。创建成功后应显示新工作流路径,并建议下一步执行 $gsd-new-milestone --ws <name> 来设置里程碑。
Codex 适配说明
该技能作为 Codex 技能适配器运行,包含从 Claude Code 语法到 Codex 工具的映射规则:
- 技能通过 $gsd-workstreams 调用。
- 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 被拒绝(Execute 模式)时,回退为纯文本编号列表并选取合理默认值。
- 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)。
适用场景
适用于需要同时管理多个并行工作流或里程碑的开发与协作场景,便于创建、切换、跟踪进度和归档工作流。
限制
收费、价格、平台支持范围、具体性能或效果等信息暂未提供。