リリースワークフロー自動化 - CHANGELOG管理、セマンティックバージョニング、GitHub Release自動化

version
2.0.0
GitHub stars
5

Install

/plugin install release-flow@no-problem-plugins

Run it inside Claude Code after adding the marketplace with /plugin marketplace add no-problem-dev/claude-code-plugins.

Contents

Discovered from source

Skills 3

CHANGELOG・バージョン管理

CHANGELOG エントリの追加とセマンティックバージョニングに基づくバージョン計算。

CHANGELOG エントリ追加

CHANGELOG の「未リリース」セクションに変更エントリを追加する。

カテゴリ一覧

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

実行手順

  1. カテゴリと説明を解析
  2. CHANGELOG.md を読み込み
  3. 「未リリース」セクションを検出
  4. 該当カテゴリのサブセクションを検出/作成
  5. エントリを追加
  6. ファイルを保存

ベストプラクティス

説明には以下を含めることを推奨:

  • プラットフォーム/コンポーネント: **Backend**:, **iOS**:, **API**:
  • 具体的な内容: 何が変わったか
  • ユーザー価値: なぜ重要か(必要に応じて)

エントリの良い例

### 追加
- **API**: POST /api/v1/users エンドポイントを追加
- **iOS**: ダークモード対応(設定画面にトグルを追加)

### 修正
- **Backend**: トークン期限切れ時に適切なエラーメッセージを返すように修正

バージョン計算

現在のバージョンから次のバージョンを計算する。

バンプタイプ

変更内容タイプ例
バグ修正のみpatch1.2.3 → 1.2.4
新機能追加(後方互換)minor1.2.3 → 1.3.0
破壊的変更major1.2.3 → 2.0.0

実行手順

  1. 現在のバージョンを取得:
    git tag --sort=-v:refname | head -1
    
    または CHANGELOG.md から最新バージョンを抽出
  2. バージョンを解析: MAJOR.MINOR.PATCH に分解
  3. 指定タイプに応じてインクリメント:
    • major: MAJOR+1, MINOR=0, PATCH=0
    • minor: MINOR+1, PATCH=0
    • patch: PATCH+1
  4. 結果を表示し、次のステップを案内

リリース準備

指定バージョンのリリースを準備する。

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

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

ワークフロー

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-manageCHANGELOG + バージョン管理「CHANGELOG 追加」「バージョン計算」

参照ドキュメント

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

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

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

形式: MAJOR.MINOR.PATCH(Semantic Versioning 2.0.0)

変更種別バージョン例説明
バグ修正のみPATCH1.0.0 → 1.0.1後方互換のバグ修正
新機能追加MINOR1.0.1 → 1.1.0後方互換の機能追加
破壊的変更MAJOR1.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 から)

Sponsors

Details

Marketplace
no-problem-dev/claude-code-plugins
Source
plugins/release-flow
Category
Workflow

More from no-problem-dev/claude-code-plugins

All 9