用途:当用户要求根据提交、标签、分支或已合并的拉取请求起草发布说明、变更日志条目或 GitHub Release 文本时使用。
主要能力:先解析发布范围,读取仓库的发布约定,确定版本、受众以及精确的 from_ref..to_ref 范围;在无歧义时从可达标签推导上一版本,若存在多条发布线或目标未知导致范围明显模糊,则先询问再继续。核验两个引用并记录其 SHA,有精确范围时不使用日期窗口。收集证据时使用 first-parent 历史识别发布级变更,再检查完整提交列表与 diff,避免遗漏 squash、rebase 和直接提交;优先使用仓库连接器获取关联的 PR 与 issue 元数据,托管 CLI 或本地 Git 作为回退。阅读配置、API、schema、迁移、依赖、运行时、部署和安全相关 diff,不单凭标题推断影响。将用户可见变更与内部维护分开,省略对目标受众无用的噪音。
撰写与核验:以变更内容及其重要性开头;明确标注破坏性变更、前置条件、数据或配置迁移、弃用、安全修复、已知问题和回滚限制;在可用时包含稳定的 PR 或 issue 引用;省略空章节;绝不编造验证、issue 链接、兼容性声明或发布日期。交付前重新检查范围、diff 统计以及任何迁移或升级说明。references/release-notes-template.md 仅作为菜单使用,不要求包含每个标题。发布标签或托管发布需要单独的明确授权。
限制:资料未提供具体安装命令、收费方式、支持平台或效果数据。