> ## 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 연결](/ko/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](/ko/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="/ko/guide/code-review/setup">
    저장소의 코드 리뷰를 구성합니다
  </Card>

  <Card title="컨벤션 규칙" icon="book" href="/ko/guide/code-review/convention-rules">
    CloudThinker가 코드에서 검사하는 내용을 커스터마이즈합니다
  </Card>
</CardGroup>