본문으로 건너뛰기

커뮤니티

팁 운영진 번역

GitHub Copilot 공식 문서: 코딩 AI에게 더 좋은 답을 받는 프롬프트 작성법

리퀘오 운영팀

GitHub 공식 문서 「GitHub Copilot 프롬프트 엔지니어링」 글을 한국어로 옮겼습니다. Copilot 기준으로 쓰였지만 Claude Code·Codex·Cursor 같은 다른 코딩 AI에도 거의 그대로 통하는 내용입니다.

프롬프트는 Copilot에게 하는 요청입니다. 질문을 하거나, 할 일을 설명하거나, 이어서 완성할 코드를 줄 수 있습니다. Copilot은 프롬프트와 함께 현재 파일의 코드, 대화 기록 같은 맥락을 보고 답을 만듭니다. 아래 요령은 IDE, CLI, GitHub 웹사이트 등 어디서 쓰든 공통으로 적용됩니다.

1. 넓게 시작하고, 점점 구체적으로

먼저 목표나 상황을 크게 설명하고, 그다음 구체적인 요구 사항을 나열하세요. 가장 중요한 요구는 앞에 둡니다. Copilot은 프롬프트의 처음과 끝에 있는 지시를 더 무겁게 봅니다.

예시)
숫자가 소수인지 알려 주는 JavaScript 함수를 작성해 줘.
함수는 정수를 받아 소수이면 true를 돌려준다.
입력이 양의 정수가 아니면 오류를 낸다.

2. 예시를 주세요

입력 예시, 출력 예시, 구현 예시를 주면 원하는 바를 훨씬 잘 이해합니다.

예시)
문자열에서 날짜를 모두 찾아 배열로 돌려주는 Go 함수를 작성해 줘. 날짜는 05/02/24, 05/02/2024, 5/2/24, 05-02-2024, 5-2-24 같은 형식일 수 있다.
findDates("11/14/2023에 치과 예약, 12-1-23에 독서 모임") → ["11/14/2023", "12-1-23"]

단위 테스트도 좋은 예시가 됩니다. 함수를 쓰기 전에 Copilot으로 테스트를 먼저 만들고, 그 테스트를 통과하는 함수를 작성하게 해 보세요.

3. 복잡한 일은 작은 일로 나누세요

큰 작업은 작고 단순한 단계로 쪼개 하나씩 요청하세요. 예를 들어 '단어 찾기 퍼즐을 만들어 줘' 대신 이렇게 나눕니다.
- 10×10 글자 격자를 만드는 함수
- 단어 목록이 주어졌을 때 격자 안의 단어를 모두 찾는 함수
- 앞의 두 함수로 단어가 10개 이상 들어 있는 격자를 만드는 함수
- 그 격자와 격자 속 단어 10개를 출력하도록 고치기

4. 모호한 말을 피하세요

'이거 뭐 하는 거야?'에서 '이거'는 현재 파일일 수도, 직전 답변일 수도, 특정 코드 블록일 수도 있습니다. 대신 이렇게 물어보세요.
- createUser 함수는 무엇을 하나요?
- 방금 답변의 코드는 무엇을 하나요?

라이브러리도 마찬가지입니다. 잘 알려지지 않은 라이브러리라면 무엇을 하는 것인지 설명하고, 특정 라이브러리를 쓰게 하려면 파일 맨 위에 import 문을 두거나 이름을 밝히세요.

규칙은 메타 지시가 아니라 직접 쓰세요. '항상 JSON으로 돌려주는 것을 기억해' 대신 '결과를 JSON으로 돌려줘'라고 씁니다.

5. 관련 맥락을 주세요

- IDE 코드 자동완성: 관련 파일은 열고, 관련 없는 파일은 닫으세요. 열린 파일을 맥락으로 씁니다.
- IDE·웹의 채팅: 참고할 코드를 선택하고, @로 파일·이슈·풀 리퀘스트·저장소를 붙이세요. /fix, /tests 같은 슬래시 명령을 지원하는 IDE도 있습니다.
- Copilot CLI: @경로로 파일을, #번호로 이슈·PR을 붙입니다. 반복해서 쓸 저장소 맥락은 .github/copilot-instructions.md, 경로별 지침 파일, AGENTS.md 같은 사용자 지침 파일에 넣으세요.
- 클라우드 에이전트(작업을 맡기는 방식): 저장소와 기준 브랜치를 고르고 목표·완료 조건·관련 파일을 적으세요. 화면이 중요하면 스크린샷이나 시안을 붙입니다. 오래 유지할 지침은 저장소 지침 파일에 둡니다.

6. 실험하고 다듬으세요

원하는 결과가 안 나오면 프롬프트를 고쳐 다시 시도하세요. 제안을 통째로 지우고 다시 시작해도 되고, 남겨 둔 채 수정을 요청해도 됩니다. 채팅에서는 직전 답변을 짚어 다음 요청을 하거나, 그 답변을 지우고 새로 시작할 수 있습니다.

7. 대화 기록을 관련 있게 유지하세요

대화형 도구는 지난 대화를 맥락으로 씁니다.
- 새 작업을 시작할 때는 새 대화·새 세션을 여세요.
- 지원된다면 더는 관련 없는 대화는 지우거나 되돌리세요. 예를 들어 Copilot CLI는 새 세션 시작, 세션 삭제, /undo·/rewind로 이전 프롬프트로 되돌리기를 지원합니다.

8. 결과를 검토하세요

AI가 만든 코드와 답변은 동료의 작업을 검토하듯 평가하고, 시험하고, 정확한지 확인한 뒤에 쓰세요.

9. 기존 코드부터 좋은 습관을 지키세요

코드베이스에 대해 묻는데 답이 시원찮다면 기존 코드가 읽기 쉬운지 먼저 보세요. 일관된 스타일과 패턴, 설명적인 변수·함수 이름, 주석, 작고 범위가 분명한 모듈, 단위 테스트가 있으면 답도 좋아집니다. 이런 정리 자체를 Copilot에게 맡겨도 됩니다(주석 달기, 큰 함수 나누기 등).

여러분이 코딩 AI에 자주 쓰는 프롬프트 요령이 있다면 댓글로 나눠 주세요. 써 보고 좋았던 프롬프트는 '프롬프트 공유' 글로 올려도 좋습니다.

---
출처: GitHub Docs 「GitHub Copilot 프롬프트 엔지니어링」 (GitHub, Inc. 및 기여자)
https://docs.github.com/en/copilot/concepts/prompting-and-context/prompt-engineering
라이선스: CC BY 4.0 https://creativecommons.org/licenses/by/4.0/deed.ko
변경 사항: 리퀘오 운영팀이 한국어로 번역하고, 일부 축약·재구성했습니다(예시 문장 한국어화, 블로그 참고 링크 생략). 원문 작성자가 이 번역을 보증하지 않습니다.

로그인하면 누를 수 있습니다. 로그인하면 저장하고 새 답글 알림을 받을 수 있습니다.

답글 0

아직 답글이 없습니다.