Bump Release

通常リリースとベータリリースの両方に対応しています。

パラメータ

• version: 使用するバージョンを明示的に指定します (例: 2.0.0)。指定されている場合、自動バージョン推論がスキップされます
• --beta: -beta.X サフィックス付きでベータリリースを作成します
• --dry-run: リリースをプレビューします。実際の変更 (ファイル修正、コミット、タグ) は行いません

ステップ

0. パッケージを探す - ユーザーがモノレポにいる場合、リリース対象のパッケージはサブディレクトリに存在する可能性があります。現在の作業ディレクトリで最初に package.json を探します。見つからない場合は、どのパッケージをリリースするかユーザーに質問します。すべてのファイルパス (CHANGELOG.md, package.json, justfile) はパッケージディレクトリを基準とします。
1. CHANGELOG.md ファイルを最後のバージョンリリース以降のすべての変更で更新します (ベータリリースの場合このステップをスキップします)。
2. package.json のバージョンをバンプします:
   • 通常リリース: セマンティック バージョニングに従います (例: 1.2.3)
   • ベータリリース: -beta.X サフィックスを追加します (例: 1.2.3-beta.1)
3. ファイルをフォーマット - リポジトリに justfile が存在する場合は just full-write を実行して、CHANGELOG.md と package.json が適切にフォーマットされていることを確認します
4. "docs: release <version>" というメッセージでコミットします
5. git tag -a v<version> -m "<version>" を実行して新しい git タグを作成します

注: --dry-run フラグが指定されている場合は、実際のファイル変更、コミット、タグ作成を行わずに、何が実行されるかを表示します。

プロセス

1. 引数をチェック - version が指定されているか、ベータリリース (--beta) か、ドライラン (--dry-run) かを判定します

2. クリーンな作業ツリーをチェック - git status --porcelain を実行して、このリリースに関係のないコミットされていない変更がないことを確認します。存在する場合は、commit スキルを実行してから続行します

3. Changelog を記入 - 現在のブランチと前のタグ間の差分を調べて Changelog を記入します。次に、コミット履歴を確認して関連する PR を検索し、各 changelog に追加します (利用可能な場合)。package.json に files フィールドが含まれている場合は、指定されたファイル/ディレクトリ内の変更のみを含めます。files フィールドが存在しない場合は、テスト変更、CI/CD ワークフロー、開発ツーリングを除くすべての変更を含めます

4. 形式に従う - references/common-changelog.md で Common Changelog 仕様を参照します

5. バージョンをチェック - package.json から現在のバージョンを取得します

6. バージョンをバンプ - version 引数が指定されている場合は直接使用します。それ以外の場合、最後のリリース以降に変更がなければ、セマンティック バージョニング ルールに従ってバンプします:

   • 通常リリースの場合:

     • PATCH (x.x.X) - バグ修正、ドキュメント更新
     • MINOR (x.X.x) - 新機能、後方互換性のある変更
     • MAJOR (X.x.x) - 破壊的変更

   • ベータリリースの場合 (--beta フラグ):

     • 現在のバージョンにベータサフィックスがない場合: バージョンに -beta.1 を追加します
     • 現在のバージョンにすでにベータサフィックスがある場合: ベータ番号をインクリメントします (例: -beta.1 → -beta.2)
     • ベータからリリースに移行する場合: ベータサフィックスを削除し、ベースバージョンを使用します

   • 不確実な場合 — 変更が曖昧な場合 (例: 利用者に影響を与える可能性のある新機能、または修正と機能の混在)、AskUserQuestion を使用してユーザーに semver レベルを決定させます:

     • header: "Version"
     • question: "Changes include both <summary>. Which release level?"
     • options: 妥当な semver レベルを、その結果のバージョンと共にリストアップします (例: "1.3.0 (minor)", "2.0.0 (major)")
     • multiSelect: false

     ユーザーの選択を使用してステップ 7 をスキップします

7. バージョンを確認 - バージョンが確実に推論された場合 (明示的な version 引数がない)、AskUserQuestion を使用して進行前に確認します:

   • header: "Version"
   • question: "Release <current> → <inferred>?"
   • options:
     • 推論されたバージョン ラベル (例: "1.3.0 (minor)") — "(Recommended)" としてマークします
     • semver レベルが 1 つ高い代替案 (例: "2.0.0 (major)")
     • 可能な場合は semver レベルが 1 つ低い代替案 (例: "1.2.4 (patch)")
   • multiSelect: false

   ユーザーが代替案を選択した場合は、残りのステップでそのバージョンを使用します。--dry-run がアクティブな場合はこのステップをスキップします (プレビューで推論されたバージョンを代わりに表示します)

ベータリリース ロジック

$ARGUMENTS で --beta フラグが指定されている場合

1. 明示的なバージョンをチェック - version が指定されている場合:
   • バージョンにすでにベータサフィックスがある場合 → そのまま使用します
   • バージョンにベータサフィックスがない場合 → -beta.1 を追加します
2. それ以外の場合は、package.json から現在のバージョンを解析し、ベータバージョンを決定します:
   • 現在のバージョンが 1.2.3 の場合: 1.2.4-beta.1 を作成します (patch をインクリメント + beta.1)
   • 現在のバージョンが 1.2.3-beta.1 の場合: 1.2.3-beta.2 を作成します (ベータ番号をインクリメント)
   • 現在のバージョンが 1.2.3-beta.5 の場合: 1.2.3-beta.6 を作成します (ベータ番号をインクリメント)
3. CHANGELOG.md 更新をスキップ - ベータリリースは changelog を更新しません
4. ベータバージョンでコミットおよびタグ付け します (例: v1.2.4-beta.1)

出力

通常リリースのみの場合、references/common-changelog.md の形式と作成ガイドラインに従って CHANGELOG.md に changelog エントリを生成します。Changed, Added, Removed, Fixed カテゴリを使用します (この順序で)。すべてのエントリは命令法の現在形の動詞で始まる必要があります。

包含基準

通常リリースのみ (ベータリリースの場合は changelog 生成がスキップされます):

• Files フィールド制約 - package.json に files フィールドが含まれている場合は、そのフィールドで指定されたファイル/ディレクトリへの変更のみを含めます。その他すべてのコードベース変更は CHANGELOG から除外します
• 本番環境の変更のみ - files フィールドが存在しない場合は、テスト変更、CI/CD ワークフロー、開発ツーリングを除外します
• Pull Request を参照 - コンテキストのために利用可能な場合は PR にリンクします
• ネット変更のみ - 現在のブランチと前のタグ間の差分を調べて、変更を特定します
• dependencies と peerDependencies の変更のみ - devDependencies への変更を除外します

例

通常リリース

# 通常の patch/minor/major リリースを作成します
/bump-release

# 通常リリースの内容をプレビューします
/bump-release --dry-run

ベータリリース

# -beta.X サフィックス付きでベータリリースを作成します
/bump-release --beta

# ベータリリースの内容をプレビューします
/bump-release --beta --dry-run

明示的なバージョン

# 正確なバージョンを指定します
/bump-release 2.0.0

# 正確なベータバージョンを指定します
/bump-release 2.0.0-beta.1

# フラグと組み合わせます
/bump-release 2.0.0 --dry-run

バージョン例

現在のバージョン	リリースタイプ	新規バージョン
1.2.3	通常	1.2.4 (patch)
1.2.3	ベータ	1.2.4-beta.1
1.2.3-beta.1	ベータ	1.2.3-beta.2
1.2.3-beta.5	通常	1.2.3
1.2.3	2.0.0	2.0.0
1.2.3	2.0.0 + ベータ	2.0.0-beta.1

リソース

• references/common-changelog.md — changelog エントリを生成する場合に読みます: Common Changelog 形式と作成ガイドライン