312362115/claude/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

YYYY.MM.PATCH

# 获取当前年月
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"

# 获取上一个 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

# Changelog — v2026.4.1
 
## 新功能（Features）
-**auth**: 支持 OAuth2 第三方登录
-**export**: 用户数据导出功能
 
## 修复（Fixes）
-**login**: 修复密码错误时返回 500 的问题
-**cache**: 修复缓存 key 冲突
 
## 重构（Refactoring）
-**api**: 统一错误响应格式
 
## 其他
-**docs**: 更新 API 文档
-**test**: 补充登录模块测试用例

# 创建 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
)"

# 创建 tag
git tag -a "v${VERSION}" -m "Release v${VERSION}"
 
# 写入 changelog 文件
# 存入 docs/changelog/YYYY-MM-DD-v<版本号>.md

用户：发个版
  │
  ├─ Step 1: 发版前检查（代码状态 + CI + 安全）
  ├─ Step 2: 生成版本号（CalVer）
  ├─ Step 3: 生成 Changelog（从 git log）
  ├─ Step 4: 创建 Release（GitHub 或本地文件）
  └─ Step 5: 发版后处理

task-finish（功能收尾）
  ↓
security-audit（发版前安全审查）
  ↓ 审查通过
release（本 skill — 发版）