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

최근에 병합된 코드에 대한 결과를 GitHub Code Quality에서 탐색하고, Copilot Autofix으로 수정하거나 Copilot 클라우드 에이전트에게 수정 작업을 위임합니다.

누가 이 기능을 사용할 수 있나요?

쓰기 권한이 있는 사용자

GitHub Team 또는 GitHub Enterprise Cloud

이 기사에서

참고

GitHub Code Quality은(는) 현재 공개 미리 보기에 있으며 변경될 수 있습니다. 공개 미리 보기에서 Code Quality은(는) 요금이 청구되지 않지만 Code Quality 스캔은 GitHub Actions 분을 소모합니다.

소개

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

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

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

          Code Quality 끌어오기 요청 및 품질 문제에 대한 주석을 검색한 다음 끌어오기 요청이 병합된 후 **두 번째 AI 검사를 실행** 합니다. 두 가지 유형의 검사는 보완 기술을 사용합니다.

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

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

필수 조건

  •         Code Quality 가 활성화되어 있습니다. [AUTOTITLE](/code-security/code-quality/how-tos/enable-code-quality)을 참조하세요.
  • 활성화된 이후 Code Quality 하나 이상의 끌어오기 요청이 병합되었습니다.

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

          Code Quality 기본 분기에서 최근에 병합된 파일을 검색한 후 보기 아래에서 **AI 결과** 결과를 볼 수 있으며, 이 보기는 최대 5 파일에 대한 결과를 표시합니다.
  1. 리포지토리의 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> 코드 품질** 를 확장하려면 클릭한 다음 **AI 결과** 를 클릭합니다.

참고

리포지토리가 비활성 상태이거나 LLM 분석에서 기본 분기에 대한 최근 푸시에서 코드 품질을 개선하는 방법을 제안할 수 없는 경우 이 보기는 비어 있습니다.

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

          **
          AI 결과
          ** 페이지에서 각 파일은 식별된 품질 문제 수와 파일이 기본 분기로 푸시된 시기와 함께 나열됩니다.
  • 검색된 품질 문제 및 제안된 수정 사항에 대한 세부 정보를 보려면 파일 이름을 클릭합니다.

코드 품질에 대한 "AI 결과" 보기의 스크린샷

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

끌어오기 요청을 열어 제안된 자동 수정을 파일에 적용하거나 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/cloud-agent/track-copilot-sessions)을(를) 참조하세요.

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

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

  • 끌어오기 요청을 열기 전에 로컬에서 작업하거나 GitHub Desktop에서 변경 내용을 작업하려고 합니다.
  • 에 대한 액세스 권한이 없습니다. Copilot 클라우드 에이전트

참고

끌어오기 요청을 직접 열면 한 번에 하나의 파일에만 수정 사항을 커밋할 수 있습니다. 한 번에 여러 파일을 수정하려면 .를 사용해야 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>를 클릭하여 **** 기본 옵션을 "끌어오기 요청 열기"로 변경합니다. 기본 설정이 기억됩니다.

    코드 품질에 대한 "AI 결과" 보기의 스크린샷

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

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

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

코드 변경을 제안하는 이유에 대한 컨텍스트를 제공하는 것이 팀 구성원이 끌어오기 요청을 검토하도록 권장하는 가장 좋은 방법입니다. 사용한 Copilot 클라우드 에이전트경우 끌어오기 요청 요약에는 끌어오기 요청에 의해 해결된 문제에 대한 전체 세부 정보가 이미 포함되어 있습니다.

뷰에서 GitHub Code Quality 직접 끌어오기 요청을 연 경우 끌어오기 요청 요약은 "AI 결과" 보기에 연결됩니다. 보기의 AI 결과 설명 중 일부를 풀 리퀘스트 요약에 복사하는 것을 고려할 수 있습니다.

GitHub Code Quality에서 만든 풀 리퀘스트 요약의 스크린샷.

5. 변경 내용이 영향을 주는지 확인 AI 결과

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

다음 단계

  • 개발 작업을 신속하게 수행하는 데 도움이 되는 방법에 Copilot 클라우드 에이전트 대해 자세히 알아봅니다. GitHub Copilot 사용하여 작업에 대한 모범 사례을(를) 참조하세요.
  •         GitHub Code Quality에 대해 [커뮤니티 토론](https://github.com/orgs/community/discussions/177488)에서 피드백을 제공합니다.