# ========================================================= # DSCR 프롬프트 코칭 시스템 (Complete Learning Edition) # 허깅페이스 배포용 app.py # ========================================================= import gradio as gr import re from typing import List # ========================================================= # 2. 확장된 데이터 구조 (모든 누락 항목 추가) # ========================================================= ALL_TECHS = [ "Persona Prompting","Few-shot Prompting","Self-consistency Prompting","Output Formatting", "Chain-of-Thought (CoT)","Constrained Prompting","RAG Prompting","Step-back Prompting","Role Prompting", ] # 확장된 기술 설명 TECH_DETAILED = { "Persona Prompting": { "desc": "대상 역할/세그먼트의 언어·KPI·관심사와 메시지를 정렬해 반응률·공감도를 높이는 기술", "purpose": "누구에게 말하는지 분명히 해 가치가 '그들의 언어'로 전달되게 함", "when_to_use": "타겟 오디언스가 명확하고, 그들만의 고유한 관심사나 업무 용어가 있을 때", "mechanics": [ "역할/권한/관심 KPI 명시 (예: Sales Leader = 파이프라인·승률·리드타임)", "톤/금칙어/선호 표현 정의 (직설·간결·숫자/ROI 중심, 모호어 금지)", "페르소나별 문장 매핑 (문제→가치→증거→CTA 흐름)" ], "real_example": """ **Before (일반적)**: "저희 솔루션을 소개하고 싶습니다" **After (CEO 페르소나)**: "이번 분기 운영비 15% 절감으로 EBITDA 개선에 기여할 방안을 제안드립니다" **After (개발자 페르소나)**: "API 응답시간 40% 단축과 에러율 0.1% 달성한 아키텍처를 공유드립니다" """, "tips": "페르소나 조사 시 LinkedIn, 업계 리포트, 고객 인터뷰를 활용해 실제 사용 언어를 파악하세요", "avoid": "가정에 의존한 페르소나 설정, 과도한 일반화, 업계 트렌드 무시" }, "Few-shot Prompting": { "desc": "소수의 고성과 예시를 제공해 톤·구조·리듬을 모사하는 기술", "purpose": "검증된 패턴 복제로 일관성 확보 및 품질 편차 최소화", "when_to_use": "특정 스타일이나 형식을 정확히 따라야 할 때, 브랜드 톤 일관성이 중요할 때", "mechanics": [ "고성과 샘플 2~3개를 헤드라인/오프닝/근거/CTA 패턴으로 제공", "구조적 요소별 예시 (제목 스타일, 문장 길이, 어조 등)", "'이 톤을 모사해 3개 변형' 같은 다변량 후보 생성" ], "real_example": """ **제공 예시**: [예시 1] "Re: Q3 매출 18% 증가 달성 방법 - 15분 논의 가능할까요?" [예시 2] "참고: 유사 업계 ROI 240% 사례 - 간단한 질문 있습니다" **AI 생성 결과**: "Re: 연말 목표 달성률 95% 전략 - 10분 상담 요청드립니다" """, "tips": "업계 최고 성과 콘텐츠를 수집하고, A/B 테스트 승리 버전을 예시로 활용하세요", "avoid": "예시가 너무 많아 혼란 야기, 맥락이 다른 예시 혼용, 오래된 예시 사용" }, "Self-consistency Prompting": { "desc": "여러 후보안 생성 후 자체 채점으로 최적안을 선택하는 기술", "purpose": "A/B 테스트를 내장하여 품질 향상 및 최적 선택지 도출", "when_to_use": "중요한 커뮤니케이션에서 최고 품질이 필요할 때, 객관적 평가가 어려울 때", "mechanics": [ "제목 5개·바디 3개·CTA 3개 등 다변량 생성", "체크리스트 기반 채점 (개인화/명료성/가치/스팸 회피/CTA 강도)", "점수 매기기 → Top 1~2안 선택" ], "real_example": """ **생성된 제목 후보들**: 1. "매출 증대를 위한 새로운 기회" (점수: 6/10) 2. "이번 달 파이프라인 25% 확대 방법" (점수: 9/10) ✓ 3. "혁신적인 비즈니스 솔루션 제안" (점수: 4/10) **채점 기준**: 구체성(3점) + 긴급성(2점) + 가치 명확성(3점) + 클릭 유도(2점) """, "tips": "명확한 채점 기준표를 만들고, 타겟 오디언스 관점에서 평가하세요", "avoid": "주관적 채점 기준, 너무 많은 후보안으로 인한 혼란, 일관성 없는 평가" }, "Output Formatting": { "desc": "산출물의 형식/섹션/필드를 고정하여 속도·가독성·재사용성을 확보하는 기술", "purpose": "승인 루프 단축, 표준화를 통한 효율성 극대화", "when_to_use": "반복적인 문서 작업, 팀 협업, 승인 프로세스가 복잡할 때", "mechanics": [ "유형별 템플릿 강제 (이메일/카피/보고서/PRD/API 문서)", "필수·선택 필드 명시 및 길이 제한", "JSON 스키마나 마크다운 구조 활용" ], "real_example": """ **이메일 포맷**: - 제목: [긴급도][카테고리] 핵심 메시지 (30자 이내) - 오프닝: 상대방 성과/관심사 언급 (1문장) - 가치제안: 구체적 혜택 (2-3문장) - 증거: 데이터/사례 (1-2개) - CTA: 명확한 다음 단계 (1문장) - PS: 추가 가치/긴급성 (선택) """, "tips": "조직의 기존 템플릿을 분석하고, 가장 성과 좋은 형식을 표준화하세요", "avoid": "과도한 제약으로 창의성 저해, 맥락을 무시한 획일적 적용" }, "Chain-of-Thought (CoT)": { "desc": "목표→지표→대안→선택→실행의 단계적 추론으로 논리 비약을 최소화하는 기술", "purpose": "분석/전략 문서의 논리 일관성 확보 및 의사결정 품질 향상", "when_to_use": "복잡한 문제 분석, 전략 수립, 논리적 설득이 필요한 상황", "mechanics": [ "각 단계별 가정/근거/대안/리스크 체크 질문 부여", "연역적/귀납적 추론 구조 명시", "중간 결론과 최종 결론의 연결고리 확인" ], "real_example": """ **단계별 추론 예시**: 1. **현황**: 고객 이탈률 15% (업계 평균 12%) 2. **원인 분석**: 온보딩 기간 평균 4주 (경쟁사 2주) 3. **가설**: 온보딩 기간 단축 → 이탈률 감소 4. **검증**: A/B 테스트로 2주 온보딩 그룹의 이탈률 8% 확인 5. **결론**: 온보딩 프로세스 개선으로 이탈률 50% 감소 가능 """, "tips": "각 단계에서 '왜?'라는 질문을 3번 이상 던지고, 반대 의견도 고려하세요", "avoid": "논리적 비약, 확인 편향, 단순한 인과관계 가정" }, "Constrained Prompting": { "desc": "길이·금칙어·필수필드·JSON 스키마 등 명확한 제약 조건을 설정하는 기술", "purpose": "브랜드/법무/심의 리스크 최소화 및 일관성 보장", "when_to_use": "규제 산업, 브랜드 가이드라인 준수, 대외 커뮤니케이션", "mechanics": [ "제목 ≤ 30자, 본문 ≤ 200단어 등 명확한 길이 제한", "사용 금지 단어 리스트 제공", "필수 포함 요소 체크리스트" ], "real_example": """ **제약 조건 예시**: - 길이: 제목 25자 이내, 본문 150단어 이내 - 금지어: "보장", "확실한", "무조건", "최고의" - 필수 포함: 회사명, 연락처, 법적 고지사항 - 톤: 전문적이되 친근함, 과장 금지 **결과물 검증**: ✓ 길이 준수 ✓ 금지어 없음 ✓ 필수 요소 포함 """, "tips": "업계 규제 사항을 미리 조사하고, 과거 이슈 사례를 참고하여 제약 조건을 설정하세요", "avoid": "과도한 제약으로 메시지 효과 저해, 불분명한 가이드라인" }, "RAG Prompting": { "desc": "외부 보고서/DB/문서의 근거를 주입하여 최신성·신뢰성을 확보하는 기술", "purpose": "추정/환각 방지, 출처 기반 서술로 신뢰도 향상", "when_to_use": "최신 데이터가 중요한 상황, 정확성이 핵심인 보고서, 근거 기반 설득", "mechanics": [ "'문서에 없는 내용은 추정 금지, 출처 명시' 지시", "인용/각주/링크 표기 의무화", "여러 소스 간 일치성 검증" ], "real_example": """ **참고 자료 주입**: "다음 자료를 바탕으로 분석하세요: - Gartner MQ 2024 (시장 현황) - 회사 2024 Q3 실적 (내부 데이터) - McKinsey Global Survey 2024 (트렌드) **결과물**: 모든 주장에 출처 표기 "시장 성장률 23% (Gartner, 2024)" "당사 점유율 15% 증가 (내부 실적, Q3)" """, "tips": "신뢰할 수 있는 1차 자료를 우선하고, 정보의 발행 날짜를 확인하세요", "avoid": "출처 불분명한 정보 활용, 편향된 자료만 선택, 맥락 무시한 데이터 인용" }, "Step-back Prompting": { "desc": "상위 목적/원칙에서 출발하여 의미 중심으로 재해석하는 기술", "purpose": "'왜 중요한가'에 먼저 답해 경영 시사점 강화", "when_to_use": "전략적 의사결정, 근본적 문제 해결, 조직 차원의 변화 관리", "mechanics": [ "상위 목표 → 핵심 원칙 → 현재 선택의 정합성 검증", "5 Whys 기법으로 근본 원인 탐구", "비즈니스 임팩트와 전략적 의미 연결" ], "real_example": """ **Step-back 사고 과정**: 표면적 문제: "마케팅 비용이 너무 높다" ↓ Step back: "왜 마케팅을 하는가?" → 고객 획득 ↓ 더 깊이: "왜 고객 획득이 중요한가?" → 성장 전략 ↓ 핵심 질문: "지속 가능한 성장 방법은?" → 고객 생애가치 최적화 """, "tips": "문제의 증상이 아닌 근본 원인에 집중하고, 장기적 관점에서 접근하세요", "avoid": "표면적 해결책에만 매몰, 현실성 없는 이상론, 과도한 추상화" }, "Role Prompting": { "desc": "'당신은 PM/전략가/UX 라이터...'처럼 특정 관점을 고정하여 목적 적합성을 높이는 기술", "purpose": "직무별 언어/판단 기준/우선순위 일치", "when_to_use": "전문 분야별 결과물, 특정 직무의 관점이 필요한 상황", "mechanics": [ "역할별 KPI·권한·리스크 관점 명시", "해당 직무의 전문 용어와 프레임워크 활용", "역할별 의사결정 기준과 제약사항 반영" ], "real_example": """ **PM 관점**: "사용자 스토리 형태로 요구사항을 정리하고, 우선순위는 비즈니스 가치와 개발 복잡도를 고려하여 설정하세요" **CFO 관점**: "ROI, EBITDA 영향, 현금흐름 관점에서 분석하고, 재무 리스크를 수치로 정량화하세요" **UX 디자이너 관점**: "사용자 여정과 접점별 페인포인트를 식별하고, 사용성 테스트 기준을 제시하세요" """, "tips": "각 역할의 실제 업무 방식과 고민을 깊이 이해하고, 해당 직무의 전문가와 검증하세요", "avoid": "표면적 역할 이해, 직무별 차이 무시, 고정관념에 의존한 역할 설정" } } # 완전한 Pain Points 설명 PAIN_DETAILED = { "반응률 저조": { "definition": "이메일 개봉률, 클릭률, 응답률이 업계 평균이나 목표치보다 현저히 낮은 상황", "symptoms": [ "이메일 개봉률 15% 미만 (B2B 평균 21%)", "클릭률 2% 미만 (업계 평균 3-4%)", "콜드 아웃리치 응답률 1% 미만", "소셜미디어 참여도 지속적 하락" ], "root_causes": [ "타겟 오디언스 불일치", "제목/헤드라인의 매력도 부족", "가치 제안의 모호함", "타이밍과 채널 전략 오류" ], "business_impact": "고객 획득 비용 증가, 매출 목표 달성 어려움, 마케팅 ROI 하락", "real_examples": [ "SaaS 회사: 기능 중심 메시지 → ROI 중심으로 변경 후 응답률 3배 증가", "컨설팅 펌: 일반적 제안 → 업계별 맞춤 사례로 개봉률 40% 개선" ], "measurement": "Google Analytics, 이메일 마케팅 툴, CRM 데이터로 추적" }, "메시지 불일치": { "definition": "채널, 팀, 시점별로 브랜드 메시지나 톤이 일관되지 않아 브랜드 신뢰도가 저하되는 상황", "symptoms": [ "채널별 다른 톤앤매너 (이메일은 격식, SNS는 캐주얼)", "팀별 상이한 가치 제안 설명", "시기별 메시지 변화로 혼란 야기", "브랜드 가이드라인 무시" ], "root_causes": [ "명확한 브랜드 가이드라인 부재", "팀 간 소통 부족", "콘텐츠 검토 프로세스 미비", "외부 에이전시와의 조율 부족" ], "business_impact": "브랜드 인지도 혼란, 고객 신뢰도 하락, 마케팅 효율성 저하", "real_examples": [ "스타트업: 창업자와 마케팅팀의 다른 메시지로 고객 혼란 → 통합 메시지 하우스 구축", "글로벌 기업: 지역별 다른 포지셔닝 → 글로벌 브랜드 가이드라인 수립" ], "measurement": "브랜드 추적 조사, 소셜 미디어 멘션 분석, 고객 피드백 분석" }, "작성 시간 과다": { "definition": "콘텐츠나 문서 작성에 과도한 시간이 소요되어 다른 업무에 지장을 주는 상황", "symptoms": [ "이메일 하나 작성에 30분 이상 소요", "보고서 작성으로 인한 야근 빈번", "콘텐츠 승인 과정에서 무한 수정", "창의적 아이디어 부족으로 고민 시간 증가" ], "root_causes": [ "템플릿이나 가이드라인 부재", "명확한 목표 설정 부족", "완벽주의 성향", "피드백 루프의 비효율성" ], "business_impact": "생산성 저하, 기회비용 증가, 직원 스트레스 증가, 프로젝트 지연", "real_examples": [ "마케팅팀: 이메일 템플릿 도입으로 작성 시간 70% 단축", "세일즈팀: 영업 제안서 자동화로 하루 3시간 절약" ], "measurement": "작업 시간 추적, 생산성 지표, 직원 만족도 조사" }, "A/B 테스트 부담": { "definition": "A/B 테스트 설계, 실행, 분석에 과도한 리소스가 투입되어 부담이 되는 상황", "symptoms": [ "테스트 설계에 일주일 이상 소요", "통계적 유의성 확보를 위한 긴 테스트 기간", "결과 분석의 복잡성", "테스트 버전 관리의 어려움" ], "root_causes": [ "테스트 도구 부족 또는 복잡성", "통계 지식 부족", "명확한 가설 설정 실패", "표본 크기 부족" ], "business_impact": "의사결정 지연, 테스트 비용 증가, 기회비용 발생", "real_examples": [ "이커머스: 자동화 도구 도입으로 테스트 설정 시간 80% 단축", "SaaS: 간단한 A/B 테스트로 전환율 25% 개선" ], "measurement": "테스트 완료율, 평균 테스트 기간, 테스트 ROI" }, "경쟁사 정보 부족": { "definition": "경쟁사의 전략, 제품, 가격 등에 대한 정보 부족으로 전략 수립에 어려움을 겪는 상황", "symptoms": [ "경쟁사 가격 정책 파악 불가", "경쟁사 신제품 출시 후 뒤늦은 대응", "시장 포지셔닝 전략 부재", "고객 이탈 원인 분석 부족" ], "root_causes": [ "체계적인 모니터링 체계 부재", "정보 수집 리소스 부족", "경쟁 분석 전문성 부족", "정보 공유 시스템 미비" ], "business_impact": "시장 기회 상실, 경쟁력 약화, 고객 이탈 증가", "real_examples": [ "핀테크: 경쟁사 모니터링 도구 도입으로 신속한 시장 대응", "리테일: 가격 비교 시스템으로 동적 가격 전략 수립" ], "measurement": "시장 점유율, 경쟁사 대비 성과 지표, 고객 만족도 비교" }, "고객 요구 불명확": { "definition": "고객의 실제 니즈와 기대사항을 정확히 파악하지 못해 제품/서비스 개선 방향을 설정하기 어려운 상황", "symptoms": [ "고객 이탈 원인 불명", "신기능 출시 후 사용률 저조", "고객 지원 문의 증가", "고객 만족도 점수 정체" ], "root_causes": [ "체계적인 고객 조사 부재", "고객 세분화 부족", "피드백 수집 채널 한계", "데이터 분석 역량 부족" ], "business_impact": "제품 개발 방향성 오류, 고객 이탈 증가, R&D 투자 효율성 저하", "real_examples": [ "B2B SaaS: 고객 인터뷰를 통해 핵심 기능 우선순위 재정립", "이커머스: 사용자 행동 분석으로 개인화 추천 시스템 개선" ], "measurement": "고객 만족도, Net Promoter Score, 고객 생애가치" }, "출처/기간 누락": { "definition": "리서치나 분석 문서에서 데이터 출처와 수집 기간이 명확하지 않아 신뢰성이 떨어지는 상황", "symptoms": [ "보고서에 '최근 조사에 따르면'과 같은 모호한 표현", "데이터 출처 미표기로 신뢰성 의심", "과거 데이터와 최신 데이터 혼재", "정보의 유효기간 불분명" ], "root_causes": [ "체계적인 자료 관리 부재", "출처 표기 가이드라인 미비", "시간에 따른 데이터 변화 간과", "검증되지 않은 2차 자료 의존" ], "business_impact": "의사결정 오류, 신뢰도 하락, 법적 리스크 증가", "real_examples": [ "컨설팅 회사: 출처 표기 표준화로 클라이언트 신뢰도 30% 향상", "투자 회사: 데이터 검증 프로세스 도입으로 투자 의사결정 정확도 개선" ], "measurement": "자료 검증률, 고객 신뢰도 조사, 의사결정 정확도" }, "리서치 작성 부담": { "definition": "시장 조사나 분석 보고서 작성에 과도한 시간과 노력이 투입되는 상황", "symptoms": [ "단일 보고서 작성에 2주 이상 소요", "데이터 수집과 분석의 중복 작업", "형식 통일과 품질 관리의 어려움", "리서치 결과의 재활용성 부족" ], "root_causes": [ "효율적인 리서치 프로세스 부재", "분석 툴과 템플릿 미비", "팀 내 역할 분담 불명확", "과거 자료 재활용 시스템 부족" ], "business_impact": "리서치 비용 증가, 의사결정 지연, 기회비용 발생", "real_examples": [ "전략 컨설팅: 리서치 템플릿 표준화로 작성 시간 50% 단축", "스타트업: 자동화된 시장 분석 도구 도입으로 주간 리포트 체계 구축" ], "measurement": "리서치 완료 시간, 비용 대비 효과, 재활용률" }, "요구사항 언어화 난항": { "definition": "제품 개발에 필요한 요구사항을 명확하고 구체적인 언어로 표현하기 어려운 상황", "symptoms": [ "모호하고 추상적인 요구사항 문서", "개발팀과 기획팀 간 이해 격차", "요구사항 변경으로 인한 잦은 재작업", "검수 기준의 불명확성" ], "root_causes": [ "도메인 지식과 기술 이해 부족", "체계적인 요구사항 정의 방법론 부재", "이해관계자 간 소통 부족", "사용자 관점의 검증 프로세스 미비" ], "business_impact": "개발 지연, 예산 초과, 최종 제품 품질 저하", "real_examples": [ "핀테크: 사용자 스토리 방식 도입으로 요구사항 명확성 80% 개선", "이커머스: 프로토타입 기반 요구사항 검증으로 개발 재작업 60% 감소" ], "measurement": "요구사항 변경률, 개발 완료율, 사용자 만족도" }, "UX 카피 불일치": { "definition": "사용자 인터페이스 내 텍스트가 일관되지 않아 사용자 경험이 혼란스러운 상황", "symptoms": [ "같은 기능에 대한 서로 다른 용어 사용", "페이지별 톤앤매너 차이", "에러 메시지의 일관성 부족", "브랜드 보이스와 UX 카피 불일치" ], "root_causes": [ "UX 라이팅 가이드라인 부재", "디자이너와 카피라이터 간 협업 부족", "용어집(Glossary) 미정립", "다국어 번역에서의 일관성 관리 미흡" ], "business_impact": "사용자 혼란 증가, 이탈률 상승, 브랜드 신뢰도 하락", "real_examples": [ "SaaS 플랫폼: UX 라이팅 시스템 구축으로 사용자 완료율 25% 향상", "모바일 앱: 일관된 용어 체계 도입으로 고객 지원 문의 40% 감소" ], "measurement": "사용자 완료율, 이탈률, 고객 지원 문의 빈도" }, "의사결정 기준 불명확": { "definition": "제품이나 기능 개발 시 우선순위나 방향성 결정 기준이 애매하여 효율적인 의사결정이 어려운 상황", "symptoms": [ "기능 우선순위 설정의 주관성", "이해관계자별 상이한 판단 기준", "데이터 기반 의사결정 체계 부재", "의사결정 지연과 반복적 논의" ], "root_causes": [ "명확한 제품 전략과 목표 부재", "정량적 평가 지표 미설정", "의사결정 프로세스 표준화 부족", "역할과 권한의 모호함" ], "business_impact": "개발 효율성 저하, 기회비용 증가, 팀 내 갈등", "real_examples": [ "스타트업: RICE 프레임워크 도입으로 의사결정 시간 70% 단축", "대기업: OKR 기반 우선순위 설정으로 제품 개발 효율성 향상" ], "measurement": "의사결정 소요 시간, 기능 개발 완료율, 팀 만족도" } } # 완전한 Output 설명 OUTPUT_DETAILED = { "콜드메일": { "definition": "이전 접점이 없는 잠재 고객에게 비즈니스 목적으로 발송하는 첫 연락 이메일", "purpose": "신규 고객 발굴, 비즈니스 관계 구축, 세일즈 파이프라인 확장", "key_components": [ "매력적인 제목줄 (개봉률 결정)", "개인화된 오프닝 (연결점 구축)", "명확한 가치 제안 (관심 유발)", "구체적인 CTA (다음 단계 유도)" ], "success_metrics": [ "개봉률: 20-30% (B2B 기준)", "응답률: 5-10%", "미팅 전환율: 1-3%", "스팸 신고율: 1% 미만" ], "best_practices": [ "발송 전 타겟 리서치 필수", "3-5개 이메일 시퀀스 설계", "A/B 테스트로 지속 최적화", "법적 규제 (GDPR, CAN-SPAM) 준수" ], "common_mistakes": [ "과도한 자기소개", "모호한 가치 제안", "너무 긴 내용", "일방적인 판매 메시지" ], "real_examples": """ **IT 컨설팅 → CFO**: 제목: Re: Q4 IT 예산 20% 절감 사례 - 15분 논의 가능할까요? 안녕하세요 김CFO님, 최근 [회사명]의 디지털 전환 투자 소식을 봤습니다. 저희는 유사 규모 제조업체 3곳의 IT 운영비를 평균 23% 절감하며 동시에 시스템 안정성을 99.9%로 향상시킨 경험이 있습니다. 다음 주 화요일 오전 11시, 15분간 간단한 사례 공유가 가능할까요? [구체적 ROI 계산서 첨부] """ }, "광고 카피": { "definition": "유료 광고 매체를 통해 타겟 오디언스의 관심을 끌고 행동을 유도하는 짧고 강력한 메시지", "purpose": "브랜드 인지도 제고, 트래픽 유도, 전환율 증대, 매출 증가", "key_components": [ "임팩트 있는 헤드라인 (주목 끌기)", "감정적 연결고리 (공감대 형성)", "명확한 혜택 (가치 전달)", "강력한 CTA (행동 유도)" ], "platform_specific": { "Google 검색광고": "키워드 연관성, 문자 수 제한 고려", "Facebook/Instagram": "비주얼과 조화, 소셜 맥락 활용", "LinkedIn": "전문적 톤, B2B 가치 제안 중심", "YouTube": "스토리텔링, 감정적 어필" }, "success_metrics": [ "CTR (클릭률): 2-5%", "전환율: 1-3%", "CPA (획득 비용): 목표 LTV 대비 1:3 이상", "ROAS (광고 수익률): 4:1 이상" ], "real_examples": """ **B2B SaaS - LinkedIn 광고**: 헤드라인: "엑셀로 2시간 걸리던 보고서, 이제 5분이면 끝" 바디: 300+ 기업이 선택한 자동 대시보드 CTA: "무료 데모 신청하기" **이커머스 - Facebook 광고**: 헤드라인: "10만원으로 침실 완전 변신" 바디: 24시간 한정 특가 + 무료배송 CTA: "지금 쇼핑하기" """ }, "시장조사 보고서": { "definition": "특정 시장의 규모, 성장률, 트렌드, 경쟁 구도 등을 체계적으로 분석한 문서", "purpose": "전략적 의사결정 지원, 투자 유치, 신사업 기회 발굴, 리스크 평가", "key_sections": [ "Executive Summary (핵심 요약)", "시장 정의 및 세분화", "시장 규모 및 성장률 분석", "경쟁 구도 및 주요 플레이어", "트렌드 및 성장 동력", "기회와 위험 요인", "결론 및 권고사항" ], "methodology": [ "Primary Research (설문, 인터뷰, FGD)", "Secondary Research (공개 자료, 보고서)", "데이터 분석 및 모델링", "전문가 검증" ], "credibility_factors": [ "데이터 출처의 신뢰성", "분석 방법론의 타당성", "객관적 시각 유지", "한계점 명시" ], "real_examples": """ **핀테크 페이먼트 시장 보고서**: Executive Summary: - 국내 모바일 결제 시장 규모 85조원 (2024년) - 연평균 성장률 15.3% (2020-2024) - 주요 성장 동력: 비대면 결제 증가, 간편결제 확산 Key Findings: - 20-30대가 전체 거래량의 67% 차지 - O2O 서비스 연계 결제 급성장 (전년 대비 45% 증가) - 보안 기술 발전이 시장 확장의 핵심 요인 """ }, "PRD": { "definition": "Product Requirements Document - 제품 개발의 목표, 기능, 요구사항을 상세히 정의한 문서", "purpose": "개발팀 가이드, 이해관계자 정렬, 프로젝트 범위 정의, 성공 기준 수립", "essential_sections": [ "문제 정의 (Problem Statement)", "목표 및 성공 지표 (Goals & Success Metrics)", "사용자 스토리 (User Stories)", "기능 요구사항 (Functional Requirements)", "비기능 요구사항 (Non-functional Requirements)", "제약사항 및 가정 (Constraints & Assumptions)", "우선순위 (Prioritization)", "타임라인 (Timeline)" ], "stakeholder_alignment": [ "Engineering: 기술적 실현 가능성", "Design: 사용자 경험 일관성", "Business: 비즈니스 가치 연결", "QA: 테스트 가능성" ], "success_criteria": [ "명확성: 모호함 없는 요구사항", "완전성: 누락된 요구사항 없음", "실현가능성: 기술적 제약 고려", "측정가능성: 정량적 성공 지표" ], "real_examples": """ **모바일 앱 알림 기능 PRD**: Problem Statement: 사용자의 70%가 중요한 업데이트를 놓치고 있으며, 이로 인해 사용자 참여도가 업계 평균 대비 30% 낮음 Success Metrics: - 알림 열람률: 현재 15% → 목표 35% - 7일 리텐션: 현재 45% → 목표 60% - 사용자 만족도: 현재 3.2/5 → 목표 4.0/5 User Stories: - 사용자로서, 내가 관심 있는 카테고리의 알림만 받고 싶다 - 사용자로서, 알림을 받을 시간대를 설정하고 싶다 """ }, "보도자료": { "definition": "언론매체를 통해 기업의 뉴스나 정보를 공식적으로 발표하는 문서", "purpose": "미디어 노출 확보, 브랜드 인지도 제고, 공식적 입장 전달, 위기 대응", "key_components": [ "뉴스가치 있는 헤드라인", "5W1H 기반 리드 문단", "배경 정보와 맥락", "인용문 (경영진, 전문가)", "회사 소개 (Boilerplate)", "연락처 정보" ], "success_metrics": [ "언론 보도율: 발송 대비 10-20%", "주요 매체 픽업률", "온라인 언급량 증가", "웹사이트 트래픽 증가" ], "best_practices": [ "기자 관점에서 뉴스가치 검토", "간결하고 명확한 문체", "사실 기반 정보 제공", "적절한 발송 타이밍" ], "real_examples": """ **스타트업 투자 유치 보도자료**: [헤드라인] ○○테크, 시리즈A 100억원 투자 유치… AI 헬스케어 사업 확장 [리드] 인공지능 기반 헬스케어 솔루션 전문기업 ○○테크(대표 김○○)가 시리즈A 라운드에서 100억원 규모의 투자를 유치했다고 15일 발표했다. [본문] 이번 투자는 ○○○캐피털이 주도하고 ○○○벤처스, ○○○인베스트먼트가 참여했다. 조달된 자금은 AI 진단 솔루션 고도화와 해외 진출에 사용될 예정이다. """ }, "랜딩페이지 섹션": { "definition": "특정 마케팅 캠페인의 목적에 맞춰 방문자를 전환시키기 위한 웹페이지의 구성 요소", "purpose": "방문자 전환율 극대화, 명확한 행동 유도, 캠페인 ROI 향상", "key_components": [ "강력한 헤드라인과 서브헤드라인", "명확한 가치 제안 (Value Proposition)", "사회적 증명 (고객 후기, 로고)", "혜택 중심의 기능 설명", "강력한 CTA 버튼", "신뢰 요소 (보안, 인증마크)" ], "conversion_optimization": [ "단일 목표에 집중", "산만한 요소 제거", "모바일 최적화", "로딩 속도 최적화", "A/B 테스트 지속 실행" ], "success_metrics": [ "전환율: 2-5% (업종별 차이)", "이탈률: 70% 이하", "페이지 체류시간: 2분 이상", "CTA 클릭률: 5-15%" ], "real_examples": """ **SaaS 무료체험 랜딩페이지**: [Hero Section] 헤드라인: "엑셀 대신 3분만에 완성하는 매출 대시보드" 서브헤드: "1,000+ 기업이 선택한 No-code 분석 툴" CTA: "14일 무료로 시작하기" [Social Proof] "매출 분석 시간이 80% 단축됐어요" - ○○기업 마케팅팀장 삼성, LG, 현대 등 고객사 로고 [Features] ✓ 드래그&드랍으로 5분만에 대시보드 완성 ✓ 실시간 데이터 자동 업데이트 ✓ 20+ 채널 연동 지원 """ }, "경쟁사 분석": { "definition": "시장 내 주요 경쟁사의 전략, 제품, 성과를 체계적으로 분석한 보고서", "purpose": "경쟁 우위 요소 식별, 시장 포지셔닝 전략 수립, 벤치마킹 기회 발굴", "key_sections": [ "경쟁사 개요 및 포지셔닝", "제품/서비스 비교 분석", "가격 정책 및 수익 모델", "마케팅 전략 및 채널", "강점과 약점 (SWOT)", "시장 점유율 및 성과 지표", "향후 전략 예측", "우리의 대응 방안" ], "analysis_framework": [ "직접 경쟁사 vs 간접 경쟁사", "제품 기능 비교 매트릭스", "가격-성능 포지셔닝 맵", "고객 리뷰 감성 분석" ], "data_sources": [ "공개 재무 정보", "제품 웹사이트 및 앱", "고객 리뷰 및 평점", "소셜미디어 활동", "채용 공고 분석", "언론 보도 자료" ], "real_examples": """ **클라우드 스토리지 경쟁 분석**: [Executive Summary] Dropbox, Google Drive, OneDrive 3강 구도에서 보안과 협업 기능이 차별화 포인트로 부상 [제품 비교] - 저장 용량: Dropbox(2GB) < Google Drive(15GB) < OneDrive(5GB) - 협업 기능: OneDrive > Google Drive > Dropbox - 보안: Dropbox > OneDrive > Google Drive [가격 전략] Dropbox: 프리미엄 전략 (월 $12) Google: 통합 서비스 전략 (월 $6) Microsoft: 번들링 전략 (Office 365 포함) """ }, "페르소나": { "definition": "실제 고객 데이터를 바탕으로 만든 가상의 대표 고객 프로필", "purpose": "고객 중심 제품 개발, 마케팅 메시지 개인화, 팀 내 고객 이해 통일", "key_components": [ "인구통계학적 정보", "행동 패턴 및 선호도", "목표와 동기 (Goals & Motivations)", "고충과 해결 과제 (Pain Points)", "정보 습득 채널", "구매 의사결정 프로세스", "선호하는 커뮤니케이션 스타일" ], "creation_process": [ "고객 인터뷰 및 설문 조사", "사용자 행동 데이터 분석", "고객 지원팀 인사이트 수집", "세그멘테이션 및 클러스터링", "페르소나 검증 및 업데이트" ], "validation_methods": [ "실제 고객과의 검증 인터뷰", "A/B 테스트를 통한 효과 측정", "마케팅 캠페인 성과 분석", "제품 사용 패턴 추적" ], "real_examples": """ **SaaS 마케팅 툴 페르소나**: [Sarah, 마케팅 매니저, 32세] Demographics: - 직급: 마케팅 매니저 (경력 5년) - 회사: B2B SaaS (직원 50-200명) - 연봉: 5,500만원 - 거주지: 서울 강남 Goals: - 마케팅 ROI 개선 (주요 KPI) - 리드 품질 향상 - 팀 생산성 증대 Pain Points: - 분산된 마케팅 데이터 통합의 어려움 - 실시간 성과 모니터링 불가 - 보고서 작성에 소요되는 시간 Preferred Channels: - LinkedIn (업계 트렌드) - 이메일 뉴스레터 - 웨비나 및 온라인 세미나 """ }, "VOC 요약": { "definition": "고객의 소리(Voice of Customer)를 수집하고 분석하여 핵심 인사이트를 요약한 보고서", "purpose": "고객 만족도 개선, 제품 개발 방향 설정, 서비스 품질 향상", "key_sections": [ "조사 개요 및 방법론", "주요 발견사항 (Key Findings)", "고객 만족도 현황", "주요 불만사항 및 개선 요청", "긍정적 피드백 및 만족 요인", "고객 세그먼트별 차이점", "개선 우선순위 및 액션 플랜" ], "data_collection_methods": [ "고객 만족도 설문조사", "심층 인터뷰 (FGI)", "고객 지원팀 티켓 분석", "온라인 리뷰 및 소셜 미디어", "사용자 행동 데이터" ], "analysis_techniques": [ "텍스트 마이닝 및 감성 분석", "테마별 키워드 클러스터링", "만족도-중요도 매트릭스", "고객 여정별 터치포인트 분석" ], "real_examples": """ **이커머스 VOC 분석 요약**: [주요 발견사항] - 전체 고객 만족도: 7.2/10 (목표 8.0) - NPS(Net Promoter Score): +15 (업계 평균 +8) [Top 3 불만사항] 1. 배송 지연 (37% 언급) 2. 반품/교환 절차 복잡 (24%) 3. 고객센터 응답 지연 (19%) [Top 3 만족요인] 1. 상품 품질 (42% 언급) 2. 가격 경쟁력 (31%) 3. 웹사이트 사용 편의성 (28%) [즉시 개선 필요 영역] 우선순위 1: 배송 프로세스 개선 (만족도 영향 최대) 우선순위 2: 고객센터 응답시간 단축 """ }, "유스케이스": { "definition": "사용자가 시스템을 통해 달성하고자 하는 목표와 그 과정을 구체적으로 기술한 문서", "purpose": "요구사항 명확화, 개발 가이드 제공, 테스트 시나리오 기반 제공", "key_components": [ "액터 (Actor) - 시스템 사용자", "전제조건 (Preconditions)", "주요 시나리오 (Main Flow)", "대안 시나리오 (Alternative Flows)", "예외 상황 (Exception Flows)", "후조건 (Postconditions)", "비즈니스 규칙" ], "writing_guidelines": [ "사용자 관점에서 작성", "구체적이고 측정 가능한 결과", "기술적 세부사항보다 비즈니스 가치 중심", "예외 상황까지 포괄적 커버" ], "validation_criteria": [ "실제 사용자 시나리오와 일치", "개발팀이 구현 가능", "테스트 케이스 도출 가능", "비즈니스 목표 달성에 기여" ], "real_examples": """ **온라인 쇼핑몰 주문 유스케이스**: [UC-001: 상품 주문하기] Actor: 로그인한 고객 Preconditions: - 고객이 회원 가입 및 로그인 완료 - 장바구니에 1개 이상 상품 존재 Main Flow: 1. 고객이 장바구니 페이지에서 "주문하기" 클릭 2. 시스템이 배송지 정보 입력 페이지 표시 3. 고객이 배송지 정보 입력 및 확인 4. 시스템이 결제 방법 선택 페이지 표시 5. 고객이 결제 방법 선택 및 결제 정보 입력 6. 시스템이 주문 정보 확인 페이지 표시 7. 고객이 최종 주문 확인 8. 시스템이 결제 처리 및 주문 완료 안내 Exception Flow: - 3a. 배송 불가 지역인 경우 3a1. 시스템이 배송 불가 메시지 표시 3a2. UC 종료 """ }, "UX 카피": { "definition": "사용자 인터페이스에서 사용자 경험을 향상시키기 위한 모든 텍스트 요소", "purpose": "사용자 이해도 증진, 행동 유도, 브랜드 톤 전달, 에러 상황 안내", "key_components": [ "내비게이션 및 메뉴 라벨", "버튼 텍스트 및 CTA", "안내 메시지 및 도움말", "에러 및 성공 메시지", "폼 라벨 및 플레이스홀더", "툴팁 및 설명문" ], "writing_principles": [ "명확성: 간단하고 이해하기 쉬운 언어", "일관성: 동일한 기능에는 동일한 용어", "도움이 되는 톤: 친근하되 전문적", "실행 가능성: 사용자가 다음에 할 일 명확히 제시" ], "testing_methods": [ "사용자 테스트 및 A/B 테스트", "완료율 및 이탈률 분석", "고객 지원팀 문의 빈도 추적", "사용자 피드백 정성 분석" ], "real_examples": """ **모바일 뱅킹 앱 UX 카피**: [Before - 애매한 표현] - 버튼: "처리" - 에러: "오류가 발생했습니다" - 안내: "정보를 확인해주세요" [After - 명확한 UX 카피] - 버튼: "이체하기" - 에러: "비밀번호가 일치하지 않습니다. 다시 입력해주세요" - 안내: "계좌번호 14자리를 정확히 입력해주세요" [톤앤매너 일관성] - 성공: "이체가 완료되었습니다" - 진행: "이체 중입니다. 잠시만 기다려주세요" - 안내: "이체 한도는 일일 500만원입니다" """ }, "릴리스 노트": { "definition": "제품의 새로운 버전 출시 시 변경사항과 개선사항을 사용자에게 알리는 문서", "purpose": "사용자 교육, 신기능 홍보, 투명한 커뮤니케이션, 사용자 만족도 향상", "key_components": [ "버전 정보 및 출시일", "주요 신기능 소개", "기존 기능 개선사항", "버그 수정 내역", "알려진 이슈 및 제한사항", "업그레이드 가이드", "지원 및 문의 정보" ], "writing_style": [ "사용자 친화적 언어 사용", "기술적 용어보다 혜택 중심 설명", "시각적 요소 (스크린샷, GIF) 활용", "감사 표현 및 긍정적 톤" ], "distribution_channels": [ "앱 스토어 업데이트 설명", "이메일 뉴스레터", "인앱 알림 및 팝업", "웹사이트 및 블로그", "소셜 미디어" ], "real_examples": """ **프로젝트 관리 툴 릴리스 노트 v2.4**: 🎉 새로운 기능 • **팀 대시보드**: 팀 전체 진행률을 한눈에 확인하세요 • **자동 알림**: 마감일 3일 전 자동으로 알림을 받으세요 • **템플릿 갤러리**: 업종별 프로젝트 템플릿 20개 추가 🔧 개선사항 • 파일 업로드 속도 50% 향상 • 모바일 앱 UI 개선으로 터치 반응성 증대 • 검색 기능 정확도 개선 🐛 버그 수정 • 댓글 알림이 오지 않던 문제 해결 • 엑셀 파일 다운로드 오류 수정 💝 피드백을 보내주신 500+ 사용자분들께 감사드립니다! """ } } # 완전한 User 설명 USER_DETAILED = { "세일즈": { "definition": "제품이나 서비스를 잠재 고객에게 판매하는 역할을 담당하는 직무", "primary_goals": [ "매출 목표 달성", "신규 고객 확보", "기존 고객 관계 유지", "파이프라인 관리" ], "key_metrics": [ "매출 달성률 (%)", "신규 고객 수", "평균 딜 사이즈", "세일즈 사이클", "전환율 (Lead → Opportunity → Close)" ], "daily_challenges": [ "리드 발굴 및 검증", "고객 관계 구축", "제안서 작성", "협상 및 클로징", "CRM 업데이트" ], "communication_style": [ "결과 중심적 언어", "숫자와 데이터 선호", "신속한 의사결정 요구", "구체적인 혜택 강조" ], "content_needs": [ "고객 사례 연구", "ROI 계산기", "경쟁사 비교 자료", "가격 정책 가이드", "이메일 템플릿" ], "personas": { "BDR (Business Development Rep)": "신규 리드 발굴 및 초기 접촉 전담", "AE (Account Executive)": "기회 발굴부터 계약 체결까지 전체 세일즈 프로세스 담당", "AM (Account Manager)": "기존 고객 관리 및 업셀/크로스셀 담당", "Sales Leader": "팀 관리 및 전략 수립, 목표 설정" } }, "마케팅팀": { "definition": "브랜드 인지도 제고, 리드 생성, 고객 유치를 위한 마케팅 활동을 기획하고 실행하는 직무", "primary_goals": [ "브랜드 인지도 향상", "양질의 리드 생성", "고객 획득 비용 최적화", "마케팅 ROI 극대화" ], "key_metrics": [ "리드 생성 수 및 품질", "CAC (Customer Acquisition Cost)", "LTV (Customer Lifetime Value)", "마케팅 ROI/ROAS", "브랜드 인지도 지표" ], "specialized_roles": { "퍼포먼스 마케팅": "유료 광고 운영 및 최적화, 데이터 기반 의사결정", "콘텐츠 마케팅": "블로그, 영상, 소셜미디어 콘텐츠 기획 및 제작", "브랜드 마케팅": "브랜드 아이덴티티 구축 및 일관성 유지", "그로스 마케팅": "실험적 접근으로 빠른 성장 동력 발굴" }, "communication_preferences": [ "창의적이고 트렌디한 표현", "시각적 요소 중요시", "스토리텔링 선호", "감정적 연결 추구" ], "tool_ecosystem": [ "Google Analytics, Adobe Analytics", "Facebook Ads Manager, Google Ads", "HubSpot, Marketo (마케팅 자동화)", "Canva, Figma (디자인 툴)" ] }, "PM": { "definition": "제품의 전략, 기획, 개발, 출시까지 전체 라이프사이클을 관리하는 역할", "core_responsibilities": [ "제품 전략 수립", "시장 및 고객 요구사항 분석", "제품 로드맵 작성", "크로스팩셔널 팀 조율", "제품 성과 모니터링" ], "key_skills": [ "데이터 분석 및 해석", "사용자 중심 사고", "기술적 이해도", "비즈니스 센스", "커뮤니케이션 및 리더십" ], "decision_framework": [ "Impact vs Effort 매트릭스", "RICE 스코어링 (Reach, Impact, Confidence, Effort)", "OKR (Objectives and Key Results)", "데이터 기반 의사결정" ], "stakeholder_management": [ "Engineering: 기술적 실현가능성 논의", "Design: 사용자 경험 최적화", "Sales: 시장 요구사항 및 피드백", "Leadership: 전략 정렬 및 리소스 확보" ], "career_levels": { "Jr PM": "1-3년 경력, 특정 기능 담당, 멘토링 필요", "Sr PM": "3-7년 경력, 독립적 제품 영역 담당", "Group PM": "7+ 경력, 여러 제품/팀 총괄, 전략 수립" } }, "전략팀": { "definition": "기업의 장기적 방향성 설정, 신사업 기회 발굴, 경영진 의사결정 지원을 담당하는 직무", "primary_functions": [ "시장 분석 및 경쟁 인텔리전스", "신사업 기회 평가", "M&A 및 파트너십 검토", "경영 전략 수립", "성과 모니터링 및 분석" ], "analytical_frameworks": [ "Porter's Five Forces", "SWOT Analysis", "BCG Matrix", "McKinsey 7S Model", "Blue Ocean Strategy" ], "deliverables": [ "시장 분석 보고서", "경쟁사 벤치마킹", "비즈니스 케이스", "전략 프레젠테이션", "실행 계획서" ], "communication_style": [ "논리적이고 구조화된 사고", "데이터와 사실 기반", "전략적 함의 중시", "장기적 관점" ], "career_paths": { "Corp Strategy": "기업 전체 차원의 전략 수립", "Biz Ops": "운영 효율성 및 프로세스 개선 중심" } }, "PR팀": { "definition": "기업의 대외 이미지 관리와 언론 관계, 커뮤니케이션 전략을 담당하는 직무", "primary_goals": [ "브랜드 이미지 관리 및 향상", "미디어 관계 구축 및 유지", "위기 상황 대응 및 관리", "기업 메시지 일관성 확보" ], "key_metrics": [ "언론 보도량 및 톤", "브랜드 멘션 증가율", "미디어 도달율 (Reach)", "위기 대응 시간", "브랜드 인지도 지표" ], "core_activities": [ "보도자료 작성 및 배포", "기자 관계 관리", "이벤트 및 기자간담회 기획", "위기 커뮤니케이션 대응", "내부 커뮤니케이션 지원" ], "communication_style": [ "정확하고 신뢰할 수 있는 정보 전달", "브랜드 메시지 일관성 유지", "타이밍과 맥락 고려", "투명하고 진정성 있는 소통" ], "specialized_roles": { "코퍼레이트 PR": "기업 전체 이미지 및 경영진 커뮤니케이션", "프로덕트 PR": "제품/서비스 관련 홍보 및 런칭 지원" } }, "창업자": { "definition": "새로운 비즈니스를 시작하고 이끌어가는 기업의 설립자 및 최고 의사결정자", "primary_goals": [ "비전 구현 및 회사 성장", "자금 조달 및 투자 유치", "핵심 인재 확보", "제품-시장 궁합(PMF) 달성", "지속 가능한 비즈니스 모델 구축" ], "key_challenges": [ "제한된 리소스 내 우선순위 결정", "불확실성 하에서의 빠른 의사결정", "다양한 이해관계자 관리", "개인적 스트레스 및 고독감 관리" ], "communication_needs": [ "투자자를 위한 피칭 자료", "직원들을 위한 비전 전달", "고객을 위한 가치 제안", "파트너를 위한 협력 제안" ], "decision_criteria": [ "장기적 비전과의 정렬성", "빠른 실행 가능성", "리소스 효율성", "시장 임팩트 잠재력" ], "stage_characteristics": { "Seed": "아이디어 검증, 초기 제품 개발, 팀 구성", "Series A+": "성장 가속화, 조직 확장, 시장 점유율 확대", "부트스트랩": "자체 자금으로 성장, 수익성 중심 운영" } }, "기획팀": { "definition": "조직의 중장기 계획 수립과 프로젝트 기획, 성과 관리를 담당하는 직무", "primary_functions": [ "사업 계획 수립 및 관리", "프로젝트 기획 및 추진", "성과 지표 설정 및 모니터링", "조직 운영 효율성 개선", "신사업 기회 발굴" ], "key_skills": [ "체계적 사고 및 분석 능력", "프로젝트 관리 역량", "데이터 분석 및 인사이트 도출", "이해관계자 조율", "문서화 및 커뮤니케이션" ], "deliverables": [ "사업 계획서", "프로젝트 기획서", "성과 보고서", "시장 분석 자료", "정책 제안서" ], "communication_style": [ "논리적이고 체계적인 구성", "데이터 기반 근거 제시", "명확한 목표 및 일정 명시", "리스크와 대안 함께 제시" ] }, "컨설턴트": { "definition": "기업의 문제 해결과 성과 개선을 위해 전문적 조언과 솔루션을 제공하는 전문가", "primary_goals": [ "고객 문제의 정확한 진단", "효과적인 솔루션 설계", "변화 관리 및 실행 지원", "측정 가능한 성과 창출" ], "expertise_areas": [ "전략 컨설팅 (Strategy)", "운영 컨설팅 (Operations)", "조직/HR 컨설팅", "IT/디지털 컨설팅", "재무 컨설팅" ], "methodology": [ "문제 정의 및 현황 분석", "가설 설정 및 검증", "솔루션 설계 및 제안", "실행 계획 수립", "성과 측정 및 개선" ], "communication_characteristics": [ "구조화된 논리 전개", "프레임워크 기반 분석", "액션 중심의 제안", "경영진 언어로 소통" ], "key_deliverables": [ "현황 진단 보고서", "문제 분석 및 원인 규명", "솔루션 제안서", "실행 로드맵", "성과 측정 대시보드" ] }, "IR/투자준비팀": { "definition": "투자자 관계 관리와 자금 조달, 기업 가치 제고를 담당하는 전문 조직", "primary_functions": [ "투자자 관계 관리 (Investor Relations)", "자금 조달 전략 수립 및 실행", "기업 가치 평가 및 제고", "재무 정보 공시 및 커뮤니케이션", "시장 동향 분석 및 보고" ], "key_stakeholders": [ "기관 투자자 (VC, PE 등)", "개인 투자자", "애널리스트 및 신용평가사", "경영진 및 이사회", "규제 기관" ], "core_materials": [ "투자 제안서 (IR Deck)", "사업 계획서", "재무 모델링", "기업 개요서", "실적 발표 자료" ], "communication_focus": [ "재무적 성과와 전망", "비즈니스 모델의 지속가능성", "경쟁 우위 및 차별화 요소", "리스크 요인 및 대응 방안", "ESG 경영 성과" ], "success_metrics": [ "투자 유치 성공률", "기업 가치 상승률", "투자자 만족도", "시장 인지도", "자금 조달 비용" ] }, "UX 디자이너": { "definition": "사용자 경험을 연구하고 설계하여 사용하기 쉽고 만족스러운 제품을 만드는 전문가", "primary_goals": [ "사용자 중심의 경험 설계", "사용성 및 접근성 향상", "비즈니스 목표와 사용자 니즈 균형", "데이터 기반 디자인 의사결정" ], "key_processes": [ "사용자 리서치 및 인사이트 도출", "사용자 여정 맵핑", "와이어프레임 및 프로토타입 제작", "사용성 테스트 및 검증", "디자인 시스템 구축 및 관리" ], "core_deliverables": [ "사용자 리서치 보고서", "페르소나 및 사용자 여정", "와이어프레임 및 플로우차트", "인터랙티브 프로토타입", "디자인 가이드라인" ], "collaboration_focus": [ "PM과의 요구사항 정의", "개발팀과의 구현 가능성 검토", "마케팅팀과의 사용자 이해 공유", "경영진과의 비즈니스 임팩트 논의" ], "specialized_roles": { "UX Writer": "사용자 인터페이스 텍스트 및 마이크로카피 전문", "Product Designer": "제품 전반의 사용자 경험 설계 담당" } }, "개발팀": { "definition": "소프트웨어 제품의 설계, 개발, 테스트, 배포를 담당하는 기술 전문가 그룹", "primary_goals": [ "안정적이고 확장 가능한 시스템 구축", "사용자 요구사항의 기술적 구현", "코드 품질 및 보안 유지", "개발 효율성 및 배포 속도 향상" ], "key_responsibilities": [ "기능 요구사항 분석 및 설계", "코드 작성 및 리뷰", "테스트 코드 작성 및 품질 보증", "배포 및 운영 모니터링", "기술 부채 관리" ], "communication_needs": [ "기술 명세서 및 API 문서", "아키텍처 설계 문서", "코드 리뷰 가이드라인", "배포 및 운영 매뉴얼", "장애 대응 보고서" ], "decision_criteria": [ "기술적 실현 가능성", "성능 및 확장성", "보안 및 안정성", "개발 및 유지보수 비용", "팀 역량 및 학습 곡선" ], "specialized_roles": { "FE (Frontend)": "사용자 인터페이스 개발 전담", "BE (Backend)": "서버 및 데이터 처리 로직 개발", "ML (Machine Learning)": "AI/ML 모델 개발 및 데이터 분석", "Infra": "인프라 구축 및 DevOps 담당" } }, "QA": { "definition": "소프트웨어 제품의 품질을 보장하기 위해 테스트를 설계하고 실행하는 품질 관리 전문가", "primary_goals": [ "결함 조기 발견 및 예방", "사용자 관점의 품질 검증", "릴리즈 품질 기준 확보", "테스트 프로세스 개선" ], "key_activities": [ "테스트 계획 수립 및 케이스 작성", "수동/자동 테스트 실행", "결함 발견 및 재현", "품질 지표 모니터링", "테스트 자동화 구축" ], "testing_types": [ "기능 테스트 (Functional Testing)", "성능 테스트 (Performance Testing)", "보안 테스트 (Security Testing)", "사용성 테스트 (Usability Testing)", "회귀 테스트 (Regression Testing)" ], "communication_focus": [ "명확하고 재현 가능한 결함 보고", "테스트 결과의 정량적 제시", "리스크 기반 우선순위 제안", "품질 개선을 위한 제안사항" ], "career_levels": { "QA 엔지니어": "테스트 실행 및 결함 발견 중심", "QA 리드": "테스트 전략 수립 및 팀 관리" } } } # ========================================================= # 3. 로직 함수들 # ========================================================= def uniq(xs: List[str]) -> List[str]: if not xs: return [] s=set(); out=[] for x in xs: if x not in s: s.add(x); out.append(x) return out AUTO_RULES_PAIN = { "반응률": ["Persona Prompting", "Few-shot Prompting", "Self-consistency Prompting"], "불일치": ["Output Formatting", "Constrained Prompting"], "작성": ["Output Formatting", "Few-shot Prompting"], "경쟁": ["RAG Prompting", "Chain-of-Thought (CoT)"], "요구": ["Persona Prompting", "Step-back Prompting"], } AUTO_RULES_OUTPUT = { "이메일": ["Persona Prompting", "Output Formatting", "Few-shot Prompting", "Self-consistency Prompting"], "카피": ["Few-shot Prompting", "Self-consistency Prompting", "Output Formatting"], "보고서": ["RAG Prompting", "Chain-of-Thought (CoT)", "Output Formatting"], "PRD": ["Role Prompting", "Constrained Prompting", "Chain-of-Thought (CoT)"], } AUTO_RULES_USER = { "세일즈": ["Persona Prompting", "Few-shot Prompting", "Self-consistency Prompting"], "마케팅": ["Few-shot Prompting", "Self-consistency Prompting"], "전략": ["Chain-of-Thought (CoT)", "Step-back Prompting", "RAG Prompting"], "PM": ["Role Prompting", "Constrained Prompting"], "데이터": ["RAG Prompting", "Constrained Prompting"], } def auto_recommend(domain_key, pains, outs, users): rec=[] if not domain_key: return [], "" if domain_key=="1 외부 커뮤니케이션": rec+=["Persona Prompting","Few-shot Prompting","Self-consistency Prompting","Output Formatting"] if domain_key=="2 시장·고객 리서치": rec+=["RAG Prompting","Chain-of-Thought (CoT)","Output Formatting","Step-back Prompting"] if domain_key=="3 제품·UX 문서": rec+=["Role Prompting","Constrained Prompting","Chain-of-Thought (CoT)","Output Formatting"] for p in pains or []: for k,ts in AUTO_RULES_PAIN.items(): if k in p: rec+=ts for o in outs or []: for k,ts in AUTO_RULES_OUTPUT.items(): if k in o: rec+=ts for u in users or []: for k,ts in AUTO_RULES_USER.items(): if k in u: rec+=ts rec.append("Output Formatting") unique_rec = uniq(rec) rationale_md = "### 🔮 자동 추천 기술 및 핵심 근거\n\n" if not unique_rec: rationale_md += "선택된 항목에 대한 자동 추천 기술이 없습니다. 직접 기술을 선택해주세요." else: for tech in unique_rec: g = TECH_DETAILED.get(tech, {}) desc = g.get("desc", "설명 없음") rationale_md += f"- **{tech}**: {desc}\n" return gr.update(value=unique_rec, choices=uniq(ALL_TECHS + unique_rec)), rationale_md def reason_from_pain(tech: str, pains: List[str], pain_subs: List[str]) -> List[str]: R=[] jp=" ".join(pains or []) + " " + " ".join(pain_subs or []) if "반응률" in jp: if tech=="Persona Prompting": R.append("반응률 저조 → 세그먼트 맞춤 어휘/어조로 **체감 가치** 상승") if tech=="Few-shot Prompting": R.append("반응률 저조 → 고성과 예시 패턴 복제") if tech=="Self-consistency Prompting": R.append("반응률 저조 → 다변량 후보 생성→자체 채점으로 **Top-1**") if "불일치" in jp or "톤/보이스" in jp or "포맷" in jp: if tech=="Output Formatting": R.append("메시지 불일치 → 형식/섹션 고정으로 정합성↑") if tech=="Constrained Prompting": R.append("메시지 불일치 → 금칙/길이/필수필드 강제") if "작성 시간" in jp or "예시 부족" in jp: if tech in {"Few-shot Prompting","Output Formatting"}: R.append("작성시간 과다/예시 부족 → 템플릿 + 예시 기반으로 속도↑") if "경쟁사 정보" in jp: if tech=="RAG Prompting": R.append("경쟁사 정보 부족 → 외부 데이터 근거 주입(최신성/신뢰성)") if tech=="Chain-of-Thought (CoT)": R.append("경쟁사 분석 구조화(CoT)로 인사이트 명료화") if "요구 불명확" in jp: if tech in {"Persona Prompting","Step-back Prompting"}: R.append("고객 요구 불명확 → 상위 목적/JTBD 정렬") return R def reason_from_output(tech: str, outs: List[str], out_subs: List[str]) -> List[str]: R=[] jo=" ".join(outs or []) + " " + " ".join(out_subs or []) if "메일" in jo or "카피" in jo or "랜딩" in jo: if tech=="Output Formatting": R.append("카피/메일 계열 → **헤드라인/서브/바디/CTA** 고정이 성과 좌우") if tech=="Self-consistency Prompting": R.append("메시지 후보 다변량 생성→최적안 선택 필요") if tech=="Few-shot Prompting": R.append("채널별 톤/길이 차이를 예시로 빠르게 적응") if "보고서" in jo or "분석" in jo: if tech=="RAG Prompting": R.append("보고서/분석 → 수치·출처 최신성 보장") if tech=="Chain-of-Thought (CoT)": R.append("보고서/분석 → 단계적 구조(CoT)로 논리 강화") if "PRD" in jo or "API" in jo: if tech in {"Constrained Prompting","Role Prompting"}: R.append("PRD/API → JSON/필드 강제 + 직무 관점 고정 필요") return R def reason_from_user(tech: str, users: List[str], user_subs: List[str]) -> List[str]: R=[] ju=" ".join(users or []) + " " + " ".join(user_subs or []) if "세일즈" in ju: if tech=="Persona Prompting": R.append("Sales는 파이프라인/승률 언어 선호 → 페르소나 톤 적용") if tech=="Few-shot Prompting": R.append("영업 레퍼런스 사례 모사가 설득력↑") if "전략" in ju: if tech in {"Chain-of-Thought (CoT)","Step-back Prompting","RAG Prompting"}: R.append("전략조직은 근거/논리/시사점 중시 → CoT+RAG+Step-back 적합") if "PM" in ju or "UX" in ju: if tech in {"Role Prompting","Constrained Prompting"}: R.append("PM/UX는 필드/AC/톤 표준 필요 → 역할 고정 + 제약 강제") return R # ========================================================= # 4. 상세 정보 표시 함수들 # ========================================================= def show_pain_details(selected_pains): if not selected_pains: return "Pain Point를 선택하면 상세 설명이 여기에 표시됩니다." details_html = "
" for pain in selected_pains: if pain in PAIN_DETAILED: detail = PAIN_DETAILED[pain] details_html += f"""

📍 {pain}

정의: {detail['definition']}

주요 증상:

근본 원인:

비즈니스 임팩트: {detail['business_impact']}

실제 사례:
    {"".join([f'
  • {example}
    • ' for example in detail['real_examples']])}

측정 방법: {detail['measurement']}

""" details_html += "
" return details_html def show_output_details(selected_outputs): if not selected_outputs: return "Output을 선택하면 상세 설명이 여기에 표시됩니다." details_html = "
" for output in selected_outputs: if output in OUTPUT_DETAILED: detail = OUTPUT_DETAILED[output] details_html += f"""

📄 {output}

정의: {detail['definition']}

목적: {detail['purpose']}

핵심 구성요소:

""" if 'success_metrics' in detail: details_html += f"""

성공 지표:

""" if 'real_examples' in detail: details_html += f"""
실제 예시: 
{detail['real_examples']}
""" details_html += "
" details_html += "
" return details_html def show_user_details(selected_users): if not selected_users: return "User를 선택하면 상세 설명이 여기에 표시됩니다." details_html = "
" for user in selected_users: if user in USER_DETAILED: detail = USER_DETAILED[user] details_html += f"""

👤 {user}

정의: {detail['definition']}

주요 목표:

핵심 지표:

""" if 'communication_style' in detail: details_html += f"""

커뮤니케이션 스타일:

""" if 'personas' in detail: details_html += f"""

세부 역할:

""" if 'specialized_roles' in detail: details_html += f"""

전문 분야:

""" details_html += "
" details_html += "
" return details_html def show_tech_details(selected_techs): if not selected_techs: return "프롬프팅 기술을 선택하면 상세 설명이 여기에 표시됩니다." details_html = "
" for tech in selected_techs: if tech in TECH_DETAILED: detail = TECH_DETAILED[tech] details_html += f"""

🛠️ {tech}

📖 정의: {detail['desc']}

🎯 목적: {detail['purpose']}

⏰ 언제 사용: {detail['when_to_use']}

🔧 작동 원리:

💡 실무 예시: 
{detail['real_example']}

✅ 활용 팁: {detail['tips']}

⚠️ 주의사항: {detail['avoid']}

""" details_html += "
" return details_html # ========================================================= # 5. 카탈로그 및 템플릿 # ========================================================= CATALOG = { "1 외부 커뮤니케이션": { "subdomains": ["이메일(콜드/웜)", "광고/랜딩", "PR/보도자료", "SNS/영상"], "pains": ["반응률 저조", "메시지 불일치", "작성 시간 과다", "A/B 테스트 부담"], "outputs": ["콜드메일", "광고 카피", "보도자료", "랜딩페이지 섹션"], "users": ["세일즈", "마케팅팀", "PR팀", "창업자"] }, "2 시장·고객 리서치": { "subdomains": ["시장보고서", "경쟁분석", "VOC 분석", "페르소나"], "pains": ["경쟁사 정보 부족", "고객 요구 불명확", "출처/기간 누락", "리서치 작성 부담"], "outputs": ["시장조사 보고서", "경쟁사 분석", "페르소나", "VOC 요약"], "users": ["전략팀", "기획팀", "컨설턴트", "IR/투자준비팀"] }, "3 제품·UX 문서": { "subdomains": ["PRD/요구사항", "유스케이스", "UX 마이크로카피", "릴리스 노트"], "pains": ["요구사항 언어화 난항", "UX 카피 불일치", "의사결정 기준 불명확"], "outputs": ["PRD", "유스케이스", "UX 카피", "릴리스 노트"], "users": ["PM", "UX 디자이너", "개발팀", "QA"] }, } PAIN_SUB = { "반응률 저조": ["제목/프리헤더", "타게팅", "CTA 약함", "신뢰 근거 부족"], "메시지 불일치": ["톤/보이스", "포맷/길이", "채널/페이싱"], "작성 시간 과다": ["템플릿 부재", "예시 부족", "승인 루프 지연"], "A/B 테스트 부담": ["설계 복잡성", "결과 분석", "리소스 부족"], "경쟁사 정보 부족": ["자료 수집", "정합성 검증", "최신성"], "고객 요구 불명확": ["세그먼트 정의", "JTBD 모호", "페인/게인"], "출처/기간 누락": ["데이터 검증", "신뢰성 확보", "유효기간"], "리서치 작성 부담": ["효율성", "표준화", "재활용"], "요구사항 언어화 난항": ["추상성", "기술 격차", "검증 프로세스"], "UX 카피 불일치": ["용어 통일", "톤앤매너", "브랜드 보이스"], "의사결정 기준 불명확": ["평가 지표", "우선순위", "프로세스"], } OUTPUT_SUB = { "콜드메일": ["신규 인바운드", "콜드 아웃바운드", "후속/리마인드", "이탈 재참여"], "광고 카피": ["웹 배너", "검색광고", "SNS 카드", "앱 푸시"], "보도자료": ["제품 출시", "투자 유치", "인사 발령", "업계 동향"], "랜딩페이지 섹션": ["Hero", "Feature", "Testimonial", "CTA"], "시장조사 보고서": ["탑다운(탐색)", "바텀업 추정", "혼합 접근", "리서치 브리프"], "경쟁사 분석": ["기능 비교표", "가격/패키지", "포지셔닝 맵", "SWOT"], "페르소나": ["B2B 구매자", "B2C 소비자", "내부 사용자", "파트너"], "VOC 요약": ["만족도 조사", "불만 분석", "개선 요청", "트렌드 분석"], "PRD": ["문제정의", "목표/지표", "범위/비범위", "수용기준(AC)", "리스크"], "유스케이스": ["주요 시나리오", "대안 플로우", "예외 상황", "비즈니스 규칙"], "UX 카피": ["버튼/CTA", "에러 메시지", "안내문", "폼 라벨"], "릴리스 노트": ["신기능", "개선사항", "버그수정", "알려진 이슈"], } USER_SUB = { "세일즈": ["BDR", "AE", "AM", "Sales Leader"], "마케팅팀": ["퍼포먼스", "콘텐츠", "브랜드", "그로스"], "PR팀": ["코퍼레이트", "프로덕트 PR"], "창업자": ["Seed", "Series A+", "부트스트랩"], "전략팀": ["Corp Strategy", "Biz Ops"], "기획팀": ["사업기획", "정책기획", "운영기획"], "컨설턴트": ["전략", "운영", "조직/HR", "IT/디지털"], "IR/투자준비팀": ["기관투자", "개인투자", "공시/IR"], "PM": ["Jr PM", "Sr PM", "Group PM"], "UX 디자이너": ["UX Writer", "Product Designer"], "개발팀": ["FE", "BE", "ML", "Infra"], "QA": ["QA 엔지니어", "QA 리드"] } TEMPLATE = """ # 최종 목표 (Mission Statement) {mission} # 산출물 정의 (Output Definition) - **산출물 종류**: {out} - **핵심 성공 지표(KPI)**: {kpi} - **성공 기준**: 1) **형식**: [{format_hint}] 구조를 100% 준수해야 함. 2) **가치**: 최종 독자인 [{audience}]에게 첫 3줄 안에 핵심 가치가 전달되어야 함. 3) **품질**: 스팸성, 과장, 모호한 표현이 없어야 함. # 가드레일 (Guardrails) - **톤앤매너**: {tone} - **금지 표현**: {ng} # 적용된 프롬프팅 전략 및 근거 (Prompting Strategies & Rationale) {tech_blocks} {rag_section} # 구체적인 작성 작업 (Task) 1. 위에 제시된 **모든 정의, 가드레일, 전략, 컨텍스트를 종합적으로 반영**하여 [{out}]의 초안을 작성하라. 2. [{format_hint}] 형식에 맞춰 섹션별로 내용을 구성하라. 3. 핵심적인 메시지, 제목, CTA에 대해서는 2~3개의 대안을 함께 제시하라. 4. 최종 결과물 마지막에, 아래 **자가 검수 체크리스트**를 포함하고 스스로 점검하라. --- **[자가 검수 체크리스트]** - [ ] 미션 스테이트먼트의 목표를 달성하는가? - [ ] 최종 독자({audience})의 언어와 관심사에 부합하는가? - [ ] 지정된 톤앤매너({tone})를 일관되게 유지하는가? - [ ] 금지 표현({ng})을 사용하지 않았는가? - [ ] 선택된 프롬프팅 기술들의 의도가 실제로 반영되었는가? """ def compose_final_prompt( mission, domain_key, pains, pain_subs, outs, out_subs, users, user_subs, techs, my_rationale, kpi_text, tone_text, ng_text, format_override, fewshot_text, rag_text ): if not all([mission.strip(), domain_key, techs]): return "⚠️ [Phase 1]의 미션 선언문과 [Phase 2]의 기술 선택을 먼저 완료해주세요." format_hint = format_override.strip() or ("섹션별 제목/본문" if not outs else "자동 추정 필요") audience = ", ".join(user_subs or users or ["정의되지 않은 사용자"]) kpi = kpi_text.strip() or "정확성, 명료성, 설득력" tone = tone_text.strip() or "전문적이고 객관적이며 간결함" ng = ng_text.strip() or "과장, 추측, 근거 없는 주장" tech_blocks = [] if my_rationale.strip(): tech_blocks.append(f"## 내 전략과 근거\n{my_rationale.strip()}\n") for t in techs: reasons = uniq( reason_from_pain(t, pains, pain_subs) + reason_from_output(t, outs, out_subs) + reason_from_user(t, users, user_subs) ) head = f"- **{t}**: {TECH_DETAILED.get(t,{}).get('desc','')}" tail = "" if reasons: tail = "\n - **선정 근거**: " + " / ".join(reasons[:3]) tech_blocks.append(head + tail) if fewshot_text.strip(): tech_blocks.append(f"- **Few-shot 예시 (모방할 패턴)**:\n```\n{fewshot_text.strip()}\n```") rag_section = "" if rag_text.strip(): rag_section = f"# 참고 자료 및 컨텍스트\n{rag_text.strip()}\n" return TEMPLATE.format( mission=mission, out=", ".join(outs or ["정의되지 않음"]), kpi=kpi, format_hint=format_hint, audience=audience, tone=tone, ng=ng, tech_blocks="\n".join(tech_blocks), rag_section=rag_section ).strip() # ========================================================= # 6. Gradio UI # ========================================================= css = """ .gradio-container { font-family: 'IBM Plex Sans KR', sans-serif; max-width: 1400px; } .gr-button { color: white; border: none; border-radius: 8px; } .gr-button-primary { background: linear-gradient(to right, #4A90E2, #50E3C2); } .phase-header { background: linear-gradient(90deg, #667eea 0%, #764ba2 100%); color: white; padding: 15px; border-radius: 10px; margin: 10px 0; text-align: center; font-weight: bold; } .detail-panel { background-color: #f8f9fa; border-radius: 8px; padding: 15px; margin-top: 10px; } """ with gr.Blocks(theme=gr.themes.Soft(), css=css, title="DSCR Prompt Coach - Complete Learning Edition") as demo: gr.Markdown(""" # 🧠 DSCR 프롬프트 코칭 시스템 (Complete Learning Edition) ## 프롬프트 엔지니어링의 4단계를 따라가며 체계적인 프롬프트를 완성하세요 **Define → Select → Compose → Refine** 💡 **모든 Pain Points, Outputs, Users에 대한 완전한 상세 설명이 포함되어 있습니다.** """) # 상태 변수들 domain_key = gr.State() pains = gr.State([]) pain_subs = gr.State([]) outs = gr.State([]) out_subs = gr.State([]) users = gr.State([]) user_subs = gr.State([]) techs = gr.State([]) with gr.Tabs() as tabs: # Phase 1: 문제 정의 (Define) with gr.TabItem("🚀 Phase 1: 문제 정의 (Define)", id=0): gr.HTML("
성공적인 프롬프트의 시작은 '풀어야 할 문제'를 명확히 아는 것입니다
") with gr.Row(): with gr.Column(scale=2): with gr.Row(): with gr.Column(): gr.Markdown("### 1. Domain (어떤 영역의 문제인가?)") domain_dd = gr.Dropdown( label="도메인 선택", choices=list(CATALOG.keys()), info="해결하려는 문제가 속한 주요 영역을 선택하세요" ) domain_note = gr.Textbox( label="도메인 특성 메모", placeholder="예: 북미 SaaS B2B 시장 진출 초기 단계", info="도메인의 특별한 상황이나 맥락을 기록하세요" ) with gr.Column(): gr.Markdown("### 2. Pain (누구의 어떤 고통을 해결하는가?)") pains_dd = gr.Dropdown( label="Pain Points(복수 선택)", multiselect=True, interactive=False, info="해결하려는 주요 문제점들을 선택하세요" ) pains_sub_dd = gr.Dropdown( label="Pain 세부사항(복수 선택)", multiselect=True, interactive=False, info="선택한 문제의 구체적인 양상들" ) with gr.Row(): with gr.Column(): gr.Markdown("### 3. Output (어떤 결과물이 필요한가?)") outs_dd = gr.Dropdown( label="산출물 유형(복수 선택)", multiselect=True, interactive=False, info="최종적으로 만들어야 할 결과물들" ) outs_sub_dd = gr.Dropdown( label="산출물 세부(복수 선택)", multiselect=True, interactive=False, info="결과물의 구체적인 형태나 변형" ) with gr.Column(): gr.Markdown("### 4. User (누가 이 결과물을 사용하는가?)") users_dd = gr.Dropdown( label="최종 사용자(복수 선택)", multiselect=True, interactive=False, info="결과물을 실제로 사용할 사람들" ) users_sub_dd = gr.Dropdown( label="사용자 세부 역할(복수 선택)", multiselect=True, interactive=False, info="사용자들의 구체적인 직급이나 역할" ) with gr.Column(scale=1): gr.Markdown("### 📚 완전한 학습 패널") with gr.Accordion("💡 Pain Points 상세 설명", open=False): pain_details = gr.HTML("Pain Point를 선택하면 완전한 상세 설명이 여기에 표시됩니다.") with gr.Accordion("📄 Output 상세 설명", open=False): output_details = gr.HTML("Output을 선택하면 완전한 상세 설명이 여기에 표시됩니다.") with gr.Accordion("👤 User 상세 설명", open=False): user_details = gr.HTML("User를 선택하면 완전한 상세 설명이 여기에 표시됩니다.") gr.Markdown("---") gr.Markdown("### 🎯 나의 미션 선언문 (Mission Statement)") mission_statement_txt = gr.Textbox( label="미션 선언문", placeholder="위 항목들을 선택하면 자동으로 초안이 생성됩니다. 자유롭게 수정하여 목표를 명확히 하세요.", lines=3, info="이 프롬프트로 달성하고자 하는 최종 목표를 명확히 서술하세요" ) def update_mission_statement(d, p, o, u): if not all([d, p, o, u]): return "" d_str = f"[{d.split(' ')[1] if ' ' in d else d}]" p_str = f"[{', '.join(p) if p else '정의되지 않은 문제'}]" o_str = f"[{', '.join(o) if o else '정의되지 않은 결과물'}]" u_str = f"[{', '.join(u) if u else '정의되지 않은 사용자'}]" return f"나는 {u_str}를 위해, {p_str} 문제를 해결하고자, {d_str} 맥락에서 {o_str}을(를) 작성한다." def on_domain_change(dkey): if not dkey: return [dkey, gr.update(), gr.update(), gr.update(), gr.update(), gr.update(), gr.update()] cfg = CATALOG.get(dkey, {}) return [ dkey, gr.update(choices=cfg.get("pains", []), value=[], interactive=True), gr.update(choices=[], value=[], interactive=False), gr.update(choices=cfg.get("outputs", []), value=[], interactive=True), gr.update(choices=[], value=[], interactive=False), gr.update(choices=cfg.get("users", []), value=[], interactive=True), gr.update(choices=[], value=[], interactive=False) ] def on_list_change(selected_list, sub_map): if not selected_list: return gr.update(choices=[], value=[], interactive=False) choices = uniq([item for s in selected_list for item in sub_map.get(s, [])]) return gr.update(choices=choices, value=[], interactive=True) domain_dd.change( on_domain_change, inputs=[domain_dd], outputs=[domain_key, pains_dd, pains_sub_dd, outs_dd, outs_sub_dd, users_dd, users_sub_dd] ) pains_dd.change(lambda x: on_list_change(x, PAIN_SUB), inputs=[pains_dd], outputs=[pains_sub_dd]) outs_dd.change(lambda x: on_list_change(x, OUTPUT_SUB), inputs=[outs_dd], outputs=[outs_sub_dd]) users_dd.change(lambda x: on_list_change(x, USER_SUB), inputs=[users_dd], outputs=[users_sub_dd]) pains_dd.change(show_pain_details, inputs=[pains_dd], outputs=[pain_details]) outs_dd.change(show_output_details, inputs=[outs_dd], outputs=[output_details]) users_dd.change(show_user_details, inputs=[users_dd], outputs=[user_details]) for comp in [domain_dd, pains_dd, outs_dd, users_dd]: comp.change( update_mission_statement, inputs=[domain_dd, pains_dd, outs_dd, users_dd], outputs=[mission_statement_txt] ) pains_dd.change(lambda x: x, pains_dd, pains) pains_sub_dd.change(lambda x: x, pains_sub_dd, pain_subs) outs_dd.change(lambda x: x, outs_dd, outs) outs_sub_dd.change(lambda x: x, outs_sub_dd, out_subs) users_dd.change(lambda x: x, users_dd, users) users_sub_dd.change(lambda x: x, users_sub_dd, user_subs) # Phase 2: 기술 선정 (Select) with gr.TabItem("💡 Phase 2: 기술 선정 (Select)", id=1): gr.HTML("
문제 해결에 가장 적합한 프롬프팅 기술 조합을 논리적 근거를 바탕으로 선택합니다
") with gr.Row(): with gr.Column(scale=2): with gr.Row(): with gr.Column(scale=1): gr.Markdown("### 1. 자동 추천 받기") gr.Markdown("Phase 1에서 정의한 내용을 바탕으로 효과적인 기술 조합을 추천받으세요.") auto_recommend_btn = gr.Button("🔮 Mixed Prompts 자동 추천", variant="primary") techs_dd = gr.Dropdown( label="프롬프팅 기술(복수 선택/수정 가능)", choices=ALL_TECHS, multiselect=True, interactive=True, info="자동 추천된 기술을 검토하고 필요시 수정하세요" ) with gr.Column(scale=1): gr.Markdown("### 2. 자동 추천 근거 검토") auto_rationale_md = gr.Markdown("자동 추천 버튼을 누르면, 각 기술이 왜 추천되었는지 핵심적인 이유가 여기에 표시됩니다.") with gr.Column(scale=1): gr.Markdown("### 🛠️ 완전한 기술 학습 패널") with gr.Accordion("📖 선택된 기술 상세 설명", open=True): tech_details = gr.HTML("프롬프팅 기술을 선택하면 완전한 상세 설명이 여기에 표시됩니다.") gr.Markdown("---") gr.Markdown("### 🤔 나의 최종 선택과 근거 (My Rationale)") gr.Markdown("**자동 추천과 설명을 비판적으로 검토한 후, 최종적으로 사용할 기술과 그 이유를 직접 정리해보세요.** 이것이 당신의 '전략'이 됩니다.") my_rationale_txt = gr.Textbox( label="나의 전략적 판단 기록", lines=5, placeholder="예시) RAG는 최신성 확보를 위해, CoT는 CEO가 중시하는 논리 구조 강화를 위해 최종 선택함. Persona Prompting은 범용 보고서이므로 불필요하다고 판단하여 제외함.", info="선택한 기술들에 대한 당신만의 전략적 판단을 기록하세요" ) auto_recommend_btn.click( auto_recommend, inputs=[domain_key, pains, outs, users], outputs=[techs_dd, auto_rationale_md] ) techs_dd.change(show_tech_details, inputs=[techs_dd], outputs=[tech_details]) techs_dd.change(lambda x: x, techs_dd, techs) # Phase 3: 프롬프트 구성 (Compose) with gr.TabItem("✍️ Phase 3: 프롬프트 구성 (Compose)", id=2): gr.HTML("
선택한 전략을 바탕으로 프롬프트의 구체적인 내용과 가드레일을 설정합니다
") with gr.Row(): with gr.Column(): gr.Markdown("### 1. 상세 가드레일 설정") kpi_text = gr.Textbox(label="핵심 성공 지표(KPI)", placeholder="예: 인사이트 정확성, 경영진 의사결정 지원") tone_text = gr.Textbox(label="톤앤매너", placeholder="예: 객관·간결·데이터 중심") ng_text = gr.Textbox(label="금지어/NG 표현", placeholder="예: 과장, 출처 미표기, 추정 수치 단정화") format_override = gr.Textbox(label="산출물 형식(Format)", placeholder="예: 요약/현황/경쟁/인사이트/권고/한계") with gr.Column(): gr.Markdown("### 2. 품질 레퍼런스 주입") fewshot_text = gr.Textbox(label="Few-shot 예시 (모방할 패턴)", lines=4, placeholder="AI가 모방했으면 하는 글의 좋은 예시를 2~3개 자유롭게 입력하세요.") rag_text = gr.Textbox(label="참고자료 (컨텍스트 주입용)", lines=4, placeholder="참고할 데이터, 보고서 내용, 또는 배경 정보를 입력하세요.") gr.Markdown("---") gen_btn = gr.Button("🚀 최종 융합 프롬프트 생성!", variant="primary", size="lg") final_prompt_txt = gr.Textbox( label="완성된 융합 프롬프트", lines=25, show_copy_button=True, interactive=False, info="생성된 프롬프트를 복사하여 ChatGPT, Claude 등에서 사용하세요" ) gr.Markdown("### 4. 자가 검수 체크리스트") gr.Markdown("프롬프트를 사용하기 전, 나의 의도가 모두 잘 반영되었는지 마지막으로 점검하세요.") self_inspection_chk = gr.CheckboxGroup( label="Self-Inspection Checklist", choices=[ "Phase 1의 '미션 선언문'이 프롬프트 목적에 잘 반영되었는가?", "Phase 2에서 선택한 기술들의 핵심 의도가 프롬프트에 녹아있는가?", "독자(User)가 이해하기 어려운 전문 용어나 모호한 지시는 없는가?", "제공한 Few-shot 예시나 참고 데이터가 충분하고 적절한가?" ] ) gen_btn.click( compose_final_prompt, inputs=[ mission_statement_txt, domain_key, pains, pain_subs, outs, out_subs, users, user_subs, techs, my_rationale_txt, kpi_text, tone_text, ng_text, format_override, fewshot_text, rag_text ], outputs=[final_prompt_txt] ) # Phase 4: 실행 및 개선 (Refine) with gr.TabItem("🔄 Phase 4: 실행 및 개선 (Refine)", id=3): gr.HTML("
프롬프트 엔지니어링은 '반복'을 통해 완성됩니다
") gr.Markdown("생성된 프롬프트를 실제 LLM에 실행해보고, 결과물을 비판적으로 분석하여 개선점을 찾아보세요.") with gr.Row(): with gr.Column(): gr.Markdown("### 1. LLM 결과물 분석") llm_output_txt = gr.Textbox(label="LLM 결과물 원문", lines=15, placeholder="LLM(ChatGPT, Claude 등)에서 나온 결과물을 그대로 복사하여 붙여넣으세요.") with gr.Column(): gr.Markdown("### 2. 결과물 평가 및 개선") eval_radio = gr.Radio(label="결과물 만족도 평가", choices=["매우 만족", "만족", "개선 필요", "매우 불만족"], value="개선 필요") analysis_txt = gr.Textbox(label="원인 분석 및 개선 방향", lines=8, placeholder="""결과물이 만족스럽지 않다면, 그 근본 원인은 어디에 있다고 생각하나요?\n\n- 문제 정의 오류? (Phase 1)\n- 기술 선택 미스? (Phase 2)\n- Few-shot 예시 부족? (Phase 3)\n- 지시가 모호했나?""", visible=True) gr.Markdown("### 3. AI 개선 제안") improve_btn = gr.Button("🔍 개선점 분석 및 제안 받기", variant="secondary") improvement_suggestions = gr.Textbox(label="AI 개선 제안", lines=8, interactive=False) def analyze_and_improve(llm_output, satisfaction, user_analysis): if not llm_output.strip(): return "분석할 LLM 결과물을 먼저 입력해주세요." suggestions = f"""## 🔍 결과물 분석 리포트 **만족도**: {satisfaction} **사용자 분석**: {user_analysis or '분석 내용 없음'} ### 개선 제안사항: 1. **프롬프트 구조 개선**: 더 명확한 단계별 지시사항 추가, 성공 기준의 구체화 필요 2. **컨텍스트 보강**: Few-shot 예시의 품질 향상, 도메인 특화 정보 보완 3. **제약사항 명확화**: 금지어/NG 표현 구체화, 형식 요구사항 세분화 ### 다음 반복 액션 아이템: - [ ] Phase 1에서 미션 스테이트먼트 재검토 - [ ] Phase 2에서 기술 조합 재선택 - [ ] Phase 3에서 Few-shot 예시 개선 - [ ] 새로운 프롬프트로 재실행 및 비교 ### 권장사항: 프롬프트 엔지니어링은 반복적 개선 과정입니다. 위 제안사항을 바탕으로 이전 Phase들로 돌아가 수정한 후 다시 테스트해보세요.""" return suggestions improve_btn.click( analyze_and_improve, inputs=[llm_output_txt, eval_radio, analysis_txt], outputs=[improvement_suggestions] ) def toggle_analysis_visibility(evaluation): return gr.update(visible=(evaluation in ["개선 필요", "매우 불만족"])) eval_radio.change(toggle_analysis_visibility, inputs=[eval_radio], outputs=[analysis_txt]) gr.Markdown("---") gr.Markdown("### 💡 완전한 학습 가이드\n...") # (하단 푸터 내용 생략) if __name__ == "__main__": demo.launch()