Ship

Ship - 发布工程师

转换自 gstack/ship，专为 WorkBuddy/OpenClaw 优化

概述

完全自动化的代码发布工作流。检测并合并基础分支、运行测试、审查差异、版本管理、更新日志、提交、推送和创建 Pull Request。

触发条件

当用户说以下内容时使用此技能：

• "ship"
• "deploy"
• "push to main"
• "create a PR"
• "merge and push"
• "发布代码"
• "准备部署"

完整发布流程

1. 基础分支检测

• 确定 PR 目标分支
• 验证分支状态

2. 预检检查

• 验证当前分支状态
• 检查变更范围
• 确认没有未提交的更改

3. 合并基础分支

• 在测试前合并最新代码
• 处理可能的冲突

4. 测试框架引导

• 自动检测测试环境
• 安装必要依赖
• 配置测试数据库

5. 运行测试

• 在合并后的代码上执行测试
• 确保所有测试通过

6. 测试覆盖率审计

• 检查覆盖率目标
• 目标：100% 覆盖
• 自动生成缺失测试

7. 预发布审查

• 结构性问题检查
• 设计审查（条件性）
• 安全检查

8. 版本自动升级

• 基于变更规模自动决定版本号：
  • Major: 破坏性变更
  • Minor: 新功能
  • Patch: Bug 修复

9. 变更日志生成

• 从提交历史自动生成
• 按类型分组
• 生成 CHANGELOG.md

10. TODO 列表更新

• 自动标记已完成项
• 添加发布相关任务

11. 提交与推送

• 创建逻辑分组的提交
• 推送到远程仓库

12. PR 创建

• 自动创建 Pull Request
• 包含变更摘要
• 链接相关 issue

13. 文档同步

• 自动更新项目文档
• API 文档
• README 更新

自动化程度

• 完全自动化：用户说 /ship 后自动执行
• 智能决策：版本号、测试生成自动处理
• 仅关键点暂停：合并冲突、测试失败时需要用户介入

完整性原则

"没有新鲜验证证据不声称完成"

• 所有变更必须通过测试
• 测试覆盖率必须达标
• 多层代码质量检查

支持的运行时

• Node.js / TypeScript
• Python
• Go
• Rust
• Ruby / Rails
• PHP
• Elixir

验证门控

在推送前必须通过：

• 所有测试通过
• 覆盖率达标
• 代码质量检查通过
• 无安全漏洞
• 文档已更新

输出

PR 内容

## 发布摘要

### 版本
- 版本号: v1.2.3
- 变更类型: Minor

### 变更内容
- 新功能: X 个
- Bug 修复: X 个
- 优化: X 个

### 测试
- 通过: XX/XX
- 覆盖率: XX%

### 检查清单
- [x] 测试通过
- [x] 覆盖率达标
- [x] 代码审查通过
- [x] 文档已更新

注意: 本技能是 gstack ship 的 WorkBuddy/OpenClaw 适配版本。