# Release

> 管理 Create-Delight Remake 整合包的正式版或测试版发布。用于用户要求发布版本、创建测试版、更新 modpack.toml 版本、打 tag、创建 GitHub Release 或处理发布产物时；先用 release-plan.ps1 解析版本、目标分支和上一版本，再按 Prepare、人工合并、Publish 流程执行。

- Skill: `jasons-impart/release` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add jasons-impart/release`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jasons-impart/release/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: jasons-impart (https://skillmd.com/u/jasons-impart)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/jasons-impart/release

---


# Create-Delight Remake 发布

发布脚本负责 Git 分支、版本写入、标签、CI 等待、说明、公开 Release、公告 PR 和重试；标签 CI 的 `release-assets` job 负责下载同一次运行的 artifact、压缩并上传 Release 资产。agent 只判断发布意图与玩家可读的文案。

## 先生成只读计划

从仓库根目录运行：

```powershell
.\.agents\skills\release\release-plan.ps1
```

传入用户已明确的值覆盖自动推导：

```powershell
.\.agents\skills\release\release-plan.ps1 -Version 'v0.5.0.6-test' -ReleaseType '测试' -AsJson
```

计划会推导版本、目标分支、上一发布版本和首个正式版候选。上一发布版本按发布类型读取 GitHub Release 元数据：测试版使用最近发布的 Release（包含 prerelease），正式版使用 GitHub 的 `latest release` tag；不要根据 tag 是否带 `-test` 推断正式性。用户明确指定版本、分支或发布类型时，以用户指定为准。

## Agent 必须完成的判断

1. 确认是正式版还是测试版；版本带 `-test` 时必须是测试版。
2. 正式版提供 1–3 条公告，逗号分隔、每条不超过 20 个中文字符。多个提交时不要采用脚本的“最近一条提交”兜底文案。
3. 若计划显示可能是子版本首个正式版，在 Prepare 前撰写 `docs/update-summary-{Version}.md`：中文、按主题分组、含 PR 号、一句范围摘要，并以“升级须知”结束。Publish 会以 GitHub Release 状态再次确认，缺少精确文件时会停止。

## 执行流程

### 1. Prepare

```powershell
.\.agents\skills\release\release-prepare.ps1 `
    -Version '<Version>' `
    -TargetBranch '<TargetBranch>' `
    -ReleaseType '<正式|测试>' `
    -Announcement '<正式版公告，可省略>' `
    -WhatIf
```

确认 dry run 后移除 `-WhatIf`。脚本会创建版本 PR；它会在稳定版时仅暂存与当前版本匹配的更新摘要文件。

### 2. 人工合并与静默监控

版本 PR 必须仍由用户手动合并；不得自动合并或启用 auto-merge。`release-prepare.ps1` 成功创建 PR 后，立即通过 `automation_update` 在当前对话创建一个 heartbeat 监控，而不是等待用户回来说明已合并。

监控提示必须包含版本、目标分支、发布类型和版本 PR URL，并要求每次运行：

- 用 `gh` 检查该 PR 状态；未合并且仍开启时保持静默，不发送状态消息。
- PR 合并后，确认目标分支已包含合并提交；在当前对话继续下面的 Publish 流程，先 `-WhatIf`，再正式执行，并等待 CI 和 Release 资产核验。
- PR 被关闭但未合并、发布失败或需要用户决定时，说明原因并停止或暂停监控。
- 发布成功后报告 Release 链接和资产，并停止或删除监控，避免重复发布。

heartbeat 使用适合主动跟进的短间隔。除合并、完成、失败或需要用户操作外，不产生消息或通知。

### 3. Publish

由 heartbeat 检测到 PR 合并后，先预览再正式执行：

```powershell
.\.agents\skills\release\release-publish.ps1 `
    -Version '<Version>' `
    -TargetBranch '<TargetBranch>' `
    -ReleaseType '<正式|测试>' `
    -WhatIf
```

`PreviousVersion` 默认按上述 GitHub Release 规则自动推导；只有推导错误时才传入覆盖值。确认 dry run 后移除 `-WhatIf`。脚本会发布 4 个正式版产物或 2 个测试版产物，并在正式版时创建公告更新 PR；只报告该 PR，不要合并它。

## 不可违反的约束

- 不编辑生成的 `pack.toml` 或 `index.toml`。
- 不直接发布或复制 CDC JAR；CDC 源码与 Packwiz 资产分别遵循 `CDC-mod-src/AGENTS.md` 和 `/packwiz-assets`。
- 脚本可恢复中断的草稿 Release；已公开的同名 Release 不可重建。
- 运行脚本前需要 PowerShell 7、Git、GitHub CLI 登录和干净或可安全暂存的工作树。

## 按需参考

- Windows 下的代理、`gh` 认证和大文件传输细节：读 [release-windows-github.md](references/release-windows-github.md)。
- 仅当用户明确要求“标签与 `modpack.toml` 版本不同”的历史过渡发布时：读 [transitional-test-tags.md](references/transitional-test-tags.md)。
- 参数和脚本内部步骤以当前实现为准：运行 `Get-Help .\.agents\skills\release\release-prepare.ps1 -Full` 或 `Get-Help .\.agents\skills\release\release-publish.ps1 -Full`。