用途:在 kube-hetzner(terraform-hcloud-kube-hetzner)仓库中准备或执行一次发布,默认只做准备,不创建标签;只有维护者明确要求「release time」或「do the release」时才执行完整本地发布门禁、创建并推送附注标签。
主要能力:分析上个标签以来的提交并分类(PATCH/MINOR/MAJOR 及破坏性变更);更新 CHANGELOG.md 的 ## [Unreleased] 段落;更新 README 版本徽章与 versions.tf 引用;必要时重新生成机器可读知识文件并核对 meta.version;验证发行说明内容与准备提交。
使用方式:命令为 /prepare-release。发布由 .github/workflows/publish-release.yaml 基于 v* 标签自动触发,从 CHANGELOG.md 中 ## [Unreleased] 到下一个 ## [ 之间的 Markdown 作为发行内容,缺失、重复或为空会拒绝;不运行 Terraform、Packer、HCloud、bootstrap 或集群门禁,这些属本地预标签检查。执行发布时需先确认 master 干净且最新、标签本地与远端均不存在,再创建并推送附注标签并确认发布成功。
适用场景:发布前的变更整理与验证、社区贡献者署名核对、v3 系列的 README/CHANGELOG/示例一致性检查。
限制:不要仅因调用本技能就创建标签;不要在打标签前把 [Unreleased] 改为 [vX.Y.Z];正常路径不要运行 gh release create;发布后需清空 [Unreleased] 并把内容移到对应版本标题下。资料未提供具体执行所依赖的完整外部环境说明。