SuperAPI AI 工具集

ship-workflow

办公与效率

查看项目

更新于 10-16 00:20

技能介绍

用途:Ship Workflow 通过仓库当前检查、必需评审、分支保护和合并策略,把变更发布到授权终点。日常发布是默认行为。可执行脚本负责 Git/平台变更、日志、对账与清理;助手负责范围、逻辑变更分组、仓库约定和陌生故障诊断。

主要能力:支持按 PR、分支、显式栈、已保存运行或当前分支解析目标;提供 clean(默认)、--until merged、--until pr 等终点;支持 --dry-run 只读检查、--inventory 盘点、--policy 显式策略、--stack-plan 栈计划、--gates 本地门禁、--resume RUN_ID 恢复。栈发布按父先子后,使用 force-with-lease 重推并重定向。

使用方式:需 Python 3.12+、Git 和已认证 gh。从目标仓库检出运行,例如:uv run --no-project --python 3.12 python "<skill-dir>/scripts/ship.py" --pr 12 --dry-run;uv run --no-project --python 3.12 python "<skill-dir>/scripts/ship.py" --pr 12 --until merged。检查 CI 可运行 gh pr checks N --repo owner/repo --watch --interval 10 --fail-fast。

适用场景:已有 PR 的常规合并、脏工作区提交规划与推送、建 PR、栈式 PR 发布、发布前本地门禁校验。

限制:不负责版本、变更日志、标签、发布、包发布或部署,这些属于独立发布权限。缺少前置条件即 BLOCKED,无手工回退。不绕过保护、不使用管理员合并、不削弱检查。退出码 0 为 PLANNED/COMPLETE,3 为 WAITING,4 为 NEEDS_JUDGMENT,2 或 5 为阻塞/输入错误。部分栈、排队中或清理未完成均不算成功。