| name | prepare-release |
| description | リリース準備を実行。CHANGELOG.md 更新、バージョン更新（package.json / Cargo.toml / tauri.conf.json）を行う。ユーザーが「リリース準備」「リリースする」「prepare release」「バージョン上げて」「CHANGELOG 更新」と言ったとき、または新バージョンのリリース準備が必要な場面で使用する。 |
| version | 1.0.0 |
| user-invocable | true |
| argument-hint | <version> |
| allowed-tools | Read, Edit, Glob, Grep, Bash |
Prepare Release - リリース準備スキル
CHANGELOG.md を更新し、プロジェクト全体のバージョンを一括更新するリリース準備スキル。
ハイブリッド方式: [Unreleased] セクションに既存内容があればそれを活用し、git 変更履歴から不足分を補完する。
Input
$ARGUMENTS
バージョン番号を引数として受け取る（v プレフィックスなし）。
Input Examples
/prepare-release 0.2.0
/prepare-release 1.0.0-beta
Validation
- 引数が空の場合はエラー終了し、使用例を表示する
- セマンティックバージョニング形式（
X.Y.Z または X.Y.Z-prerelease）であることを確認する
Target Files
CHANGELOG File
Version Manifest Files
バージョンは以下の 3 ファイルに分散しており、すべて同一バージョンに更新する。
| ファイル | フィールド |
|---|
package.json | "version" |
src-tauri/Cargo.toml | version |
src-tauri/tauri.conf.json | "version" |
Processing Flow
Step 1: Validate Version Argument
$ARGUMENTS からバージョン番号をパースする- セマンティックバージョニング形式を検証する
- 不正な場合はエラーメッセージと使用例を表示して終了する
Step 2: Detect Previous Release
git tag --list 'v*' --sort=-version:refname で最新のリリースタグを取得する- タグが存在しない場合は初回リリースとして扱う（全コミットを対象にする）
- 比較基点を記録する（例:
v0.1.0）
Step 3: Read Current [Unreleased] Content
CHANGELOG.md を Read で読み込み、## [Unreleased] セクションの内容を抽出する。
- 内容あり: 既存エントリをベースとして保持する
- 内容なし: Step 4 で全エントリを生成する
Step 4: Analyze Git Changes
前回タグから HEAD までの変更を分析する。
git log <previous-tag>..HEAD --oneline --no-merges
git diff <previous-tag>..HEAD --stat
変更内容を以下のカテゴリに分類する:
| Category | 判定基準 |
|---|
| Breaking Changes | 互換性を破る変更、設定ファイル形式変更 |
| Added | 新機能、新 UI コンポーネント |
| Changed | 既存機能の改善・変更 |
| Fixed | バグ修正、不具合対応 |
| Removed | 機能や UI の削除 |
Step 5: Generate / Supplement CHANGELOG Entries
重要: CHANGELOG はアプリケーション利用者向けである。
以下の変更は CHANGELOG に 含めない:
- CI/CD ワークフロー（
.github/workflows/）の追加・変更
- 開発者向けスクリプトの追加・変更
- テストコード・テストフィクスチャ（
__tests__/, *.test.ts）の追加・変更
.claude/ 配下の開発者向け設定・スキル.sdd/ 配下の設計ドキュメント.gitignore、PR テンプレート等のリポジトリ管理ファイル- 純粋な内部リファクタリング（ユーザーに見える変化がないもの）
- ドキュメント（README.md 等）の変更
以下の変更は CHANGELOG に 含める:
src/ 配下のフロントエンドコード変更（UI、機能追加・変更）src-tauri/src/ 配下のバックエンドコード変更（新コマンド、機能改善）- ユーザーが体感するバグ修正・機能追加・パフォーマンス改善
- 対応プラットフォームの追加・変更
ハイブリッドロジック:
[Unreleased] に既存内容がある場合:
- 既存エントリをベースとする
- git 変更履歴と照合し、カバーされていないユーザー向け変更を特定する
- 不足分のエントリのみ追加生成する
[Unreleased] が空の場合:
- git 変更履歴からユーザー向け変更のエントリを生成する
- ユーザー向け変更が存在しない場合:
- ユーザーに「利用者向けの変更がありません」と報告し、CHANGELOG 更新をスキップするか確認する
記述スタイル:
- 各エントリは
- 変更内容の要約 形式
- カテゴリは
### ヘッダーで分類（Added, Changed, Fixed, Removed, Breaking Changes）
- 既存の CHANGELOG.md のスタイルに合わせる
Step 6: Update CHANGELOG File
CHANGELOG.md に対して以下を実行する:
## [Unreleased] セクションの既存内容をクリアする## [Unreleased] の直後に空行を挟んで新バージョンセクションを挿入する:
## [VERSION] - YYYY-MM-DD
- 日付は実行日（
date +%Y-%m-%d で取得）を使用する
- Step 5 で生成/統合したエントリを配置する
- ファイル末尾のバージョン比較リンクを更新する:
[Unreleased] リンクの比較先を新バージョンタグに変更- 新バージョンのリリースリンクを追加
リンク更新例:
[Unreleased]: https://github.com/ToshikiImagawa/Buruma/compare/v0.2.0...HEAD
[0.2.0]: https://github.com/ToshikiImagawa/Buruma/compare/v0.1.0...v0.2.0
[0.1.0]: https://github.com/ToshikiImagawa/Buruma/releases/tag/v0.1.0
Step 7: Update Version Manifest Files
3 ファイルのバージョンを一括更新する。
- package.json:
"version": "OLD" → "version": "NEW" に置換
- src-tauri/Cargo.toml:
version = "OLD" → version = "NEW" に置換
- src-tauri/tauri.conf.json:
"version": "OLD" → "version": "NEW" に置換
各ファイルの現在のバージョンを Read で確認してから Edit で更新する。3 ファイルすべてが同一バージョンに揃っていることを確認する。
Step 8: Summary
更新結果のサマリーを templates/output.md に従って表示する。
Output Format
templates/output.md のテンプレートに従って出力する。プレースホルダーを実際の値に置換すること。
Notes
- このスキルは CHANGELOG の生成・編集とバージョン更新を行う。コミットや PR 作成は行わない
- 生成されたエントリは必ずユーザーにレビューを促す
- プレリリースバージョン（
-alpha, -beta, -rc.1 等）もサポートする
