Markdown 기반 Custom Agent 도입을 통한 CLI 워크플로우 표준화 및 컨텍스트 파편화 해결

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

Natalie Guevara2026년 6월 9일16분intermediate

AI 요약

Context

단발성 Prompt 기반의 CLI 인터랙션으로 인한 반복적인 컨텍스트 입력과 팀별 표준 미준수 문제 발생. 도구 간 전환 과정에서 발생하는 정보 손실 및 실행 일관성 부족이 주요 병목 지점으로 작용.

Repository 내 .github/agents 경로에 Markdown 파일 기반의 Agent Profile을 정의하여 기술적 표준 및 가드레일 명시
YAML Frontmatter를 통한 Agent의 역할, 접근 가능 Tool, 모델 설정의 선언적 정의 구조 채택
CLI에서 /agent 커맨드를 통한 특정 도메인 전문가(Custom Agent) 호출 및 실행 컨텍스트 일관성 확보
Git 버전 관리 시스템 내 Agent Profile을 포함시켜 팀 전체의 워크플로우 리뷰 및 동기화 메커니즘 구현
단순 텍스트 생성을 넘어 gh, semgrep, trivy 등 실제 시스템 Tool과 연동되는 Execution-heavy 워크플로우 설계
CLI-IDE-GitHub으로 이어지는 도구 체인 전반에 걸쳐 동일한 Agent 정의를 공유하는 Context Continuity 구조 구축

실천 포인트

1. 반복되는 터미널 작업 중 정형화된 Tool 조합이 필요한 태스크 식별

2. `.agent.md` 파일 내에 팀의 코딩 표준 및 보안 가드레일을 명시적으로 정의

3. Agent가 접근할 Tool 리스트를 최소화하여 실행 예측 가능성 및 보안성 확보

4. 작성된 Agent Profile을 PR 리뷰 프로세스에 포함시켜 팀 내 지식 공유 및 최적화 수행

태그