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

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

기술 만들기 및 추가

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

기술을 추가하려면 SKILL.md 파일 및 모든 보조 리소스를 Copilot 기술을 찾아야 하는 위치에 저장합니다. 리포지토리 내에 있거나 홈 디렉터리 내에 있을 수 있습니다.

```
       `skills` 지원되는 위치 중 하나에 디렉터리를 만들어 현재의 스킬뿐만 아니라 나중에 만들고자 하는 스킬까지 저장할 수 있습니다.
```
단일 리포지토리에 특정된 프로젝트 기술에 대해, 리포지토리에서 .github/skills 또는 .claude/skills 또는 .agents/skills 디렉터리를 만들고 사용하십시오.

프로젝트 간에 공유되는 개인 기술의 경우, 홈 디렉터리에 ~/.copilot/skills, ~/.claude/skills, 또는 ~/.agents/skills 디렉터리를 만들고 사용하세요.
새 기술에 대한 하위 디렉터리를 만듭니다. 각 기술에는 자체 디렉터리(예: .github/skills/webapp-testing)가 있어야 합니다.

기술 하위 디렉터리 이름은 소문자여야 하며 공백에 하이픈을 사용해야 합니다.
기술 하위 디렉터리에서 기술 지침이 SKILL.md 포함된 파일을 만듭니다.

중요

기술 파일의 이름을 지정 SKILL.md해야 합니다.
```
       `SKILL.md` 파일은 YAML 프런트매터가 있는 Markdown 파일입니다. 가장 간단한 형식으로 다음을 포함합니다.
```
- YAML Frontmatter * 이름 (필수): 기술에 대한 고유 식별자입니다. 공백에 하이픈을 사용하는 소문자여야 합니다. 일반적으로 기술 디렉터리의 이름과 일치합니다. * 설명 (필수): 기술이 수행하는 작업 및 사용해야 하는 시기에 Copilot 대한 설명입니다. * 라이선스 (선택 사항): 이 기술에 적용되는 라이선스에 대한 설명입니다.
- Markdown 본문에는 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.

---
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 기술 디렉터리의 모든 파일을 자동으로 검색하고 기술의 지침과 함께 사용할 수 있게 합니다. 즉, 기술 디렉터리에 스크립트 또는 기타 리소스를 포함하고 지침에서 SKILL.md 참조할 수 있습니다.

스크립트를 실행하는 기술을 만들려면 다음을 수행합니다.

       **기술 디렉터리에 스크립트를 추가합니다.** 예를 들어 SVG 이미지를 PNG로 변환하는 기술에는 다음과 같은 구조가 있을 수 있습니다.

.github/skills/image-convert/
├── SKILL.md
└── convert-svg-to-png.sh

```
       **필요에 따라 기술에 필요한 도구를 미리 승인합니다.** 
       `SKILL.md` 프런트매터의 `allowed-tools` 필드를 사용하여 Copilot 사용자가 매번 확인하지 않고도 사용할 수 있는 도구를 나열할 수 있습니다. 도구가 필드에 `allowed-tools` 나열되지 Copilot 않은 경우 사용하기 전에 사용 권한을 묻는 메시지가 표시됩니다.
```
```
---
name: image-convert
description: Converts SVG images to PNG format. Use when asked to convert SVG files.
allowed-tools: shell
---
```
경고

이 기술 및 참조된 스크립트를 검토하고 그 출처를 완전히 신뢰하는 경우에만 shell 또는 bash 도구를 미리 승인하십시오. 터미널 명령을 실행하기 shell 위한 확인 단계를 사전 승인하거나 bash 제거하며, 공격자가 제어하는 기술 또는 프롬프트 삽입이 사용자 환경에서 임의의 명령을 실행하도록 허용할 수 있습니다. 의심스러운 경우 allowed-tools에서 shell 및 bash을 생략하여 Copilot가 터미널 명령을 실행하기 전에 명시적인 확인을 요청하도록 해야 합니다.

       **스크립트를 사용하는 방법을 Copilot에게 알려주는 지침을 작성합니다.** Markdown 본문에서 `SKILL.md`의 스크립트를 실행할 때와 방법을 설명합니다.

When asked to convert an SVG to PNG, run the `convert-svg-to-png.sh` script
from this skill's base directory, passing the input SVG file path as the
first argument.

에이전트 기술 사용

작업을 수행할 때, 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 사용자 지정 기능 비교을 참조하세요.