用途:ship 是 Forge 工作流里的交付环节,负责把已验证的功能分支推送到远端,并按项目自带的 PR 模板创建拉取请求,然后停下等待人工合并。它本身从不执行合并。
主要能力:创建 PR 前设有硬性门槛,要求本次会话中已运行 /validate 并展示类型检查、lint、测试、安全四项输出且全部通过,Forge issue 处于 in_progress,当前分支不是 main 或 master。它会做分支新鲜度检查,若基线分支有新提交则要求重新运行 /validate。还会运行合并模拟与合并顺序检查,发现冲突时询问是否继续,可记录覆盖说明。创建 PR 后自动打标签、检查过期 worktree、记录 PR 交接评论并同步 issue。
使用方式:命令为 /ship。推送使用 git push --force-with-lease -u origin <branch-name>,因为 /validate 可能已变基。创建 PR 使用 gh pr create,正文必须读取并填充项目模板(如 .github/pull_request_template.md),无模板时使用最小回退格式,并包含 Closes forge-xxx。之后记录 ship→review 阶段转换,可运行 forge team sync 与 forge team verify。
适用场景:标准、关键、简单、热修复、重构、文档等变更在验证通过后的交付阶段。标准变更下一步为 review,关键变更还需 verify,其余类型在 ship 结束。
限制:不自动合并,合并需用户在 GitHub UI 手动完成后再运行 /verify;不在 ship 阶段把 issue 标记为完成;检查仍待定时只报告 PR 编号并转交 /review;文档更新属于合并前门禁,需在功能分支完成并确认 CI 通过。