> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudthinker.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Extensions

> イシュートラッカーとの連携でコードレビューにコンテキストを追加する

Extensions は、イシュートラッカーを CloudThinker のコードレビューエージェントに接続します。エージェントが MR/PR の説明やブランチ名にイシューへの参照を検出すると、リンクされたチケットの詳細を自動的に取得し、レビュー時のコンテキストとして活用します。これにより、コードの変更が要件を満たしているかどうかを検証できます。

***

## 利用可能な Extensions

### Jira / Confluence

Jira チケットの詳細と Confluence の仕様をコードレビューに直接取り込み、エージェントがすべての変更の背後にあるビジネス要件を理解できるようにします。

**仕組み：** レビューエージェントが MR/PR の説明内に Jira または Confluence のリンクを検出すると、チケットの詳細（サマリー、受け入れ条件、リンクされたページ）を自動的に取得し、そのコンテキストを使ってコードの変更が要件を満たしているかを検証します。

**トリガー条件：**

| パターン                    | 例                                                       |
| ----------------------- | ------------------------------------------------------- |
| 説明内の Jira URL           | `https://myorg.atlassian.net/browse/OPS-1234`           |
| 説明内の Confluence ページ URL | `https://myorg.atlassian.net/wiki/spaces/.../pages/...` |
| 説明またはブランチ名のチケットキー       | `OPS-1234`                                              |

**必要条件：** [Atlassian 接続](/ja/guide/connections/atlassian)

***

### GitHub Issues

GitHub イシューのコンテキストをコードレビューに取り込み、プルリクエストがリンクされたイシューの要件に対応しているかどうかをエージェントが検証できるようにします。

**仕組み：** レビューエージェントが PR の説明またはブランチ名にイシューへの参照を見つけると、イシューの詳細（タイトル、本文、ラベル、コメント）を取得し、それらの要件に対してコードの変更をレビューします。

**トリガー条件：**

| パターン            | 例                                          |
| --------------- | ------------------------------------------ |
| PR 説明のイシューキーワード | `Closes #123`、`Fixes #456`、`Resolves #789` |
| 説明内のイシュー参照      | `#123`                                     |

<Note>コードレビューのプロバイダーとして GitHub が設定されている場合のみ表示されます。</Note>

***

### GitLab Issues

GitLab イシューのコンテキストをコードレビューに取り込み、マージリクエストがリンクされたイシューの要件に対応しているかどうかをエージェントが検証できるようにします。

**仕組み：** レビューエージェントが MR の説明またはブランチ名にイシューへの参照を見つけると、イシューの詳細（タイトル、説明、ラベル、コメント）を取得し、それらの要件に対してコードの変更をレビューします。

**トリガー条件：**

| パターン            | 例                                          |
| --------------- | ------------------------------------------ |
| MR 説明のイシューキーワード | `Closes #123`、`Fixes #456`、`Resolves #789` |
| 説明内のイシュー参照      | `#123`                                     |

<Note>コードレビューのプロバイダーとして GitLab が設定されている場合のみ表示されます。</Note>

***

## セットアップ

<Steps>
  <Step title="イシュートラッカーを接続する">
    **Workspace Settings** > **Connections** に移動し、対象のサービス（[Atlassian](/ja/guide/connections/atlassian)、GitHub、または GitLab）を接続します
  </Step>

  <Step title="Extensions ページを確認する">
    **Code Review** > **Extensions** に移動し、接続状態が「Connected」と表示されていることを確認します
  </Step>

  <Step title="MR/PR にイシュー参照を含める">
    MR/PR の説明にイシューリンクまたはチケットキーを追加します。レビューエージェントが自動的に検出します — 追加の設定は不要です。
  </Step>
</Steps>

***

## エージェントによるイシューコンテキストの活用

コードレビューエージェントがイシュー参照を検出すると：

1. **取得** — チケットまたはイシューの詳細（タイトル、説明、受け入れ条件、ラベル、コメント）を取得します
2. **検証** — コードの変更が記載された要件を満たしているかどうかを確認します
3. **フラグ** — 受け入れ条件に基づいて、実装が不足または不完全な箇所を指摘します
4. **参照** — レビューの検出結果にチケットのコンテキストを引用し、要件とコードのつながりを示します

これは完全に自動的です — 最初の接続設定以外のコマンドや設定は不要です。

***

## ヒント

* **MR/PR の説明にリンクを含めてください** — エージェントは説明とブランチ名を参照のためにスキャンします。コンテキストが多いほどレビューの質が向上します。
* **受け入れ条件が重要です** — 明確な受け入れ条件を持つ構造化された Jira チケットは、コードの変更を検証するための最も強いシグナルをエージェントに与えます。
* **複数の参照がサポートされています** — 関連するチケットやイシューをいくつでもリンクできます。エージェントはすべてを取得します。

***

## 関連情報

<CardGroup cols={2}>
  <Card title="Code Review セットアップ" icon="gear" href="/ja/guide/code-review/setup">
    リポジトリのコードレビューを設定する
  </Card>

  <Card title="コンベンションルール" icon="book" href="/ja/guide/code-review/convention-rules">
    CloudThinker がコードでチェックする内容をカスタマイズする
  </Card>
</CardGroup>
