リポジトリスキャン結果を理解する

カテゴリスコアを確認し、傾向を追跡し、未解決の発見事項を閲覧し、ファイル散布図を使用します。

リポジトリのスキャンが完了すると、結果は次の場所に表示されます。 リポジトリ タブと、リポジトリの詳細ページに表示されます。これらの結果は 既存コード：最近の PR の変更だけでなく、コードベース全体にわたる未解決の品質問題です。

このガイドでは、スコアの読み方、指摘のトリアージ方法、ホットスポットの見つけ方を説明します。

リポジトリ概要

この リポジトリ タブには、接続済みのすべてのリポジトリが、4 つのカテゴリのスコアとともに一覧表示されます：

• 保守性: コードの変更や拡張がどれだけ容易か
• 可読性: 明瞭さ、命名、構成
• パフォーマンス: 効率性とリソース使用量
• 信頼性: 正確性、エラーハンドリング、バグを招きやすいパターン

各セルには、評価ラベル、色のインジケーター、数値が表示されます。ラベルはそのカテゴリで最も重大な未解決の指摘を示し、数値はそのカテゴリにある未解決の指摘の合計件数です。

この PR チェック 列は、 PR チェック がそのリポジトリで有効になっているかどうか（ON / OFF）を示します。PR チェックは 新しいコード のプルリクエストを対象とし、リポジトリスキャンは 既存コード フルリポジトリ全体を対象とします。これら 2 つは独立しているため、どちらか一方または両方を有効にできます。

追跡対象のリポジトリをクリックすると、詳細ページが開きます。

カテゴリ評価

各カテゴリの評価は、 最も重大な未解決の指摘 そのカテゴリ内に基づいており、総問題数ではありません。

評価	条件
優秀	低または情報レベルの指摘のみ（中以上はなし）
良好	少なくとも 1 件の中程度の指摘があるが、高または重大はない
普通	少なくとも 1 件の高い指摘があるが、重大はない
不良	少なくとも 1 件の重大な指摘がある

指摘は、それを引き起こしたルールに基づいてカテゴリにグループ化されます。既定およびカスタムの各チェックは、上記 4 つのカテゴリのいずれかに属します。低重大度の指摘は評価ラベルに影響しませんが、問題件数には含まれます。

時間経過による推移

〜を開いて 時間経過による推移 タブをリポジトリの詳細ページで開くと、未解決の指摘が週ごとにどう変化するかを確認できます。

このチャートは指摘を重大度ごとに分けて表示するため、重大・高・中・低優先度の品質負債が増えているのか減っているのかを確認できます。クリーンアップ作業の効果を測定し、対応が必要な回帰を見つけるのに役立ちます。

Issues タブ

この Issues タブは、リポジトリの詳細ページで、ルールごとにグループ化されたすべての未解決の指摘を一覧表示します。各行には次が表示されます：

• 種類: 影響を受けるファイルの言語
• 名前: ルール名と影響を受けるファイル
• 重大度: グループ内で最も高い重大度
• 場所: 問題が発生しているファイルパス
• 修正時間: 解決に必要と見込まれる工数

行をクリックすると、詳細サイドバーが開きます。そこから次のことができます：

• 〜を読む TL;DR と どう修正すればよいですか？ ガイダンス
• 参照 サブ問題 ファイル名、行番号、コードスニペット付きで
• 開く コード分析を表示 特定の発生箇所をより深く確認するために
• 個々の指摘を無視する

AutoFix で指摘を修正する

指摘を手作業で修正する代わりに、Aikido に変更を生成させることができます。 AutoFix は指摘に対する修正を生成し、その変更を含むプルリクエストを開くこともできるため、自分で書くのではなくレビューしてマージできます。

ファイル散布図

〜に切り替え ファイル散布図 タブで、コード品質のホットスポットを可視化します。つまり、頻繁に変更される一方で、未解決の品質負債を抱えるファイルです。

各点はリポジトリ内の 1 つのファイルを表します：

• X 軸: 過去 3 か月間にそのファイルに触れた PR の数
• Y 軸: そのファイル内の未解決のコード品質指摘数

グラフの 右上 にあるファイルがホットスポットです。アクティビティが高く、品質が低い状態です。リファクタリングやクリーンアップ作業を計画する際は、これらを優先してください。

散布図には 両方の モードが同じリポジトリで有効になっている必要があります： PR チェック 〜の 新しいコード アクティビティデータ、および〜のリポジトリスキャン 既存コード 指摘件数