| name | changelog-manage |
| description | CHANGELOG エントリ追加・バージョン計算。「CHANGELOG」「変更履歴」「changelog add」「version bump」「バージョン」「バージョンアップ」などのキーワードで自動適用。 |
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 |
実行手順
- 現在のバージョンを取得:
git tag --sort=-v:refname | head -1
または CHANGELOG.md から最新バージョンを抽出
- バージョンを解析: MAJOR.MINOR.PATCH に分解
- 指定タイプに応じてインクリメント:
- major: MAJOR+1, MINOR=0, PATCH=0
- minor: MINOR+1, PATCH=0
- patch: PATCH+1
- 結果を表示し、次のステップを案内