リリースワークフローガイド（v2.0）

リリースプロセス全体を統合管理するオーケストレーター。

重要: 明示的な呼び出しのみ

リリース操作はユーザーの明示的な指示で実行すること。プロアクティブに実行しない。

スキル

スキル	用途	使いどころ
release-prepare	リリース準備	「リリース準備」「release prepare」
changelog-manage	CHANGELOG + バージョン管理	「CHANGELOG 追加」「バージョン計算」

参照ドキュメント

プラグインルートの詳細実装例:

• ../../references/RELEASE_PROCESS.md — リリースプロセス完全ガイド
• ../../references/auto-release-on-merge.yml — GitHub Actions ワークフロー

セマンティックバージョニング

形式: MAJOR.MINOR.PATCH（Semantic Versioning 2.0.0）

変更種別	バージョン	例	説明
バグ修正のみ	PATCH	1.0.0 → 1.0.1	後方互換のバグ修正
新機能追加	MINOR	1.0.1 → 1.1.0	後方互換の機能追加
破壊的変更	MAJOR	1.1.0 → 2.0.0	互換性のない変更

プレリリース: 1.0.0-alpha.1, 1.0.0-beta.1, 1.0.0-rc.1

CHANGELOG 形式

Keep a Changelog 準拠:

# Changelog

## [未リリース]

### 追加
- 新機能の説明

## [1.0.0] - 2025-01-15

### 追加
- 初回リリース

[未リリース]: https://github.com/owner/repo/compare/v1.0.0...HEAD
[1.0.0]: https://github.com/owner/repo/releases/tag/v1.0.0

カテゴリ

カテゴリ	英語	説明
追加	Added	新機能
変更	Changed	既存機能の変更
非推奨	Deprecated	将来削除予定の機能
削除	Removed	削除された機能
修正	Fixed	バグ修正
セキュリティ	Security	セキュリティ修正

リリースブランチ戦略

main (production)
  ├── release/v1.0.0 (リリース準備)
  ├── release/v1.1.0 (次のリリース)
  └── feature/* (開発)

リリースフロー

重要: PR の自動作成

リリース PR は GitHub Actions が自動作成します。 手動で作成しないこと。

ワークフロー

1. リリースブランチ作成: main から release/vX.Y.Z
2. 開発: フィーチャーをリリースブランチにマージ
3. CHANGELOG 更新: 「未リリース」セクションにエントリ追加
4. リリース準備: release-prepare スキルを使用
   • CHANGELOG 更新（未リリース → [X.Y.Z]）
   • コミット
   • リモートに自動プッシュ
5. PR 自動作成: GitHub Actions が PR を作成
6. PR マージ: 自動リリースがトリガー

PR マージ後（自動）

1. タグ作成（vX.Y.Z）
2. CHANGELOG 付き GitHub Release
3. 次のリリースブランチ作成
4. 次のリリース用ドラフト PR

トラブルシューティング

CHANGELOG バリデーションエラー

エラー: CHANGELOG.md does not contain version [X.Y.Z] section

対処:

1. 形式を確認: ## [X.Y.Z] - YYYY-MM-DD
2. バージョンがブランチ名と一致することを確認
3. 再コミット・再プッシュ

タグが既に存在する

# リモートタグを削除
git push origin :refs/tags/vX.Y.Z
# ローカルタグを削除
git tag -d vX.Y.Z
# GitHub Release を削除（Web から）