
release-flow
リリースワークフロー自動化 - CHANGELOG管理、セマンティックバージョニング、GitHub Release自動化
- version
- 2.0.0
- GitHub stars
- 5
Install
/plugin install release-flow@no-problem-pluginsRun it inside Claude Code after adding the marketplace with /plugin marketplace add no-problem-dev/claude-code-plugins.
Contents
Discovered from sourceSkills 3
CHANGELOG・バージョン管理
CHANGELOG エントリの追加とセマンティックバージョニングに基づくバージョン計算。
CHANGELOG エントリ追加
CHANGELOG の「未リリース」セクションに変更エントリを追加する。
カテゴリ一覧
| カテゴリ | 英語 | 説明 |
|---|---|---|
| 追加 | Added | 新機能 |
| 変更 | Changed | 既存機能の変更 |
| 非推奨 | Deprecated | 将来削除予定の機能 |
| 削除 | Removed | 削除された機能 |
| 修正 | Fixed | バグ修正 |
| セキュリティ | Security | セキュリティ関連 |
実行手順
- カテゴリと説明を解析
- CHANGELOG.md を読み込み
- 「未リリース」セクションを検出
- 該当カテゴリのサブセクションを検出/作成
- エントリを追加
- ファイルを保存
ベストプラクティス
説明には以下を含めることを推奨:
- プラットフォーム/コンポーネント:
**Backend**:,**iOS**:,**API**: - 具体的な内容: 何が変わったか
- ユーザー価値: なぜ重要か(必要に応じて)
エントリの良い例
### 追加
- **API**: POST /api/v1/users エンドポイントを追加
- **iOS**: ダークモード対応(設定画面にトグルを追加)
### 修正
- **Backend**: トークン期限切れ時に適切なエラーメッセージを返すように修正
バージョン計算
現在のバージョンから次のバージョンを計算する。
バンプタイプ
| 変更内容 | タイプ | 例 |
|---|---|---|
| バグ修正のみ | patch | 1.2.3 → 1.2.4 |
| 新機能追加(後方互換) | minor | 1.2.3 → 1.3.0 |
| 破壊的変更 | major | 1.2.3 → 2.0.0 |
実行手順
- 現在のバージョンを取得:
または CHANGELOG.md から最新バージョンを抽出git tag --sort=-v:refname | head -1 - バージョンを解析: MAJOR.MINOR.PATCH に分解
- 指定タイプに応じてインクリメント:
- major: MAJOR+1, MINOR=0, PATCH=0
- minor: MINOR+1, PATCH=0
- patch: PATCH+1
- 結果を表示し、次のステップを案内
リリース準備
指定バージョンのリリースを準備する。
重要: 明示的な呼び出しのみ
リリース操作は必ずユーザーの明示的な指示で実行すること。プロアクティブに実行しない。
ワークフロー
1. プリフライトチェック(必須)
# 最新のリモート状態を取得
git fetch origin
# 現在のブランチを確認
git branch --show-current
# release/v<version> ブランチにいるか確認
# いなければ、ユーザーに作成/切り替えを確認
# ローカルがリモートと同期しているか確認
git status -uno
ローカルが遅れている場合:
git pull origin <branch>
未コミットの変更がある場合:
- ユーザーに警告し、対処方法を確認
2. バージョンバリデーション
- バージョン形式を検証(X.Y.Z)
- ブランチ名とバージョンの一致を確認:
release/v<version>
3. CHANGELOG 更新
- CHANGELOG.md を読み込み
## [未リリース]セクションを検出## [<version>] - YYYY-MM-DDに変換- 新しい
## [未リリース]セクションをトップに追加 - 比較リンクを更新
4. コミット
git add CHANGELOG.md
git commit -m "chore: prepare for v<version> release"
5. プッシュ(自動)
git push origin release/v<version>
6. 結果報告
重要な注意事項
- バージョンはセマンティックバージョニング(X.Y.Z)に従うこと
- 「未リリース」セクションが空の場合、ユーザーに警告
- バージョンセクションが既に存在する場合、エラーを表示
- PR を手動で作成しないこと — GitHub Actions が自動作成
出力例
リリース準備完了
- バージョン: v1.2.0
- ブランチ: release/v1.2.0
- CHANGELOG: 更新済み
- プッシュ: 完了
次のステップ:
- リリース PR は GitHub Actions で自動作成されます
- 確認・マージ: gh pr view
注意: PR は手動で作成しないでください。既存の PR を確認:
gh pr list --head release/v1.2.0
リリースワークフローガイド(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
# GitHub Release を削除(Web から)
Sponsors
Details
- Marketplace
- no-problem-dev/claude-code-plugins
- Source
- plugins/release-flow
- Category
- Workflow