> For the complete documentation index, see [llms.txt](https://help.aikido.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.aikido.dev/docs/docs-ja/kdo/repository-scans/understand-repository-scan-results.md).

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

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

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

## リポジトリの概要

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

* **保守性：** コードの変更や拡張のしやすさ
* **可読性：** 明確さ、命名、構造
* **パフォーマンス：** 効率とリソース使用量
* **信頼性：** 正確さ、エラー処理、バグを起こしやすいパターン

各セルには、評価ラベル、色のインジケーター、数値が表示されます。ラベルはそのカテゴリで最も深刻度の高い未解決の指摘を表し、数値はそのカテゴリの未解決指摘の総数です。

その **PRチェック** 列は、 [PRチェック](/docs/docs-ja/kdo/code-quality-setup.md) そのリポジトリで有効になっているか（**ON** / **OFF**）を示します。PRチェックは **新しいコード** に対するプルリクエストを対象とし、リポジトリスキャンは **既存のコード** リポジトリ全体を対象とします。両者は独立しているため、どちらか一方または両方を有効にできます。

<div data-with-frame="true"><figure><img src="/files/ab850adf680c0e8630ac0b72d0f059117adaed28" alt="Code Quality repositories table with category scores"><figcaption></figcaption></figure></div>

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

## カテゴリの評価

各カテゴリの評価は、そのカテゴリにおける **最も深刻度の高い未解決の指摘** に基づいており、総問題数ではありません。

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

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

## 経時的トレンド

次を開きます **経時トレンド** リポジトリ詳細ページのタブで、未解決の指摘が週ごとにどう変化するかを確認できます。

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

<figure><img src="/files/f1e54ebf422178329d95bb61fdf016f4399b535b" alt="Trend Over Time chart showing open code quality findings by severity"><figcaption></figcaption></figure>

## Issuesタブ

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

* **種類：** 影響を受けるファイルの言語
* **名前:** ルール名と影響を受けるファイル
* **深刻度：** グループ内で最も高い深刻度
* **場所：** 問題が発生しているファイルパス
* **修正時間：** 解決に必要と見積もられる作業量

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

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

### AutoFixで指摘を修正する

指摘を手作業で修正する代わりに、Aikidoに変更を生成させることができます。 [AutoFix](/docs/docs-ja/autofix-xiu-zheng/overview-aikido-autofix.md) は、その指摘の修正案を生成し、変更内容を含むプルリクエストを開くことができます。そのため、自分で書くのではなく、レビューしてマージするだけで済みます。

## ファイル散布図

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

<figure><img src="/files/6def69002c6e96a4e3beea51f54c11345658e46b" alt="File scatter plot showing PR activity vs open findings per file"><figcaption></figcaption></figure>

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

* **X軸：** 過去3か月にそのファイルに触れたPRの数
* **Y軸：** そのファイルにある未解決のコード品質指摘の数

チャートの **右上** にあるファイルがホットスポットです。更新頻度が高く、品質が低いものです。リファクタリングやクリーンアップ作業を計画する際は、これらを優先してください。

{% hint style="info" %}
散布図には **両方** のモードを同じリポジトリで有効にする必要があります： [PRチェック](/docs/docs-ja/kdo/code-quality-setup.md) 〜のための **新しいコード** アクティビティデータには、そしてリポジトリスキャンには **既存のコード** 指摘件数のための
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.aikido.dev/docs/docs-ja/kdo/repository-scans/understand-repository-scan-results.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
