# 리포지토리 백로그에서 코드 품질 결과 수정

리포지토리의 기본 브랜치에 있는 발견 사항에 대해 자동 수정을 생성하거나, 관련 없는 발견 사항을 무시합니다.

> \[!TIP]
> Code Quality이 처음이라면 리포지토리의 품질 점수를 검토하고 개선하는 방법을 단계별로 안내하는 [리포지토리의 코드 품질 점수 올리기](/ko/code-security/tutorials/improve-code-quality/raise-your-quality-rating?utm_campaign=code-quality-ga-july-2026\&utm_medium=docs\&utm_source=docs-fix-backlog-walkthrough-tip)을 참조하세요.

## 기본 브랜치에서 Code Quality가 작동하는 방식

Code Quality는 기본 브랜치를 검사하고 리포지토리의 <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-shield" aria-label="shield" role="img"><path d="M7.467.133a1.748 1.748 0 0 1 1.066 0l5.25 1.68A1.75 1.75 0 0 1 15 3.48V7c0 1.566-.32 3.182-1.303 4.682-.983 1.498-2.585 2.813-5.032 3.855a1.697 1.697 0 0 1-1.33 0c-2.447-1.042-4.049-2.357-5.032-3.855C1.32 10.182 1 8.566 1 7V3.48a1.75 1.75 0 0 1 1.217-1.667Zm.61 1.429a.25.25 0 0 0-.153 0l-5.25 1.68a.25.25 0 0 0-.174.238V7c0 1.358.275 2.666 1.057 3.86.784 1.194 2.121 2.34 4.366 3.297a.196.196 0 0 0 .154 0c2.245-.956 3.582-2.104 4.366-3.298C13.225 9.666 13.5 8.36 13.5 7V3.48a.251.251 0 0 0-.174-.237l-5.25-1.68ZM8.75 4.75v3a.75.75 0 0 1-1.5 0v-3a.75.75 0 0 1 1.5 0ZM9 10.5a1 1 0 1 1-2 0 1 1 0 0 1 2 0Z"></path></svg> Security and quality 탭에 있는 "\*\*\*\*" 페이지에 발견 사항을 보고합니다.
**두 가지 유형의 분석을 실행합니다**.

1. \*\*
   표준 결과
   \*\*: Code Quality는 CodeQL를 사용하여 기본 브랜치에 대해 결정적이고 규칙 기반의 검사를 수행합니다. 검사 결과는 규칙과 언어별로 그룹화되고, 심각도(**Error**, **Warning**, **Note**)로 레이블이 지정되며, 각 항목에는 제안된 자동 수정이 포함됩니다.

2. \*\*
   AI 결과
   \*\*: Code Quality AI 기반 분석을 사용하여 모범 사례, 명명 규칙 또는 디자인 고려 사항과 같이 규칙 기반 분석에서 검색할 수 없는 문제를 포함하여 가장 최근에 기본 분기에 푸시된 파일의 품질 문제를 식별합니다.

> \[!NOTE]
> 최근 변경된 파일용 "AI 결과" 페이지는 현재 공개 미리 보기 상태이며 변경될 수 있습니다.

해결에 대한 자세한 내용은 AI 결과을 [](/ko/code-security/how-tos/maintain-quality-code/fix-findings-in-recent-merges)참조하세요.

## 표준 발견 사항 해결

1. 리포지토리의 **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-shield" aria-label="shield" role="img"><path d="M7.467.133a1.748 1.748 0 0 1 1.066 0l5.25 1.68A1.75 1.75 0 0 1 15 3.48V7c0 1.566-.32 3.182-1.303 4.682-.983 1.498-2.585 2.813-5.032 3.855a1.697 1.697 0 0 1-1.33 0c-2.447-1.042-4.049-2.357-5.032-3.855C1.32 10.182 1 8.566 1 7V3.48a1.75 1.75 0 0 1 1.217-1.667Zm.61 1.429a.25.25 0 0 0-.153 0l-5.25 1.68a.25.25 0 0 0-.174.238V7c0 1.358.275 2.666 1.057 3.86.784 1.194 2.121 2.34 4.366 3.297a.196.196 0 0 0 .154 0c2.245-.956 3.582-2.104 4.366-3.298C13.225 9.666 13.5 8.36 13.5 7V3.48a.251.251 0 0 0-.174-.237l-5.25-1.68ZM8.75 4.75v3a.75.75 0 0 1-1.5 0v-3a.75.75 0 0 1 1.5 0ZM9 10.5a1 1 0 1 1-2 0 1 1 0 0 1 2 0Z"></path></svg> Security and quality** 탭으로 이동합니다.

2. **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-code-review" aria-label="code review" role="img"><path d="M1.75 1h12.5c.966 0 1.75.784 1.75 1.75v8.5A1.75 1.75 0 0 1 14.25 13H8.061l-2.574 2.573A1.458 1.458 0 0 1 3 14.543V13H1.75A1.75 1.75 0 0 1 0 11.25v-8.5C0 1.784.784 1 1.75 1ZM1.5 2.75v8.5c0 .138.112.25.25.25h2a.75.75 0 0 1 .75.75v2.19l2.72-2.72a.749.749 0 0 1 .53-.22h6.5a.25.25 0 0 0 .25-.25v-8.5a.25.25 0 0 0-.25-.25H1.75a.25.25 0 0 0-.25.25Zm5.28 1.72a.75.75 0 0 1 0 1.06L5.31 7l1.47 1.47a.751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018l-2-2a.75.75 0 0 1 0-1.06l2-2a.75.75 0 0 1 1.06 0Zm2.44 0a.75.75 0 0 1 1.06 0l2 2a.75.75 0 0 1 0 1.06l-2 2a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042L10.69 7 9.22 5.53a.75.75 0 0 1 0-1.06Z"></path></svg> 코드 품질** 을(를) 확장하려면 클릭하고, 그런 다음 **표준 결과** 을(를) 클릭합니다.

3. 대시보드 필터를 사용하여 품질 점수에 영향을 줄 가능성이 가장 큰 결과에 초점을 맞춥니다. 예를 들어 "안정성"에 대한 모든 "오류" 수준 결과를 보려면 필터를 다음으로 설정합니다.

   `is:open category:reliability severity:error`

4. 검색 결과는 규칙별로 그룹화됩니다. 규칙 이름을 클릭하여 해당 규칙에 대한 모든 결과를 자세히 볼 수 있습니다.

   !["표준 결과" 보기의 규칙을 보여 주는 스크린샷 규칙 이름이 진한 주황색으로 강조 표시됩니다.](/assets/images/help/code-quality/click-rule-name.png)

5. **자세히 표시**를 클릭한 다음 규칙의 설명, 권장되는 수정 사항, 코드 예제 및 참조를 검토합니다.

![코드 품질 규칙의 결과를 보여 주는 스크린샷 "자세히 표시" 텍스트가 진한 주황색으로 강조 표시됩니다.](/assets/images/help/code-quality/click-show-more.png)

1. 개별 찾기의 오른쪽에서 **수정 생성**을 클릭합니다.
2. 제안된 변경 내용의 차이 검토 동의하면 **끌어오기 요청 열기**를 클릭합니다.
3. "Commit autofix to branch" 대화상자에서 "풀 요청 열기(Open a pull request)"를 선택한 후 **변경 내용 커밋(Commit change)** 을 클릭합니다.
4. 자동 수정 풀 리퀘스트의 검토 준비가 완료되면 상태를 "Draft"에서 "Ready for review"로 변경하고, 병합하기 전에 CI 검사가 통과할 때까지 기다리세요.
5. 또는 발견이 관련이 없거나 실행 가능하지 않은 경우 **해제**를 클릭합니다. 예를 들어 레거시 코드에서 더 이상 유지 관리되지 않는 결과를 해제하거나, 팀의 코딩 표준에 알려진 예외이거나, 실제 품질 위험을 초래하지 않는 가양성인 경우를 해제할 수 있습니다.

유지 관리 가능성 또는 안정성 점수를 높이려면 현재 해당 메트릭에 영향을 주는 가장 높은 심각도 수준에서 모든 결과를 해결해야 합니다.
[메트릭 및 점수 참조](/ko/code-security/reference/code-quality/metrics-and-ratings)을(를) 참조하세요.

## 코드 품질 점수가 업데이트되었는지 확인

자동 수정 풀 리퀘스트가 병합된 후에는 "표준 결과" 보기로 돌아가 다음을 확인하세요.

* 발견 항목 수가 감소했습니다.
* 해당 메트릭에 대한 현재 최소 심각도 수준에서 모든 결과를 해결한 경우 유지 관리 가능성 또는 안정성 점수가 향상되었습니다.

## 다음 단계

* [최근에 병합된 파일에서 코드 품질 결과 수정](/ko/code-security/how-tos/maintain-quality-code/fix-findings-in-recent-merges)