# Vibeflow Ship

> 测试通过后使用 — 准备发布工件、版本管理和发布输出

- Skill: `ttttstc/vibeflow-ship` (Agent Skill)
- Install (CLI): `npx skillmds@latest add ttttstc/vibeflow-ship`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ttttstc/vibeflow-ship/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ttttstc (https://skillmd.com/u/ttttstc)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ttttstc/vibeflow-ship

---


# 发布准备

在所有测试通过（系统测试 + QA 如需要）后，准备项目发布。

**启动宣告：** "正在使用 vibeflow-ship 准备发布。"

## 前置条件

- 系统测试报告存在且裁定为 Go 或 Conditional-Go
- QA 报告存在且通过（如工作流要求 QA）
- 无严重/重要缺陷未修复

## 检查清单

### 1. 发布前检查

- [ ] 读取 ST 报告确认 Go/Conditional-Go 裁定
- [ ] 读取 QA 报告确认通过（如适用）
- [ ] 运行完整测试套件 — 最后一次确认零失败
- [ ] 验证 feature-list.json 中所有活跃功能为 passing
- [ ] 读取 `.vibeflow/workflow.yaml` 确认发布配置

### 2. 版本管理

从 `.vibeflow/workflow.yaml` 读取 `ship` 配置：

- **version_bump**：如启用，更新项目版本号
  - 读取当前版本（`VERSION` 文件、`package.json`、`pyproject.toml` 等）
  - 根据变更范围确定版本号（major/minor/patch）
  - 更新所有版本引用
- **tag**：如启用，创建 git tag

### 3. 完善 RELEASE_NOTES.md

读取现有 `RELEASE_NOTES.md`，确保：

- `[Unreleased]` 章节包含所有已交付功能的变更记录
- 将 `[Unreleased]` 重命名为 `[版本号] - YYYY-MM-DD`
- 添加新的空 `[Unreleased]` 章节
- 格式遵循 Keep a Changelog

```markdown
# Changelog

## [Unreleased]

## [X.Y.Z] - YYYY-MM-DD

### Added
- [功能描述]（对应 FR-xxx）

### Changed
- [变更描述]

### Fixed
- [修复描述]
```

### 4. 更新文档

- 确保 README.md 反映当前功能集和使用方式
- 确保 examples/ 可运行
- 如有 API 文档，确保与实现同步

### 5. 创建发布提交

```
git add -A
git commit -m "release: vX.Y.Z

- [功能摘要]
- ST report: Go
- QA report: Pass (如适用)"
```

### 6. 创建 Tag（如工作流配置启用）

```
git tag -a vX.Y.Z -m "Release vX.Y.Z"
```

### 7. 创建 PR（如工作流配置启用）

使用 `gh pr create` 创建 Pull Request：
- 标题：`Release vX.Y.Z`
- 正文：包含功能摘要、测试结果摘要、变更统计

### 8. 发布摘要

向用户展示发布摘要：

```markdown
## 发布摘要

**版本**：vX.Y.Z
**功能数**：X 个活跃功能
**测试**：
- 单元测试：XXX 通过
- 覆盖率：XX% 行 / XX% 分支
- 变异得分：XX%
- 系统测试：Go
- QA：Pass（如适用）

**关键交付**：
- [功能 1]
- [功能 2]
- ...

**已知限制**：
- [如有]
```

### 9. 过渡

发布完成后进入 `vibeflow-reflect`。

## 工作流配置参考

`.vibeflow/workflow.yaml` 中 `ship` 章节可能包含：

```yaml
ship:
  version_bump: true|false
  tag: true|false
  pr: true|false
  release_docs: true|false
```

按配置跳过不需要的步骤（如 prototype 模板可能不创建 tag 和 PR）。

## 集成

**调用者：** vibeflow-router 或 vibeflow-test-system/vibeflow-test-qa
**依赖：** 系统测试 Go + QA 通过（如需要）
**产出：** 发布提交、RELEASE_NOTES.md、可选 tag 和 PR
**链接到：** vibeflow-reflect