utility-pm-changelog-curator について
リリース準備に向けて Git の履歴から CHANGELOG の草案を作る、クライアント横断のディスパッチスキルです。Claude Code ではネイティブのサブエージェントを呼び出し、それ以外ではリポジトリの規則に従います。草案はレビュー用で、直接コミットしません。
主な機能
- 01タグ間の Git コミットを収集
- 02リポジトリ規則に沿った分類と書き換え
- 03対象バージョンとコミット済み限定の指定
- 04Claude Code と他のクライアントで実行
- 05コミットではなくレビュー用草案を作成
活用シーン
- 01バージョンタグ間のリリースノート作成
- 02公開向け CHANGELOG 項目の草案作成
- 03Claude Code 以外でのコミット履歴の整理
- 04リリースワークフローでの CHANGELOG 草案生成
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ product-on-purpose/ pm-skills --skill utility-pm-changelog-curatorインストール後、Claude Code で/utility-pm-changelog-curatorを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
HISTORY.mdevals/trigger-fixtures.jsonreferences/EXAMPLE.mdTEMPLATE.md詳細
PM 変更履歴キュレーター(ディスパッチスキル)
pm-changelog-curator サブエージェント用のクライアント横断ディスパッチラッパーです。実行環境を検出し、Claude Code ではネイティブのサブエージェントに処理を委譲し、Claude 以外のクライアントでは agents/pm-changelog-curator.md を読み込んでインラインで実行します。
使用する場合
- リリースの準備をしており、2 つのタグ間の Git ログから CHANGELOG のドラフトを作成したい場合
- ネイティブの pm-changelog-curator サブエージェントに対応していない、Claude 以外の AI クライアントを使用している場合
- pm-skills の CHANGELOG 品質ルール(内部メモへの参照なし、emダッシュなし、公開パスのみ)を手動で適用せずに守ったドラフトを作成したい場合
使用しない場合
- CHANGELOG の項目を直接コミットしたい場合(このスキルが作成するのはレビュー用のドラフトであり、コミットではありません)
- PM 成果物をレビューしたい場合 → 代わりに
utility-pm-criticを使用してください - リポジトリ全体のガバナンス監査を行いたい場合 →
utility-pm-skill-auditorを使用してください - リリースの全行程をガイドしてほしい場合 →
utility-pm-release-conductorを使用してください(ゲート G2 でこのスキルに連携します)
手順
実行環境の検出手順。 このスキルを呼び出している AI クライアントを特定してください。
pm-skills プラグインをインストールした Claude Code で実行している場合
ユーザーの引数を指定して @agent-pm-skills:pm-changelog-curator を呼び出してください。$ARGUMENTS に --since-tag、--target-version、--committed-only が含まれている場合は、それらを渡してください。サブエージェントのドラフトをユーザーに返してください。
その他の AI クライアントで実行している場合
Codex CLI、Cursor、Windsurf、Copilot、Gemini CLI、またはネイティブの pm-skills プラグインのサブエージェント機能に対応していないその他のクライアントの場合:
- サブエージェントの正式な定義を
agents/pm-changelog-curator.mdから読み込みます - そのファイル内のシステムプロンプト本文を作業指示として実行します
- サブエージェントの定義に記載された 8 ステップのドラフト作成フローを実行します(対象範囲の確定 -> 品質ルールの確認 -> 作業ツリーの確認 -> コミットの列挙 -> 分類 -> グループ化 -> 書き換え -> 対象バージョンの決定 -> ドラフトの出力)
$ARGUMENTSの--since-tag、--target-version、--committed-only引数を適用します- マスタープラン D26 に従って、階層化された出力を返します(CHANGELOG の全ドラフト + ステータス概要 + ステータス YAML)
クライアント横断に関する注意事項
このディスパッチスキルでは、AI クライアントに以下を要求します。
git log、git describe、git statusの実行に Bash を使用する- CLAUDE.md の品質ルールと、既存の CHANGELOG.md のフォーマット例を読む
- サブエージェントの正式な定義ファイルを読む
- エージェント本文を作業指示として扱う
正式なクライアント横断の対応状況は、サブエージェント互換性マトリックスを参照してください。v2.16.0 時点でのこのスキルの概要:Claude Code + Codex CLI では本番運用可能(Codex CLI で git log の実行、CLAUDE.md の品質ルールの読み込み、問題のない CHANGELOG 項目のドラフト作成、作業ツリーが汚れている場合の正しい拒否を確認済み);Cursor / Windsurf / Copilot CLI / Gemini CLI では試験運用中です。クライアントの動作が不安定な場合は、git log を手動で実行し、品質基準として CLAUDE.md を参照して手動でドラフトを作成してください。
参照ファイル
- サブエージェントの正式な定義:
agents/pm-changelog-curator.md - 動作仕様:
docs/internal/release-plans/v2.16.0/spec_pm-changelog-curator.md - CHANGELOG の品質ルールの参照元:
CLAUDE.md(リポジトリのルート) - 既存の CHANGELOG.md のフォーマット:
CHANGELOG.md(ルート);v2.15.1 と v2.15.2 の項目が正式な例です - 実行環境コンポーネントのカタログ:
docs/reference/runtime-components.md - 出力テンプレート:
references/TEMPLATE.md - 作成例:
references/EXAMPLE.md