mcpField
R
release-orchestrator

release-orchestrator

github.com/borghei云与 DevOps1.0k80 次安装5 天前更新
代码仓库

关于 release-orchestrator

release-orchestrator 是面向使用 conventional commits 的 git 项目团队的发布管理技能。它验证发布准备情况、生成变更日志、判断语义化版本升级，并以 GO、CONDITIONAL 或 NO-GO 结果设置发布门禁。

主要功能

  1. 01七项发布前验证
  2. 02检测语义化版本升级
  3. 03根据提交生成变更日志
  4. 04加权计算部署准备度
  5. 05发布流水线与 CI/CD 门禁

适用场景

  1. 01发布前检查代码仓库
  2. 02准备变更日志和版本升级
  3. 03在检查失败时阻止发布
  4. 04为 CI/CD 添加发布门禁

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/borghei/claude-skills --skill release-orchestrator

安装后在 Claude Code 中输入/release-orchestrator确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

assets/
release_checklist_template.md
sample_release_data.json
references/
ci_cd_best_practices.md
release_engineering_guide.md
release-workflows-and-operations.md
rollback_strategies.md
scripts/
changelog_generator.py
preflight_checker.py
release_readiness_scorer.py
version_bumper.py

详细介绍

发布编排器

该 Agent 会运行发布前验证、根据约定式提交生成变更日志、自动升级语义化版本，并通过 GO/CONDITIONAL/NO-GO 决策评估部署就绪度。

核心能力

  • 发布前验证 — 7 项自动化检查：分支同步、合并冲突、工作区是否干净、密钥扫描（AWS/GCP/GitHub/Stripe/JWT）、.gitignore 覆盖情况、约定式提交、依赖锁定一致性。
  • 版本管理 — 根据 package.json、pyproject.toml、Cargo.toml 等文件中的提交历史自动检测 semver 升级类型（PATCH/MINOR/MAJOR）；支持预发布标签（--pre alpha|beta|rc）。
  • 变更日志生成 — 按类型分组（Added/Changed/Fixed/Security/Breaking）的 Keep a Changelog 格式 Markdown，包含哈希和 @author 署名。
  • 部署就绪度 — 对 7 个类别加权评分（测试、代码质量、文档、安全、破坏性变更、依赖、回滚），并给出 GO（80+）/CONDITIONAL（60-79）/NO-GO（<60）决策；单个类别低于 40 分时视为阻断项。
  • 端到端流水线 — 以非交互方式串联所有工具；发布前验证失败、测试失败或结果为 NO-GO 时阻止流程。提供 CI/CD 步骤和 pre-push Git 钩子。
  • 发布类型 — hotfix、patch、minor、major 和预发布流程，包含分支模式和升级规则。

适用场景

  • 运行发布前验证，或通过密钥扫描和 GO/NO-GO 检查来控制发布。
  • 在打标签前，根据约定式提交生成变更日志。
  • 根据提交历史自动升级语义化版本。
  • 从测试、质量、安全和回滚等方面评估部署就绪度。
  • 将发布验证接入 CI/CD 流水线或 pre-push 钩子。

请先确认

编排发布前，请确认以下信息。如果有任何一项未知或含糊不清，请先询问，不要自行假设：

  • 基准分支和引用范围 — HEAD 要与什么进行比较（影响发布前的分支同步检查，以及变更日志的 --from/--to）
  • 发布类型 — hotfix / patch / minor / major / pre-release（确定分支模式和升级规则）
  • 门禁严格程度 — 是否在 CONDITIONAL（60-79）时阻止，还是仅在 NO-GO（<60）时阻止（决定流水线是否停止）

停止规则：仅询问对结果影响最大的 2-3 项。如果用户表示“只要先起草”，则继续处理，并在产物顶部列出假设。

工具

工具用途命令
preflight_checker.py运行 7 项发布前检查（同步、冲突、密钥、提交、依赖）python scripts/preflight_checker.py --repo . --base main --json
changelog_generator.py根据引用范围生成 Keep a Changelog 格式的 Markdownpython scripts/changelog_generator.py --repo . --from v1.2.0 --to HEAD --output CHANGELOG.md
version_bumper.py根据提交自动检测下一个 semver 版本；写入版本文件python scripts/version_bumper.py --repo . --dry-run --json
release_readiness_scorer.py评估就绪度（0-100 分），并给出 GO/CONDITIONAL/NO-GO 决策python scripts/release_readiness_scorer.py --input release_data.json --json

所有工具都支持使用 --json 输出机器可读结果。退出代码 0 = 通过，1 = 失败（适用于 CI）。

参考资料

加载与任务匹配的参考资料——保持此文件精简，按需查阅详细信息：

  • references/release-workflows-and-operations.md — 快速入门命令、三个核心工作流（发布前检查、版本/变更日志、就绪度）及其检查点表、端到端流水线脚本、发布类型矩阵、CI/CD 集成 YAML、反模式和故障排除表。运行或串联任何工作流时请阅读。
  • references/release_engineering_guide.md — 发布策略（滚动发布、蓝绿发布、金丝雀发布）和发布工程实践。选择部署策略时请阅读。
  • references/rollback_strategies.md — 数据库迁移回滚、可逆迁移规则和回滚操作手册。规划发布回滚部分时请阅读。
  • references/ci_cd_best_practices.md — 流水线设计模式（阶段-门控、扇出/扇入）和 CI/CD 最佳实践。设计外围流水线时请阅读。

范围与限制

此技能涵盖： 发布前验证、语义化版本升级、变更日志生成、部署就绪度评分，以及针对 git + conventional-commits 项目通过 GO/NO-GO 决策把控发布。

此技能不涵盖： 实际部署/编排执行（由 senior-devops / devops-workflow-engineer 负责）、测试编写（由 senior-qa 负责），或超出密钥模式匹配范围的深度安全扫描（由 senior-secops 负责）。

集成点

技能集成方式
senior-devops流水线阶段将发布前检查和就绪度 JSON 用作门控
senior-qa测试结果计入 Tests 类别（权重为 25%）
senior-secops密钥扫描和 CVE 数量计入 Security 类别（权重为 15%）
code-reviewer代码质量指标计入 Code Quality 类别（权重为 20%）
devops-workflow-engineer工作流 YAML 将工具作为流水线步骤调用

评论

支持 Markdown