Skip to main content

첫 번째 사용자 지정 지침

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

참고 항목

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

사용자 지정 정보

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

  •         **사용자 지정 지침**은 GitHub Copilot이 모든 상호 작용에서 어떻게 작동해야 하는지에 대한 지속적인 지침을 제공합니다.
    
  •         **프롬프트 파일(공개 미리 보기)** 은 필요할 때 호출할 수 있는 특정 작업에 대한 재사용 가능한 프롬프트를 정의합니다. 프롬프트 파일은 VS Code 및 JetBrains IDE에서만 사용할 수 있습니다. 입문 예제로는 [AUTOTITLE](/copilot/tutorials/customization-library/prompt-files/your-first-prompt-file)을 확인하세요.
    

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

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

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

첫 번째 지침

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이 함수를 생성하는 방식을 변경합니다.

테스트

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

  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
    

추가 참고 자료