Skip to main content

첫 번째 사용자 지정 지침

이 간단한 예시를 사용하여 첫 번째 사용자 지정 지침을 만들고 테스트합니다.

참고 항목

  • 이 라이브러리의 예시는 영감을 얻기 위한 것입니다. 프로젝트, 언어, 팀 프로세스에 더 구체적으로 맞게 조정하는 것이 좋습니다.
  • 특정 언어 및 시나리오에 대한 사용자 지정 지침의 커뮤니티 기여 예시는 우수한 GitHub Copilot 사용자 지정 리포지토리를 참조하세요.
  • 사용자 지정 지침을 만드는 플랫폼 또는 IDE에 따라 다양한 범위에서 사용자 지정 지침을 적용할 수 있습니다. 자세한 내용은 "GitHub Copilot Chat 응답 사용자 지정 정보"을(를) 참조하세요.

사용자 지정 정보

두 가지 유형의 파일을 사용하여 GitHub Copilot의 응답을 사용자 지정할 수 있습니다.

  • 사용자 지정 지침은 GitHub Copilot이 모든 상호 작용에서 어떻게 작동해야 하는지에 대한 지속적인 지침을 제공합니다.
  • 프롬프트 파일(공개 미리 보기) 은 필요할 때 호출할 수 있는 특정 작업에 대한 재사용 가능한 프롬프트를 정의합니다. 프롬프트 파일은 VS Code에서만 사용할 수 있습니다. 소개 예시는 첫 번째 프롬프트 파일을(를) 참조하세요.

사용자 지정 지침은 각 AI 워크플로에 컨텍스트를 추가하는 데 도움이 되지만 프롬프트 파일을 사용하면 특정 채팅 상호 작용에 지침을 추가할 수 있습니다.

가장 일반적으로 사용되고 지원되는 것은 리포지토리 사용자 지정 지침이지만, GitHub의 GitHub Copilot 채팅에 대해서만 개인 및 조직 사용자 지정 지침을 정의할 수도 있습니다. 다음 두 가지 방법으로 리포지토리 사용자 지정 지침을 만들 수 있습니다.

  • 리포지토리 전체 지침: 리포지토리의 모든 파일에 적용되는 단일 copilot-instructions.md 파일을 리포지토리 루트에 만듭니다.
  • 경로 특정 지침: 특정 파일 또는 디렉터리에만 적용되는 applyTo 필드를 사용하여 하나 이상의 .instructions.md 파일을 만듭니다. 현재 Visual Studio Code 및 GitHub Copilot 코딩 에이전트에서의 Copilot Chat 에서는 경로 특정 지침이 지원됩니다.

첫 번째 지침

GitHub Copilot이 코딩 기본 설정을 이해하는 데 도움이 되는 핵심 사용자 지정 지침부터 시작해 보세요.

함수 작성 지침

Markdown
When writing functions, always: - Add descriptive JSDoc comments - Include input validation - Use early returns for error conditions - Add meaningful variable names - Include at least one example usage in comments 

이 지침은 GitHub Copilot이 함수를 생성하는 방식을 변경합니다.

테스트

사용자 지정 지침이 가져올 수 있는 차이점을 빠르게 테스트하려면 Copilot Chat의 몰입형 보기에서 개인 사용자 지정 지침을 사용할 수 있습니다.

  1. 먼저, github.com/copilot으로 이동하여 이 프롬프트를 입력하세요.

    Create a JavaScript function that calculates the area of a circle

    사용자 지정 지침이 없으면 다음과 같은 결과가 발생할 수 있습니다.

    function areaOfCircle(radius) { if (typeof radius !== 'number' || radius < 0) { throw new Error('Radius must be a non-negative number'); } return Math.PI * radius * radius; } 
  2. 이제 페이지 왼쪽 하단에 있는 프로필 사진을 클릭하고 Personal instructions를 클릭하여 개인 사용자 지정 지침에 액세스하세요. 위의 지침을 텍스트 상자에 붙여넣은 다음, Save를 클릭합니다.

    이제 이전에 입력한 것과 동일한 프롬프트를 입력합니다.

    사용자 지정 지침을 사용하면 다음과 같은 결과를 받게 됩니다.

    /** * Calculates the area of a circle given its radius. * * @param {number} radius - The radius of the circle. Must be a positive number. * @returns {number|null} The area of the circle, or null if the input is invalid. * * @example * // returns 78.53981633974483 * areaOfCircle(5); * * @example * // returns null (invalid input) * areaOfCircle(-2); */ function areaOfCircle(radius) { if (typeof radius !== "number" || isNaN(radius) || radius <= 0) { // Invalid input: radius must be a positive number return null; } const area = Math.PI * Math.pow(radius, 2); return area; } // Example usage: console.log(areaOfCircle(5)); // 78.53981633974483 console.log(areaOfCircle(-2)); // null 

추가 참고 자료