일회성 프롬프트에서 워크플로우로: GitHub Copilot CLI에서 커스텀 에이전트를 사용하는 방법

개발자는 CLI, IDE, GitHub 등 다양한 환경에서 작업하며 반복적인 명령 실행이나 컨텍스트 설명에 시간을 소모하곤 합니다. GitHub Copilot CLI의 커스텀 에이전트(Custom Agents) 기능을 활용하면 이러한 번거로움을 줄이고, 팀의 고유한 스택과 표준을 반영한 재사용 가능한 워크플로우를 구축할 수 있습니다.

커스텀 에이전트는 Markdown 파일로 정의되는 Copilot 에이전트로, 일반적인 답변을 넘어 에이전트의 역할, 사용 가능한 도구, 준수해야 할 표준 및 출력 형식을 구체적으로 지정할 수 있습니다. 예를 들어, 단순히 코드를 정리하는 것을 넘어 팀의 포매팅 규칙, 접근성(Accessibility) 표준, 보안 요구사항을 모두 적용한 전문 에이전트를 만들 수 있습니다.

에이전트 프로필은 저장소 내 .github/agents 디렉토리에 .agent.md 파일로 저장됩니다. 이를 통해 팀원들은 에이전트를 검토하고 버전 관리를 할 수 있으며, CLI에서 정의한 워크플로우를 IDE와 Pull Request 단계까지 일관되게 적용할 수 있습니다.

커스텀 에이전트 설정 방법:

• Copilot CLI에서 /agent 명령어를 사용하여 에이전트 호출
• 대상 저장소의 .github/agents 디렉토리에 YAML 프론트매터가 포함된 Markdown 파일 생성
• 에이전트의 역할, 범위, 기능 및 가드레일을 정의하여 일관된 동작 보장