GitHub Copilot 명령 줄 인터페이스 (CLI)용 에이전트 기술 생성

특정 작업을 수행할 때 Copilot의 동작과 기능을 수정합니다.

이 기사에서

에이전트 기술은 Copilot가 관련될 때 로드하여 특정 작업에서 성능을 향상시킬 수 있는 지침, 스크립트 및 리소스가 포함된 폴더입니다. 자세한 내용은 에이전트 기술에 대하여을(를) 참조하세요.

기술 만들기 및 추가

에이전트 기술을 만들려면 SKILL.md 파일을 작성하고, 필요에 따라 지침에서 참조할 수 있는 추가 Markdown 파일이나 스크립트 같은 다른 리소스를 추가 작성합니다.

기술을 추가하려면 SKILL.md 파일과 추가 리소스를 Copilot이(가) 기술을 찾을 수 있는 위치에 저장해야 합니다. 리포지토리 내에 있거나 홈 디렉터리 내에 있을 수 있습니다.

  1.        `skills` 기술 및 앞으로 만들고자 하는 다른 기술을 저장할 디렉터리를 만드십시오.

    단일 리포지토리에 특화된 프로젝트 기술의 경우, 기술을 .github/skills 또는 .claude/skills 아래에 저장하십시오.

    프로젝트 간에 공유될 수 있는 개인 기술은 ~/.copilot/skills 또는 ~/.claude/skills에 저장하세요.

  2. 새 기술에 대한 하위 디렉터리를 만듭니다. 각 기술에는 자체 디렉터리(예: .github/skills/webapp-testing)가 있어야 합니다.

    기술 하위 디렉터리 이름은 소문자여야 하며 공백에 하이픈을 사용해야 합니다.

  3. 기술 하위 디렉터리에서 기술 지침이 SKILL.md 포함된 파일을 만듭니다.

    중요

    기술 파일의 이름을 지정 SKILL.md해야 합니다.

           `SKILL.md` 파일은 YAML 프런트매터가 있는 Markdown 파일입니다. 가장 간단한 형식으로 다음을 포함합니다.
    • YAML Frontmatter * 이름 (필수): 기술에 대한 고유 식별자입니다. 공백에 하이픈을 사용하는 소문자여야 합니다. 일반적으로 기술 디렉터리의 이름과 일치합니다. * 설명 (필수): 기술이 수행하는 작업 및 Copilot에서 사용해야 하는 경우에 대한 설명입니다. * 라이선스 (선택 사항): 이 기술에 적용되는 라이선스에 대한 설명입니다.
    • Copilot가 따를 지침, 예시 및 가이드라인을 포함한 마크다운 본문입니다.

  4. 필요에 따라 스크립트, 예제 또는 기타 리소스를 기술 디렉터리에 추가합니다.

    예를 들어 여러 형식 간에 이미지를 변환하는 기술을 작성하는 경우 SVG 이미지를 PNG로 변환하기 위한 스크립트를 포함할 수 있습니다. 기술 지침은 Copilot에게 이러한 리소스를 언제 그리고 어떻게 사용할지 알려야 합니다.

예제 SKILL.md 파일

          **프로젝트 능력**의 경우 이 파일은 리포지토리의 디렉터리에 위치하게 됩니다`.github/skills/github-actions-failure-debugging`.

          **개인 스킬**의 경우 이 파일은 `~/.copilot/skills/github-actions-failure-debugging` 디렉터리에 위치합니다.
Markdown
---
name: github-actions-failure-debugging
description: Guide for debugging failing GitHub Actions workflows. Use this when asked to debug failing GitHub Actions workflows.
---

To debug failing GitHub Actions workflows in a pull request, follow this process, using tools provided from the GitHub MCP Server:

1. Use the `list_workflow_runs` tool to look up recent workflow runs for the pull request and their status
2. Use the `summarize_job_log_failures` tool to get an AI summary of the logs for failed jobs, to understand what went wrong without filling your context windows with thousands of lines of logs
3. If you still need more information, use the `get_job_logs` or `get_workflow_run_logs` tool to get the full, detailed failure logs
4. Try to reproduce the failure yourself in your own environment.
5. Fix the failing build. If you were able to reproduce the failure yourself, make sure it is fixed before committing your changes.

에이전트 기술 사용

작업을 수행할 때, Copilot는 사용자의 프롬프트와 기술 설명을 기반으로 언제 기술을 사용할지 결정합니다.

Copilot가 기술을 사용하기로 선택하면, SKILL.md 파일이 에이전트의 컨텍스트에 주입되어 에이전트가 사용자의 지침에 접근할 수 있습니다. 그런 다음 이러한 지침을 따르고 기술 디렉터리에 포함할 수 있는 스크립트 또는 예제를 사용할 수 있습니다.

Copilot에게 특정 기술을 사용하도록 지시하려면, 프롬프트에 기술 이름 앞에 슬래시를 붙여 포함합니다. 예를 들어 "frontend-design"이라는 기술이 있는 경우 다음과 같은 프롬프트를 사용할 수 있습니다.

Use the /frontend-design skill to create a responsive navigation bar in React.

CLI의 기술 명령

  •         **현재 사용 가능한 기술을 나열** 합니다. 명령 `/skills list` 또는 프롬프트를 사용합니다.

    What skills do you have?

  •         **특정 기술을 사용하거나 사용하지 않도록 설정합니다** . 명령을 `/skills` 사용한 다음 키보드의 위쪽 및 아래쪽 키와 스페이스바를 사용하여 기술을 켜거나 끕니다.

  • 기술(해당 위치 포함)에 대해 자세히 알아보세요. 명령을 /skills info사용합니다.

  •         **기술 위치 추가: 기술을** 저장할 대체 위치를 추가하려면 명령을 `/skills add`사용합니다.

  •         **기술 다시 로드:** CLI 세션 중에 기술을 추가한 경우 CLI를 다시 시작할 필요가 없도록 명령을 `/skills reload` 사용하여 기술을 추가할 수 있습니다.

  •         **기술 제거:** 플러그 인을 통해서가 아니라 직접 추가한 기술을 제거하려면 명령을 `/skills remove SKILL-DIRECTORY`사용합니다. 플러그 인의 일부로 추가된 기술을 제거하려면 플러그 인 자체를 관리해야 합니다. 
        `info` 하위 명령을 사용하여 기술이 제공된 플러그 인을 확인합니다.

기술 및 사용자 지정 지침

기술과 사용자 정의 지침을 모두 사용하여 Copilot에게 저장소에서 작업하는 방법과 특정 작업을 수행하는 방법을 가르칠 수 있습니다.

거의 모든 작업에 관련되어 있는 간단한 지침에 대해서는 사용자 지정 지침을 사용하는 것이 좋으며(예: 리포지토리의 코딩 표준에 대한 정보), Copilot가 관련 있을 때만 사용하는 보다 자세한 지침에 대해서는 기능을 활용하는 것이 좋습니다.

리포지토리 사용자 지정 지침에 대한 자세한 내용은 GitHub Copilot 대한 리포지토리 사용자 지정 지침 추가을 참조하세요.

기술이 다른 사용자 지정 기능과 어떻게 다른지에 대한 자세한 내용은 GitHub Copilot CLI 사용자 지정 기능 비교을 참조하세요.