---
name: changelog
description: 一键发版：生成更新日志 → commit → 打 tag，全流程自动化。
---

# Changelog - 一键发版

> **定位**：发版全流程。`/changelog 0.2.0` 一个命令搞定日志生成 + commit + tag。

## 用法

```
/changelog <version>        # 例: /changelog 0.2.0
/changelog                  # 不传版本号则自动推断
```

## 执行流程

### 1. 确定版本号

**有参数**：直接使用用户传入的版本号。

**无参数**：自动推断。读取最新 tag，按 semver 规则 bump patch 版本 +1。例如当前最新 `v0.1.2` → 推断为 `0.1.3`。若无 tag 则默认 `0.1.0`。

版本格式：`{major}.{minor}.{patch}`（标准 semver）

### 2. 获取 Commits

```bash
# 找到上一个 tag
git tag --sort=-creatordate

# 读取 commits（从上一个 tag 到 HEAD）
git log {prev_tag}..HEAD --oneline --no-merges
```

如果没有上一个 tag，则从初始 commit 开始。

### 3. AI 总结

将 commit 列表总结为用户友好的中文更新说明：

| type | emoji | 说明 |
|------|-------|------|
| feat | ✨ | 新功能 / 新 Skill |
| fix | 🐛 | Bug 修复 |
| refactor | ♻️ | 代码重构 |
| docs | 📝 | 文档更新 |
| chore | 🔧 | 杂项维护 |

规则：
- 每条说明 1 句话，简洁明了
- 合并相关的小 commit 为一条
- 面向用户描述（不要出现技术细节如文件名、函数名）
- summary：一句话概括本次更新的核心主题

### 4. 展示草稿，等待确认

```
📦 v{version} · {date}
{summary}

✨ 新增 /go 执行按钮 Skill...
📝 更新 README 文档格式...
🐛 修复仓库 URL 配置...
```

**必须等用户确认或修改后才继续**。

### 5. 写入文件

用户确认后，更新 `CHANGELOG.md`：

- 文件不存在时创建，头部加 `# Changelog` 标题
- 将新条目插入已有内容**头部**（标题行之后，最新版本在前），保持现有条目不变
- 条目格式：

```markdown
## v{version} ({YYYY-MM-DD})

{summary}

- ✨ xxx
- 🐛 xxx
- ♻️ xxx
```

### 6. Commit + Tag

```bash
# Stage 变更文件
git add CHANGELOG.md

# Commit
git commit -m "release: v{version}"

# 打 tag
git tag v{version}
```

### 7. 完成提示

```
✅ 发版完成！
- 📝 CHANGELOG.md: 新增 v{version} 条目
- 🏷️ git tag: v{version}

需要 push 到远程吗？(git push && git push --tags)
```