> 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-to/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.
