AI를 사용하여 최근에 병합된 코드의 품질 향상

소개

이 자습서에서는 최근에 기본 브랜치에 병합된 코드의 품질 문제를 Code Quality의 AI 기반 분석을 통해 탐색하고 수정하는 방법을 보여 줍니다.

최근에 병합된 파일의 품질을 향상하면 리포지토리의 기술 문제를 줄이고 다른 개발자가 활성 개발 중인 파일을 더 쉽게 작업할 수 있습니다.

Code Quality에는 두 개의 방어선이 있습니다.

Code Quality는 끌어오기 요청을 스캔하여 품질에 대한 우려 사항을 주석으로 남기고, 끌어오기 요청이 병합된 후 두 번째 AI 검사를 실행합니다. 두 가지 유형의 검사는 보완 기술을 사용합니다.

•           **풀 리퀘스트 스캔**은 CodeQL 규칙을 사용하여 문제를 식별합니다. 이 분석은 철저히 테스트되고 코드가 품질 규칙과 일치하지 않는 위치를 파악하는 데 능숙하며 많은 파일을 분석할 수 있습니다. 그러나 코딩 언어의 하위 집합을 지원하며 규칙이 없는 문제를 식별할 수 없습니다.
  

•         **최근에 병합된 파일 검사는** 대용량 언어 모델을 사용하여 가장 최근에 변경된 파일을 분석하고 최대 5 파일에 대한 결과를 보고합니다. 이 분석은 규칙에 의해 제한되지 않고 모든 언어에서 코드를 검사하고 CodeQL 규칙에서 제공하는 것 이상으로 확장할 수 있는 컨텍스트 인사이트 및 제안을 제공합니다.
  

필수 조건

• Code Quality가 활성화되어 있습니다. GitHub Code Quality를 활성화합니다.을 참조하세요.
• Code Quality을(를) 사용하도록 설정한 이후, 하나 이상의 끌어오기 요청이 병합되었습니다.

1. 리포지토리에 대한 AI 제안 보기

최근에 병합된 파일을 기본 분기에서 Code Quality 스캔한 후, AI 결과 보기에서 결과를 확인할 수 있습니다. 이 보기에서는 최대 5 파일에 대한 결과를 표시합니다.

1. 리포지토리의 "보안" 탭으로 이동합니다.

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> 코드 품질** 를 확장하려면 클릭한 다음 **AI 결과** 를 클릭합니다.
   

2. 리포지토리에 대한 제안된 개선 사항 살펴보기

          **AI 결과** 페이지에서 각 파일은 식별된 품질 문제 수와 파일이 기본 분기로 푸시된 시점과 함께 나열됩니다.

• 검색된 품질 문제 및 제안된 수정 사항에 대한 세부 정보를 보려면 파일 이름을 클릭합니다.

3. 수정 작업 위임 또는 끌어오기 요청 직접 열기

제안된 자동 수정 사항을 파일에 적용하기 위해 풀 리퀘스트를 열거나, 수정 작업을 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)을(를) 참조하세요.
  

사용자 고유의 끌어오기 요청 열기

끌어오기 요청을 직접 생성하여 자동 수정 제안을 적용할 수 있습니다. 다음 경우에 가장 적합한 옵션입니다.

• 끌어오기 요청을 열기 전에 변경 내용을 로컬에서 또는 GitHub Desktop에서 작업하고 싶습니다.
• Copilot 코딩 에이전트에 대한 액세스 권한이 없습니다.

끌어오기 요청 열기

1. 검색된 품질 문제의 세부 정보를 보려면 파일 이름을 클릭합니다.

2. 문제 및 제안된 수정 사항을 검토합니다.

3.           **Copilot** 드롭다운에 할당을 확장한 다음 <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-git-pull-request" aria-label="Pull request" role="img"><path d="M1.5 3.25a2.25 2.25 0 1 1 3 2.122v5.256a2.251 2.251 0 1 1-1.5 0V5.372A2.25 2.25 0 0 1 1.5 3.25Zm5.677-.177L9.573.677A.25.25 0 0 1 10 .854V2.5h1A2.5 2.5 0 0 1 13.5 5v5.628a2.251 2.251 0 1 1-1.5 0V5a1 1 0 0 0-1-1h-1v1.646a.25.25 0 0 1-.427.177L7.177 3.427a.25.25 0 0 1 0-.354ZM3.75 2.5a.75.75 0 1 0 0 1.5.75.75 0 0 0 0-1.5Zm0 9.5a.75.75 0 1 0 0 1.5.75.75 0 0 0 0-1.5Zm8.25.75a.75.75 0 1 0 1.5 0 .75.75 0 0 0-1.5 0Z"></path></svg> **풀 리퀘스트를 열어** 기본 옵션을 "풀 리퀘스트 열기"로 변경합니다. 기본 설정이 기억됩니다.
   

   

4.        **끌어오기 요청 열기**를 클릭하여 커밋 옵션 대화 상자를 엽니다.
   

5.        **변경 내용 커밋**을 클릭하여 수정 사항이 포함된 풀 리퀘스트를 만듭니다.
   

4. 끌어오기 요청 검토자에게 컨텍스트를 제공하십시오.

코드 변경을 제안하는 이유에 대한 컨텍스트를 제공하는 것이 팀 구성원이 끌어오기 요청을 검토하도록 권장하는 가장 좋은 방법입니다. Copilot 코딩 에이전트를 사용하면 끌어오기 요청 요약에 해당 요청으로 해결된 문제에 대한 상세 정보가 이미 포함됩니다.

GitHub Code Quality 보기에서 직접 끌어오기 요청을 열었다면 끌어오기 요청 요약은 “AI 결과” 보기로 연결됩니다. AI 결과 보기의 설명 중 일부를 풀 리퀘스트 요약에 복사해 사용할 수 있습니다.

5. 변경 사항이 AI 결과에 영향을 미치는 것을 확인하세요.

끌어오기 요청을 병합한 후 "AI 결과" 보기로 돌아가면 수정한 결과가 더 이상 나열되지 않습니다.

다음 단계

• Copilot 코딩 에이전트가 개발 작업을 빠르게 수행하는 데 어떻게 도움이 되는지 자세히 알아보세요. GitHub Copilot을 사용하여 작업을 수행하는 방법에 대한 모범 사례을(를) 참조하세요.
• 커뮤니티 토론에서 GitHub Code Quality와 관련해 피드백을 제공하세요.