| name | prepare-release |
| description | Prepare a release by updating CHANGELOG and version manifests. Analyzes git history, supplements existing [Unreleased] entries, and generates release notes. |
| version | 1.0.0 |
| license | MIT |
| user-invocable | true |
| argument-hint | <version> |
| allowed-tools | Read, Edit, Glob, Grep, Bash |
Prepare Release - リリース準備スキル
CHANGELOG を更新し、バージョンマニフェストファイル（pyproject.toml, init.py）を一括更新するリリース準備スキル。
ハイブリッド方式: [Unreleased] セクションに既存内容があればそれを活用し、git 変更履歴から不足分を補完する。
Input
$ARGUMENTS
バージョン番号を引数として受け取る（v プレフィックスなし）。
Input Examples
/prepare-release 0.2.0
/prepare-release 1.0.0-alpha
Validation
- 引数が空の場合はエラー終了し、使用例を表示する
- セマンティックバージョニング形式（
X.Y.Z または X.Y.Z-prerelease）であることを確認する
Target Files
CHANGELOG File
| ファイル | 言語 |
|---|
CHANGELOG.md | English |
Version Manifest Files
| ファイル | フィールド |
|---|
pyproject.toml | version |
src/sdd_cli/__init__.py | __version__ |
tests/test_init.py | assert __version__ == "VERSION" |
tests/test_cli.py | assert "VERSION" in result.output |
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 ファイルを 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 | 互換性を破る変更、CLI API 変更 |
| Added | 新機能、新コマンド、新オプション |
| Changed | 既存機能の変更、リファクタリング |
| Fixed | バグ修正、不具合対応 |
| Removed | 機能やオプションの削除 |
Step 5: Generate / Supplement CHANGELOG Entries
重要: CHANGELOG はパッケージ利用者向けである。
以下の変更は CHANGELOG に含めない:
- CI/CD ワークフロー（
.github/workflows/）の追加・変更
- 開発者向けスクリプト（
scripts/）の追加・変更
- テストコード・テストフィクスチャ（
tests/）の追加・変更
.claude/skills/ 配下の開発者向けスキル.gitignore、PR テンプレート等のリポジトリ管理ファイル- その他、パッケージをインストールしたユーザーに影響しない変更
以下の変更は CHANGELOG に含める:
src/sdd_cli/ 配下のコード変更（コマンド、機能、バグ修正）pyproject.toml の依存関係や設定変更（ユーザーに影響する場合）- パッケージ利用者に影響するバグ修正・機能追加・破壊的変更
ハイブリッドロジック:
[Unreleased] に既存内容がある場合:
- 既存エントリをベースとする
- git 変更履歴と照合し、カバーされていない利用者向け変更を特定する
- 不足分のエントリのみ追加生成する
[Unreleased] が空の場合:
- git 変更履歴から利用者向け変更のエントリを生成する
- 利用者向け変更が存在しない場合:
- ユーザーに「パッケージ利用者向けの変更がありません」と報告し、CHANGELOG 更新をスキップするか確認する
記述スタイル（既存 CHANGELOG に準拠）:
- 各エントリは
- **対象名** - 変更内容の要約 形式または - 変更内容の要約 形式
- サブ項目はインデント2スペースで
- 詳細内容
- カテゴリは
### ヘッダーで分類（Added, Changed, Fixed, Removed, Breaking Changes）
Step 6: Update CHANGELOG File
CHANGELOG ファイルに対して以下を実行する:
## [Unreleased] セクションの既存内容をクリアする## [Unreleased] の直後に空行を挟んで新バージョンセクションを挿入する:
## [VERSION] - YYYY-MM-DD
- 日付は実行日（
date +%Y-%m-%d で取得）を使用する
- Step 5 で生成/統合したエントリを配置する
Step 7: Update Version Manifests
4箇所のバージョンフィールドをすべて新バージョンに更新する:
pyproject.toml → version = "NEW_VERSION"src/sdd_cli/__init__.py → __version__ = "NEW_VERSION"tests/test_init.py → assert __version__ == "NEW_VERSION"tests/test_cli.py → assert "NEW_VERSION" in result.output
更新方法:
pyproject.toml: Edit tool で version = "OLD_VERSION" → version = "NEW_VERSION" に置換__init__.py: Edit tool で __version__ = "OLD_VERSION" → __version__ = "NEW_VERSION" に置換tests/test_init.py: Edit tool で == "OLD_VERSION" → == "NEW_VERSION" に置換tests/test_cli.py: Edit tool で "OLD_VERSION" in → "NEW_VERSION" in に置換
Step 8: Summary
更新結果のサマリーを表示する:
- 更新されたバージョン:
OLD_VERSION → NEW_VERSION
- CHANGELOG エントリ数（カテゴリ別）
- 更新されたファイル一覧
- 次のステップ（レビュー → コミット → タグ → プッシュ）
Output Format
## Release Preparation Complete
**Version**: OLD_VERSION → NEW_VERSION
**Date**: YYYY-MM-DD
### CHANGELOG Updates
| Category | Entries | Source |
|:---|:---|:---|
| Added | N | existing / generated / mixed |
| Changed | N | ... |
| Fixed | N | ... |
### Updated Files
- [ ] `CHANGELOG.md`
- [ ] `pyproject.toml`
- [ ] `src/sdd_cli/__init__.py`
### Next Steps
1. 変更内容をレビューする
2. コミットする: `git add -A && git commit -m "[add] v{VERSION} リリース準備"`
3. タグを作成する: `git tag v{VERSION}`
4. プッシュする: `git push origin main --tags`
5. GitHub Actions の Release ワークフローが自動実行される
Notes
- このスキルは CHANGELOG の 生成・編集 と バージョン更新 を行う。コミットやタグ作成は行わない
- 生成されたエントリは必ずユーザーにレビューを促す
- プレリリースバージョン（
-alpha, -rc.1 等）もサポートする
- pyproject.toml と src/sdd_cli/init.py のバージョンは必ず一致させる
