에이전트 기술 정보

에이전트 기술은 Copilot 코딩 에이전트, GitHub Copilot 명령 줄 인터페이스 (CLI) 및 Visual Studio Code 인사이더가 전문화된 작업을 수행하는 능력을 향상시킵니다.

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

Copilot 코딩 에이전트는 GitHub Copilot Pro, GitHub Copilot Pro(프로)+, GitHub Copilot Business,GitHub Copilot Enterprise 플랜과 함께 사용할 수 있습니다. 에이전트는 GitHub에 저장된 모든 리포지토리에서 사용할 수 있습니다. 단, 관리형 사용자 계정가 소유한 리포지토리에서는 에이전트가 명시적으로 비활성화되어 있습니다.

GitHub Copilot 명령 줄 인터페이스 (CLI)는 GitHub Copilot Pro, GitHub Copilot Pro(프로)+, GitHub Copilot Business,GitHub Copilot Enterprise 플랜과 함께 사용할 수 있습니다. 조직에서 Copilot을 수신하는 경우 조직의 설정에서 부조종사 CLI 정책을 활성화해야 합니다.
Sign up for Copilot

이 문서의 내용

에이전트 기술 정보

에이전트 스킬은 Copilot이(가) 특수 작업에서 성능을 향상시키기 위해 필요할 때 로드할 수 있는 지침, 스크립트 및 리소스의 모음입니다. 에이전트 기술은 다양한 에이전트에서 사용하는 개방형 표준입니다.

에이전트 기술은 Copilot 코딩 에이전트, GitHub Copilot 명령 줄 인터페이스 (CLI), 그리고 Visual Studio Code 인사이더의 에이전트 모드와 함께 작동합니다. VS Code 안정 버전에서의 지원은 곧 제공될 예정입니다.

Copilot이(가) 특정한 반복 가능한 방식으로 작업을 수행할 수 있도록 사용자 정의 능력을 만들거나, anthropics/skills 저장소나 GitHub의 커뮤니티가 만든 github/awesome-copilot 컬렉션에 공유된 능력을 사용할 수 있습니다.

Copilot는 다음을 지원합니다.

  • 리포지토리에 저장된 프로젝트 기술(.github/skills 또는 .claude/skills)
  • 개인 기술은 홈 디렉터리에 저장되며 프로젝트 간에 공유됩니다 (~/.copilot/skills 또는 ~/.claude/skills) (Copilot 코딩 에이전트 및 GitHub Copilot 명령 줄 인터페이스 (CLI) 전용)

조직 수준 및 엔터프라이즈 수준 기술에 대한 지원이 곧 제공될 예정입니다.

참고 항목

GitHub Copilot 명령 줄 인터페이스 (CLI)는 데이터 보호를 사용하여 공개 미리 보기 단계에 있으며 변경될 수 있습니다.

기술 만들기 및 추가

  1. 새 기술에 대한 하위 디렉터리를 만듭니다. 각 기술에는 자체 디렉터리(예: .github/skills/webapp-testing)가 있어야 합니다. 기술 디렉터리 이름은 소문자여야 하고, 공백에 하이픈을 사용하며, 일반적으로 name 프런트매터 SKILL.md 와 일치해야 합니다.

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

    개인 기술을 프로젝트 간에 공유하려면 ~/.copilot/skills 또는 ~/.claude/skills 아래에 저장하세요.

  2. 귀하의 기술 지침을 포함하는 SKILL.md 파일을 만드세요.

    참고 항목

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

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

  3. 필요에 따라 스크립트, 예제 또는 기타 리소스를 기술 디렉터리에 추가합니다. 예를 들어 여러 형식 간에 이미지를 변환하는 기술을 작성하는 경우 SVG 이미지를 PNG로 변환하기 위한 스크립트를 포함할 수 있습니다.

예제 SKILL.md 파일

프로젝트 기술의 경우 이 파일은 /path/to/repository/.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는 사용자의 프롬프트와 기술 설명을 기반으로 언제 기술을 사용할지 결정합니다.

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

기술 및 사용자 지정 지침

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

거의 모든 작업과 관련된 간단한 지침(예: 저장소의 코딩 표준 정보)에는 사용자 정의 지침을 사용하고, Copilot가 필요할 때 참조해야 하는 보다 자세한 지침에는 기술을 사용하는 것을 권장합니다.

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