changelog-review

Claude Code の変更履歴レビュー

このスキルを使用するタイミング

このスキルを使用する場合...	代わりに別のスキルを使用する場合...
プラグインに影響する破壊的変更について Claude Code のリリースをレビューする場合	プロジェクトのセッションで得た知見をルールやレシピにまとめる場合
プラグインで活用できる Claude Code の新機能を見つける場合	スキルのスクリプト抽出の機会を監査する場合は、代わりに project-skill-scripts を使用してください
インストール済みプラグインに影響が出る前に非推奨機能を追跡する場合	プラットフォームのレビューではなく、機能開発を再開する場合は、代わりに project-continue を使用してください

Claude Code の変更履歴を分析し、プラグイン開発への影響を特定するための専門知識です。

主な目的

Claude Code のリリースをレビューして、以下を行います。

• プラグインの更新が必要となる破壊的変更を特定する
• プラグインで活用できる新機能を見つける
• 問題になる前に非推奨機能を追跡する
• プラグインが現在のベストプラクティスに従っていることを確認する

変更のカテゴリ

影響大（対応必須）

カテゴリ	変更例	対応
破壊的変更	API の変更、ツール名の変更	影響を受けるプラグインを直ちに更新する
セキュリティ修正	権限の脆弱性	権限ルールをレビューして更新する
非推奨	機能やフィールドの削除	非推奨の使用箇所を削除する
フックの変更	新しいイベント、スキーマの変更	hooks-plugin を更新する

影響中（レビューを推奨）

カテゴリ	変更例	対応
新機能	新しいツール、frontmatter フィールド	プラグインの機能強化を検討する
権限の更新	新しいワイルドカードパターン	権限のドキュメントを更新する
SDK の変更	新しいコールバック、ストリーミング	SDK 関連のスキルを更新する
MCP の改善	OAuth、サーバー設定	agent-patterns-plugin を更新する

影響小（情報のみ）

カテゴリ	変更例	対応
バグ修正	UI の改善	変更履歴に記録する
パフォーマンス	起動の最適化	対応不要
IDE の機能	VS Code の更新	対応不要

プラグインへの影響マトリクス

変更履歴のカテゴリをプラグインに対応付けます。

Claude Code の領域	影響を受けるプラグイン
フック	hooks-plugin, configure-plugin
スキル／コマンド	スキル／コマンドを含むすべてのプラグイン
エージェント	agents-plugin, agent-patterns-plugin
MCP サーバー	agent-patterns-plugin
権限	configure-plugin, hooks-plugin
Git 操作	git-plugin
テストツール	testing-plugin
SDK の変更	agent-patterns-plugin

バージョンの追跡

バージョンの状態は .claude-code-version-check.json に保存されます。

{
  "lastCheckedVersion": "2.1.7",
  "lastCheckedDate": "2026-01-14",
  "changelogUrl": "https://raw.githubusercontent.com/anthropics/claude-code/main/CHANGELOG.md",
  "reviewedChanges": [
    {
      "version": "2.1.7",
      "date": "2026-01-14",
      "relevantChanges": [],
      "actionsRequired": []
    }
  ]
}

分析プロセス

ステップ 1：現在の状態を取得する

# Read last checked version
cat .claude-code-version-check.json | jq -r '.lastCheckedVersion'

ステップ 2：変更履歴を取得する

WebFetch を使って、以下から最新の変更履歴を取得します。 https://raw.githubusercontent.com/anthropics/claude-code/main/CHANGELOG.md

ステップ 3：新しいバージョンを特定する

取得した変更履歴のバージョンと lastCheckedVersion を比較します。 そのバージョン以降のすべての変更を抽出します。

ステップ 4：変更を分類する

各変更について、以下を判断します。

1. 影響レベル（大／中／小）
2. 影響を受けるプラグイン
3. 必要な対応

ステップ 5：レポートを作成する

以下を含むレポートを作成します。

• 見つかった新しいバージョン
• 直ちに対応が必要な影響大の変更
• レビューする価値のある影響中の変更
• プラグインの改善案

ステップ 6：バージョンの追跡情報を更新する

.claude-code-version-check.json を以下の内容で更新します。

• 新しい lastCheckedVersion
• 新しい lastCheckedDate
• レビューした変更の概要

変更検出パターン

破壊的変更

以下を確認します。

• 「BREAKING」または「Breaking Change」の見出し
• 「Removed」セクション
• 「Migrat」というキーワード
• 「deprecated」が「removed」に変更されている箇所

フックシステムの変更

以下を確認します。

• 機能に関する「hook」への言及
• 新しいフックイベント（SessionStart、SessionEnd、SubagentStart など）
• フックの入出力のスキーマ変更
• 権限の判定に関する更新

スキル／コマンドの変更

以下を確認します。

• 「skill」または「slash command」への言及
• フロントマターフィールドの変更
• 検出メカニズムの更新
• 「context: fork」などの新しいフィールド

エージェント／サブエージェントの変更

以下を確認します。

• 「agent」または「subagent」への言及
• Task ツールの変更
• エージェントの設定オプション
• 新しいエージェントタイプ

権限の変更

以下を確認します。

• 「permission」への言及
• ワイルドカードパターンの更新
• セキュリティ修正
• Bash の権限の変更

レポート形式

人間が読めるレビュー報告書のテンプレート（Summary / High-Impact / Medium-Impact / Action Items / Next Steps）については、REFERENCE.md を参照してください。 CI の経路では代わりにトリアージ用のイシューが作成されます。下記の「自動化との統合」を参照してください。

自動化との統合

.github/workflows/changelog-review.yml ワークフローは、このレビューを毎週実行します。 これは、組織の再利用可能なワークフロー laurigates/.github/.github/workflows/reusable-changelog-review.yml@main （イシュー #1304）を呼び出す薄いラッパーです。スケジュール、ディスパッチ入力、リポジトリ固有の入力（アナライザーパス、コミット範囲、ルールファイルのセクション、プラグインリスト）は呼び出し元にあり、2 ジョブのパイプライン（bash による事前チェックゲート → opus によるトリアージ）は上流にあります。アナライザースクリプトとそのテストはこのリポジトリに置かれ、analyzer-script 入力を介して再利用可能なワークフローに渡されるため、分析ロジックはここでレビューおよび単体テストできます。

bash scripts/analyze-changelog.sh --excerpt <slice> --repo-dir . \
  --tracked <ver> --latest <ver>

スクリプト（scripts/analyze-changelog.sh、テストは scripts/tests/test-analyze-changelog.sh）は、構造化された KEY=VALUE 出力を生成します。キーワードのカウントに加え、非推奨化／削除からプラグインコードへの橋渡しを行います。非推奨化または破壊的変更を伴う削除の行に記載されたツール／設定／コマンドについて、このリポジトリのスキル／フック／エージェント／ルールを grep し、引き続き参照しているファイルをトリアージ候補として提示します。見逃しは次の 2 種類が原因となっています。

• #1638 — 非推奨の識別子（例：TaskOutput）がフックスクリプト内で参照され続けていたケースです。以前のキーワードマップが .claude/rules/*.md しか指していなかったためです。deprecat|removed|renamed|unshipped の形式で検出します。
• #1733 — / 区切りのペアを含む、動詞が後置された BREAKING ツール削除の記述（BREAKING: TeamCreate/TeamDelete tools removed、2.1.178）を、非推奨化の文法形式で検出できず、agent-patterns-plugin:agent-teams スキルが削除済みツールを参照していることを警告できなかったケースです。BREAKING 行の抽出で検出します。

変更履歴のレビューは、ドキュメントだけの作業ではありません。 実行のたびに、ルールドキュメントの更新と、削除／名称変更されたツール／設定／環境変数を参照するプラグインのコード修正を、同じタスクの一部として扱います。ACTIONABLE_DEPRECATION の候補は追跡イシューの最優先セクションです。削除された識別子が参照されているのは、単に古い文章が残っているのではなく、正確性のバグです（スキルが Claude に存在しないツールを呼び出すよう指示してしまいます）。

ワークフローの流れ：

1. 毎週、スケジュールに従って実行
2. 変更履歴を取得してバージョンを比較（skip-if-exists は差分を考慮します。未対応の追跡イシューが開いていても、新しいバージョンが抑止されることはありません）
3. 新しいバージョンが見つかった場合：アナライザーを実行し、追跡イシューを 1 件作成（最優先は、コード内で引き続き参照されている非推奨の識別子）、小規模な PR でバージョン JSON を更新
4. イシューに適切なラベルを付与

エージェントによる最適化

コンテキスト	コマンド
変更履歴の一部を分析（構造化された KEY=VALUE）	bash scripts/analyze-changelog.sh --excerpt <slice> --repo-dir . --tracked <ver> --latest <ver>
トリアージフィルター — コード準拠の候補のみ	… analyze-changelog.sh … | grep -E '^(ACTIONABLE_DEPRECATION|DEPRECATED_TOKENS)='
検出された候補ファイルの一覧表示	… analyze-changelog.sh … | sed -n '/^CANDIDATES:/,/^=== END/p'
集約ステータスのみ	… analyze-changelog.sh … | grep -E '^(STATUS|ISSUE_COUNT)='
アナライザーの回帰テストを実行	bash project-plugin/skills/changelog-review/scripts/tests/test-analyze-changelog.sh

クイックリファレンス

Claude Code 関連の URL

リソース	URL
変更履歴	https://raw.githubusercontent.com/anthropics/claude-code/main/CHANGELOG.md
ドキュメント	https://docs.anthropic.com/en/docs/claude-code
GitHub	https://github.com/anthropics/claude-code

バージョン番号の形式

Claude Code はセマンティックバージョニングを使用します：MAJOR.MINOR.PATCH

• MAJOR：互換性のない変更
• MINOR：新機能
• PATCH：バグ修正

Issue ラベル

ラベル	用途
changelog-review	変更履歴に関するすべての Issue
breaking-change	更新が必要な互換性のない変更
enhancement	新機能の提案
maintenance	一般的な保守作業