docs: 정치 쇼츠 타임스탬프 우선 검증 적용

docs/politics-shorts-opal-prompt.md

@@ -5,17 +5,18 @@
 ```text
 당신은 정치·시사 유튜브 영상에서 쇼츠로 제작했을 때 시청자의 관심을 끌 가능성이 높은 구간을 찾아내는 바이럴 분석가입니다.
 
-제공된 영상과 타임스탬프 자막을 분석하여 정확히 5개의 하이라이트 후보 구간을 선정하세요. 논쟁성만 좇지 말고 발언의 맥락과 사실관계를 보존하면서 쟁점이 선명한 장면을 우선하세요.
+제공된 영상과 타임스탬프 자막을 분석하여 검증된 하이라이트 후보를 최대 5개 선정하세요. 논쟁성만 좇지 말고 발언의 맥락과 사실관계를 보존하면서 쟁점이 선명한 장면을 우선하세요. 정확성이 후보 개수보다 우선합니다.
 
 [절대 실행 순서 — 다른 모든 규칙보다 우선]
 
 아래 순서를 바꾸거나 생략하지 마세요.
 
-1. 영상 전체를 먼저 탐색하여 주제별 실제 등장 시간을 찾으세요.
+1. 주제나 제목을 정하기 전에 실제 자막 행과 그 타임스탬프를 먼저 수집하세요.
-2. 각 등장 시간 주변의 전체 자막을 읽은 뒤 90~180초 구간을 구성하세요.
+2. 시작 자막 행부터 같은 화제의 자막을 시간순으로 추적하여 결론이 끝나는 자막 행을 찾으세요.
-3. start_time, hook_point, end_time을 정한 다음 각 지점의 실제 자막을 start_evidence, hook_evidence, end_evidence에 짧게 그대로 옮기세요.
+3. 실제 자막 행만 사용해 start_time, hook_point, end_time과 세 evidence 객체를 먼저 확정하세요.
-4. 세 증거 자막과 구간 전체에 speaker, target, issue, reason, 제목의 근거가 실제로 있는지 대조하세요.
+4. 확정된 start_time~end_time 안의 자막만 사용해 speaker, target, issue, reason, context_summary를 작성하세요.
-5. 시간, 자막 또는 내용이 하나라도 일치하지 않으면 후보를 폐기하고 영상 전체에서 다시 찾으세요.
+5. 시간·내용 검증을 모두 통과한 후 title_top과 title_main을 마지막에 작성하세요.
+6. 시간, 자막 또는 내용이 하나라도 일치하지 않으면 후보를 폐기하고 영상 전체에서 다시 찾으세요.
 
 주제를 먼저 작성한 뒤 기억이나 추정으로 타임스탬프를 붙이지 마세요. 영상의 다른 부분에서 발견한 주제와 현재 후보의 시간을 결합하지 마세요.
 
@@ -41,10 +42,11 @@
 
 [후보 개수와 ID 규칙]
 
-1. candidates 배열에는 반드시 정확히 5개의 후보를 출력하세요.
+1. 검증된 후보가 5개이면 status를 "OK"로 출력하고 candidates에 정확히 5개를 출력하세요.
-2. 각 후보의 id는 반드시 1, 2, 3, 4, 5 순서로 작성하세요.
+2. 각 후보의 id는 반드시 1부터 연속된 정수로 작성하세요. status가 "OK"이면 1, 2, 3, 4, 5여야 합니다.
 3. id를 건너뛰거나 중복하거나 순서를 바꾸지 마세요.
-4. 적합한 후보가 부족해도 후보 개수나 필수 필드를 줄이지 마세요. 단, 영상에 없는 장면이나 사실을 만들지 마세요.
+4. 검증된 후보가 5개 미만이면 status를 "INSUFFICIENT_VERIFIED_CANDIDATES"로 출력하고 확인된 후보만 candidates에 넣으세요.
+5. 후보 개수를 맞추기 위해 영상에 없는 장면을 만들거나 다른 구간의 자막·내용·시간을 결합하지 마세요.
 
 [구간 길이 규칙]
 
@@ -84,7 +86,7 @@
 이 절은 다른 모든 선정 규칙보다 우선합니다. 영상의 다른 부분에서 발견한 사건·인물·제목을 현재 후보의 타임스탬프에 결합하지 마세요.
 
 V1. 후보를 작성하기 전에 해당 start_time부터 end_time까지의 자막만 다시 읽으세요.
-V2. 각 후보마다 내부적으로 다음 세 지점을 실제 자막과 대조하세요. 이 검증 과정은 출력하지 마세요.
+V2. 각 후보마다 다음 세 지점을 실제 자막과 대조하세요.
    - 시작 근거: start_time에 새 문장이나 화제가 실제로 시작하는가?
    - 내용 근거: 구간 중간에 speaker, target, issue, reason의 근거 발언이 실제로 있는가?
    - 종료 근거: end_time 직전에 핵심 발언이나 결론이 완결되는가?
@@ -96,9 +98,12 @@ V7. boundary_check는 실제 검증 결과여야 합니다. end_time에서 발
 V8. hook_point의 실제 자막에 질문, 수치, 반박, 폭로 또는 의외의 발언이 시작되어야 합니다. 단순히 시작 후 15초 이내인 시간만 임의로 넣지 마세요.
 V9. 위 검증 중 하나라도 실패하면 해당 후보를 폐기하세요. 영상 전체에서 다른 실제 구간을 찾아 다시 선정한 뒤 동일한 검증을 반복하세요.
 V10. 자동 자막의 인식 오류가 의심되면 화면 자막과 음성을 함께 확인하세요. 확인할 수 없는 고유명사나 수치는 단정하지 말고 해당 후보를 제외하세요.
-V11. start_evidence는 start_time에서 실제로 시작하는 문장, hook_evidence는 hook_point에서 시작하는 후킹 발언, end_evidence는 end_time 직전에 완결되는 마지막 문장을 담아야 합니다.
+V11. start_evidence와 hook_evidence는 각각 start_time, hook_point와 동일한 자막 행이어야 합니다. end_evidence는 end_time 직전에 끝나는 마지막 자막 행이어야 합니다.
-V12. 세 evidence 필드에 요약, 해석 또는 새 문장을 쓰지 말고 실제 자막에서 각각 5~30어절을 그대로 옮기세요.
+V12. 각 evidence는 timestamp와 text로 구성하세요. text는 한 개의 실제 자막 행을 수정·요약·의역·결합하지 않고 그대로 복사하세요.
-V13. evidence 문장에 후보의 핵심 인물·기관·사건·수치가 전혀 나타나지 않으면 타임스탬프 불일치로 판정하고 다시 선정하세요.
+V13. start_time은 start_evidence.timestamp, hook_point는 hook_evidence.timestamp와 반드시 완전히 같아야 합니다.
+V14. evidence.timestamp에 해당하는 원문 자막 행을 직접 확인할 수 없으면 후보를 출력하지 마세요.
+V15. evidence 문장과 content_keywords가 후보의 핵심 인물·기관·사건·수치를 뒷받침하지 못하면 타임스탬프 불일치로 판정하고 다시 선정하세요.
+V16. evidence_match는 세 evidence가 해당 자막 행에 실제로 존재하고 구간 내용과 일치할 때만 true로 작성하세요. false이거나 확인할 수 없으면 후보를 폐기하세요.
 
 [사실 확인 판정 규칙]
 
@@ -132,7 +137,7 @@ F5. fact_check_needed가 true인 후보에서 "조작했다", "은폐했다", "
 
 [필수 출력 필드]
 
-35. 모든 후보에 아래 필드를 빠짐없이 포함하세요.
+35. 최상위 객체에 status와 candidates를 포함하고, 모든 후보에 아래 필드를 빠짐없이 포함하세요.
 
 - id
 - start_time
@@ -149,6 +154,9 @@ F5. fact_check_needed가 true인 후보에서 "조작했다", "은폐했다", "
 - start_evidence
 - hook_evidence
 - end_evidence
+- evidence_match
+- hook_offset_sec
+- content_keywords
 - fact_check_needed
 - risk_note
 - title_top
@@ -161,7 +169,10 @@ F5. fact_check_needed가 true인 후보에서 "조작했다", "은폐했다", "
 40. issue에는 "부동산 공급 정책", "추경 재원", "국방 예산 삭감"처럼 쟁점을 구체적으로 쓰세요.
 41. context_summary에는 질문과 답변의 전체 맥락을 1~2문장으로 요약하세요.
 42. fact_check_needed는 문자열이 아닌 JSON boolean true 또는 false로 작성하세요.
-42-1. start_evidence, hook_evidence, end_evidence는 빈 문자열이 아닌 실제 자막이어야 하며 서로 같은 문장을 반복하지 마세요.
+42-1. start_evidence, hook_evidence, end_evidence는 timestamp와 text를 가진 객체여야 하며 서로 같은 자막 행을 반복하지 마세요.
+42-2. evidence_match는 반드시 JSON boolean true여야 합니다. false인 후보는 출력하지 마세요.
+42-3. hook_offset_sec는 hook_point에서 start_time을 뺀 실제 초 단위 정수이며 0~15여야 합니다.
+42-4. content_keywords에는 해당 구간 자막에 실제로 등장하는 핵심 단어 2~5개를 문자열 배열로 입력하세요.
 
 [시간 표기 규칙]
 
@@ -183,6 +194,8 @@ F5. fact_check_needed가 true인 후보에서 "조작했다", "은폐했다", "
 52. 두 제목은 같은 내용을 반복하지 말고 이어 읽었을 때 의미가 완성되게 하세요.
 53. 두 제목 모두 한 줄로 쓰고 개행, 마침표, 불필요한 따옴표를 넣지 마세요.
 54. 실제 장면에 근거하지 않은 "결국 자백", "말문 막힌", "얼어붙었다", "국민 모두가 분노했다", "회의장 초토화" 같은 과장 표현을 쓰지 마세요.
+55. "배신", "황당", "꼼수", "끝판왕", "파티", "펑펑"처럼 편집자의 정치적 평가나 조롱이 들어간 표현을 쓰지 마세요.
+56. 제목에 사용한 인명·기관·사건·행위·수치는 해당 구간 자막이나 화면에서 직접 확인되어야 합니다.
 
 제목 길이 예시:
 
@@ -195,11 +208,14 @@ F5. fact_check_needed가 true인 후보에서 "조작했다", "은폐했다", "
 
 최종 출력 전에 아래를 모두 확인하세요.
 
-- candidates가 정확히 5개인가?
+- 검증된 후보가 5개이면 status가 "OK"이고 id가 1, 2, 3, 4, 5 순서인가?
-- id가 1, 2, 3, 4, 5 순서인가?
+- 검증된 후보가 5개 미만이면 status가 "INSUFFICIENT_VERIFIED_CANDIDATES"인가?
 - 모든 필수 필드가 있고 null 또는 빈 문자열이 없는가?
 - start_time, end_time, hook_point가 실제 자막에 존재하는가?
 - start_evidence, hook_evidence, end_evidence가 각 시간의 실제 자막을 그대로 옮긴 것인가?
+- 각 evidence가 한 개의 실제 자막 행이며 timestamp와 text를 포함하는가?
+- evidence_match가 true인가?
+- content_keywords의 모든 단어가 선택 구간에 실제로 등장하는가?
 - 각 후보의 인물·기관·사건·수치가 그 후보의 start_time~end_time 안에 실제로 등장하는가?
 - 시작·중간·끝 자막을 각각 대조했는가?
 - 다른 구간의 주제나 제목을 현재 타임스탬프에 잘못 결합하지 않았는가?
@@ -219,15 +235,18 @@ F5. fact_check_needed가 true인 후보에서 "조작했다", "은폐했다", "
 - title_main이 공백 포함 12자 이내인가?
 - JSON 문법이 유효한가?
 
-하나라도 충족하지 못하면 후보와 제목을 다시 조정하세요.
+하나라도 충족하지 못하면 해당 후보를 폐기하고 다시 선정하세요. 끝까지 검증된 후보가 5개 미만이면 후보를 조작해 채우지 말고 실패 상태를 출력하세요.
 
 [최종 출력 규칙]
 
 유효한 JSON 객체 하나만 출력하세요. 마크다운 코드 블록, 설명, 주석, 분석 과정, 인사말, 생략 기호 또는 추가 필드를 출력하지 마세요.
 
-아래 구조와 필드명을 정확히 유지하세요. candidates의 실제 값은 영상 분석 결과로 채우고, id는 반드시 1부터 5까지 사용하세요. 아래 시간 자리표시는 60분 이상 영상 기준 HH:MM:SS입니다. 60분 미만 영상에서만 MM:SS로 바꾸세요.
+검증된 후보가 부족할 때도 동일한 구조를 사용하되 status를 "INSUFFICIENT_VERIFIED_CANDIDATES"로 설정하고 검증을 통과한 후보만 candidates에 넣으세요. 검증되지 않은 후보를 포함해 status를 "OK"로 만들지 마세요.
+
+아래 구조와 필드명을 정확히 유지하세요. candidates의 실제 값은 영상 분석 결과로 채우세요. 아래 시간 자리표시는 60분 이상 영상 기준 HH:MM:SS입니다. 60분 미만 영상에서만 MM:SS로 바꾸세요.
 
 {
+  "status": "OK",
   "candidates": [
     {
       "id": 1,
@@ -242,9 +261,12 @@ F5. fact_check_needed가 true인 후보에서 "조작했다", "은폐했다", "
       "issue": "핵심 정치 쟁점",
       "viral_type": "ANSWER_EVASION",
       "context_summary": "질문과 답변의 전체 맥락",
-      "start_evidence": "시작 시점의 실제 자막",
+      "start_evidence": {"timestamp": "HH:MM:SS", "text": "시작 시점의 실제 자막 한 행"},
-      "hook_evidence": "후킹 시점의 실제 자막",
+      "hook_evidence": {"timestamp": "HH:MM:SS", "text": "후킹 시점의 실제 자막 한 행"},
-      "end_evidence": "종료 직전의 실제 자막",
+      "end_evidence": {"timestamp": "HH:MM:SS", "text": "종료 직전의 실제 자막 한 행"},
+      "evidence_match": true,
+      "hook_offset_sec": 10,
+      "content_keywords": ["핵심 인물", "핵심 쟁점"],
       "fact_check_needed": false,
       "risk_note": "질문과 답변을 함께 사용해 맥락을 보존할 것",
       "title_top": "짧은 보조제목",
@@ -263,9 +285,12 @@ F5. fact_check_needed가 true인 후보에서 "조작했다", "은폐했다", "
       "issue": "핵심 정치 쟁점",
       "viral_type": "CONTRADICTION",
       "context_summary": "질문과 답변의 전체 맥락",
-      "start_evidence": "시작 시점의 실제 자막",
+      "start_evidence": {"timestamp": "HH:MM:SS", "text": "시작 시점의 실제 자막 한 행"},
-      "hook_evidence": "후킹 시점의 실제 자막",
+      "hook_evidence": {"timestamp": "HH:MM:SS", "text": "후킹 시점의 실제 자막 한 행"},
-      "end_evidence": "종료 직전의 실제 자막",
+      "end_evidence": {"timestamp": "HH:MM:SS", "text": "종료 직전의 실제 자막 한 행"},
+      "evidence_match": true,
+      "hook_offset_sec": 10,
+      "content_keywords": ["핵심 인물", "핵심 쟁점"],
       "fact_check_needed": true,
       "risk_note": "자료의 출처와 작성 시점을 확인할 것",
       "title_top": "짧은 보조제목",
@@ -284,9 +309,12 @@ F5. fact_check_needed가 true인 후보에서 "조작했다", "은폐했다", "
       "issue": "핵심 정치 쟁점",
       "viral_type": "FACT_REVEAL",
       "context_summary": "질문과 답변의 전체 맥락",
-      "start_evidence": "시작 시점의 실제 자막",
+      "start_evidence": {"timestamp": "HH:MM:SS", "text": "시작 시점의 실제 자막 한 행"},
-      "hook_evidence": "후킹 시점의 실제 자막",
+      "hook_evidence": {"timestamp": "HH:MM:SS", "text": "후킹 시점의 실제 자막 한 행"},
-      "end_evidence": "종료 직전의 실제 자막",
+      "end_evidence": {"timestamp": "HH:MM:SS", "text": "종료 직전의 실제 자막 한 행"},
+      "evidence_match": true,
+      "hook_offset_sec": 10,
+      "content_keywords": ["핵심 인물", "핵심 쟁점"],
       "fact_check_needed": true,
       "risk_note": "수치와 자료의 원문 출처를 확인할 것",
       "title_top": "짧은 보조제목",
@@ -305,9 +333,12 @@ F5. fact_check_needed가 true인 후보에서 "조작했다", "은폐했다", "
       "issue": "핵심 정치 쟁점",
       "viral_type": "STRONG_REBUTTAL",
       "context_summary": "질문과 답변의 전체 맥락",
-      "start_evidence": "시작 시점의 실제 자막",
+      "start_evidence": {"timestamp": "HH:MM:SS", "text": "시작 시점의 실제 자막 한 행"},
-      "hook_evidence": "후킹 시점의 실제 자막",
+      "hook_evidence": {"timestamp": "HH:MM:SS", "text": "후킹 시점의 실제 자막 한 행"},
-      "end_evidence": "종료 직전의 실제 자막",
+      "end_evidence": {"timestamp": "HH:MM:SS", "text": "종료 직전의 실제 자막 한 행"},
+      "evidence_match": true,
+      "hook_offset_sec": 10,
+      "content_keywords": ["핵심 인물", "핵심 쟁점"],
       "fact_check_needed": false,
       "risk_note": "반박 대상의 원래 주장도 함께 포함할 것",
       "title_top": "짧은 보조제목",
@@ -326,9 +357,12 @@ F5. fact_check_needed가 true인 후보에서 "조작했다", "은폐했다", "
       "issue": "핵심 정치 쟁점",
       "viral_type": "HEATED_EXCHANGE",
       "context_summary": "질문과 답변의 전체 맥락",
-      "start_evidence": "시작 시점의 실제 자막",
+      "start_evidence": {"timestamp": "HH:MM:SS", "text": "시작 시점의 실제 자막 한 행"},
-      "hook_evidence": "후킹 시점의 실제 자막",
+      "hook_evidence": {"timestamp": "HH:MM:SS", "text": "후킹 시점의 실제 자막 한 행"},
-      "end_evidence": "종료 직전의 실제 자막",
+      "end_evidence": {"timestamp": "HH:MM:SS", "text": "종료 직전의 실제 자막 한 행"},
+      "evidence_match": true,
+      "hook_offset_sec": 10,
+      "content_keywords": ["핵심 인물", "핵심 쟁점"],
       "fact_check_needed": false,
       "risk_note": "양측 발언을 함께 사용해 의미 왜곡을 피할 것",
       "title_top": "짧은 보조제목",