rde-eval について
rde-evalは、React Doctorの変更をReact Doctor Evalsで範囲を限定してローカル評価するスキルです。環境準備、サンプル実行、ルール該当箇所の調査、回帰テスト、結果報告を案内します。
主な機能
- 01React DoctorとRDEのチェックアウトを準備
- 02範囲を限定したサンプルをローカル評価
- 03ルールごとに結果を集計
- 04ルール該当箇所を分類・調査
- 05誤検知を回帰テストに追加
- 06評価内容と成果物のパスを報告
活用シーン
- 01未コミットのReact Doctor変更をローカルで評価
- 02サンプルリポジトリでルール該当箇所を調査
- 03再実行で誤検知の修正を検証
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ millionco/ react-doctor --skill rde-evalインストール後、Claude Code で/rde-evalを入力して読み込まれたか確認します。
詳細
ローカルでルール評価を実行する
ローカルで反復作業を行う範囲を限定するには、React Doctor Evals(RDE)を使用します。run-parity は、変更を含むプルリクエストをプッシュした後にのみ使用してください。
両方のチェックアウトを準備する
export REACT_DOCTOR_CHECKOUT=/absolute/path/to/react-doctor
export RDE_CHECKOUT=/absolute/path/to/react-doctor-evals
git -C "$RDE_CHECKOUT" pull --ff-only
ni -C "$RDE_CHECKOUT"
nr -C "$RDE_CHECKOUT" build
nr -C "$REACT_DOCTOR_CHECKOUT" build
path: の指定は、コミット前の React Doctor の変更を読み込みます。RDE コマンドは評価用チェックアウトから実行してください。
範囲を限定したサンプルを実行する
cd "$RDE_CHECKOUT"
node dist/cli.js run "path:$REACT_DOCTOR_CHECKOUT" --runner local --take 100
node dist/cli.js digest "path:$REACT_DOCTOR_CHECKOUT" --rule <rule-id>
node dist/cli.js digest "path:$REACT_DOCTOR_CHECKOUT" --json --rule <rule-id> > <artifact-directory>/hits.json
テストと最初のサンプルが成功してから、--take の値を増やしてください。
対象ルールのヒットを確認する
各ヒットについて、または件数が多い場合は代表的なサンプルについて、次の手順を実行します。
- 報告された場所で固定済みのリポジトリを開きます。
- コードとルールの仕様を比較します。
- ヒットを真陽性、偽陽性、または未対応に分類します。
- 偽陽性ごとにルールの回帰テストを追加します。
- 確認済みの偽陽性を
fuzzの回帰コーパスに追加します。 - 再ビルドして、同じサンプルを再実行します。
リポジトリ数とプロジェクトルート数は別々に記録してください。エラーレコードを正常なスキャンとして扱わないでください。
結果を報告する
チェックアウトのリビジョン、対象ルール、リポジトリ数、プロジェクトルート数、診断、確認したヒット、修正した偽陽性、アーティファクトのパスを報告してください。セットアップエラーやスキップしたリポジトリがあれば、その内容も記載してください。
ローカルでの検証後は、rule-validate に戻ってください。プルリクエストとのパリティ確認を実行するかどうかは、そのスキルが判断します。
コメント
Markdown 対応