From one-off prompts to workflows: How to use custom agents in GitHub Copilot CLI

개요

GitHub Copilot CLI의 커스텀 에이전트 기능은 개발 팀의 스택과 워크플로우를 이해하여 반복적이고 검토 가능한 프로세스로 전환하는 것을 목표로 합니다.

주요 내용

* 커스텀 에이전트의 개념: 커스텀 에이전트는 Markdown 파일로 정의되며, 에이전트의 작동 방식, 사용할 수 있는 도구, 준수해야 할 표준, 생성해야 하는 출력 등을 명시하여 특정 작업에 맞춤화된 행동을 일관되게 수행합니다.
* 작동 방식: 커스텀 에이전트는 .github/agents 디렉토리에 생성된 Markdown 프로필 파일(.agent.md 확장자)을 통해 GitHub Copilot CLI에서 호출됩니다. 이 프로필에는 에이전트의 역할, 범위, 기능 및 가드레일이 정의됩니다.
* 활용 시나리오:
* 보안 감사 에이전트: 리포지토리 전반에 걸쳐 표준 보안 검사를 실행하고, 심각도별로 결과를 요약하며, PR(Pull Request) 준비된 체크리스트를 생성합니다.
* IaC(Infrastructure as Code) 컴플라이언스 에이전트: Terraform 계획 및 Kubernetes 매니페스트를 조직의 가드레일과 정책에 대해 검토하고, 위험한 변경 사항을 강조하며, 승인 준비가 된 요약본을 생성합니다.
* 릴리즈 문서 에이전트: 이전 릴리즈 이후 병합된 PR을 수집하고, 분류하며, 팀 스타일에 맞는 릴리즈 노트를 작성하고, CHANGELOG.md를 업데이트하며, 테스트, 마이그레이션, 롤아웃/롤백을 포함하는 짧은 릴리즈 체크리스트를 생성합니다.
* 인시던트 대응 에이전트: 서비스 이름과 시간 범위를 입력받아 최근 배포, 오류율, 상위 엔드포인트, 관련 로그 등 "첫 번째 관찰" 데이터를 수집하고, 팀 템플릿에 따라 인시던트 보고서를 작성하며, 다음 단계를 제안합니다.
* 오프더쉘프 에이전트 vs. 커스텀 에이전트 선택:
* 오프더쉘프 에이전트: 최소한의 설정으로 즉시 가치를 얻고 싶을 때, 특정 도구의 전문 지식에 의존하고 싶을 때, 파트너의 권장 사항에 따라 표준화하고 싶을 때, 여러 리포지토리에 걸쳐 반복되는 작업을 커버하고 싶을 때 사용합니다.
* 커스텀 에이전트: 팀의 작업 방식(명명 규칙, 검토 표준, 보안 검사 등)을 정의하고 싶을 때, 정확한 스택 및 내부 도구와 통합하고 싶을 때, 워크플로우의 "글루워크(glue work)"를 줄이고 싶을 때, 워크플로우를 코드처럼 버전 관리하고 발전시키고 싶을 때 사용합니다.
* 시작 방법: GitHub Copilot CLI를 설치하고, 반복하는 워크플로우부터 시작하여 에이전트로 만들어 일관성을 유지합니다. 파트너 에이전트를 먼저 사용하거나, PR 제목과 레이블로 CHANGELOG.md 항목을 생성하거나, 버그 보고서를 구조화된 이슈 댓글로 변환하는 등의 작은 커스텀 에이전트를 만들어 시작할 수 있습니다.

시사점

커스텀 에이전트는 팀의 지식을 산재된 메모와 일회성 프롬프트에서 벗어나, 팀이 신뢰할 수 있는 재사용 가능하고 구조화된 워크플로우로 전환함으로써 워크플로우 표준화를 돕습니다. 이는 에이전트가 실행 중인 환경에 따라 다르게 접근될 수 있는 작업에 특히 가치가 있으며, 도구 체인 전반에 걸쳐 컨텍스트 손실 없이 일관성을 유지하고, CLI에서 시작된 실행 집약적인 작업이 IDE를 거쳐 GitHub에서 검토 가능한 작업으로 이어지도록 지원합니다.