create-release-note

# 创建发布说明 基于已合并的 PR 和提交，为指定版本生成全面的发布说明。 ## 执行流程 ### 1. 解析参数 从参数中提取： - `<version>`：当前发布版本（必需），格式 `X.Y.Z` - `<prev-version>`：上一版本（可选），如未提供则自动检测 ### 2. 确定版本范围 **当前标签**：`v<version>` **上一标签**（如未指定）： ```bash git tag --sort=-v:refname ``` 查找 `v<version>` 之前最近的标签。 **验证标签存在**： ```bash git rev-parse v<version> git rev-parse v<prev-version> ``` ### 3. 参考历史发布说明格式与分类 获取最近多条已发布的 Release Note 作为格式参考，并参考预定义的完整分类清单： 执行前先读取 `.agents/rules/release-commands.md`。 ```bash # Part A：按 `.agents/rules/release-commands.md` 的 release 查询命令逐条获取最近 3 条 Release 的 body ``` **Part B：完整分类清单** - `🆕 Feature` - `✨ Enhancement` - `✅ Bugfix` - `📚 Documentation` **用途**： - Part A：分析最近 3 条历史发布说明的章节结构、标题风格、emoji 使用、条目格式 - Part B：提供静态完整分类清单，确保后续生成时不遗漏已有分类 - 该静态清单用于确保变更分类时不遗漏已有类别名称；若当前版本无该类变更，仍按步骤 7 的格式规则省略空分类 - 后续步骤 7 生成发布说明时，**必须**同时参考步骤 3 的历史格式风格和完整分类清单，保持版本间的一致性 - 如果没有历史发布说明，则使用步骤 7 中定义的默认格式 ### 4. 收集已合并的 PR 与贡献者 获取标签之间的日期范围，然后查询已合并的 PR： ```bash # 获取标签日期 git log v<prev-version> --format=%aI -1 git log v<version> --format=%aI -1 # 获取范围内已合并的 PR（按 `.agents/rules/release-commands.md` 的 merged PR 查询命令执行） ``` 同时收集没有 PR 的直接提交： ```bash git log v<prev-version>..v<version> --format="%H %s" --no-merges ``` 从 commit `Co-authored-by` trailer 中收集协作贡献者： ```bash git log v<prev-version>..v<version> \ --no-merges \ --format='%(trailers:key=Co-authored-by,valueonly,unfold)' \ | grep -v '^$' | sort | uniq -c | sort -rn ``` 输出每行一个 `Name <email>`（`uniq -c` 给出该身份在范围内作为 co-author 的 commit 数）。 ### 5. 收集关联 Issue ...