关于 create-release
create-release 是用于准备软件发布,并在获得授权后通过单一路径发布的技能。它协调版本与变更日志更新、验证、发布拉取请求,并核实选定发布流程的结果。
主要功能
- 01区分准备与正式发布
- 02更新变更日志和版本声明
- 03运行发布相关验证门禁
- 04创建草稿发布拉取请求
- 05选择单一文档化发布路径
- 06核实发布与构件结果
适用场景
- 01准备带版本信息的发布拉取请求
- 02发布已合并的发布拉取请求
- 03确认工作流中的标签和发布归属
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ frostney/ known-good-route --skill create-release安装后在 Claude Code 中输入/create-release确认已加载。
详细介绍
创建发布
准备一个标签中包含其变更日志的发布,然后仅在获得发布授权后,通过一条有证据支持的路径进行发布。
授权
- 准备:确定版本,更新变更日志和版本声明,进行验证,并打开发布 PR。仅请求准备、提升版本或生成说明,只授权此阶段。
- 发布:PR 合并后,通过仓库既定的发布程序创建或触发标签/发布。请求截取版本、打标签、发布或运行
/create-release,也授权此阶段。 /milestone-rush调用方在其经过验证的里程碑边界提供发布授权。沿用已确定的发布计划和版本;无需单独的用户命令。/deliver集成交付不属于此触发条件。- 如果单独的发布授权不明确,仅执行准备阶段。
不变量
- 变更日志和版本提升必须先于标签,通过 squash 合并的 PR 落地。
- 使用仓库配置的工具和当前文档。重新生成生成式变更日志,不要手动编辑。
- 运行声明的发布相关检查,并且只报告观察到的结果。
- 绝不 amend、强制推送、强制更新标签、跳过钩子或通过多条路径发布。
准备
- 要求工作树干净,然后确定授权阶段、远程默认分支、变更日志/版本工具、上次发布、远程标签、工作流和发布文档。
- 如果没有可发布的提交,则停止。
- 使用已确定的显式版本,或根据项目的确定性版本策略计算版本。如果两者都无法确定,则根据未发布的约定式提交推荐一个版本,并询问用户选择。
- 从最新的远程基线创建发布分支。
- 使用项目工具生成变更日志部分,并更新每项权威版本声明。如果项目从标签派生版本,则不要臆造清单版本提升。
- 运行发布相关检查,提交
chore(release): <version>,并通过/create-pr打开一个草稿发布 PR,其中包含变更日志部分和观察到的验证结果。仅准备的请求到此结束。
发布
- 获得发布授权后,通过
/address-feedback automatic-merge推进发布 PR,然后使用delivery-wait验证其 squash 合并和集成修订。复用已验证的合并;绝不为打开的 PR 分支打标签。 - 刷新已合并的基线,然后重新读取实际的工作流 YAML 和发布文档。明确区分标签创建、GitHub 发布创建、制品签名和注册表发布的负责人。
- 仅选择一条路径,避免重复创建标签或发布:
- 工作流负责标签和发布:仅触发或监控工作流;
- Agent 负责标签、工作流负责发布:推送已验证的标签一次,然后监控;
- 工作流负责标签、Agent 负责发布:验证其标签,然后创建一个 GitHub 发布;
- Agent 负责两者:仅在没有工作流负责任一操作时,推送已验证的标签一次并创建一个发布。
- 如果负责人不明确,或文档与工作流不一致,则停止。
- 仅执行选定的路径,并验证该路径负责的最终标签目标、发布、工作流结果、制品和注册表状态。对于这些 GitHub 状态转换,使用辅助程序的
wait workflow-terminal、wait tag-target和wait release-assets操作;不要在多个模型轮次中监控未变化的状态。
开头先说明发布结果、PR/发布 URL、选定的发布方和当前证据。绝不要将未经观察的状态描述为已完成。
评论
支持 Markdown