agent-infra: Skill for Claude Code

创建发布说明

基于已合并的 PR 和提交，为指定版本生成全面的发布说明。

执行流程

1. 解析参数

从参数中提取：

• <version>：当前发布版本（必需），格式 X.Y.Z
• <prev-version>：上一版本（可选），如未提供则自动检测

2. 确定版本范围

当前标签：v<version>

上一标签（如未指定）：

git tag --sort=-v:refname

查找 v<version> 之前最近的标签。

验证标签存在：

git rev-parse v<version>
git rev-parse v<prev-version>

3. 参考历史发布说明格式与分类

读取一次 typed 发布说明上下文，并参考预定义的完整分类清单：

执行前先读取 .agents/rules/release-commands.md。

agent-infra-internal platform-release-notes context \
  --from-tag "v<prev-version>" --to-tag "v<version>" \
  --branch "<base-branch>" --history-limit 3

Part B：完整分类清单

• 🆕 Feature
• ✨ Enhancement
• ✅ Bugfix
• 📚 Documentation

用途：

• Part A：分析最近 3 条历史发布说明的章节结构、标题风格、emoji 使用、条目格式
• 每项 history 含 tag、正文和 Release URL；正文只作为格式样例，不作为当前版本的变更事实
• Part B：提供静态完整分类清单，确保后续生成时不遗漏已有分类
• 该静态清单用于确保变更分类时不遗漏已有类别名称；若当前版本无该类变更，仍按步骤 7 的格式规则省略空分类
• 后续步骤 7 生成发布说明时，必须同时参考步骤 3 的历史格式风格和完整分类清单，保持版本间的一致性
• 如果没有历史发布说明，则使用步骤 7 中定义的默认格式

4. 收集已合并的 PR 与贡献者

使用步骤 3 返回的 pullRequests 与 commits。每个 commit 的 authors 只包含该 commit 的平台作者；pullRequestNumbers 表示平台记录的 PR 关联。技能不读取平台原始字段或邮箱规则。PR 的 closingIssues 是该 PR 实际关闭的 Issue，不按 PR/Issue 编号推断关联。

发布说明记录标签间实际交付的变更。对于没有关联 PR 的 commit，依据 typed context 中的 oid 检查实际 diff，判断它记录的是版本交付还是发布流程本身。仅包含版本元数据更新、生成发布产物或其他版本准备/发布机械操作的 commit 不属于本版本变更，也不计入贡献者；同一 commit 若还包含独立的产品、文档或维护改动，则保留这些改动及其作者。diff 无法说明提交用途时，保留该 commit，并根据实际改动描述。步骤 6 的变更分类和步骤 7 的贡献者统计使用同一筛选结果。

5. 收集关联 Issue

使用步骤 3 中每个 PR 的 closingIssues，不在通用技能中解析平台专有引用语法。

6. 分类变更

按类型（从 PR 标题的 Conventional Commit 前缀）：

• feat、perf、refactor、依赖升级 -> Enhancement
• fix -> Bugfix
• docs -> Documentation（如少于 3 项则合并到 Enhancement）

按模块（从 PR 标题 scope、标签或文件路径）：

• 从 PR 标题中的方括号 [module] 或 Conventional scope feat(module): 推断模块
• 兜底：分析变更的文件

7. 生成发布说明

优先使用步骤 3 中获取的历史格式风格，并确保覆盖步骤 3 列出的所有分类。 每次动态参考最近 3 条已发布说明；把这些正文共同使用的章节、双语布局和安装段作为稳定格式，条目内容按当前版本变化。不要把样例中的作者或链接复制到当前版本。

如果没有历史发布说明，使用以下默认格式化为 Markdown：

## {Module / 模块}

### Enhancement / 增强

- [{scope}] Description by @author in [#N](url)

### Bugfix / 修复

- [{scope}] Description by @author in [#N](url)

## Contributors / 贡献者

@contributor1, @contributor2, @contributor3, @reporter1 (reported #N)

## Installation / 安装

{本版本的中英文安装说明，沿用历史正文中的稳定安装步骤}