[안건] AI 프롬프트 가이드 — 4명 각자 프롬프트 작성 작업

[yujinimda]

개요

프로필 기반 AI 직업 매칭 기능을 구현하기 위해 4명(우석, 유진, 아름, 지현)이 각자 프롬프트를 작성하고 결과를 비교합니다.

기본 인프라(OpenAI fetch, BFF Route, 전략 패턴)는 이미 셋팅 완료했습니다 → PR #62

---

작업 방법

1. 본인 전략 파일 열기

src/features/match/strategies/
├── wooseokStrategy.ts   ← 우석
├── yujinStrategy.ts     ← 유진
├── areumStrategy.ts     ← 아름
└── jihyunStrategy.ts    ← 지현

2. system + user 프롬프트 작성

import type { MatchStrategy } from './types';

export const {name}Strategy: MatchStrategy = {
  name: '한국어이름',
  buildMessages: (profile) => ({
    system: '여기에 시스템 프롬프트',
    user: '여기에 유저 프롬프트',
  }),
};

3. 테스트

pnpm dev

브라우저 콘솔에서:

const res = await fetch('/api/match', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  credentials: 'include',
  body: JSON.stringify({ strategy: '본인영문이름' }),
});
const data = await res.json();
console.log(data);

---

AI 응답 형식 (반드시 이 형식으로)

{
  "radar_chart": {
    "repetition": 85,
    "interpersonal": 40,
    "physical": 60,
    "hand_detail": 90,
    "env_sensitivity": 70
  },
  "summary_text": "반복적이고 조용한 환경에서 손작업에 집중할 때 가장 편안해요",
  "top3_jobs": [
    { "rank": 1, "job_name": "데이터 입력 사무원", "match_pct": 92, "fit_level": "잘 맞아요" },
    { "rank": 2, "job_name": "조립·포장 작업원", "match_pct": 78, "fit_level": "잘 맞아요" },
    { "rank": 3, "job_name": "도서관 사서보조", "match_pct": 65, "fit_level": "도전해볼 수 있어요" }
  ]
}

---

평가 기준

기준	설명
정확도	프로필 특성이 레이더 차트와 직종에 합리적으로 반영되는가
일관성	같은 입력에 비슷한 결과가 나오는가
자연스러움	summary_text가 자연스러운 한국어인가
직종 현실성	추천 직종이 실제로 존재하고 장애 특성에 맞는가
응답 안정성	JSON 파싱 에러 없이 안정적으로 응답하는가

---

주의사항

• 자기 브랜치 파서 해주세요 공통 로직은 수정가능
• 본인 전략 파일만 수정 — 다른 사람 파일 수정 금지
• 응답 형식 변경 금지 (Zod 검증 실패)
• API 키 하드코딩 금지

세부 가이드 → docs/AI_match_guide.md

[yujinimda]

저희는 오픈에이아이 api 키에요~!
오픈에이아이 api 내에서 모델은 자유롭게 골라쓰세요~! 모델은 비싼거 쓰셔도 댑니다~! 원하시는대로 자율롭게 모델 바꿔가면서 테스트 해보세요~!

언어에 좋은 모델이 있고 가성비 모델이 있고한데 사실 가성비로 언어를 잘 뽑으면 그게 가장 베스트긴해요 왜 그 모델을 선택해서 뽑으셨는지 생각해주셨으면 합니다~!

[yujinimda]

ai 돌리는 요금은 생각 안하셔도 됩니다 저 엄청 넉넉하게 상금으로 받은게 있고 혹시 몰라서 리밋도 걸어놔서 자유롭게 마음대로 테스트 하세요~!

[aahreum]

#67
프롬프트 PR 올렸습니다~!

https://ahahahahreum.notion.site/3465213dcd4c8032a752f988cf060ec1?source=copy_link
테스트한 프롬프트들 노션에 작성했습니다!
summary_text에 대해 설명을 명확히 안넣어주면 상투적인 말만 출력해서 디테일하게 넣어보았습니다

[yujinimda]

혹시 점수기준이 어떻게 나오는지 간단하게 pr에 적어주실수있나요??