用途:从仓库已有的标签和历史中创建或起草 GitHub Release,并生成发布说明。适用于用户请求发布 GitHub Release、生成 release notes 等场景。
主要能力:先验证发布目标(git status、gh repo view、git fetch --tags、git tag --list、git ls-remote、版本文件等);检查已有 Release(gh release list --json)并识别最新稳定版、预发布命名模式和目标标签是否已有 Release;读取最近至少两个稳定 Release 作为结构参考;通过 git log、git diff --stat 和 gh api compare 收集变更事实;按需列出依赖更新(含新旧版本);再创建 Release 并验证结果。
使用方式:notes-only 请求返回文本;draft-release 请求创建未发布的草稿。创建命令示例:gh release create <target-tag> --title <target-tag> --notes-file <notes-file> --verify-tag,并按需加 --latest、--latest=false 或 --prerelease。使用临时 notes 文件并在完成后删除。
限制:仅从远程已验证标签创建,标签不存在时先询问;不凭空编造动机、破坏性变更、迁移说明或依赖变更;工作树有改动时除非用户明确要求否则不编辑或提交;已存在的 Release 不覆盖说明;发布说明用英文且精简具体,不添加仅表示版本号的条目。