test-coverage-improver

テストカバレッジ改善

現在のカバレッジの根拠を使って、呼び出し元から見える振る舞いのテストに不足がないかを特定します。カバレッジ測定、カバレッジ指標の悪化、またはカバレッジ成果物からの不足箇所の発見には、このワークフローを選択してください。ユーザーがすでにテストする振る舞いを指定している場合、測定も依頼されていない限り、通常の実装／レビューのワークフローを使用してください。テストの追加だけでは、このスキルや最後の pnpm test:coverage の実行は必要になりません。

スコープと権限

評価または提案のみを求められた場合は、編集せずに不足箇所と推奨テストを報告してください。ユーザーがテストの改善を依頼した場合、または計画を承認した場合は、対象のテストを実装し、再度確認を求めることなくレビューと検証を完了してください。新たな契約上の判断、スコープの拡大、または追加の権限が必要な場合に限り、確認してください。カバレッジ作業によって、実際の API 呼び出しや、より広範なサンドボックスへのアクセスが許可されることはありません。

ワークフロー

1. 現在の coverage/coverage-summary.json または coverage/coverage-final.json、coverage/lcov.info、および記録されているコマンド／環境の根拠を確認してください。対象のソースとテストの状態を反映している場合に限り、再利用してください。存在しない場合や古くなっている場合は、リポジトリの検証用サンドボックスと認証情報のポリシーに従って pnpm test:coverage を実行してください。この初回測定は実装レビューに先立って行います。広範な測定を行う前に、ホストの容量に関する指針を確認してください。
2. 依頼されたスコープ内で、カバレッジされていない振る舞いを特定してください。割合だけを目標とするより、公開されている振る舞いや、意味のあるエラー、キャンセル、ライフサイクルの経路を優先してください。不足箇所の特定には、JSON レポート、coverage/lcov.info、または coverage/lcov-report/index.html を使用してください。テストは該当する packages/<pkg>/test/ ディレクトリに配置してください。
3. 評価の場合は、根拠と提案するシナリオを報告してください。実装が承認されている場合は、独立した期待結果を設定できる、最も制御しやすい呼び出し元の境界でテストを選択してください。ヘルパーのロジックを単に再現するテストや、サポートされていない組み合わせを列挙するテストは追加しないでください。
4. テストを実装し、影響を受けるチェックを実行して、$implementation-final-review を完了してください。反復検証の対象を絞り、レビューが完了する前にカバレッジ測定を繰り返さないでください。
5. レビューが問題なく完了したら、最終測定として pnpm test:coverage を実行し、必要な SDK ゲートとして $code-change-verification を実行してください。これらは目的が異なるため、有効な最終測定がすでにあれば再利用し、繰り返さないでください。カバレッジの変化、検証した振る舞い、残っている重要な不足箇所を報告してください。

報告

カバレッジの根拠が対象とするスコープと、その鮮度、各新規テストが保護する振る舞い、検証結果、未解決の不足箇所を明記してください。コメントとコードは英語のままにしてください。カバレッジ率だけを正しさの証拠として扱わないでください。