with one click
with one click
[HINT] Download the complete skill directory including SKILL.md and all related files
| name | release-notes |
| description | リリースノート作成。前回リリース以降の全PRを調査し、PR要約とリリースノートを生成する。 |
| allowed-tools | Read, Write, Edit, Glob, Grep, Bash, Task, AskUserQuestion |
| argument-hint | <version> (例: 1.0.11) |
バージョン $ARGUMENTS のリリースノート(PR要約 + ユーザー向けリリースノート)を作成する。
docs/release_notes/v$ARGUMENTS/
出力ディレクトリを作成:
mkdir -p docs/release_notes/v<version>
前回リリースのタグを特定:
gh release list --limit 5
ユーザーに前回のタグを確認する。
Task sub-agent で以下を実行し、結果をファイルに書き出す:
前回リリースの日付を取得:
gh release view <previous-tag> --json publishedAt --jq '.publishedAt'
それ以降のマージ済みPRを全件取得:
gh pr list --state merged --search "merged:>YYYY-MM-DD" --limit 100 --json number,title,mergedAt --jq 'sort_by(.mergedAt) | .[] | "\(.number)\t\(.mergedAt)\t\(.title)"'
各PRの詳細を確認:
gh pr view <number> --json title,body,labels,files
mulmocast パッケージ更新がある場合、上流の変更を詳細調査する:
a. バージョン範囲を特定(前回リリースの mulmocast バージョン → 今回のバージョン)
b. 前バージョンと現バージョンのコードを実際に diff して新規追加を特定する(最重要): 上流のリリースノートやPRタイトルだけで「新機能」と判断してはならない。上流リリースノートには app が既に取り込み済みの機能も含まれるため、必ず実コードで差分を確認する。
# 前バージョンの tarball をダウンロードして比較
mkdir -p /tmp/mulmocast-old-<old-ver>
cd /tmp/mulmocast-old-<old-ver>
curl -sL https://registry.npmjs.org/mulmocast/-/mulmocast-<old-ver>.tgz | tar xzf -
# モデル一覧の diff(provider2agent.js が動的ロードの定義元)
diff <(grep -E "google/|xai/|bytedance/|runwayml/|kwaivgi/" /tmp/mulmocast-old-<old-ver>/package/lib/types/provider2agent.js | sort) \
<(grep -E "google/|xai/|bytedance/|runwayml/|kwaivgi/" node_modules/mulmocast/lib/types/provider2agent.js | sort)
この diff で追加された行のみを「新規モデル」として記載する。
c. 上流リポジトリのリリースノートは補足情報として参照(モデル以外の機能変更を把握するため):
gh release list --repo receptron/mulmocast --limit 20
gh release view <tag> --repo receptron/mulmocast # 各バージョンごと
d. app 側の対応範囲を調査し、リリースノートに記載する範囲を判断する:
elements 配列、canvasSize、オーディオミキシング等)。これらは CLI の機能であり、app のリリースノートには含めないe. PR要約にはバージョン別に構造化して記載し、「2.4.8 時点で既存」と「今回新規」を明確に区別する
PRをカテゴリ分類して docs/release_notes/v<version>/release_notes_v<version>_pr_summary.md に書き出す。
PR要約の記述ルール:
.vue ファイル等)を読んで確認するカテゴリ(ユーザー向け):
カテゴリ(開発者向け) — リリースノートでは「開発者向け」セクションにまとめる:
PR要約をもとに、ユーザー向けリリースノートを作成する:
docs/release_notes/v<version>/release_notes_v<version>.md# MulmoCast App v<version> Release Notes
## 新機能
### 機能名
- 説明
## バグ修正
- ユーザーに影響するバグ修正のみ(devモード限定のバグは「開発者向け」へ)
## 削除された機能
- 削除内容
## 改善
- ユーザーに影響する改善のみ
## 開発者向け
- devモード限定のバグ修正
- リファクタリング
- 依存パッケージ更新
- テスト・CI/CD
- その他の内部変更
作成したファイルをユーザーに提示し、内容の確認・修正を依頼する。
docs/release_notes/v1.0.9/docs/release_notes/v1.0.10/docs/release_notes/v1.0.11/