用途:Ship 是 PR 合并前的最后一道流程,负责编排整个预合并过程:按顺序运行审查门、依据结果决定是否放行,并创建 PR。它本身是编排器而非单体工具:Simplify 与 Code Review 由它内联执行,Adversarial 委托给 adversarial-review 技能,Finalize 委托给 finalize 技能。
主要能力:八道门依次为 Context(确认位置,不安全则中止)、Change Inventory(映射改动与风险)、Simplify(内联,去除多余复杂度)、Code Review(内联,找缺陷,未解决的关键问题阻断)、Adversarial(可选,红队高风险改动)、Finalize(lint、测试、质量、文档、卫生)、Readiness(按当前 diff 生成仪表盘)、PR(推送、撰写 PR、报告 URL)。
使用方式:支持参数 --status(仅显示就绪度仪表盘)、--adversarial(强制运行对抗门)、--no-adversarial(跳过并抑制提示)。门 3–6 构成审查循环,若某门编辑了文件则提交 ship: apply review fixes (round N) 并重跑,最多 2 轮。就绪度按 HEAD 记录,可跨调用跳过已通过的门。
适用场景:在功能分支上完成改动后,需要一次性完成审查、修复、验证并开 PR 时使用。
限制:需要 shell、git 与读写文件能力;依赖 scripts/readiness.sh,缺失需重装整个 ship 目录;基础分支无本地或远程引用时需先 git fetch;位于基础分支或工作区不干净时会中止;不假设存在 MCP、插件、浏览器或 GitHub 连接器,缺失时降级到 shell + git 并说明未完成项。