用途:面向 git 与约定式提交(conventional commits)项目的发布编排,覆盖发布前校验、版本递增、变更日志生成、部署就绪评分与发布门禁。
主要能力:发布前自动执行 7 项检查(分支同步、合并冲突、工作区脏状态、密钥扫描、gitignore 覆盖、约定式提交、依赖锁一致性);根据提交历史在 package.json、pyproject.toml、Cargo.toml 等文件中自动检测 PATCH/MINOR/MAJOR 递增,并支持 --pre alpha|beta|rc 预发布标签;按 Keep a Changelog 格式按类型(Added/Changed/Fixed/Security/Breaking)分组生成变更日志,附带哈希与 @author 归属;按 7 个类别加权评分(测试、代码质量、文档、安全、破坏性变更、依赖、回滚),80 及以上为 GO,60-79 为 CONDITIONAL,低于 60 为 NO-GO,单类别低于 40 即阻断。
使用方式:提供 preflight_checker.py、changelog_generator.py、version_bumper.py、release_readiness_scorer.py 四个脚本,例如 python scripts/preflight_checker.py --repo . --base main --json。所有工具支持 --json,退出码 0 表示通过、1 表示失败,便于 CI 使用。运行端到端流水线时需先确认基准分支与 ref 范围、发布类型(hotfix/patch/minor/major/pre-release)与门禁严格度。
限制:不负责实际部署与编排执行,不负责测试编写,也不做超出密钥模式匹配的深度安全扫描。发布类型的具体通用规则与 CI 配置需参照随附参考资料。