# Version Bump

> 更新版本号和 CHANGELOG.md。当用户要求更新版本、发版、写更新日志时使用。Triggers on "更新版本", "bump version", "发版", "更新日志".

- Skill: `majiayu000/version-bump-7` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/version-bump-7`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/version-bump-7/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/version-bump-7

---


# Version Bump

更新应用版本号和 CHANGELOG.md。

## 步骤

### 1. 获取 CHANGELOG.md 上次修改以来的 git log

```bash
git --no-pager log --format=" - %s" $(git --no-pager log -1 --format=%H -- CHANGELOG.md)..HEAD
```

此命令：
- 找到 CHANGELOG.md 最后一次修改的 commit
- 列出从那之后到 HEAD 的所有提交
- 输出格式已适配 CHANGELOG.md 的列表格式

### 2. 确定新版本号

根据变更内容决定版本号递增规则：

| 变更类型 | 版本递增 | 示例 |
|----------|----------|------|
| 破坏性变更 | major | 1.0.0 → 2.0.0 |
| 新功能 | minor | 1.0.0 → 1.1.0 |
| 修复/优化 | patch | 1.0.0 → 1.0.1 |

### 3. 编写更新日志

将 git log 归纳为简洁的用户可读条目：

- 用自然语言描述，不要带 `feat:`、`fix:` 等 commit 前缀
- 合并相关的多个 commit 为一条（如 probe 模型 + 服务 + 页面 → "支持查看视频详细信息"）
- 去掉内部模块细节（如 ffmpeg_kit、build_runner），只写用户可感知的功能
- 每条一句话，不超过 20 个字

### 4. 更新文件

| 文件 | 修改内容 |
|------|----------|
| `CHANGELOG.md` | 在顶部添加新版本段落 |
| 应用 `pubspec.yaml` | 更新 `version` 字段，build number +1 |

### 5. 提交并整理

```
chore: 更新版本至 <新版本号>
```

如果版本更新过程中有来回修改产生多余 commit，先 rebase 合并为一个再继续。

### 6. 添加 git tag

```bash
git tag v<新版本号>
```