diff --git a/README.md b/README.md index 923fe8c..a0e41e5 100644 --- a/README.md +++ b/README.md @@ -69,14 +69,25 @@ docker compose up -d | 템플릿 | 생성되는 구조 | 기본 강도 | 라이브 요약 | |---|---|---|---| -| 🗂️ 회의록 | 요약 / 논의 / 액션 / 결정 | 표준 | ✅ | +| 🗂️ 회의록 | 요약 / **내용 기반 주제 섹션** / 액션 / 결정 | 표준 | ✅ | | 🎓 강의·세미나 노트 | 핵심 개념 / 예시 / 인용 / 후속 질문 | 상세 | ✅ | -| 🤝 1:1 미팅 | 주제 / 고민 / 피드백 / 다음 액션 | 표준 | ✅ | +| 🤝 1:1 미팅 | 요지 / **내용 기반 주제 섹션** / 고민 / 피드백 / 다음 액션 | 표준 | ✅ | | 💡 브레인스토밍 | 카테고리별 아이디어 / 즉시 시도 / 보류 | 상세 | ✅ | | 🎤 인터뷰 | Q&A 포맷 / 인상적 발언 / 종합 | 표준 | ❌ | | 📝 원문 정리 | 요약 없이 문단화·오탈자 정리만 | 상세 고정 | ❌ | | ⚙️ 커스텀 | 자유 프롬프트 입력 | - | ✅ | +**내용 기반 주제 섹션** + +회의록·1:1 템플릿은 `## 주요 논의 사항` 같은 고정 제목을 쓰지 않습니다. 그 회의가 실제로 무엇을 +다뤘는지에 따라 AI가 섹션 제목을 직접 짓습니다 — 예를 들어 `## 단계별 개발 계획`, +`## 수익화 방안`, `## 기술적 고려사항` 처럼. 제목만 훑어도 회의 내용이 파악됩니다. + +**액션 아이템 담당자** + +발화에서 담당자가 파악되면 `- [ ] (김지훈) 경쟁 사이트 리스트업 — 5/17까지` 형태로 이름과 기한이 붙습니다. +담당자가 정해지지 않은 항목도 버리지 않고 그대로 수집합니다. + **강도 3단계** - **간결** — 각 섹션 3줄 이내 - **표준** — 맥락이 이해될 정도 diff --git a/src/__tests__/templates.test.ts b/src/__tests__/templates.test.ts index 5303994..c27661f 100644 --- a/src/__tests__/templates.test.ts +++ b/src/__tests__/templates.test.ts @@ -164,3 +164,119 @@ describe('liveEnabledFor / depthAdjustableFor', () => { expect(depthAdjustableFor('custom')).toBe(false) }) }) + +describe('내용 기반 섹션 구조', () => { + const transcript = '이번에는 가격 비교 사이트를 만들어 봅시다' + + it('meeting은 섹션 제목을 직접 짓도록 지시한다', () => { + const prompt = buildPrompt({ + templateId: 'meeting', + depth: 'standard', + transcript, + }) + expect(prompt).toContain('섹션 제목을 직접 지어서') + // 고정 제목을 쓰지 말라는 지시가 함께 있어야 한다 + expect(prompt).toContain('일반적인 제목은 쓰지 마세요') + }) + + it('one_on_one도 주제별 제목을 직접 짓도록 지시한다', () => { + const prompt = buildPrompt({ + templateId: 'one_on_one', + depth: 'standard', + transcript, + }) + expect(prompt).toContain('제목을 직접 지어') + }) + + it('raw는 구조적 제목을 덧붙이지 말라는 지시를 유지한다', () => { + const prompt = buildPrompt({ + templateId: 'raw', + depth: 'detailed', + transcript, + }) + expect(prompt).toContain('구조적 제목(## 섹션)을 덧붙이지 마세요') + }) +}) + +describe('액션 아이템 담당자 표기', () => { + const transcript = '다음 주까지 정리해 주세요' + + it('담당자 표기를 요구한다', () => { + const prompt = buildPrompt({ + templateId: 'meeting', + depth: 'standard', + transcript, + }) + expect(prompt).toContain('(담당자)') + }) + + it('담당자가 불분명해도 항목을 버리지 않도록 지시한다', () => { + const prompt = buildPrompt({ + templateId: 'meeting', + depth: 'standard', + transcript, + }) + expect(prompt).toContain('담당자가 불분명해도') + }) + + it('체크박스 형식을 유지해 액션 아이템 파서와 호환된다', () => { + for (const id of ['meeting', 'one_on_one', 'brainstorm'] as const) { + const prompt = buildPrompt({ templateId: id, depth: 'standard', transcript }) + expect(prompt).toContain('- [ ]') + } + }) +}) + +describe('공통 규칙', () => { + const transcript = '테스트 발화' + + it('프리셋 템플릿 전체에 공통 규칙이 붙는다', () => { + for (const id of Object.keys(TEMPLATES) as (keyof typeof TEMPLATES)[]) { + const prompt = buildPrompt({ templateId: id, depth: 'standard', transcript }) + expect(prompt).toContain('지어내지 마세요') + expect(prompt).toContain('한국어로 작성하세요') + } + }) + + it('발화자 표기가 있으면 활용하도록 지시한다', () => { + const prompt = buildPrompt({ + templateId: 'meeting', + depth: 'standard', + transcript, + }) + expect(prompt).toContain('발화자 표기가 있다면') + }) + + it('영어 기술 용어는 원문 표기를 유지하도록 지시한다', () => { + const prompt = buildPrompt({ + templateId: 'meeting', + depth: 'standard', + transcript, + }) + expect(prompt).toContain('원문 표기를 유지하세요') + }) + + it('custom 프롬프트에는 공통 규칙을 덧붙이지 않는다', () => { + const prompt = buildPrompt({ + templateId: 'custom', + depth: 'standard', + transcript, + customPrompt: '한 줄로만 요약해줘', + }) + expect(prompt).toContain('한 줄로만 요약해줘') + expect(prompt).not.toContain('지어내지 마세요') + }) + + it('custom 프롬프트가 비어 있으면 meeting 템플릿 + 공통 규칙으로 대체한다', () => { + const prompt = buildPrompt({ + templateId: 'custom', + depth: 'standard', + transcript, + customPrompt: ' ', + }) + expect(prompt).toContain('회의록 작성 전문가') + expect(prompt).toContain('지어내지 마세요') + // 기존 동작 유지 — custom 경로에는 강도/라이브 모디파이어를 적용하지 않는다 + expect(prompt).not.toContain('작성 강도') + }) +}) diff --git a/src/lib/templates.ts b/src/lib/templates.ts index 823847d..42850a8 100644 --- a/src/lib/templates.ts +++ b/src/lib/templates.ts @@ -34,20 +34,24 @@ export const TEMPLATES: Record, Template> = { depthAdjustable: true, basePrompt: `당신은 회의록 작성 전문가입니다. 아래 발화 내용을 분석하여 마크다운 회의록을 작성하세요. -포함할 섹션: ## 요약 -(3~5줄 핵심 내용) +회의 전체를 3~5줄로. 무엇을 논의했고 무엇이 정해졌는지. -## 주요 논의 사항 -1. 순번 매기기 +이어지는 본문은 **섹션 제목을 직접 지어서** 구성하세요: +- 실제로 논의된 주제를 스스로 파악해 \`##\` 제목을 붙여 나눕니다. +- "주요 논의 사항", "논의 내용" 같은 일반적인 제목은 쓰지 마세요. + 이 회의가 무엇을 다뤘는지 제목만 봐도 알 수 있어야 합니다. + (예: "단계별 개발 계획", "수익화 방안", "기술적 고려사항") +- 주제 수는 내용에 따라 정하되 보통 3~6개입니다. ## 액션 아이템 -- [ ] 담당자와 기한이 명확한 항목만 +반드시 \`- [ ]\` 체크박스 형식으로 작성하세요. +담당자가 파악되면 \`(담당자)\`를 앞에, 기한이 언급됐으면 뒤에 덧붙입니다. +예: \`- [ ] (김지훈) 경쟁 사이트 리스트업 — 5/17까지\` +담당자가 불분명해도 해야 할 일이 명확하면 포함하세요. ## 결정 사항 -- 합의 또는 확정된 것만 - -한국어로 작성하세요.`, +- 합의되었거나 확정된 것만. 없으면 이 섹션을 생략하세요.`, }, lecture: { @@ -60,20 +64,18 @@ export const TEMPLATES: Record, Template> = { depthAdjustable: true, basePrompt: `당신은 학습용 노트를 작성하는 전문가입니다. 강의/세미나 녹취를 구조화된 학습 자료로 정리하세요. -포함할 섹션: ## 주요 주제 (한 줄 요약) ## 핵심 개념 각 개념마다 ### 소제목 + 설명 + 구체 예시 +소제목은 강의에서 실제로 다룬 개념 이름을 그대로 쓰세요. ## 기억할 인용·예시 > 중요한 문장 인용 형식으로 ## 후속 질문 -- 스스로 탐구해볼 만한 질문 - -한국어로 작성하세요.`, +- 스스로 탐구해볼 만한 질문`, }, one_on_one: { @@ -86,12 +88,11 @@ export const TEMPLATES: Record, Template> = { depthAdjustable: true, basePrompt: `당신은 1:1 미팅 정리 전문가입니다. 개인적이고 신뢰 기반의 대화임을 존중하며 정리하세요. -포함할 섹션: ## 이번 세션 요지 (2~3줄) -## 논의한 주제 -- 주요 대화 흐름 +이어서 대화에서 실제로 다룬 주제마다 **\`##\` 제목을 직접 지어** 나누세요. +"논의한 주제" 같은 일반적인 제목 대신, 무엇에 대한 이야기였는지 드러내는 제목을 쓰세요. ## 고민·블로커 - 공유된 어려움 @@ -100,9 +101,7 @@ export const TEMPLATES: Record, Template> = { - 건설적 피드백 위주 ## 다음 미팅까지 할 일 -- [ ] 합의된 후속 조치 - -한국어로 작성하세요.`, +- [ ] 합의된 후속 조치. 담당자가 있으면 \`(담당자)\` 표기`, }, brainstorm: { @@ -115,12 +114,12 @@ export const TEMPLATES: Record, Template> = { depthAdjustable: true, basePrompt: `당신은 브레인스토밍 세션을 정리하는 전문가입니다. 나온 아이디어를 분류하고 실행 가능성 관점에서 정리하세요. -포함할 섹션: ## 세션 개요 (1~2줄 — 주제/목표) ## 아이디어 (카테고리별) ### [카테고리 이름] +카테고리는 미리 정해진 목록이 아니라, 나온 아이디어를 보고 직접 묶어서 이름 붙이세요. - 아이디어 요약 ## 즉시 시도 가능 @@ -130,9 +129,7 @@ export const TEMPLATES: Record, Template> = { - 사유 간단히 ## 다음 스텝 -- 구체적인 후속 행동 - -한국어로 작성하세요.`, +- [ ] 구체적인 후속 행동. 담당자가 있으면 \`(담당자)\` 표기`, }, interview: { @@ -145,7 +142,6 @@ export const TEMPLATES: Record, Template> = { depthAdjustable: true, basePrompt: `당신은 인터뷰 녹취를 Q&A 형식으로 정리하는 전문가입니다. -포함할 섹션: ## 개요 (인터뷰 대상/주제 1~2줄) @@ -159,9 +155,7 @@ A: [답변 요약] > 직접 인용 ## 종합 인상 -- 전반적 테마 / 놓치지 말 것 - -한국어로 작성하세요.`, +- 전반적 테마 / 놓치지 말 것`, }, raw: { @@ -181,8 +175,7 @@ A: [답변 요약] 엄격한 규칙: - 내용을 삭제하거나 축약하지 마세요 - 구조적 제목(## 섹션)을 덧붙이지 마세요 -- 타임스탬프가 있으면 그대로 유지하세요 -- 한국어로 작성하세요.`, +- 타임스탬프가 있으면 그대로 유지하세요`, }, } @@ -195,7 +188,19 @@ const DEPTH_MODIFIERS: Record = { '작성 강도: **상세**. 원문의 주요 세부사항·수치·고유명사를 누락 없이 포함하세요. 구조만 바꾸고 내용은 최대한 보존합니다.', } -const LIVE_MODIFIER = `회의가 아직 진행 중입니다. 지금까지의 내용을 기반으로 **중간 정리**를 작성하세요. 확정되지 않은 결정은 "(논의 중)"으로 표시하세요.` +const LIVE_MODIFIER = `회의가 아직 진행 중입니다. 지금까지의 내용을 기반으로 **중간 정리**를 작성하세요. 확정되지 않은 결정은 "(논의 중)"으로 표시하세요. +섹션 제목은 지금까지 나온 주제를 기준으로 붙이되, 이후 갱신될 수 있으므로 간결하게 유지하세요.` + +/** + * 프리셋 템플릿 전체에 공통으로 덧붙는 규칙. + * + * custom 프롬프트에는 적용하지 않는다 — 사용자가 전적으로 제어하는 영역이기 때문. + */ +const COMMON_RULES = `공통 규칙: +- 발화에 없는 내용을 지어내지 마세요. 불확실하면 쓰지 마세요. +- 발화자 표기가 있다면 누가 무엇을 주장하고 약속했는지 반영하세요. +- 영어 기술 용어·제품명은 번역하거나 음차하지 말고 원문 표기를 유지하세요 (예: latency, deployment). +- 한국어로 작성하세요.` /** * 증분 갱신 모드. @@ -252,7 +257,7 @@ export function buildPrompt(args: BuildPromptArgs): string { if (templateId === 'custom') { const custom = customPrompt?.trim() if (!custom) { - instruction = TEMPLATES.meeting.basePrompt + instruction = `${TEMPLATES.meeting.basePrompt}\n\n${COMMON_RULES}` } else { instruction = custom } @@ -272,6 +277,8 @@ export function buildPrompt(args: BuildPromptArgs): string { } } + parts.push(COMMON_RULES) + instruction = parts.join('\n\n') }