「チェック」とは、単一の検証を指します。チェックは単一の検証を指します。 「実行履歴」とは、実行履歴とは、ポリシーに基づき変更内容に対してチェックを実施した一回分の結果を指します。 「検出結果」とは検出結果とは、チェックによって報告される事象を指します。
これらは「品質 → 実行履歴」および品質 → 実行履歴と「品質 → 検出結果」で確認できます。品質 → 検出結果.
実行履歴の確認方法
実行履歴には各チェックの結果と出力内容が記載されています。検証に失敗した場合、その原因を把握するには実行履歴を確認します。
上から順に確認してください。最初に失敗したチェックが本当の原因であることが多いです。ビルドエラーに続いて12件のテストエラーが発生した場合、それは1つの問題であり13個の問題ではありません。
検出結果
検出結果はレビューエージェント、スキャナー、アドバイザリーゲートから生成されます。各検出結果には発見された内容、場所、重大度が記載されています。
そのライフサイクルは以下の通りです：
- 作成済みチェックまたはレビューアーによって作成されます。
- 割り当て済み修正可能な検出結果は再作業として開発者エージェントに戻され、それ以外はpull requestに添付されます。
- 解決済み修正済み、承認済み、または無視済みの状態です。
分類作業
各検出結果に対する問いは「これは真実か？」ではなく「これが次の工程に影響を与えるか？」です。
- 今すぐ修正正確性やセキュリティなど、レビューで却下される可能性のある問題です。
- 承認事実ではあるが、今回は対応する必要がない問題です。その理由を記録してください。
- 無視誤検知であるか、またはこのコードには該当しないルールです。
無視する場合は必ず理由を明記してください。理由の明記されていない無視は、不都合な事実を隠す行為と変わりません。数ヶ月後にはどちらだったか誰にも判断できなくなります。
検出結果が多すぎる場合
検出結果の量はコード品質ではなく設定に関するシグナルです。
ほとんどの変更でチェックが発動する場合、それは問題を発見しているのではなくコードベースの特性を表しています。ルールが既存の規約に合致しないか、または容認している技術的負債であるかのどちらかです。いずれにせよ、そのチェックの設定が適切でないことを意味します。
検出結果とゲート
アドバイザリーゲートによる検出結果は参考情報です。一方、ブロッキングゲートによる同じ検出結果はタスクの進行を停止させます。検出結果自体は同一ですが、ポリシーによって影響が決まるのです。
チェックが正しいが厳格すぎる場合に使うべき手段は、チェック自体を削除するのではなく重大度を変更することです。詳しくは品質ポリシーとゲート.