用途:为任意软件制品做通用版本管理,不依赖特定 VCS,覆盖定号、记变更、标发布、查一致四个环节。核心原则是版本号代表对使用者的兼容性承诺,而非构建次数。
主要能力:按 SemVer 决策表判定 MAJOR/MINOR/PATCH(破坏对外契约升 MAJOR、向后兼容新增或标记弃用升 MINOR、兼容修正与仅元数据升 PATCH);按文档化契约、可观察行为、纯实现细节三层判定兼容性;维护 CHANGELOG(Keep a Changelog 约定,分组 Added/Changed/Deprecated/Removed/Fixed/Security);发布标记(有 git 打 vX.Y.Z tag,无 git 记 RELEASES 清单);审计多处版本号一致性。
使用方式:先定位唯一版本源(如 package.json、pyproject.toml、Cargo.toml、VERSION、SKILL.md frontmatter 等),只改这一处,其余派生;再写版本源与 CHANGELOG,最后打标记并按环境回查一致。可配合 semantic-release、release-please、changesets、setuptools_scm 等工具在派生环节自动化。
限制:只管版本号,分支/提交/PR 属 git-workflow,依赖版本与漏洞属 dependency-scan;破坏性判定无法确定时须询问用户,不默认;已发布版本冻结内容,纠错走新版本号,撤回用各生态 yank/deprecate 机制。参考资料含 references/ecosystems.md、references/deprecation-templates.md、references/research.md。