[뉴스레터] GitHub Copilot 커스텀 에이전트: 우리 팀만의 개발 규칙을 코파일럿에 심는 법
페이지 정보
본문
12/3일 Github에서 발행한 기술블로그를 한글화 및 인사이트 정리하였습니다.
모든 개발팀에는 불문율이 있습니다. Terraform 모듈을 어떻게 구성할지, 어떤 대시보드를 신뢰할지, 데이터베이스 마이그레이션을 어떻게 처리할지(밤늦게는 절대 안 되죠!) 등등요. 그리고 우리의 일은 코드 에디터를 넘어 관측성, 보안, CI/CD, 수많은 서드파티 도구까지 넓게 펼쳐져 있습니다.
GitHub Copilot은 단순히 코드 작성만 돕는 도구가 아닙니다. 팀이 이미 쓰고 있는 도구, 플랫폼, 워크플로우를 그대로 활용하면서 전체 소프트웨어 개발 라이프사이클을 관리하도록 돕는 것이 목표죠. 그리고 이 '전체 워크플로우'를 코파일럿 안으로 가져오는 것이 바로 커스텀 에이전트입니다.
이 글에서는 GitHub Copilot에 새로 추가된 커스텀 에이전트가 무엇인지, 어떻게 우리 팀의 규칙을 학습시키고 활용할 수 있는지 자세히 살펴볼 거예요. 특히 다음 내용을 중심으로 알아볼 겁니다.
- "우리 팀만의 개발 규칙"을 코파일럿에 심는 법 - 마크다운 파일 하나로 만드는 도메인 전문가
- 관측성부터 보안, IaC까지, 파트너 에이전트로 실전 워크플로우 자동화 - Dynatrace, JFrog, Terraform 등
- 코파일럿 CLI, VS Code, github.com 어디서든 에이전트 활용하기 - 통합된 개발 경험의 확장
- 코드 일관성, 지식 공유, 도구 통합의 3가지 핵심 가치 - 왜 커스텀 에이전트가 우리 팀에 필요한가?
- 직접 커스텀 에이전트를 만들고 관리하는 방법 - .github/agents 디렉토리 활용
우리 팀만의 '도메인 전문가', 커스텀 에이전트란?
커스텀 에이전트는 특정 도메인에 특화된 지식을 가진 '마크다운 기반 전문가'라고 생각할 수 있습니다. 마치 팀에 JFrog 보안 전문가, PagerDuty 인시던트 대응자, MongoDB 성능 전문가가 새로 들어온 것처럼요. 이들은 우리 팀의 도구, 워크플로우, 표준을 이해하며 코파일럿이 작동하는 모든 곳에서 활약합니다.
- 코파일럿 CLI: 터미널에서 빠른 워크플로우 자동화
- VS Code: 코파일럿 챗을 통한 대화형 작업
- github.com: 코파일럿 패널에서 통합된 경험 제공
에이전트를 정의하는 방법은 간단합니다. YAML 프런트매터와 일반 마크다운으로 에이전트의 이름, 설명, 전문 분야를 지정하면 되죠.
---name: readme-specialistdescription: Expert at creating and maintaining high-quality README documentation---You are a documentation specialist focused on README files. Your expertise includes:- Creating clear, structured README files following best practices- Including all essential sections: installation, usage, contributing, license- Writing examples that are practical and easy to follow- Maintaining consistency with the project's tone and styleOnly work on README.md or documentation files—do not modify code files.이렇게 정의한 에이전트 파일을 저장소의 특정 디렉토리에 추가하면 즉시 활성화됩니다.
.github/agents/readme-specialist.md
그림 1. 코파일럿 CLI, VS Code, github.com에서 커스텀 에이전트가 활성화되는 모습
어디에 에이전트를 정의할 수 있나요?
커스텀 에이전트는 프로젝트의 특성과 사용 범위에 따라 다양한 레벨에서 정의할 수 있습니다.
- 저장소 레벨:
.github/agents/CUSTOM-AGENT-NAME.md에 추가하여 프로젝트 전용 워크플로우에 사용 - 조직/엔터프라이즈 레벨:
.github또는.github-private저장소의/agents/CUSTOM-AGENT-NAME.md에 추가하여 조직 전체에서 사용
파트너 에이전트로 실전 워크플로우에 AI 심기
커스텀 에이전트는 단순한 마크다운 파일이기 때문에, 파트너들이 제공하는 에이전트를 우리 저장소에 추가하는 것만으로 바로 활용할 수 있습니다. 현재 관측성, 보안, 데이터베이스, DevOps 등 다양한 분야에서 파트너 빌트 에이전트들이 제공되고 있어요.
60초 만에 파트너 에이전트 써보기
원하는 에이전트 마크다운 파일을 선택해 .github/agents/<agent-name>.agent.md 경로에 추가한 뒤, 아래 명령어로 즉시 활용할 수 있습니다.
- 코파일럿 CLI:
copilot --agent=<agent-name> --prompt ""<task>"" - VS Code Copilot Chat: 챗 패널에서 에이전트 선택 후 작업 지시
- github.com: 코파일럿 패널의 Agents 탭에서 에이전트 선택 후 작업 지시
주요 파트너 에이전트 예시는 다음과 같습니다.
- 관측성: Dynatrace Expert, Elasticsearch agent
- 보안: JFrog Security Agent, StackHawk Security Onboarding
- 데이터베이스: MongoDB Performance Advisor, Neon Migration Specialist, Neo4j Docker Client Generator
- DevOps & IaC: Terraform Agent, Arm Migration Agent, Octopus Release Notes Agent
- 인시던트 & 프로젝트 관리: PagerDuty Incident Responder, Monday Bug Context Fixer
- 자동화 & API: Apify Integration Expert, Factory.ai Code Spec Custom Agent
이제 몇 가지 실전 사례를 통해 에이전트의 강력함을 경험해 볼까요?
인시던트부터 보안, IaC까지: 커스텀 에이전트 실전 활용
파트너들이 제공하는 커스텀 에이전트들은 실제 개발 워크플로우에서 마주하는 복잡한 문제를 단 한 줄의 명령어로 해결할 수 있도록 돕습니다. 몇 가지 대표적인 활용 사례를 통해 그 위력을 확인해 보세요.
1. PagerDuty Incident Responder: 인시던트 신속 대응
copilot --agent=pagerduty-incident-responder \ --prompt ""Summarize active incidents and propose the next investigation steps.""PagerDuty 경고에서 컨텍스트를 가져와 현재 인시던트 상태를 명확히 요약하고, 다음 조사 단계를 제안하며, 팀을 위한 인시던트 업데이트 초안을 작성합니다.
2. JFrog Security Agent: 취약한 의존성 자동 수정
copilot --agent=jfrog-security \ --prompt ""Scan for vulnerable dependencies and provide safe upgrade paths.""취약한 패키지를 식별하고, 안전한 업그레이드 버전을 제공하며, 종속성 파일을 직접 패치하고, 명확한 보안 검토용 Pull Request 요약을 생성합니다.
3. Neon Migration Specialist: 데이터베이스 마이그레이션 및 최적화
copilot --agent=neon-migration-specialist \ --prompt ""Review this schema migration for safety and best practices.""스키마 변경을 검증하고, 위험한 마이그레이션을 방지하며, 분석 워크플로우를 튜닝하고, 쿼리 최적화를 돕습니다.
4. Amplitude Experiment Implementation: A/B 테스트 및 기능 롤아웃 가속화
copilot --agent=amplitude-experiment-implementation \ --prompt ""Integrate an A/B test for this feature and generate tracking events.""실험 스캐폴딩을 생성하고, 깔끔하고 일관된 이벤트 추적 코드를 삽입하며, 변형을 제품 로직에 매핑하고, 데이터가 Amplitude로 정확히 흘러가는지 확인합니다.
✨왜 커스텀 에이전트가 우리 팀에 꼭 필요한가?
커스텀 에이전트는 코파일럿이 단순히 "코드 작성"을 돕는 것을 넘어, "우리 팀이 소프트웨어를 만드는 방식"을 이해하고 지원하도록 만듭니다. 이는 개발 생산성과 팀워크에 다음과 같은 긍정적인 영향을 가져옵니다.
- 일관된 패턴 유지: Terraform 컨벤션, DB 규칙, 보안 표준 등 팀의 불문율을 코파일럿이 이해하고 자동으로 적용하여 코드 일관성을 높입니다.
- 반복적인 컨텍스트 전달 제거: 팀의 기대치를 한 번 정의하면 모든 곳에서 재사용되어 매번 컨텍스트를 설명할 필요가 없어집니다.
- 자동화된 전문 지식 공유: 특정 분야의 전문가가 휴가 중이거나 다른 시간대에 있더라도, 팀 전체가 최신 베스트 프랙티스를 따를 수 있도록 전문 지식을 자동으로 공유합니다.
- 도구와의 직접적인 연동: Model Context Protocol(MCP) 서버를 통해 DevOps, 보안, 관측성 시스템 등 기존 도구에서 직접 데이터를 가져와 작업합니다.
전체 파트너 에이전트 카탈로그
GitHub는 다양한 파트너들과 협력하여 실제 엔지니어링 문제를 해결하는 커스텀 에이전트들을 개발했습니다. 현재 제공되는 전체 카탈로그는 awesome-copilot 저장소에서 확인할 수 있습니다.
관측성 및 모니터링
- Dynatrace Observability and Security Expert: 애플리케이션 모니터링 구성 및 최적화
- Elasticsearch Remediation Agent: Elasticsearch 설정, 쿼리 최적화, 관측성 설정 지원
보안 및 규정 준수
- JFrog Security Agent: 의존성 취약점 식별 및 해결
- StackHawk Security Onboarding: 동적 애플리케이션 보안 테스트 설정
데이터베이스 및 데이터 관리
- MongoDB Performance Advisor: MongoDB 쿼리 성능 분석 및 최적화
- Neon Migration Specialist: Neon 서버리스 Postgres로 DB 마이그레이션
- Neo4j Docker Client Generator: Neo4j 그래프 DB용 Docker 클라이언트 코드 생성

그림 2. Neo4j Docker 클라이언트 생성 에이전트 작동 시연
DevOps 및 인프라
- Terraform Infrastructure Agent: Terraform IaC 작성, 검토 및 최적화
- Arm Migration Agent: Arm 기반 아키텍처로 애플리케이션 마이그레이션
- DiffBlue Java Unit Test Custom Agent: DiffBlue의 AI 기반 엔진으로 Java 유닛 테스트 자동 생성
인시던트 대응 및 프로젝트 관리
- PagerDuty Incident Responder: 프로덕션 인시던트 분류 및 대응
- Monday Bug Context Fixer: monday.com에서 컨텍스트를 가져와 버그 신속 해결

그림 3. Monday Bug Context Fixer가 monday.com 컨텍스트를 활용하는 모습
API 통합 및 자동화
- Apify Integration Expert: 웹 스크래핑 및 자동화 워크플로우 통합
- Factory.ai Code Spec Custom Agent: Droid CLI를 사용하여 CI/CD 파이프라인 개발 워크플로우 설치, 구성 및 자동화

그림 4. Factory.ai Code Spec 에이전트의 Droid CLI 자동화 시연
이 모든 에이전트를 다음과 같은 명령어로 실행할 수 있습니다.
copilot --agent=<agent-name> --prompt ""<task>""우리 팀의 개발 생산성을 한 단계 높이는 방법
GitHub Copilot 커스텀 에이전트는 단순히 코드를 넘어 우리 팀의 고유한 개발 방식을 이해하고 지원합니다. 팀의 규칙을 에이전트에 내재화하여 일관성을 유지하고, 전문가의 지식을 자동 공유하며, 모든 도구를 코파일럿 안에서 직접 연동할 수 있죠. 지금 바로 우리 팀에 맞는 에이전트를 만들어 보세요!
원문에서 더 알아보기 →