Release Preparation Helper

リリース作業の forensic check と CHANGELOG 移行支援 を 1 つにまとめた skill。手動でやると忘れがちな以下 4 段階を 1 コマンドで通す:

1. 各 manifest の 現在の version を一覧化 (7 runtime × 9 manifest)
2. release-versions.toml の expected_prefix との照合
3. CHANGELOG.md [Unreleased] の内容と、リリース時に必要な 昇格作業 の提案
4. 公開 registry (PyPI / crates.io / NuGet / npm / Maven Central) の 最新公開 version 取得

実装は read-mostly — 変更提案は markdown diff 形式でユーザに提示し、 適用は明示確認後 (memory feedback_merge_caution.md に従う)。

引数

• $ARGUMENTS 空: 全 runtime を一覧
• python / rust / csharp / npm / swift / kotlin: 特定 runtime のみ
• --target-version X.Y.Z: 次回リリース予定 version (CHANGELOG 移行提案に使う)

現在の状態

• ブランチ: !git rev-parse --abbrev-ref HEAD
• 引数: $ARGUMENTS
• canonical truth: !grep -A1 "^\\[meta\\]" docs/spec/release-versions.toml | head -5

フェーズ 1: Manifest version 一覧

以下の 9 manifest を並列で Read し、現在の version を抽出して表化:

# 例: rust workspace version
grep -A1 "^\[workspace.package\]" src/rust/Cargo.toml | grep "^version" | head -1

フェーズ 2: Expected prefix との照合

docs/spec/release-versions.toml を tomllib で読み、各 manifest の expected_prefix を取得。フェーズ 1 の実 version が prefix で始まるかを照合:

| Runtime | Manifest version | expected_prefix | Status |
|---------|------------------|-----------------|--------|
| Python  | `<local>`        | `<expected_prefix>` | ✓      |
| Rust    | `<local>`        | `<expected_prefix>` | ✓      |
| C# Core | `<local>`        | `<expected_prefix>` | ✓ / 要確認 |
| ...     | ...              | ...             | ...    |

mode = "warn" でも、fail ステータスを report 上で強調表示。

フェーズ 3: CHANGELOG.md 状況

# [Unreleased] セクション抽出
awk '/^## \[Unreleased\]/{flag=1; next} /^## /{flag=0} flag' CHANGELOG.md | head -60

集計:

• [Unreleased] 直下の sub-section 数 (h3 見出しの個数)
• 既存 release tag (## [X.Y.Z]) の最新 5 件
• --target-version 指定時は、 移行 markdown を提示:

## [X.Y.Z] - YYYY-MM-DD

(Unreleased から移動した内容)

## [Unreleased]

(空または next-version の作業中項目)

ユーザに「これを CHANGELOG.md に適用していいか」明示確認 (memory feedback_merge_caution.md 準拠)。

フェーズ 4: 公開 registry の最新 version

オプションで以下を取得 (rate limit を考慮し並列実行):

# PyPI
curl -s https://pypi.org/pypi/piper-plus/json | jq -r '.info.version'

# crates.io
curl -s https://crates.io/api/v1/crates/piper-plus | jq -r '.crate.max_version'
curl -s https://crates.io/api/v1/crates/piper-plus-cli | jq -r '.crate.max_version'

# NuGet
curl -s "https://api.nuget.org/v3-flatcontainer/piperplus.core/index.json" | jq -r '.versions[-1]'
curl -s "https://api.nuget.org/v3-flatcontainer/piperplus.cli/index.json" | jq -r '.versions[-1]'

# npm
npm view piper-plus version
npm view @piper-plus/g2p version

# Maven Central (search.maven.org)
curl -s "https://search.maven.org/solrsearch/select?q=g:io.github.ayutaz+AND+a:piper-plus-g2p-android&rows=1&wt=json" | \
    jq -r '.response.docs[0].latestVersion'

各 registry で取得失敗 (404 / timeout) は <未公開> として表示し fail にしない。

フェーズ 5: ローカル vs 公開 vs canonical の 3-way 差分

## Release Status

| Runtime | Local | Published | Canonical (.toml) | Verdict |
|---------|-------|-----------|-------------------|---------|
| Python  | `<local>` | `<published>` | `<expected_prefix>` | Local ahead → publish required |
| Rust    | `<local>` | `<published>` | `<expected_prefix>` | In sync |
| C# Core | `<local>` | `<published>` | `<expected_prefix>` | 判定 |
| ...     | ...   | ...       | ...               | ...     |

Verdict 例:

• In sync: local == published == canonical prefix
• Local ahead → publish required: local が published より新しい
• Canonical drift: local が canonical prefix に該当せず → release-versions.toml 更新が必要
• Published ahead → local bump needed: published が新しい (hot fix されたケース等)
• <未公開>: registry に存在しない (initial release 直前)

フェーズ 6: 推奨アクション

verdict に応じて推奨 next action を表示:

注意事項

• 本 skill は変更を勝手に適用しない: フェーズ 3 の CHANGELOG 移行は markdown 出力のみ。ユーザ承認後に Edit で適用
• rate limit: 5 registry × 1 req = ~7 req、 GitHub API は無関係なので 5000/h 制限内
• オフラインモード: registry 取得失敗時はフェーズ 4 をスキップして report 生成
• release-versions.toml は canonical truth: 実 version との不一致は drift として明示
• memory feedback_pr_no_milestones.md 準拠: マイルストーン提案を含めない

使用例

# 全 runtime の current / published / canonical を一覧
/release-prep

# Python だけに絞って詳細表示
/release-prep python

# 次回リリース予定での CHANGELOG 移行案を生成
/release-prep --target-version <target-version>

# Rust だけ + target version
/release-prep rust --target-version <target-version>

期待効果

• リリース時の manifest 一括確認 を 1 コマンドに集約 (現状: 9 manifest を手動 Read)
• 「local では bump 済みだが publish されてない」のような状態を即発見
• CHANGELOG [Unreleased] の昇格作業の 規定化 (現状: 手動 markdown 編集)
• release-versions.toml mode = "warn" → "fail" 切替の判断材料を提供

/sync-docs Agent 7 (version drift 監査) と相補的: /sync-docs は drift 検出、/release-prep は drift 解消支援。