| name | release-workflow |
| description | リリースワークフロー全体のガイド。CHANGELOG 形式、セマンティックバージョニング、Git フローのベストプラクティス。「release」「リリース」「version」「バージョン」「CHANGELOG」「tag」「GitHub Release」などのキーワードで自動適用。 |
| disable-model-invocation | true |
| context | fork |
リリースワークフローガイド(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 が自動作成します。 手動で作成しないこと。
ワークフロー
- リリースブランチ作成: main から
release/vX.Y.Z
- 開発: フィーチャーをリリースブランチにマージ
- CHANGELOG 更新: 「未リリース」セクションにエントリ追加
- リリース準備: release-prepare スキルを使用
- CHANGELOG 更新(未リリース → [X.Y.Z])
- コミット
- リモートに自動プッシュ
- PR 自動作成: GitHub Actions が PR を作成
- PR マージ: 自動リリースがトリガー
PR マージ後(自動)
- タグ作成(vX.Y.Z)
- CHANGELOG 付き GitHub Release
- 次のリリースブランチ作成
- 次のリリース用ドラフト PR
トラブルシューティング
CHANGELOG バリデーションエラー
エラー: CHANGELOG.md does not contain version [X.Y.Z] section
対処:
- 形式を確認:
## [X.Y.Z] - YYYY-MM-DD
- バージョンがブランチ名と一致することを確認
- 再コミット・再プッシュ
タグが既に存在する
git push origin :refs/tags/vX.Y.Z
git tag -d vX.Y.Z