코드 리뷰·에러 해결에 쓰는 코딩 프롬프트 작성법

AI는 코드를 읽고 설명하고 고치는 데 꽤 쓸모가 있습니다. 하지만 “이거 왜 안 돼?”라고만 물으면 AI는 상황을 추측해서 답할 수밖에 없고, 엉뚱한 해결책을 내놓기도 합니다. 코딩 프롬프트의 핵심은 AI가 내 컴퓨터 화면을 볼 수 없다는 점을 기억하고, 필요한 정보를 빠짐없이 주는 것입니다.

코딩 프롬프트에 꼭 넣을 정보

• 환경: 언어와 버전, 프레임워크, 운영체제 (예: Python 3.12, Flask 3, Ubuntu)
• 목표: 이 코드가 원래 무엇을 해야 하는지
• 현재 상황: 실제로 어떤 일이 일어나는지, 에러 메시지 전체
• 관련 코드: 문제가 있는 부분과 그 코드를 부르는 부분
• 이미 해 본 것: 시도했지만 안 된 방법
• 제약 조건: 바꾸면 안 되는 부분, 쓸 수 없는 라이브러리 등

에러 해결 프롬프트 예시

너는 Python 백엔드를 10년간 개발한 시니어 개발자야.
아래 Flask 코드에서 에러가 나는 원인을 찾아 줘.

[환경] Python 3.12, Flask 3.0, Ubuntu 24.04
[목표] /upload 로 받은 CSV 파일을 읽어 행 수를 돌려주는 기능
[현상] 한글이 들어간 CSV를 올리면 아래 에러가 남
UnicodeDecodeError: 'utf-8' codec can't decode byte 0xb0 in position 0
[이미 해 본 것] encoding='utf-8'을 명시했지만 같은 에러
[코드]
(관련 코드 붙여 넣기)

원인을 먼저 설명하고, 고친 코드는 바뀐 부분만 보여 줘.
확실하지 않은 부분은 추측이라고 표시해 줘.

에러 메시지는 요약하지 말고 전체를 그대로 붙여 넣는 것이 좋습니다. 마지막 줄뿐 아니라 어느 파일 몇 번째 줄에서 났는지가 원인을 찾는 데 중요한 단서가 되기 때문입니다.

코드 리뷰 프롬프트 예시

리뷰를 부탁할 때는 무엇을 중점적으로 볼지 정해 주면 쓸모 있는 지적을 받을 수 있습니다.

아래 코드를 리뷰해 줘. 다음 순서로 중요한 것부터 봐 줘.
1. 버그나 잘못된 동작이 생길 수 있는 부분
2. 보안 문제(입력값 검증, SQL 인젝션 등)
3. 성능 문제
4. 읽기 어렵거나 중복된 부분
각 지적마다 문제가 되는 줄, 이유, 고친 예시를 표로 정리해 줘.
취향 차이에 불과한 스타일 지적은 빼 줘.

리팩토링 프롬프트 예시

아래 함수를 읽기 쉽게 리팩토링해 줘.
- 동작(입력과 출력)은 절대 바꾸지 마.
- 외부 라이브러리는 새로 추가하지 마.
- 바꾼 이유를 항목별로 짧게 설명해 줘.
- 기존 동작이 그대로인지 확인할 수 있는 테스트 코드도 함께 만들어 줘.

“동작은 바꾸지 마”라는 조건과 테스트 코드 요청이 핵심입니다. 리팩토링 과정에서 AI가 의도치 않게 동작을 바꾸는 경우가 있는데, 테스트가 있으면 바로 알아챌 수 있습니다.

AI가 준 코드를 쓸 때 주의할 점

• 그대로 붙여 넣지 말고 이해한 뒤 쓰기: AI는 존재하지 않는 함수나 옵션을 만들어 내기도 합니다. 공식 문서로 확인하고, 실행해서 결과를 검증하세요.
• 비밀 정보 지우기: API 키, 비밀번호, 서버 주소, 고객 데이터는 프롬프트에 넣기 전에 반드시 지우거나 가짜 값으로 바꾸세요.
• 회사 코드라면 사내 규정 확인하기: 외부 AI 서비스에 소스 코드를 입력해도 되는지 먼저 확인하세요.

AI 프롬프트 빌더의 ‘일반 / 텍스트’ 탭에서 목적을 ‘코딩’으로 고르면 ‘에러 분석 및 트러블슈팅’, ‘심층 코드 리뷰’, ‘모듈화 및 리팩토링’ 같은 항목과 ‘코딩 퀄리티업 추가 옵션’을 골라 위와 같은 프롬프트를 만들 수 있습니다.