用途
gs-openspec-ship 是一个编排型技能,用于将 OpenSpec 变更从实现推进到验证、审查、归档、提交,并最终创建一个草稿拉取请求。它适用于用户执行 /gs-openspec-ship 命令、说出“ship these openspec changes”,或要求实现 OpenSpec 变更并完成后续验证、审查等流程的场景。
主要能力
该技能作为编排器,自身不执行 rebase、实现、验证、审查、归档、提交或创建拉取请求,而是按顺序为每个变更启动子代理执行七个步骤:
- 应用(apply):遵循 openspec-apply-change 技能,实现所有剩余任务。
- 验证(verify):遵循 openspec-verify-change 技能,生成完整验证报告。
- 修复验证问题:修复验证报告中列出的所有 CRITICAL、WARNING 和 SUGGESTION 项。
- 审查(review):遵循 gs-review 技能,对未提交变更进行审查并生成完整报告。
- 修复审查问题:修复审查报告 Findings 下的所有编号项。
- 归档并同步规格:遵循 openspec-archive-change 技能,在存在 delta 规格且同步未阻塞时先同步再归档。
- 提交:遵循 gs-git-commit 技能,为该变更创建一个提交,包含实现、同步的规格和归档移动。
在第一个变更开始前,执行一次 rebase,将当前分支变基到远程默认分支。在所有变更处理完毕后,创建一个包含本次运行所有提交的草稿拉取请求。
使用方式
输入格式为 /gs-openspec-ship <change> [<change> ...],也接受文字列表,如“implement the following openspec change(s):”后跟变更名称。可选参数 --store <id> 适用于运行中的所有 OpenSpec 命令。未提供变更名称时,运行 openspec list --json 并询问要交付哪些活动变更。
该技能与运行时无关,使用当前运行时的子代理机制。如果该机制不可用,则在当前会话中执行步骤并以步骤名称标记结果。运行在属于工作的检出目录中进行,不创建或切换分支或工作树。
每个步骤启动一个子代理并等待其完成后再开始下一步。子代理提示独立,不向用户提问。共享恢复契约规定:失败命令是待调查的证据而非自动阻塞;在存在安全、范围内下一步操作时继续;读取实际诊断信息;修复格式、lint、编译器警告和实现导致的测试失败;从规格、代码和既定模式中解决实现细节;遇到需求冲突、产品行为变更或范围扩大时停止;修复本地环境问题;超时或连接失败后检查操作是否完成再重试;遵循仓库验证指南;绝不绕过检查、弱化断言、丢弃需求或声称未执行的检查通过。连续三次修复尝试无实质进展后返回阻塞。
适用场景
适用于需要将 OpenSpec 变更批次交付的场景,包括实现变更、验证、审查、修复问题、归档、提交和创建拉取请求的完整流程。支持多个变更依次处理,每个变更完成或阻塞后再处理下一个。
限制
该技能不直接执行具体操作,依赖子代理和已安装的技能。需要找到 openspec-apply-change、openspec-verify-change、openspec-archive-change、openspec-sync-specs、gs-review、gs-git-commit 和 gs-pull-request 等技能;找不到时停止并指明缺失技能。gs-review 不可用时阻塞变更,不编造审查。真正的阻塞(如需求、范围或授权决策)会停止批次并保留检出状态,不打开拉取请求。rebase 阻塞时停止运行。批量因未完成编辑而停止时,不打开拉取请求。