312362115 发版（Release）
发版不只是打 tag，是一个质量门禁流程：安全审查→生成版本→创建 Release。
第一步：发版前检查
发版前必须确认以下条件：
准备发版
│
├─ 1. 代码状态检查
│ ├─ 工作区干净？（无未提交改动）
│ ├─ 在正确的分支上？（main / release branch）
│ └─ 已合并所有需要的 PR？
│
├─ 2. CI 状态检查（如果有）
│ └─ GitHub Actions 全绿？
│
├─ 3. 安全审查
│ └─ 提示用户：是否需要跑 security-audit？（上线服务强烈建议）
│
└─ 4. 测试验证
└─ 核心功能是否经过验证？
检查命令：
# 工作区状态
git status
# CI 状态（GitHub）
gh run list --limit 5
# 未合并的 PR
gh pr list
任何检查不通过，提示用户处理后再继续，不强行发版。
第二步：确定版本号
CalVer 格式
YYYY.MM.PATCH
| 部分 | 含义 | 示例 |
|---|---|---|
| YYYY | 年份 | 2026 |
| MM | 月份（不补零） | 4 |
| PATCH | 当月第几次发布（从 1 开始） | 1, 2, 3... |
版本号生成逻辑：
# 获取当前年月
YEAR=$(date +%Y)
MONTH=$(date +%-m)
# 查找当月已有的最大版本号
LATEST=$(git tag --list "${YEAR}.${MONTH}.*" --sort=-version:refname | head -1)
if [ -z "$LATEST" ]; then
# 当月第一次发布
VERSION="${YEAR}.${MONTH}.1"
else
# 递增 PATCH
PATCH=$(echo "$LATEST" | awk -F. '{print $3 + 1}')
VERSION="${YEAR}.${MONTH}.${PATCH}"
fi
echo "版本号: $VERSION"
示例：
- 2026 年 4 月第 1 次发布 →
2026.4.1 - 2026 年 4 月第 2 次发布 →
2026.4.2 - 2026 年 5 月第 1 次发布 →
2026.5.1
第三步：生成 Changelog
从 git log 提取
# 获取上一个 tag 到 HEAD 的所有提交
PREV_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "")
if [ -z "$PREV_TAG" ]; then
# 没有历史 tag，取所有提交
COMMITS=$(git log --oneline --pretty=format:"%s")
else
COMMITS=$(git log ${PREV_TAG}..HEAD --oneline --pretty=format:"%s")
fi
按 type 分组
根据 commit message 的 type(scope): desc 格式自动分组：
# Changelog — v2026.4.1
## 新功能（Features）
- **auth**: 支持 OAuth2 第三方登录
- **export**: 用户数据导出功能
## 修复（Fixes）
- **login**: 修复密码错误时返回 500 的问题
- **cache**: 修复缓存 key 冲突
## 重构（Refactoring）
- **api**: 统一错误响应格式
## 其他
- **docs**: 更新 API 文档
- **test**: 补充登录模块测试用例
分组规则：
| commit type | changelog 分组 |
|---|---|
| feat | 新功能（Features） |
| fix | 修复（Fixes） |
| refactor | 重构（Refactoring） |
| perf | 性能优化（Performance） |
| docs, test, chore, ci | 其他（如果没有 feat/fix/refactor 可省略） |
Changelog 输出
- 有 GitHub：嵌入 GitHub Release 的 body
- 无 GitHub：写入
docs/changelog/YYYY-MM-DD-v<版本号>.md
第四步：创建 Release
方式 A：GitHub Release（优先）
# 创建 tag
git tag -a "v${VERSION}" -m "Release v${VERSION}"
git push origin "v${VERSION}"
# 创建 GitHub Release
gh release create "v${VERSION}" \
--title "v${VERSION}" \
--notes "$(cat <<'EOF'
<changelog 内容>
EOF
)"
方式 B：本地 Changelog 文件
如果项目不在 GitHub 或不需要 GitHub Release：
# 创建 tag
git tag -a "v${VERSION}" -m "Release v${VERSION}"
# 写入 changelog 文件
# 存入 docs/changelog/YYYY-MM-DD-v<版本号>.md
第五步：发版后
- 通知用户：发版完成，输出版本号和 Release URL
- 更新 package.json / pyproject.toml（如果项目需要版本号同步到配置文件）
- 提醒：如果有需要手动操作的部署步骤，列出来
完整发版流程
用户：发个版
│
├─ Step 1: 发版前检查（代码状态 + CI + 安全）
├─ Step 2: 生成版本号（CalVer）
├─ Step 3: 生成 Changelog（从 git log）
├─ Step 4: 创建 Release（GitHub 或本地文件）
└─ Step 5: 发版后处理
与其他 skill 的关系
task-finish（功能收尾）
↓
security-audit（发版前安全审查）
↓ 审查通过
release（本 skill — 发版）