Prompt Engineering For Developer

핵심 원칙 4가지

1. 페르소나 설정: AI가 특정 역할(예: 시니어 개발자, 보안 전문가, 코드 리뷰어 등)을 맡도록 지시

   • 나쁜 예: "이 코드 리뷰해줘."

   • 좋은 예: "당신은 10년 차 시니어 백엔드 개발자입니다. Spring Security 전문가의 관점에서 이 코드의 보안 취약점을 중점적으로 리뷰해주세요."

2. 명확성과 구체성: 요청의 목적과 기대 결과를 명확히 정의

   • 나쁜 예: "코드를 최적화해줘."

   • 좋은 예: "이 Python 함수의 가독성을 높이는 방향으로 리팩토링해줘. 실행 속도는 변경되면 안 돼."

3. 제약 조건 설정: AI가 따라야 할 구체적인 규칙이나 제한 사항을 명시

   • 나쁜 예: "API 엔드포인트를 만들어줘."

   • 좋은 예: "Java 17과 Spring Boot 3.3을 사용해, 외부 라이브러리 없이 RESTful API 엔드포인트를 만들어줘. null 입력도 반드시 처리해야 해."

4. 단계별 사고: 단계별로 문제를 해결하도록 유도하여, 스스로 논리적인 계획을 세우고 작업을 분해하도록 함

   • 나쁜 예: "이 기능을 구현해줘."

   • 좋은 예: "이 기능을 구현하는 데 필요한 단계를 하나씩 설명해줘. 각 단계별로 어떤 작업이 필요한지 구체적으로 알려줘." -> "그 단계들을 하나씩 실행해줘."

실전 기법

Zero-Shot vs. Few-Shot

• Zero-Shot (단순 요청): AI의 일반 지식에만 의존하여 바로 질문하는 방식

• Few-Shot (예시 제공): AI에게 작업에 대한 예시를 먼저 보여주고, 그 스타일에 맞춰 작업을 요청하는 방식

Few-Shot 기법은 AI의 '출력 공간(Output Space)'을 강력하게 '제약'하는 원리를 이용한다.

// 우리 팀의 테스트 코드 스타일 예시
@Test
void should_return_user_when_id_exists() {
  // given
  given(userRepository.findById(any())).willReturn(Optional.of(user));
  // when
  User foundUser = userService.findById(1L);
  // then
  assertThat(foundUser.getName()).isEqualTo(user.getName());
}

// 위 예시와 동일한 스타일(given-when-then)로,
// 'deleteUser' 메서드에 대한 테스트 코드를 작성해줘.

AI는 제공된 예시(컨텍스트)를 바탕으로, 다음에 생성될 내용이 어떤 구조와 스타일을 가져야 하는지 높은 확률로 예측한다.

반복적 개선

첫 번째 답변에 만족하지 말고, 그 답변을 새로운 컨텍스트로 삼아 추가 요청을 하는 방식이다.

1. 명령: "상품 주문(Order)을 처리하는 OrderService 클래스 만들어줘."

2. AI: (초안 코드 생성)

3. 피드백 및 계속 반복...

4. AI: (최종 코드 완성)

이 기법은 AI와의 대화 내역 전체가 '누적 컨텍스트'로 작동하는 원리를 활용하여, 점진적으로 결과물을 개선해 나가는 방식이다.

• 장점: 점진적으로 복잡한 결과물을 완성 가능

• 단점: 대화가 길어질수록 컨텍스트 윈도우 한계에 빠르게 도달 가능

  • 토큰(비용) 소모가 커지고 AI의 응답 속도가 느려지거나 맥락을 잃을 수 있음

  • 복잡한 작업이 완료되면 주기적으로 컨텍스트를 초기화하는 것이 좋음

Chain of Thought(CoT) & 단계별 실행

'단계별 사고' 원칙을 실제 작업으로 연결하는 가장 강력한 기법으로, '계획' 단계와 '실행' 단계를 개발자가 의도적으로 분리하는 것이다.

• 계획 수립(CoT)

  • 명령: "기존 UserService에 Redis를 이용한 캐시 레이어를 추가하려고 해. 필요한 작업 단계를 순서대로 설명해줘."

1. `build.gradle` (또는 `pom.xml`)에 `spring-boot-starter-data-redis` 의존성을 추가합니다.
2. `application.yml`에 Redis 호스트 및 포트 정보를 설정합니다.
3. `@Configuration` 클래스를 만들어 `@EnableCaching`을 선언하고, `CacheManager` 빈을 설정합니다.
4. `UserService`의 `findUserById` 같은 메서드에 `@Cacheable` 어노테이션을 추가합니다.
5. `updateUser`나 `deleteUser` 메서드에는 `@CacheEvict`를 추가하여 캐시를 갱신합니다.

• 단계별 실행 및 검증 (Execution): 각 단계를 하나씩 실행하도록 AI에 지시하여, 개발자가 각 단계의 결과물을 검토하고 승인할 수 있게 함

이는 AI가 스스로 논리적인 계획을 세우고(Chain of Thought), 개발자는 그 계획을 검토하고 제어(Control)할 수 있게 한다.

수동 컨텍스트 주입(Manual Context Injection)

AI의 컨텍스트 분석이 완벽하지 않거나, 현재 열리지 않은 파일의 정보를 AI가 알아야 할 때 개발자가 '사실(Facts)'을 직접 컨텍스트에 주입하는 기법이다.

• Few-Shot이 타일(Style)을 주입한다면, 이 기법은 데이터(Data)를 주입하는 방식

  • 에러 로그 / 의존성 목록 / 외부 문서 등

• AI가 모르는 '현재 상태'나 '외부 정보'를 명시적으로 제공하여 정확한 답변 유도