한 줄로 GitHub Copilot을 한국어로 바꾼 이야기

배경

안녕하세요, 전민오입니다.

PR을 올리면 GitHub Copilot이 자동으로 리뷰를 달아주는 기능, 쓰고 계신가요? 처음엔 신기해서 열심히 읽었는데, 시간이 지나니까 팀원들이 점점 안 읽더라고요.

"영어로 길게 써있으면 대충 넘기게 되더라"

맞는 말이었어요. 한국어로 "이 함수는 너무 길어요"라고 하면 바로 와닿는데, "This function is too long and should be refactored"라고 하면 왠지 읽기가 귀찮아지죠.

그래서 찾아봤어요. Copilot을 한국어로 바꿀 수 있는 방법이 있을까?

한 줄이면 됩니다

결론부터 말하면, 딱 한 줄 추가하면 됩니다.

프로젝트 루트에 .github/copilot-instructions.md 파일을 만들고:

Respond in Korean for all replies and code reviews.

끝입니다.

이게 전부예요. 파일 하나 만들고, 한 줄 쓰면 끝.

Before / After

실제로 얼마나 달라지는지 볼까요?

Before (영어)

GitHub Copilot 영어 리뷰 예시

영어로 긴 설명이 나오면 읽기가 부담스러워요. 특히 피곤할 때는 더 그렇죠.

After (한글)

GitHub Copilot 한글 리뷰 예시

딱 보시면 아시겠지만, 한글이 훨씬 머리에 잘 들어와요. 읽는 속도도 빠르고, 내용도 바로 이해돼요.

어떻게 동작하나요?

.github/copilot-instructions.md 파일은 GitHub Copilot에게 "이렇게 동작해줘"라고 알려주는 설정 파일이에요.

  • PR 리뷰 댓글
  • 코드 설명
  • 제안사항
  • 버그 리포트

이 모든 게 한국어로 나옵니다.

다른 설정도 추가할 수 있어요

한국어 설정 외에도 여러 가지를 커스터마이징할 수 있어요:

Respond in Korean for all replies and code reviews.

## 코드 리뷰 스타일
- 친절하고 건설적인 톤으로 작성해주세요
- 문제를 지적할 때는 개선 방법도 함께 제시해주세요
- 칭찬할 부분이 있으면 적극적으로 칭찬해주세요

## 우선순위
1. 보안 이슈는 반드시 지적
2. 성능 문제는 중요도 표시
3. 코드 스타일은 제안만

## 프로젝트 컨텍스트
- TypeScript + React 18 프로젝트
- 함수형 컴포넌트만 사용
- Tailwind CSS 사용 중

이렇게 프로젝트에 맞게 세밀하게 조정할 수 있어요.

장점

1. 팀원들이 실제로 읽어요

가장 큰 변화예요. 전에는 Copilot 리뷰를 대충 넘기던 팀원들이, 이제는 진짜로 읽고 반영해요.

"아 이거 진짜 한글이 편하네요. 이제 제대로 읽게 돼요" — 팀원 A

2. 리뷰 내용 이해가 빨라졌어요

영어로 읽을 때는 한 번 더 생각하는 시간이 필요했는데, 한글로 바로 들어오니까 이해가 훨씬 빠르더라고요.

3. 설정이 진짜 쉬워요

파일 하나, 한 줄. 5분도 안 걸려요.

단점과 주의사항

1. 가끔 영어가 섞여요

완벽하진 않아요. 특히 코드 관련 용어나 에러 메시지는 영어로 나올 때가 있어요.

useState 훅을 사용할 때는... (O)
use-state hook을 사용할 때는... (X)

이 정도는 괜찮은데, 가끔 문장 중간에 영어가 섞이기도 해요.

2. 기술 용어 번역이 애매할 때가 있어요

"Debounce"를 "디바운스"라고 할까, "입력 지연"이라고 할까? 이런 게 좀 애매할 수 있어요.

3. 팀 전체가 동의해야 해요

.github/copilot-instructions.md는 저장소 전체에 적용되니까, 팀원들과 먼저 이야기하는 게 좋아요.

"영어가 더 익숙한데..."

이런 팀원이 있을 수도 있으니까요.

팁

팀에 도입할 때

  1. 먼저 제안해보세요

    • "한번 써볼까요?" 정도로 가볍게
    • 1주일 정도 써보고 피드백 받기

  2. 다른 옵션도 함께 설정하세요

    • 리뷰 스타일, 우선순위 등
    • 팀의 코딩 컨벤션 추가

  3. 필요하면 되돌릴 수 있어요

    • 파일 하나 지우면 끝
    • 부담 없이 시도해볼 수 있어요

개인 프로젝트에서도 좋아요

팀 프로젝트가 아니어도, 개인 프로젝트에서 쓰면 공부할 때 편해요. 특히 처음 배우는 라이브러리나 프레임워크 쓸 때요.

마무리

GitHub Copilot을 한국어로 바꾸는 건 정말 간단했어요. 파일 하나, 한 줄.

하지만 효과는 생각보다 컸어요. 팀원들이 리뷰를 더 꼼꼼히 읽게 되었고, 코드 품질도 자연스럽게 올라갔거든요.

여러분의 프로젝트에도 한번 적용해보세요. 5분이면 충분해요.

참고 링크