用途:ship 是代码到达远端前唯一的语义评审关卡,用于处理本地未提交或未推送的改动并完成整合。触发场景包括用户要求推送、说 /ship、review and push、commit and push、ship it,或推送并修复 CI 直到通过。
主要能力与流程:按编号编排执行,先检查改动(git status、git diff),把 main 同步进工作分支,读取 AGENTS.md 并判定 ship profile、integration 模型与 CI owner,做冒烟检查与架构合理性检查,用并行 agent 评审改动文件,经 confidence-scorer 裁定问题,给出结论与分级发现,修复关键问题并重跑冒烟(最多 3 轮),按名暂存并提交,运行本地 gate 后整合。默认整合方式为分支加 PR 加 CI 门控自动合并;仅当 AGENTS.md 声明 direct-push 或紧急绕过时才直接 git push origin HEAD:main。
使用方式:预期起始状态是本地未提交或未推送的改动,从该分支直接调用 /ship 整合;若通过 /worktree 工作,需记录 WORKTREE_ID、WORKTREE_PATH 与 REPO_ROOT 以便整合成功后清理 worktree。PR 打开后通常为 fire-and-forget,不在会话中盯 CI,除非用户明确要求。
限制与安全规则:绝不直接推 main(除 break-glass);未运行本地 gate 前不推送;禁止 --no-verify、git push --force、--force-with-lease、git reset --hard 与 git add -A 或 git add .(按名暂存);不得削弱 gate。评审输出为建议性,需对照真实代码路径核实关键发现。review 修复循环与 push 修复循环各上限 3 轮,超出则停止并报告。深度按 profile 调整:静态 Vercel SPA 用轻量 agent 组,AWS SAM 或涉及 infra、DB、auth 的改动用完整组。以上按公开资料整理,具体配置细节以仓库内 references 文件为准。