release-management

发布管理

使用 gh release、语义化版本控制和变更日志生成来自动化发布。

CC ≥ 2.1.118 (M122)： claude plugin tag <version> 会在创建标签前验证插件清单层级（marketplace.json、plugin.json、package.json、version.txt）。在 CI 中运行 --dry-run，然后由 release-please 创建发布 PR；及早发现清单不一致。参见 src/skills/chain-patterns/references/plugin-tag.md。

关键：任务管理为必需项 (CC 2.1.16)

在进行任何其他操作之前，先创建任务以跟踪进度：

# 1. Create main task IMMEDIATELY
TaskCreate(
  subject="Release: {version}",
  description="Creating release with semantic versioning and changelog",
  activeForm="Releasing {version}"
)

# 2. Create subtasks for each release phase
TaskCreate(subject="Version & changelog", activeForm="Determining version and generating changelog")
TaskCreate(subject="Create release", activeForm="Creating GitHub release")
TaskCreate(subject="Verify & announce", activeForm="Verifying release and announcing")

# 3. Set dependencies for sequential phases
TaskUpdate(taskId="3", addBlockedBy=["2"])
TaskUpdate(taskId="4", addBlockedBy=["3"])

# 4. Update status as you progress
TaskUpdate(taskId="2", status="in_progress")  # When starting
TaskUpdate(taskId="2", status="completed")    # When done

快速参考

创建发布

# Auto-generate notes from PRs
gh release create v1.2.0 --generate-notes

# With custom title
gh release create v1.2.0 --title "Version 1.2.0: Performance Update" --generate-notes

# Draft release (review before publishing)
gh release create v1.2.0 --draft --generate-notes

# Pre-release (beta, rc)
gh release create v1.2.0-beta.1 --prerelease --generate-notes

# With custom notes
gh release create v1.2.0 --notes "## Highlights
- New auth system
- 50% faster search"

# From notes file
gh release create v1.2.0 --notes-file RELEASE_NOTES.md

列出和查看发布

# List all releases
gh release list

# View specific release
gh release view v1.2.0

# View in browser
gh release view v1.2.0 --web

# JSON output
gh release list --json tagName,publishedAt,isPrerelease

验证发布 (gh CLI 2.86.0+)

# Verify release attestation (sigstore)
gh release verify v1.2.0

# Verify specific asset
gh release verify-asset v1.2.0 ./dist/app.zip

# Verify with custom trust policy
gh release verify v1.2.0 --owner myorg

管理发布

# Edit release
gh release edit v1.2.0 --title "New Title" --notes "Updated notes"

# Delete release
gh release delete v1.2.0

# Upload assets
gh release upload v1.2.0 ./dist/app.zip ./dist/app.tar.gz

---

语义化版本控制

MAJOR.MINOR.PATCH
  │     │     │
  │     │     └── Bug fixes (backwards compatible)
  │     └──────── New features (backwards compatible)
  └────────────── Breaking changes

Examples:
  1.0.0 → 1.0.1  (patch: bug fix)
  1.0.1 → 1.1.0  (minor: new feature)
  1.1.0 → 2.0.0  (major: breaking change)

Pre-release:
  2.0.0-alpha.1  (early testing)
  2.0.0-beta.1   (feature complete)
  2.0.0-rc.1     (release candidate)

---

发布工作流

使用 git 标签和 gh release 执行标准发布和热修复发布流程。

加载 Read("references/release-workflows.md")，查看标准发布和热修复发布的分步工作流。

---

生成变更日志

从 PR 自动生成、使用自定义 .github/release.yml 模板，以及手动编写 CHANGELOG.md 格式的变更日志。

加载 Read("references/changelog-generation.md")，查看变更日志模板示例和 Keep-a-Changelog 格式。

---

发布自动化与检查清单

用于由标签触发发布的 GitHub Actions 工作流、版本升级脚本，以及发布前后检查清单。

加载 Read("references/release-automation.md")，查看 CI 工作流、版本升级脚本和发布检查清单。

---

最佳实践

1. 使用语义化版本控制 - 说明变更影响
2. 先创建草稿发布 - 发布前检查说明
3. 根据 PR 生成说明 - 获得准确、自动生成的历史记录
4. 发布时关闭里程碑 - 跟踪完成情况
5. 仅为 main 创建标签 - 切勿为功能分支创建标签
6. 醒目地说明破坏性变更 - 在发布说明中突出显示

相关技能

• ork:github-operations：里程碑、议题和 CLI 参考
• ork:github-operations：分支管理和 git 操作

参考资料

按需使用 Read("references/<file>") 加载：

文件	内容
semver.md	语义化版本控制规则和决策树
release-workflows.md	标准发布和热修复发布流程
changelog-generation.md	自动生成、模板和手动编写的变更日志格式
release-automation.md	GitHub Actions 工作流、版本升级脚本和检查清单