개발자로서 GitHub Copilot을 효과적으로 사용하는 방법

tag: ai, github, productivity, tools

tag: ai, github, productivity, tools

20분 동안 깜빡이는 커서를 응시하며 버그가 자신의 논리 문제인지 아니면 단순히 정신 상태의 문제인지 궁금해하고 있을 때입니다. 그러다 Ctrl+I를 누르고 필요한 내용을 반 문장으로 입력하자, GitHub Copilot이 몇 초 만에 작동하는 함수를 제공합니다. 그 순간은 마법이 아닙니다. 그것은 Copilot을 단순한 코드 생성기가 아니라, 바로 옆에 앉아 있는 고도로 숙련되고 상황 인지적인 주니어 개발자로 대우하는 결과입니다. 좌절감을 주는 도구와 생산성 증폭기 사이의 차이는 전적으로 어떻게 프롬프트(prompt)를 입력하느냐에 달려 있습니다.

Copilot을 검색 엔진처럼 취급하는 것을 멈추세요. 실제로 실행되는 결과를 원한다면, '요청하기'에서 '협업하기'로 사고방식을 전환해야 합니다. 오늘 GitHub Copilot을 가장 효과적인 개발 파트너로 만드는 방법을 알려드립니다.

컨텍스트(Context) 활용의 기술 마스터하기

Copilot은 추측하는 것이 아니라, 사용자가 제공한 데이터를 기반으로 예측합니다. 개발자들이 흔히 저지르는 실수는 '인접 탭(neighboring tabs)' 기능을 무시하는 것입니다. Copilot은 IDE에서 열려 있는 모든 파일을 처리하여 컨텍스트를 이해합니다 [7]. 만약 사용자 인증 기능을 만들고 있는데 database.py와 models.py가 닫혀 있다면, Copilot은 눈이 가리고 코드를 작성하고 있는 것과 같습니다.

실행 가능한 팁: 새로운 작업을 시작하기 전에, 그 작업과 관련된 모든 파일을 열어두세요. 다른 것은 모두 닫으세요. 관련 없는 컨텍스트는 모델의 주의 집중 범위(attention window)를 희석시킵니다 [2]. 백엔드 작업에서 프론트엔드 작업으로 전환할 때는 즉시 백엔드 파일을 닫으세요. 이 간단한 습관만으로도 인라인 제안의 정확도를 두 배로 높일 수 있습니다.

코드를 얻는 프롬프트 작성하기, 잡담은 피하기

일반적인 프롬프트는 일반적인 코드만을 산출합니다.

1. 목표 (Goal): 무엇을 달성하려고 합니까?
2. 제약 사항 (Constraints): 어떤 규칙을 따라야 합니까? (예: “async 사용”, “외부 라이브러리 사용 금지”, “null 처리”)
3. 예시 (Examples): 원하는 입출력 스타일을 모델에게 보여주세요 [1].

다음은 효과적으로 작동하는 프롬프트의 Python 예시입니다:

# REST API에서 사용자 데이터를 가져오는 async 함수를 작성하세요.
# 제약 사항:
# - 'asyncio'와 함께 'requests' 라이브러리를 사용하세요
...

이 정도 수준의 세부 정보를 제공하면, Copilot은 환각 (Hallucination)을 멈추고 엔지니어링을 시작합니다.

거대한 작업을 분해하기

만약 Copilot에게 “풀스택 이커머스 앱을 만들어줘”라고 요청한다면, 실패할 것입니다. 불완전한 파일들이 뒤엉킨 엉망진창인 결과물을 생성할 것입니다. 비결은 점진적 반복 (Incremental iteration) [2][6]에 있습니다. 큰 문제를 한 입 크기의 작은 조각으로 나누고 하나씩 해결하세요.

앱 전체를 요청하는 대신 다음과 같이 진행하세요:

1. 먼저 데이터베이스 스키마 (Database schema)를 요청합니다.
2. 상품을 생성하는 API 엔드포인트 (Endpoint)를 요청합니다.
3. 해당 엔드포인트에 대한 단위 테스트 (Unit test)를 요청합니다.

각각의 작은 성공이 다음 단계를 위한 컨텍스트 (Context)를 구축합니다. 만약 Copilot의 제안이 충분하지 않다면, 거절하고 처음부터 다시 시작하지 마세요. 더 많은 컨텍스트를 제공하거나 변경 사항을 구체적으로 명시하여 이를 개선하세요 [6]. 이러한 반복 루프 (Iterative loop)가 고품질의 유지보수 가능한 코드를 얻는 방법입니다.

단순히 수락하지 말고, 이해하세요

AI를 사용할 때 가장 큰 위험은 이해하지 못하는 코드를 맹목적으로 수락하는 것입니다. Copilot은 올바르게 보이지만 미묘한 보안 결함이나 성능 문제를 가진 솔루션을 제안할 수도 있습니다. 코드를 구현하기 전에 반드시 제안된 코드를 이해해야 합니다 [1].

Copilot Chat을 사용하여 코드를 설명하게 하세요. 코드 블록을 강조 표시하고 “이 함수가 무엇을 하는지, 그리고 왜 예외 케이스 (Edge cases)를 이런 방식으로 처리하는지 설명해줘”라고 물어보세요. 이를 통해 도구를 튜터 (Tutor)로 활용하여, 코드가 단순히 작동한다는 사실뿐만 아니라 왜 작동하는지를 배울 수 있습니다. 제안 내용이 확실하지 않다면, Copilot에게 다른 접근 방식으로 다시 작성해달라고 요청하세요 [1].

단축키와 피드백 루프 활용하기

속도가 중요합니다. Copilot은 인라인 코드 (inline code)에 대해 종종 여러 제안을 제공합니다. 수동으로 탭(tab) 키를 눌러 넘기는 대신, 키보드 단축키를 사용하여 빠르게 순환하며 확인하세요 [1]. VS Code에서는 Alt+\ (Windows) 또는 Option+\ (Mac)를 사용하여 제안 사이를 즉시 이동할 수 있습니다.

하지만 속도는 단순히 수락하는 것만을 의미하지 않습니다. 그것은 피드백에 관한 것입니다. 제안을 수락하거나 거절할 때, 여러분은 자신의 특정 워크플로 (workflow)에 맞춰 모델을 학습시키고 있는 것입니다. Copilot Chat에서 엄지 척 또는 엄지 아래 아이콘을 클릭하여 품질을 표시하세요 [1]. 이러한 피드백 루프 (feedback loop)는 여러분의 프로젝트에 특화된 향후 제안을 개선합니다.

슬래시 명령어(Slash Commands)와 변수 활용하기

Copilot Chat에서 단순히 평범한 영어만 입력하지 마세요. 슬래시 명령어 (slash commands)를 사용하여 문맥 (context)을 정확하게 정의하세요. Copilot이 특정 파일을 참조하기를 원한다면, @filename을 사용하거나 먼저 코드를 하이라이트(highlight) 하세요 [5]. 예를 들어:

@models.py User 클래스가 비밀번호 해싱 (password hashing)을 어떻게 처리하는지 설명해줘.

이렇게 하면 Copilot에게 어디를 살펴봐야 하는지 정확히 알려주어 모호함을 제거합니다. “이것(this)” 또는 “저것(that)”과 같은 모호한 용어는 모델을 혼란스럽게 만듭니다 [5]. “이게 뭐야?” 대신 “createUser 함수는 무엇을 하나요?”와 같이 명시적으로 질문하세요.

막혔을 때는 반복 시도하기

Copilot이 원하는 결과를 주지 않는다면, 화면을 멍하니 바라보며 시간을 낭비하지 마세요. 프롬프트 (prompt)를 다시 작성하세요. 요청 사항을 여러 개의 더 작은 프롬프트로 나누세요 [1]. 때로는 모델에 다른 관점이 필요할 뿐입니다. 먼저 코드 없이 상위 수준의 솔루션에 대한 개요를 작성해달라고 요청한 다음, 각 부분을 점진적으로 파고들어 보세요 [6]. 이러한 “계획 후 코딩 (plan then code)” 접근 방식은 최종 결과물을 즉시 요청하는 것보다 종종 더 나은 결과를 가져옵니다.

마치며: 당신은 설계자이고, Copilot은 빌더(Builder)입니다

GitHub Copilot은 당신을 대체하는 것이 아니라, 당신의 능력을 증폭시킵니다. 명확한 지침이 주어졌을 때, Copilot은 반복적인 코드, 테스트, 보일러플레이트 (boilerplate)와 같은 명확한 패턴을 처리하는 데 가장 뛰어납니다 [6]. 하지만 이를 가이드하기 위해서는 여러분의 전문 지식이 필요합니다. Copilot을 사용하여 기준점 (baseline)을 잡은 다음, 이를 수정, 검토 및 개선하세요.

Copilot을 통해 승리하는 개발자는 프롬프트 (prompt)를 가장 많이 입력하는 사람이 아닙니다. 그들은 가장 최상의 프롬프트를 작성하는 사람들입니다. 그들은 컨텍스트 (context)를 설정하고, 작업을 세분화하며, 반복 (iteration)을 멈추지 않습니다.

여러분의 차례입니다: 지금 바로 IDE를 여세요. 관련 없는 탭들은 닫으세요. 실제로 작업 중인 파일들을 여세요. 위에서 설명한 3단계 공식을 사용하여 구체적이고 제약 조건이 있는 프롬프트를 하나 작성해 보세요. 여러분의 작업 속도가 얼마나 빨라지는지 확인해 보시기 바랍니다.

완벽한 코드를 기다리는 것을 멈추세요. 여러분이 가졌던 최고의 파트너와 함께 구축을 시작하세요.

이 내용이 도움이 되었다면, 커피 한 잔을 후원해 주세요 ☕ — 여러분의 후원이 이 글들을 계속 발행할 수 있는 힘이 됩니다!

또한 저의 AI 도구 모음도 확인해 보세요: AI 次元世界 — 개발자를 위한 무료 AI 도구들입니다.