제목
카테고리
프로그래밍/소프트웨어 개발
서브카테고리
개발 툴
대상자
- 소프트웨어 개발자 (특히 GitHub Copilot 사용자)
- 난이도: 중간 (구체적인 설정과 사용 팁 포함)
핵심 요약
.github/copilot-instructions.md
파일은 모든 채팅 상호작용의 컨텍스트를 제공하며, 프로젝트별 지침을 명확히 정의해야 함.- Ask Mode로 아이디어를 브레인스토밍하고, Agent Mode로 구현 단계별로 점진적인 개발을 수행해야 함.
- 프리미엄 요청 제한을 피하기 위해 단일 주제/스토리별로 새로운 채팅 시작과 불필요한 파일 캔슬이 필수적.
섹션별 세부 요약
1. `.github/copilot-instructions.md` 파일의 역할
- Copilot은 이 파일이 존재할 경우 자동으로 읽음.
- 프로젝트의 기본 지침을 정의하고, 구체적인 조건은 Copilot이 오류를 보일 때 추가.
- 예: "코드 변경 전 목표 요약", "사용자가 코드베이스에 익숙하지 않다는 가정" 명시.
2. Agent Mode 사용 전략
- Ask Mode로 요구사항 정의, Agent Mode로 구현 단계별 작업.
- 점진적 개발: 계획 → 검증 → 실행 순서로 진행.
- 예시: "보안 인증 구현" 시 JWT 토큰 발급, 오류 처리 포함.
3. 요청 제한 관리 및 최적화 팁
- 프리미엄 요청이 빠르게 누적되므로, 사용자 확인 요청을 강제.
- VS Code에서 불필요한 파일 닫기로 Copilot 집중도 향상.
- History 버튼으로 이전 세션 복구 가능.
4. 지침 설정 시 주의사항
- 과도한 지침은 Copilot 혼란 유발, 단계적 추가 필요.
- 프로젝트 설명, Tech Stack, Code Style 명시 시 효과적.
- DO/NOT DO 예시를 포함해 명확한 코드 가이드 제공.
5. Copilot의 이상 행동 대응
- 의도치 않은 수정 시 일시 중지 후 플랜 설명 요청.
- 설명이 합리적 → 계속, 비합리적 → 재설정 또는 지침 수정.
- 자체 생성 지침을 요청해 프로젝트 맞춤형 지시문 작성 권장.
결론
.github/copilot-instructions.md
파일을 활용해 명확한 지침 정의하고, Ask/Agent Mode 분리하여 작업 효율성 극대화.- 프리미엄 요청 제한을 피하기 위해 단일 작업별 채팅 생성과 불필요한 컨텍스트 제거가 핵심.
- Copilot의 혼란 시 일시 중지 및 플랜 설명 요청으로 문제 해결.