Documentation
¶
Overview ¶
Command releasecheck —— 发版纪律的机器判据(把散文变成门禁)。
四条纪律此前只写在 AGENTS.md「发版纪律」与 docs/AI-GUIDE.md §3.6 里, 全靠人手工核对。它们各自对应一种**只有下游才会发现**的残缺:
- **tag 快照里的 CHANGELOG 必须已含该 tag 自己那一段**。顺序反了(先打 tag 后生成)⇒ 下游 go mod download 拿到的模块里,发布说明缺自己那版。
- **CHANGELOG 不得含 U+FFFD**。源 commit message 带坏字节时生成器会忠实 复现,而坏字节在两侧都读不出原因。
- **一个提交只装一类内容**。「依赖文件 + 非依赖文件」混装会让行为变更落进 「依赖地板」段——下游扫 breaking 时根本看不见(2026-10-25 v0.13.0 实例)。
- **tag 必须是 annotated**。轻量 tag 承载不了发布说明,只剩一个指向。
判定面:只在 tag 快照上判 ¶
HEAD 没有 exact tag(普通提交 / PR 分支)⇒ **显式跳过并 exit 0**。故它可以 安全地挂在 make check 里:日常绿,打 tag 后 CI 的 tag 运行必然有 exact tag, 那时它才是硬判据。这条与「跳过必须显式、不许静默」一致——跳过时会打印原因。
为什么第 3 条带一张闭合的 legacy 清单 ¶
已发布的提交不可重写(改写公开历史会让下游按 commit 引用的校验失效)。故 历史上已发生的混装只能登记、不能修;清单**只减不增**,新增混装一律报红。
Click to show internal directories.
Click to hide internal directories.