breaking-changes について
Claude Codeの更新によるプラグインAPIの互換性リスクを調べるスキルです。追跡対象のAPIと公式の変更を比較し、影響箇所を深刻度別に示します。
主な機能
- 01Claude Code APIの追跡
- 02公式更新とのAPI比較
- 03影響を受けるAPIをプラグイン内で検索
- 04ファイルと行番号による影響報告
- 05深刻度別の変更分類
活用シーン
- 01Claude Code更新後のプラグイン確認
- 02削除・変更されたAPIの使用箇所の特定
- 03非推奨APIと新規APIの確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/breaking-changesを入力して読み込まれたか確認します。
詳細
公式の変更履歴と、現在の API サーフェス（フックの種類とマッチャー、エージェントのフロントマターフィールド、プラグインマニフェストのスキーマ、SKILL.md の形式、スクリプトの CLI フラグ — `references/api-surface.md` で追跡）を差分比較することで、Claude Code のアップデートにおける破壊的変更を検出します。変更された各 API についてプラグインを grep し、影響を特定の file:line の位置にマッピングして、重大度（BREAKING / DEPRECATED / NEW）別に分類して報告します。
破壊的変更検出スキル
概要
Claude Code の API 変更を、私たちのプラグインエコシステムと比較し、互換性の問題を検出します。
API サーフェスファイル
api-surface.md リファレンスには、現在把握している API が含まれています：
- フックの種類とそのマッチャー
- エージェントのフロントマターフィールド
- プラグインマニフェストのスキーマ
- スキルの SKILL.md 形式
- 使用されているスクリプトの CLI フラグ
検出ワークフロー
- 現在の api-surface.md を 読み込む
- 最新の Claude Code API ドキュメントを 取得する
- 追加／変更／削除された API を 差分比較する
- 変更された各 API についてプラグインを grep する
- file:line の影響マッピングとともに 報告する
影響評価
| 変更の種類 | 重大度 | 例 |
|---|---|---|
| API の削除 | BREAKING | フックの種類が削除された |
| スキーマの変更 | BREAKING | フロントマターフィールドの名前が変更された |
| 新しい必須フィールド | BREAKING | 必須の新しいパラメータ |
| 非推奨の API | DEPRECATED | 古いフックがまだ動作する |
| 新しい任意の API | NEW | 新しいフックの種類が追加された |
リファレンス
コメント
Markdown 対応