참고 항목
GitHub Code Quality은(는) 현재 공개 미리 보기에 있으며 변경될 수 있습니다. 공개 미리 보기에서 Code Quality은(는) 요금이 청구되지 않지만 Code Quality 스캔은 GitHub Actions 분을 소모합니다.
Understanding why your pull request is blocked
Repository administrators can set code quality gates for maintainability and reliability using GitHub Code Quality. When you open a pull request, a scan automatically runs to check your changes against these standards.
If your pull request introduces code that falls below the required quality threshold, you’ll see a merge block banner at the bottom of the pull request in the Checks section: "Merging is blocked: Code quality findings were detected."
These checks help maintain a healthy, maintainable codebase and prevent technical debt from accumulating.
Viewing scan results and their severity levels
The results of the scan are reported as comments on your pull request, left by the github-code-quality[bot]. Each comment corresponds to a specific code quality problem that was detected in your changes.
Comments are labeled by severity (Error, Warning, Note). To learn more about what the severity levels mean, see Severity levels.
Determining which findings are blocking your pull request
The quality gate set by repository administrators defines the minimum severity level that will block merging.
The merge block banner may specify the minimum severity level. All findings at that severity level or higher must be addressed before you can merge your pull request.
참고 항목
If you don't see a severity level defined in the merge block banner, it means that your repository is using the most stringent code quality thresholds, which require all findings to be addressed before merging.
Fixing or dismissing each finding
In order to unblock your pull request, you need to resolve each required finding by deciding whether to fix the issue in your code or dismiss the comment.
Leveraging 코파일럿 자동 수정 and Copilot 코딩 에이전트 to fix findings
코파일럿 자동 수정
풀 리퀘스트에 대한 코멘트에는 풀 리퀘스트에 직접 커밋할 수 있는 제안된 자동 수정이 포함됩니다. 논리, 보안 및 스타일에 대해 제안된 자동 수정을 신중하게 검토한 다음 제안 적용을 클릭합니다.
이러한 제안을 적용하는 데는 Copilot 라이선스가 필요 없습니다.
Copilot 코딩 에이전트
또는 Copilot 라이선스가 있는 경우 수정 작업을 Copilot 코딩 에이전트에 위임할 수 있습니다. 풀 리퀘스트에 @Copilot을(를) 언급하는 주석을 달고, Copilot이 감지된 문제를 해결해달라고 요청합니다.
Copilot는 댓글에 눈 이모티콘(👀)으로 응답한 후, 새 에이전트 세션을 시작하고 필요한 수정 사항이 포함된 끌어오기 요청을 엽니다.
Copilot 코딩 에이전트의 작업을 추적할 수 있습니다.
- 끌어오기 요청에서 작업이 진행됨에 따라 요약이 업데이트됩니다.
-
[에이전트 페이지](https://github.com/copilot/agents?ref_product=copilot&ref_type=engagement&ref_style=text) 또는 세션 로그를 사용하여 [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/track-copilot-sessions)을 참조하세요.
Copilot 라이선스를 사용하여 Copilot 코딩 에이전트을(를) 호출해야 합니다.
Copilot에 등록
Dismissing the finding
코드베이스의 컨텍스트에서 관련이 없거나 실행 가능하지 않은 경우 찾기를 해제할 수 있습니다. 발견을 기각하는 일반적인 이유는 다음과 같습니다.
- 발견은 더 이상 유지 관리되지 않는 레거시 코드에 있습니다.
- 이는 팀의 코딩 표준에 대한 알려진 예외입니다.
- 실제 품질 위험을 초래하지 않는 오탐입니다.
관련 없는 경고를 해제하면 품질 검사를 의미 있는 문제에 집중할 수 있습니다.
Verifying that you've met the requirements
To see if you've met the code quality requirements, look at the "Checks" section at the bottom of your pull request. The merge block banner should no longer be present, and you should be able to merge your changes as usual.
Next steps
Reduce technical debt by fixing findings in recently changed files. See Improving the quality of recently merged code with AI.