05. 요청하는 방법¶

[Bad] 지시를 개선하려고 노력
"전문적이고 간결하며 기술적으로 정확한 응답을 해주세요.
 코드는 모범 사례를 따르고 에러 핸들링을 포함해야 합니다."

[Good] 예시를 개선하려고 노력
"이런 스타일로 코드 작성해줘:

def fetch_user(user_id: str) -> User | None:
    try:
        response = api.get(f'/users/{user_id}')
        return User.from_dict(response.json())
    except ApiError as e:
        logger.error(f'Failed to fetch user {user_id}: {e}')
        return None
"

❌ "당신은 10년 경력의 시니어 개발자입니다..."
❌ "단계별로 생각해주세요..."
❌ "실수하지 마세요..."
❌ "전문가처럼 응답해주세요..."

✅ 원하는 것을 명확히
✅ 관련 컨텍스트 제공
✅ 예시가 있으면 예시 제공

[컨텍스트]
FastAPI 프로젝트에서 JWT 인증을 구현 중이야.
현재 access token만 사용하고 있어.

[질문]
refresh token을 추가하려면 어떻게 해야 해?

[현재]
def get_users():
    users = db.query(User).all()
    return users

[원하는 것]
- 페이지네이션 추가
- 총 개수도 함께 반환
- 정렬 옵션 추가

이 함수를 다른 엔티티에도 적용하고 싶어:

# 기존 (참고용)
def create_user(data: UserCreate) -> User:
    user = User(**data.dict())
    db.add(user)
    db.commit()
    return user

# 만들어줘
create_order, create_product도 같은 패턴으로

로그인 API 만들어줘.

제약:
- 외부 라이브러리 최소화
- 기존 User 모델 활용
- /api/v1/auth 경로 사용

❌ "당신은 Google의 수석 엔지니어이고, 20년 경력의..."

✅ "이 코드 리뷰해줘"

❌ "반드시! 꼭! 절대로! 실수하지 말고!"

✅ 원하는 결과를 명확히 설명

❌ "더 좋게 만들어줘"

✅ "성능을 개선해줘. 특히 DB 쿼리 횟수를 줄이고 싶어"

❌ "로그인, 회원가입, 비밀번호 찾기, 소셜 로그인 다 만들어줘"

✅ "먼저 로그인부터 만들자"

> 사용자 검색 API 만들어줘

[Claude 구현]

> 좋은데, 대소문자 구분 없이 검색되게 해줘

[수정]

> 검색 결과가 너무 많을 수 있으니 limit 파라미터 추가해줘

[최종]

❌ "이건 내가 원한 게 아니야"

✅ "에러 핸들링이 빠져 있어. try-except 추가해줘"

❌ "더 깔끔하게"

✅ "이런 스타일로 다시 써줘:
   [원하는 스타일의 예시 코드]"

❌ "다시 해줘"

✅ "함수가 너무 길어. 50줄 이하로 분리해줘"