create-release-note

name	create-release-note
description	从 PR/commit 中自动生成结构化的 Release Notes，并可选创建 GitHub Draft Release。支持 x.y.0 版本合并前一 minor 系列的 release notes。当用户要求生成发布说明、创建 release notes 时触发。参数为版本号和可选的上一版本号。

生成 Release Notes

自动从 PR、commit 和 Issue 中收集变更信息，按模块和类型分类，生成符合项目格式的 Release Notes。

参数

• <version>: 当前发布版本号，格式为 X.Y.Z（必需）
• <prev-version>: 上一版本号（可选，不提供则自动推断）

执行流程

步骤 1-3：公共步骤

1. 解析参数并验证版本号格式（X.Y.Z）
2. 确定版本范围（当前 tag 和上一 tag）
3. 判断版本类型: PATCH == 0 走合并路径，PATCH > 0 走常规路径

合并路径（x.y.0 版本）

从 GitHub 已发布的 release 中合并前一 minor 系列的所有 release notes。

常规路径（x.y.z, z > 0）

4. 收集两个 tag 之间合并的 PR 和直接 commit
5. 收集关联的 Issue
6. 按模块分组（FIT/FEL/Waterflow/AI Config）
7. 按类型分组（Enhancement/Bugfix/Documentation）
8. 生成格式化的 Release Notes

公共步骤

9. 展示并确认，询问用户是否调整
10. 创建 GitHub Draft Release:

    gh release create v<version> --title "v<version>" --notes-file /tmp/release-notes-v<version>.md --draft
    

注意事项

• 需要 gh CLI 且已认证
• Tag 必须已存在（通常由 release skill 完成）
• 创建的是 Draft Release，需人工审核后发布