| name | release-notes |
| description | AivisSpeech の新バージョンリリース時に updateInfos のリリースノートドラフトを作成・更新するスキル。「リリースノート」「updateInfos」「アップデート情報」「リリース準備」などのキーワードが出たら使う。updateInfos.draft.json の作成・更新、エンジン側リリースノートとの統合、漏れチェックまでを包括的にサポートする。 |
AivisSpeech リリースノート作成
運用ルール
public/updateInfos.json は VITE_LATEST_UPDATE_INFOS_URL により master ブランチの内容が全ユーザーに配信される。リリース前に更新すると未リリースバージョンの通知が届いてしまうため、ドラフトは必ず public/updateInfos.draft.json に作成し、リリースコミット時に updateInfos.json へ反映する。
調査の進め方
1. タグ日付の確認(最優先)
git tag -l --format='%(refname:short) %(creatordate:iso)' | sort -t' ' -k2
前バージョンタグの日付を確認し、git log <前バージョンタグ>..HEAD で対象コミットの範囲を確定する。前バージョン以前から存在していた機能を「追加」と記載するミスを防ぐために、これは絶対に最初にやること。
2. コミットメッセージだけでなく実際の差分を確認する
コミットメッセージには全ての変更が書かれているとは限らない。以下のサブエージェントを並行起動し、各領域の git diff <前バージョンタグ>..HEAD を調査する:
- ヘルプドキュメント:
public/howtouse.md, public/qAndA.md, public/contact.md 等
- エディタ UI: ModelManageDialog, DictionaryManageDialog, PresetManageDialog, Talk/, SettingDialog, MenuBar 等
- VOICEVOX 由来の変更: tsukumijima 以外のコミットでソング/シーケンサー/マルチトラック関連を除いたもの
- 前プレビュー版以降の差分: 直近のプレビュー版タグ以降の変更
3. エンジン側リリースノートの統合
AivisSpeech は AivisSpeech Engine を包含する。エンジン側のリリースノート (../AivisSpeech-Engine/resources/engine_manifest_assets/update_infos.json) の内容を取り込む。
- エンジン側の変更には
Engine: プレフィックスを付ける
- エンジン側の API 追加で対応する UI 機能がエディタ側にある場合は、UI 機能として記載する(プレフィックスなし)
4. Opus サブエージェントによる漏れチェック
ドラフト完成後、Opus モデルのサブエージェントに全コミットとドラフトを突き合わせてもらい、漏れ・誤りを検出する。
記述フォーマット
絵文字カテゴリ(この順序で並べる)
🚀 : 主要な新機能
✨ : 改善・UI/UX 向上
⚡ : パフォーマンス改善
✅ : 小規模な機能追加
🛠️ : バグ修正(末尾に「🛠️ そのほか、様々な不具合を修正」を置く)
⬆️ : 依存関係・ベースバージョンの更新
項目の並べ方(厳守)
各絵文字カテゴリの中で、エディタ側の項目を全て先に配置し、Engine: プレフィックス付きの項目を全て後に配置する。Engine: 項目の後にエディタ側の項目を挿入してはならない。新しいエディタ側の項目を追加する際は、そのカテゴリ内の最後のエディタ側項目の直後(最初の Engine: 項目の直前)に挿入すること。
カテゴリ内では重要度の高い項目を上に配置する。関連する小さな変更は1項目にまとめてよい(例: 括弧書きで列挙)。
リグレッション修正
プレビュー版ユーザーが多いため、リグレッション修正も全て含める。ただし「リグレッション」という表現は使わない。
contributors
- tsukumijima 以外の直接 PR 貢献者がいれば個別に記載
- VOICEVOX マージ由来は末尾に
VOICEVOX Contributors としてまとめる
git log <前バージョンタグ>..HEAD --no-merges --format="%an" | sort | uniq -c | sort -rn で確認
JSON 構造
[
{
"version": "X.Y.Z",
"descriptions": [
"🚀 エディタ側の新機能...",
"🚀 Engine: エンジン側の新機能...",
"✨ エディタ側の改善...",
"✨ Engine: エンジン側の改善...",
"⚡ ...",
"✅ ...",
"🛠️ エディタ側のバグ修正...",
"🛠️ Engine: エンジン側のバグ修正...",
"🛠️ そのほか、様々な不具合を修正",
"⬆️ ..."
],
"contributors": ["tsukumijima", "VOICEVOX Contributors"]
},
...既存バージョンのエントリ
]
チェックリスト