mcpField
R
release-manager

release-manager

github.com/borghei开发1.0k129 次安装1 周前更新
代码仓库

关于 release-manager

release-manager 是面向软件团队的发布规划技能，可将 conventional commits 转为变更日志、判断语义化版本升级，并评估发布准备情况，生成检查清单、回滚手册和沟通计划。

主要功能

  1. 01生成 Markdown 和 JSON 变更日志
  2. 02判断语义化版本升级及预发布轨道
  3. 03评估发布准备度并发现阻塞项
  4. 04准备回滚手册和利益相关者沟通计划
  5. 05支持常规、热修复和预发布工作流

适用场景

  1. 01为发布草拟变更日志和下一版本号
  2. 02检查候选版本的准备情况与阻塞项
  3. 03规划热修复及回滚步骤
  4. 04生成发布说明前检查提交规范

安装

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

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

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

包含的文件

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

changelog_generator.py
README.md
release_planner.py
version_bumper.py
assets/
sample_commits.json
sample_git_log_full.txt
sample_git_log.txt
sample_release_plan.json
expected_outputs/
changelog_example.md
release_readiness_example.txt
version_bump_example.txt
references/
conventional-commits-guide.md
hotfix-procedures.md
release-workflow-comparison.md
workflows-and-tool-reference.md

详细介绍

发布管理器

该 Agent 通过将符合规范的提交解析为结构化变更日志、确定语义化版本号递增幅度，并借助检查清单、回滚操作手册和利益相关方沟通计划评估发布就绪情况，自动化发布管理。

核心能力

  • 生成变更日志 — 将上一个标签以来符合规范的提交解析为 Keep-a-Changelog Markdown/JSON，按类型分组，并突出显示重大变更和问题链接。
  • 语义化版本号递增 — 根据提交类型确定 MAJOR/MINOR/PATCH，支持预发布阶段（alpha → beta → rc），并为 npm、Python、Rust、Git、Docker 输出版本递增命令。
  • 发布就绪情况 — 从功能、质量门禁、审批和时间安排等方面为发布计划评分，并指出阻塞问题。
  • 回滚与沟通 — 生成包含触发条件和预计耗时的回滚操作手册，以及附带定时消息模板的利益相关方沟通计划。
  • 工作流 — 变更日志+版本递增、就绪情况评估和加急热修复发布，每种工作流都包含验证检查点。

适用场景

  • 准备发布 — 生成变更日志并确定下一个版本。
  • 验证候选版本 — 评估就绪情况并指出阻塞项。
  • 发布热修复 — 加急修复、预发布版本管理和经过测试的回滚。
  • 审查提交规范 — 确认符合规范的提交能够生成整洁的变更日志。

先行确认

准备发布前，请确认以下输入。如果有任何信息未知或含糊不清，请询问，切勿自行假设：

  • 上一个发布标签 / 提交范围 — 确定变更日志的时间范围和版本递增决策依据
  • 发布类型 — 标准 / 热修复 / 预发布（alpha→beta→rc）（用于选择工作流和版本管理路径）
  • 目标生态系统 — npm / Python / Rust / Git / Docker（决定要输出哪些版本递增命令）

停止规则：只询问对输出影响最大的 2-3 项。如果用户说“先起草一下”，则继续操作，并在产物顶部列出假设。

工具

工具用途命令
changelog_generator.py根据符合规范的提交生成 Keep-a-Changeloggit log --oneline v1.0.0..HEAD | python changelog_generator.py --version 1.1.0 --format both
version_bumper.py确定 SemVer 版本递增幅度并输出递增命令git log --oneline v1.0.0..HEAD | python version_bumper.py --current-version 1.0.0 --analysis
release_planner.py评估发布就绪情况、检查清单、回滚和沟通计划python release_planner.py --input release-plan.json --include-checklist --include-rollback

参考资料

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

  • references/workflows-and-tool-reference.md — 快速入门、含检查点的 3 个核心工作流、版本递增规则、回滚触发条件、反模式、故障排除表、成功标准，以及三个脚本的完整 CLI 标志参考。运行发布或查询标志时阅读。
  • references/conventional-commits-guide.md — 符合规范的提交格式、类型和页脚约定。修正提交规范以确保变更日志/版本工具正常工作时阅读。
  • references/hotfix-procedures.md — 严重程度分类（P0–P3）、热修复流程及适用于各工作流的最佳实践。发布紧急修复时阅读。
  • references/release-workflow-comparison.md — Git Flow、GitHub Flow 与 Trunk-based 的对比，涵盖结构、分支类型和权衡。选择或统一分支模型时阅读。

范围与限制

此技能涵盖：

  • 解析规范提交，并以 Markdown 和 JSON 格式生成结构化变更日志
  • 确定语义化版本升级类型（major/minor/patch），并支持预发布版本（alpha、beta、rc）
  • 从功能、质量门禁、审批和时间安排等方面评估发布就绪情况
  • 根据结构化输入生成回滚操作手册、沟通计划和发布检查清单

此技能不涵盖：

  • 实际执行 CI/CD 流水线或部署自动化（参见 engineering/ci-cd-pipeline-generator）
  • 部署期间的实时监控、告警或事件响应（参见 engineering/monitoring-alerting-setup）
  • 代码审查流程或拉取请求管理（参见 engineering/code-review-automation）
  • 基础设施配置、容器编排或环境管理（参见 engineering/infrastructure-as-code）

集成点

技能集成方式数据流
engineering/ci-cd-pipeline-generator将变更日志生成和版本升级作为流水线阶段嵌入Git 日志输出流入 changelog_generator.py；版本升级输出传入流水线标记步骤
engineering/code-review-automation在合并前验证 PR 提交是否遵循规范提交格式上游验证提交信息，可确保变更日志生成的输入干净
engineering/monitoring-alerting-setup根据回滚操作手册中的监控阈值定义回滚触发条件回滚触发阈值（错误率 >2x、延迟 >50%）传入告警规则配置
engineering/api-design-reviewer审查者标记的 API 破坏性变更对应 MAJOR 版本升级API 审查结果填入发布计划 JSON 中的 breaking_changes 数组
engineering/infrastructure-as-code回滚操作手册中的部署步骤引用基础设施回滚命令回滚操作手册的 command 字段包含特定于基础设施的命令（kubectl、DNS、负载均衡器）
project-management/release-planning发布计划 JSON 结构与 PM 发布跟踪工件保持一致PM 功能列表和审批状态直接传入 release_planner.py 的输入格式

评论

支持 Markdown