diagnosing-react-code

React コードの診断

react-doctor は React パッケージをスキャンし、セキュリティ、パフォーマンス、正確性、アーキテクチャに関する診断と、0〜100 のスコアを表示します。Node の要件は ^20.19.0 || >=22.13.0 です。

初回実行の前に

• セッション中の初回実行では、npm からサードパーティ製パッケージをダウンロードして実行します。固定されたバージョンを明示して、実行前にユーザーに確認してください。
• デフォルトでは、スコアは react-doctor のスコア API から取得され、サプライチェーンスキャンは Socket.dev にクエリを送信します。マシン外に情報を一切送信しない場合は、--no-score --no-supply-chain を追加してください（この場合、実行結果にスコアは表示されません）。

実行

package.json の dependencies または peerDependencies に react が記載されているパッケージ内で実行してください。モノレポのルートでは、ツールがプロジェクトを選択するよう求めます。

npx -y [email protected] --verbose --scope changed

• バージョンを固定すると、実行間でスコアを比較できます。@latest には決して切り替えず、固定バージョンを意図的に変更する場合にのみアップグレードしてください。フラグが拒否された場合は、npx -y [email protected] --help を確認して調整してください。
• --verbose はすべてのルールとファイルを表示します。デフォルトでは上位 3 件のみを表示します。
• --scope changed は、自動検出されたベース参照との差分で変更されたファイルにある新しい指摘のみを報告します（設定するには --base <ref> を使用します）。パッケージ全体のヘルスチェックには --scope full を使用してください。これは非推奨の --diff に代わるものです。

修正の反復

1. ベースラインのスコアとエラー数、警告数を記録します。
2. まずエラーの診断、セキュリティ、正確性の問題を修正します。警告は、現在のタスクで変更したコードに限って修正してください。
3. エラーがなくなり、スコアがベースライン以上になるまで、同じコマンドを再実行します。エラーが残る修正を 3 回行った後、または修正によってタスクの範囲外の動作が変わる場合は停止し、残っている問題を報告してください。

バージョンとスコープ、ベースラインから最終結果までのスコア（または「計算されていません：--no-score」）、修正した診断と、修正しなかった理由を添えた未修正の診断を、それぞれ <severity> <rule> <file>:<line> の形式で報告してください。