用途:Ship 是一个结构化发布流水线,引导代码从工作分支走到已发布版本,共 7 个带门禁的阶段。触发词为 ship、release、publish。
主要能力:阶段 1 预检(git 状态、分支、测试、构建);阶段 2 AI 代码审查(用 ccw cli --tool gemini --mode analysis 对 diff 做风险分析);阶段 3 版本号提升(识别 package.json、pyproject.toml、VERSION);阶段 4 生成变更日志、创建发布提交并推送;阶段 5 创建 PR(主干开发可跳过);阶段 6 平台发布(npm publish / twine upload / cargo publish,私有包可跳过);阶段 7 打标签并创建 GitHub Release。
使用方式:按顺序执行各阶段,每个阶段有门禁条件,门禁失败即停止并报告状态。预检参考命令包括 git status --porcelain、git branch --show-current、npm test / pytest、npm run build / python -m build。
适用场景:需要规范化、可追溯发布流程的多项目仓库,支持 npm、Python 和通用项目。
限制:阶段 5、6 可条件跳过,阶段 7 为终态阶段,除非发布步骤失败否则总会执行。执行以 DONE、DONE_WITH_CONCERNS、BLOCKED、NEEDS_CONTEXT 之一结束,并遵循三振升级规则。具体配置与更多细节暂未提供。