Menu
Phase 3 — 스크린샷 기반 VQA 검수 + SSIM 비교 + 수정 (최대 3라운드)
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
| name | visual-qa-fix |
| description | Phase 3 — 스크린샷 기반 VQA 검수 + SSIM 비교 + 수정 (최대 3라운드) |
게임 실행 스크린샷을 캡처하고, VQA(Visual Question Answering)로 시각적 품질을 검수합니다. reference.png 대비 SSIM(구조적 유사도)도 측정합니다. 최대 3라운드 반복.
반복 (최대 3회) {
1. 스크린샷 캡처 (여러 장면)
2. VQA 실행 (Gemini Flash)
3. SSIM 비교 (reference.png vs 스크린샷)
4. 리포트 분석 → 수정 계획
5. 수정 실행
6. compile-check
}
여러 게임 상태의 스크린샷을 캡처합니다:
# 메인 화면
bash ${CLAUDE_PLUGIN_ROOT}/tools/capture.sh screenshot --scene main --wait 2
# 게임플레이 (시간 경과)
bash ${CLAUDE_PLUGIN_ROOT}/tools/capture.sh screenshot --scene main --wait 5
# 특정 상태 (게임 오버, 메뉴 등)
bash ${CLAUDE_PLUGIN_ROOT}/tools/capture.sh screenshot --scene main --wait 10
python3 ${CLAUDE_PLUGIN_ROOT}/tools/visual_qa.py \
--screenshots "screenshot_*.png" \
--reference "reference.png" \
--questions "게임이 시각적으로 올바르게 보이는가?,UI 요소가 올바른 위치에 있는가?,스프라이트가 정상적으로 렌더링되는가?"
VQA 결과: JSON 리포트
{
"verdict": "fail|pass|acceptable",
"issues": [
{"severity": "high|medium|low", "description": "...", "suggestion": "..."}
],
"score": 0.75
}
python3 ${CLAUDE_PLUGIN_ROOT}/tools/screenshot_diff.py \
--reference "reference.png" \
--screenshot "screenshot_main.png"
SSIM ≥ 0.7 → acceptable, SSIM ≥ 0.85 → good
VQA 리포트의 issues를 분석하여 수정 계획 수립:
godot-task 스킬 패턴으로 수정합니다.
# progress에 VQA 라운드 기록 (jq로 직접)
# vqa.rounds에 {round, verdict, score, issues, fixes} 추가
# vqa.currentRound 증가
bash ${CLAUDE_PLUGIN_ROOT}/scripts/godot-gate.sh vqa-gate
Phase 0 — 게임 콘셉트 확장, 비주얼 타겟 생성, PLAN/STRUCTURE/ASSETS.md 작성, 사용자 승인
완성된 Godot 게임을 UX 디자이너, 게임 디자이너, 기술 리뷰어(Godot 전문) 3관점으로 병렬 평가한다.
단일 태스크 실행기 — GDScript 코드 작성, 씬 수정, 사운드 연결, Godot 4 함정 회피
Godot 게임 인터랙티브 테스트 — 입력 주입, 상태 검증, 스크린샷 캡처를 자동화하는 테스트 스킬
Phase 1 — 프로젝트 스캐폴딩 + 스크립트 스텁 + 씬 생성 + 에셋 생성 (이미지/사운드/음악)
Phase 2 — PLAN.md 태스크를 순서대로 구현. godot-task 스킬로 각 태스크 실행, compile-check + 스크린샷