mcpField
R
release

release

github.com/eljun开发077 次安装2 周前更新
代码仓库

关于 release

用于仓库工作流的发布阶段 skill，将已合并且验证完成的任务整理为版本发布。它强调记录部署后检查、编写面向用户的更新日志，并复核任务跟踪状态。

主要功能

  1. 01按影响或指定输入选择版本
  2. 02要求记录部署后检查或豁免
  3. 03生成或更新更新日志
  4. 04适时创建标签和发布说明
  5. 05更新已发布任务并复核跟踪状态

适用场景

  1. 01准备已合并任务的版本发布
  2. 02暂缓实时检查尚未完成的任务
  3. 03在更新日志中记录已发布变更

安装

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

$npx skills add https://github.com/eljun/claude-workflow-skills --skill release

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

详细介绍

release - 版本发布阶段

不变原则

  • 仅发布已合并的 Ready To Ship 任务。
  • 闭环： 只有在生产系统上运行了任务的部署后检查（列于 PR / 测试报告中），并将结果记录在测试报告中，或用户明确豁免该任务的检查后，任务才能移至 Shipped。已合并不代表已正常运行。
  • 更新日志条目应以用户为中心。
  • 不要包含尚未合并的拉取请求。
  • 未经用户明确批准，不要重写现有标签。
  • 将已发布的条目移至 Shipped 后，重新读取 TASKS.md，确认每一行都已从 Ready To Ship 移出。过时的跟踪记录会阻塞后续会话和无头会话。

运行时适配器可以将此阶段提供为斜杠命令、菜单操作或自然语言技能调用。可移植的阶段名称为 release。

调用方式

支持的版本输入：

  • auto 或不提供参数：根据任务的 Version Impact 推导
  • patch
  • minor
  • major
  • 显式版本，例如 v1.2.3

工作流

  1. 读取 AGENTS.md。
  2. 读取 TASKS.md，查找 Ready To Ship 中已合并的条目。
  3. 阅读每个任务文档，了解其类型、版本影响和摘要。
  4. 对每个任务，确认已运行并记录其部署后检查（或已由用户豁免）。检查仍待处理的任务应保留在 Ready To Ship，并在交接内容中列出待处理的检查。
  5. 确定下一个版本。
  6. 生成或更新 docs/changelogs/CHANGELOG.md。
  7. 如果仓库工作流要求提交发布提交，则提交更新日志更改。
  8. 适当时创建 git 标签。
  9. 适当时使用可用的仓库托管工具创建发布说明。
  10. 在 TASKS.md 中将已发布条目移至 Shipped，并从 Ready To Ship 中移除每一行。
  11. 重新读取 TASKS.md，确认已发布任务的行位于 Shipped 且不在 Ready To Ship 中。如果任何一行未位于预期分区，说明移动遗漏了——在交接前立即完成编辑。

版本计算

信号版本影响
破坏性变更或要求用户迁移major
新功能minor
Bug 修复、文档、杂项、小幅增强patch

同时发布多个任务时，采用影响最高的级别。

更新日志模板

## [v{version}] - {Date}

### New Features
- {User-facing feature}

### Fixes
- {Bug fix}

### Improvements
- {Enhancement}

### Documentation
- {Documentation update}

### Breaking Changes
- {Required migration, if any}

交接

Release prepared: v{version}
Tasks shipped: {IDs}
Held (post-deploy checks pending): {IDs or "None"}
Changelog: docs/changelogs/CHANGELOG.md

评论

支持 Markdown