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 の形式について説明します。

変更履歴のテンプレート例と Keep-a-Changelog 形式を確認するには、Read("references/changelog-generation.md") を読み込みます。

---

リリースの自動化とチェックリスト

タグをトリガーとする GitHub Actions ワークフロー、バージョン更新スクリプト、リリース前後のチェックリストについて説明します。

CI ワークフロー、更新スクリプト、リリースチェックリストを確認するには、Read("references/release-automation.md") を読み込みます。

---

ベストプラクティス

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 ワークフロー、更新スクリプト、チェックリスト