개발자를 위한 AI 프롬프트 세트 — 코드 작성·리뷰·디버깅

개발자의 하루는 코드를 쓰는 것으로 끝나지 않습니다. 에러를 찾고, 테스트를 만들고, 리뷰 의견을 정리하는 일도 많습니다. AI는 이런 반복 작업의 초안을 만드는 데 쓸 수 있습니다.

이 글에서 다루는 것은 코드 자체가 아니라 코드를 얻어 내는 프롬프트입니다. 예시 문장을 복사해 쓰세요.

개발 프롬프트의 기본 구조

개발 프롬프트에는 세 가지가 들어갑니다. AI의 역할, 사용 언어와 제약 조건, 원하는 출력 형식입니다. 조건이 분명할수록 답변을 쓸 수 있습니다. 예를 들어 언어 버전이 중요한 프로젝트라면 버전을 함께 적으세요. 프레임워크 이름도 적으면 답변이 프로젝트 상황에 맞습니다.

출력 형식을 정할 때는 코드만 받을지, 설명을 함께 받을지도 정하세요.

한 가지 원칙을 지키세요. AI가 제안한 코드는 직접 읽고 확인한 뒤에 씁니다. 동작 확인과 테스트는 사람의 몫입니다. 코드 작성뿐 아니라 주석 정리, 커밋 메시지 작성에도 같은 구조를 쓸 수 있습니다. 기본 사용법은 챗GPT 완벽 가이드에서 확인하시면 됩니다.

요구사항을 코드로 바꾸는 프롬프트

하고 싶은 일을 문장으로 적는 것이 시작입니다. 함수 하나 정도로 범위를 좁혀 요청하면 답변이 정리됩니다. 작은 단위로 나누는 또 다른 이유는 리뷰하기도 쉽다는 점입니다.

요구사항을 적을 때는 입력과 출력을 함께 쓰는 것이 좋습니다. 어떤 값을 넣고 어떤 값을 받아야 하는지 정해 두면 함수의 범위가 명확해집니다. 여기서는 파이썬을 예시로 쓰지만 문장 구조는 언어와 무관하게 같습니다.

너는 파이썬 개발자다. 아래 요구사항을 만족하는 함수를 작성해 줘.
요구사항: CSV 파일을 읽어 특정 열의 빈 값을 0으로 바꾸는 함수
제약: 표준 라이브러리만 사용, 함수 하나로 완성
출력: 코드와 간단한 사용 예시

받은 코드에서 이해되지 않는 부분은 바로 물어보세요. “이 줄이 왜 필요한지 설명해 줘”처럼 이어서 지시하면 됩니다. 처음부터 파일 전체를 맡기기보다는 작은 단위로 검증해 나가는 편이 관리하기 쉽습니다. 답변을 받으면 먼저 코드를 읽고 사용 예시를 직접 실행해 보세요. 예상과 다른 부분은 그 자리에서 추가로 물어보면 됩니다.

에러 메시지로 디버깅하는 프롬프트

디버깅은 오류의 원인을 찾아 고치는 작업입니다. 에러 메시지는 전문을 그대로 붙여넣는 것이 좋습니다.

아래 에러 메시지와 코드를 보고 원인을 찾아 줘.
에러 메시지: (에러 전문 붙여넣기)
코드: (관련 함수만 붙여넣기)
출력: 1. 에러 의미 2. 의심 지점 3. 수정 방법 순서로 정리

에러가 계속되면 재현 절차와 최근에 바꾼 부분을 함께 알려 주세요. 정보가 늘수록 답변이 실제 상황에 가까워집니다. 이미 시도해 본 해결 방법도 적어 두세요. 같은 답이 반복되는 것을 줄일 수 있습니다.

테스트 코드를 만드는 프롬프트

테스트는 어떤 케이스를 검사할지 정하는 것이 중요합니다. 정상 케이스, 경계값, 예외를 골고루 요청하세요.

아래 함수에 대한 테스트 코드를 만들어 줘.
함수: (코드 붙여넣기)
구성: 정상 케이스 2개, 경계값 2개, 예외 케이스 1개
도구: pytest

pytest는 파이썬에서 널리 쓰는 테스트 도구입니다. 다른 언어를 쓴다면 해당 언어의 테스트 도구 이름을 적으세요. 테스트가 완성되면 직접 실행해 보세요. 실패 케이스가 의도대로 만들어졌는지도 함께 확인하면 됩니다.

코드 리뷰와 리팩토링 프롬프트

코드 리뷰는 동료가 코드를 읽고 의견을 나누는 과정입니다. 리팩토링은 동작은 그대로 두고 구조를 개선하는 작업입니다. 둘 다 검토 관점을 정해 요청하면 답변이 정리됩니다.

너는 시니어 개발자로 코드 리뷰를 한다. 아래 코드를 검토해 줘.
관점: 가독성, 예외 처리, 이름 규칙
출력: 잘한 점 2개, 개선점 3개, 수정 예시 1개
코드: (붙여넣기)

아래 코드를 리팩토링해 줘. 동작은 그대로 유지해야 한다.
우선순위: 함수 분리, 이름 다듬기
출력: 변경 전후 비교와 변경 이유
코드: (붙여넣기)

리뷰 결과는 후보 의견으로 받아들이세요. 반영 여부는 팀의 코드 규칙에 따라 정하면 됩니다. 리팩토링 후에는 테스트를 다시 실행하세요.

상황별 프롬프트 정리

상황	프롬프트에 넣을 정보	주의점
기능 구현	언어, 요구사항, 제약	사용 예시 함께 요청
디버깅	에러 전문, 관련 코드	재현 절차 포함
테스트 작성	함수, 케이스 구성, 도구	경계값 포함
코드 리뷰	검토 관점, 출력 형식	기준을 구체적으로
리팩토링	유지 조건, 우선순위	동작 확인은 직접

자주 묻는 질문

Q. 사내 코드를 붙여넣어도 되나요? 회사 보안 규정을 먼저 확인하세요. 공개해도 되는 수준의 예시 코드만 입력하는 것이 안전합니다.

Q. AI가 만든 코드를 그대로 써도 되나요? 읽고 이해한 뒤에 쓰세요. 코드가 길면 핵심 부분만 가져와 직접 조립하는 방식이 안전합니다.

Q. 답변이 계속 어긋나요. 요구사항을 더 잘게 나눠 보세요. 대화가 길어지면 새 대화를 시작하는 것도 방법입니다. 조건을 다듬는 문법은 프롬프트 고급 문법에서 다룹니다.

마무리하며

프롬프트는 자주 반복하는 작업부터 쓰는 것이 좋습니다. 이 글의 예시를 자기 언어와 프로젝트에 맞게 바꿔 보관하세요.

에디터 안에서 AI를 쓰고 싶다면 Cursor·Copilot 가이드를, 더 많은 기본 문장은 챗GPT 프롬프트 100선에서 확인하세요.