ppt-visual-qa

name	ppt-visual-qa
description	Run visual QA on a generated deck — capture slide screenshots (server-side Playwright), then YOU analyze them for visual defects and generate fixes via the ppt-generator prepare/ingest handshake. Opt-in; needs `playwright install chromium`. Keywords - "비주얼 QA / 시각 검사 / 스크린샷 점검 / visual qa / pixel-perfect check".

ppt-visual-qa

렌더된 슬라이드의 시각적 결함(줄바꿈, 겹침, 잘림, 대비, 정렬 등)을 스크린샷으로 점검하고 고친다. 스크린샷 캡처는 서버(Playwright)가, 비전 분석과 수정 spec 생성은 네가(클라이언트) 담당한다. 반복 루프(분석→수정→재캡처)도 네가 오케스트레이션한다.

전제: 디자인 스펙이 생성돼 있어야 하고, 사용자가 동의해야 한다 (opt-in). playwright install chromium 로 브라우저 바이너리가 설치돼 있어야 한다.

반복 루프

max_iterations(기본 2)만큼 반복하되, 이슈가 없어지면 멈춘다. iteration 은 0 부터 센다.

각 iteration n 에서:

1. 스크린샷 캡처 (서버)

mcp__ppt-generator__capture_slides(project_id, slide_indices, iteration=n) 호출.

• slide_indices 는 1-based comma 문자열 (빈 문자열 = 전체). 이후 iteration 에서는 아직 이슈가 남은 슬라이드만 넘긴다.
• 반환: screenshots: [{slide_index, screenshot_path}], max_iterations.

2. 분석 (슬라이드별, 병렬)

각 캡처된 슬라이드에 대해:

1. mcp__ppt-generator__prepare_visual_qa_analysis(project_id, slide_index, iteration=n) 호출.
   • 반환: system_prompt, user_prompt, response_schema, images(스크린샷 경로).
2. 네가 images 의 스크린샷을 읽고 spec 과 대조해 시각적 이슈를 찾아, response_schema 대로 분석 JSON 을 생성한다.
3. mcp__ppt-generator__ingest_visual_qa_analysis(project_id, slide_index, analysis_json) 호출.
   • 반환의 has_issues 가 false 면 이 슬라이드는 통과 — 다음 iteration 대상에서 제외.
   • true 면 analysis_context 를 다음 단계로 넘긴다.

3. 수정 (이슈 있는 슬라이드만, 병렬)

이슈가 있는 각 슬라이드에 대해:

1. mcp__ppt-generator__prepare_visual_qa_fix(project_id, slide_index, analysis_context, iteration=n) 호출.
   • analysis_context 는 이전 분석 ingest가 반환한 opaque token.
   • 반환: response_schema, images, fix_context.
2. 네가 이슈를 반영한 전체 슬라이드 spec JSON 을 response_schema 대로 생성한다.
3. mcp__ppt-generator__ingest_visual_qa_fix(project_id, slide_index, fix_json, fix_context) 호출 — 저장·재렌더.
   • status="fixed" 면 다음 iteration 에서 이 슬라이드를 다시 캡처·분석해 검증.
   • status="unfixed" 면 검증 실패 — 그대로 두거나 재시도.
   • status="unresolved" 면 허용된 시각 속성만으로 해결할 수 없어 원본을 보존한 상태다. 반환된 remaining_issues 를 최종 보고에 포함하고 반복 대상에서 제외한다.

4. 마무리

• 반복이 끝나면 mcp__ppt-generator__finalize_visual_qa(project_id) 를 1회 호출.
• 반환된 slides_html_path 를 사용자에게 공유한다.
• 최대 반복에 도달했는데 마지막 분석에 이슈가 남았거나 unresolved가 반환된 슬라이드는 슬라이드 번호와 잔여 이슈를 사용자에게 명시한다.

규칙

• 스크린샷을 실제로 읽고 분석한다 (images 경로). 근거 없이 이슈를 지어내지 않는다.
• 생성 단계에서는 항상 response_schema 를 정확히 따른다. ingest 검증 실패 시 고쳐 재시도.
• max_iterations 를 넘겨 무한히 반복하지 않는다. 이슈가 없어지면 즉시 멈춘다.
• 사용자가 동의한 경우에만 실행한다.