spectrum-audit

Spectrum 監査

コードベースが Spectrum デザインシステムおよび React Spectrum S2 のベストプラクティスに準拠しているかを監査し、スコア付きの優先順位を付けたレポートを作成します。このスキルはレポートのみを作成し、ファイルは変更しません。

使用するタイミング

開発者から、Spectrum / S2 の正確性、設定、スタイル、アクセシビリティ、コンポーネントの使用に関する問題について、プロジェクトの監査、レビュー、Lint、確認を依頼された場合に使用します。

@react-spectrum/s2 がインストールされたプロジェクトが必要です。S2 が依存関係にない場合は、その旨を伝えて終了します。

仕組み

以下のフェーズを順番に実行します。

フェーズ 0 — 対象範囲

• 監査対象のプロジェクト、またはモノレポの場合は特定のパッケージを確認します。ワークスペースのルートではなく、パッケージを監査してください。
• ロックファイルからパッケージマネージャーとバンドラー（Vite / webpack / Next.js / Parcel / Rollup / ESBuild）を特定し、package.json の依存関係を読み取ります。
• @react-spectrum/s2 がインストールされていることを確認します。スキャン対象のソースグロブ（例：src/**/*.{tsx,jsx,ts,js}）を定めます。
• react-spectrum-s2 スキルが利用可能かどうかを確認します（エージェントにインストール済みのスキル一覧にあるか、.cursor/skills/ や .agents/skills/ などのローカルスキルディレクトリ内にあるか）。見つかったかどうかを記録します。レポートテンプレートでこの情報を使用します。

フェーズ 1 — チェックの実行

references/checks/ 内の各チェックファイルを順番に確認します。違反ごとに、検出事項を {file:line, rule, severity, category, fix} の形式で記録します。実際に読み取るか grep した行番号のみを記載し、場所を決して捏造しないでください。file:line ごとに、異なる根本原因 1 件につき検出事項を 1 件記録します。複数のチェックファイルが同じ問題を対象としている場合（例：コレクションの aria-label がない、またはサードパーティ製デザインシステムを使用している場合）は、最も具体的なチェックに割り当て、カテゴリ間で重複させないでください。

• 01 — セットアップと設定
• 02 — コンポーネントの使用
• 03 — スタイル
• 04 — アクセシビリティと正確性
• 05 — バージョン管理とメンテナンス
• 06 — テスト

これらのチェックの基準となるルールは react-spectrum-s2 スキルに記載されています。必要に応じて、その SKILL.md（実装ガイド）と references/guides/getting-started.md、references/guides/component-decision-tree.md、references/components/ を確認します。このスキルがインストールされていない場合は、チェックファイルのみを使って進めますが、その制限事項をレポートに記載してください（フェーズ 3 を参照）。

フェーズ 2 — スコアの算出

記録した検出事項に スコアリング基準 を適用し、カテゴリ別スコアと総合 Spectrum 準拠スコアを算出します。スコアは検出事項の件数に基づく算術計算です。推定してはいけません。

フェーズ 3 — レポート

レポートテンプレート に従って、監査対象プロジェクトに SPECTRUM-AUDIT.md を作成します。レポートには、スコアの見出し、グレード、重大度ごとの件数、概要、カテゴリ別スコア、重大度別にまとめた検出事項（クリック可能な file:line と、ルールを定義するチェック名をそれぞれ付記）、優先順位付きのアクション項目、良好な点を含めます。また、フェーズ 0 で react-spectrum-s2 が検出されなかった場合は、インストールを推奨します。

フェーズ 4 — 引き継ぎ

このスキルではコードを編集しません。以下のスキルを推奨します。

• 修正を実装するには react-spectrum-s2 スキルを推奨します。インストールされていない場合：

  npx skills add https://react-spectrum.adobe.com --skill react-spectrum-s2
  

• Spectrum 1 のパッケージ（@adobe/react-spectrum、@react-spectrum/*、@spectrum-icons/*）が存在する場合は、migrate-react-spectrum-v3-to-s2 スキルを推奨します。