release-notes-generatorlisted

# Release Notes Generator 打 tag 时自动对比代码变更，生成标准化的 Release Notes。 ## Overview 对比上一个 tag 到当前 HEAD 的 git 历史，按 conventional commit 分类（feat/fix/docs/refactor/chore），自动检测 breaking changes，生成标准化的 Release Notes。可选创建 git tag 和 GitHub Release。 ## When to Use - 用户要打 tag / 创建 release - 用户想总结版本变更 - 用户提到 changelog、release notes、版本说明 - 用户输入 `/release-notes` **When NOT to Use:** - 用户只是想看 git log - 用户想修改已有的 release notes ## Core Pattern ### Step 1: 检测版本号 获取最新 tag（`git describe --tags --abbrev=0`），用户指定版本号或根据变更类型建议：有 breaking changes → major，有新功能 → minor，只有 bugfix → patch。 ### Step 2: 对比变更 ```bash PREV_TAG=$(git describe --tags --abbrev=0) git log ${PREV_TAG}..HEAD --oneline git diff ${PREV_TAG}..HEAD --stat ``` ### Step 3: 分类变更 | 类别 | 前缀 | 说明 | |------|------|------| | 🚀 Features | `feat:` | 新功能 | | 🐛 Bug Fixes | `fix:` | 修复 | | 📝 Documentation | `docs:` | 文档 | | ♻️ Refactor | `refactor:` | 重构 | | 🔧 Chores | `chore:` | 构建/工具/配置 | | 💥 Breaking Changes | `BREAKING CHANGE` | 破坏性变更 | 读取 commit 消息中的 conventional commit 前缀，没有前缀的根据文件变更推断。 ### Step 4: 生成 Notes 使用 `templates/release-notes.md` 模板生成，包含版本号、日期、分类变更列表、diff 链接。 ### Step 5: 创建 Tag/Release（可选） 询问用户是否创建 annotated tag 和 GitHub Release（`gh release create`）。 ## Quick Reference ```bash /release-notes # 交互式，自动建议版本号 /release-notes v1.1.0 # 指定版本号 /release-notes --dry-run # 只生成不创建 tag ``` | 参数 | 说明 | 默认值 | |------|------|--------| | `version` | 版本号 | 自动建议 | | `--dry-run` | 只生成不创建 | false | ## Common Mista