review-cheatsheet

name	review-cheatsheet
description	나노바나나 치트시트 이미지를 Gemini Vision으로 분석하여 해당 kr md 파일의 내용과 일치하는지 검증합니다. 기술적/문맥적 오류, 잘못된 텍스트/그래프/그림을 찾아냅니다. 사용: /review-cheatsheet week1/slug/chapter
arguments	[{"name":"path","description":"week/slug/chapter 형식의 문서 경로\n예: week1/deep-dive-llms/tokenization\n","required":true},{"name":"all","description":"week1의 모든 치트시트를 검증 (--all)","required":false}]

review-cheatsheet Skill

나노바나나 치트시트 이미지를 Gemini Vision API로 분석하여 원본 한국어 문서와 비교 검증합니다.

사용법

# 개별 챕터 검증
/review-cheatsheet week1/deep-dive-llms/tokenization

# 단일 페이지 검증
/review-cheatsheet week1/how-openai-uses-codex

# week1 전체 검증
/review-cheatsheet --all

입출력

입력 파일

파일 유형	경로
치트시트 이미지	public/cheatsheets/week{N}/{slug}/{chapter}.png
한국어 번역	docs/week{N}/{slug}/kr/{chapter}.md

출력 파일

.claude/outputs/review-cheatsheet/
└── week{N}/{slug}/
    ├── {chapter}-gemini-analysis.json    # Gemini Vision 분석 결과
    └── {chapter}-review-report.md        # 검증 리포트

검증 항목

1. 텍스트 정확성: 이미지 내 텍스트가 md 파일 내용과 일치하는지
2. 기술적 정확성: 수치, 용어, 개념이 올바른지
3. 문맥적 일관성: 그래프/다이어그램이 설명과 맞는지
4. 오탈자/오류: 잘못된 텍스트, 깨진 문자 등

워크플로우

/review-cheatsheet week1/deep-dive-llms/tokenization
           │
           ▼
┌──────────────────────────────────────┐
│ 1. 파일 경로 확인                      │
│    - 치트시트: public/cheatsheets/... │
│    - kr md: docs/.../kr/*.md          │
└──────────────────────────────────────┘
           │
           ▼
┌──────────────────────────────────────┐
│ 2. Gemini Vision API 호출             │
│    - 이미지 분석                       │
│    - 모든 텍스트/요소 추출             │
└──────────────────────────────────────┘
           │
           ▼
┌──────────────────────────────────────┐
│ 3. md 파일과 비교 분석                 │
│    - Task agent로 비교                │
│    - 불일치/오류 탐지                  │
└──────────────────────────────────────┘
           │
           ▼
┌──────────────────────────────────────┐
│ 4. 리포트 생성                         │
│    - 발견된 이슈 정리                  │
│    - 심각도 분류                       │
└──────────────────────────────────────┘

실행 지침

이 스킬이 호출되면 다음 단계를 따르세요.

Step 1: 경로 파싱 및 파일 확인

경로 파싱:
- week1/deep-dive-llms/tokenization
  → week: 1
  → slug: deep-dive-llms
  → chapter: tokenization

파일 경로:
- 이미지: public/cheatsheets/week1/deep-dive-llms/tokenization.png
- kr md: docs/week1/deep-dive-llms/kr/tokenization.md

파일명 매핑 주의:
- 일부 파일명이 다를 수 있음
- 이미지: preview-of-things-to-come.png → md: preview-things-to-come.md
- 이미지: sft-to-rl.png → md: supervised-finetuning-to-rl.md
- 매핑 실패 시 Glob으로 유사 파일 검색

Step 2: Gemini Vision API 호출

Python 스크립트로 Gemini Vision API를 호출합니다:

python3 << 'PYEOF'
import os
import json
from pathlib import Path

# .env 파일에서 API 키 로드
env_path = Path(".env")
if env_path.exists():
    for line in env_path.read_text().split('\n'):
        if '=' in line and not line.strip().startswith('#'):
            key, value = line.strip().split('=', 1)
            os.environ[key] = value

import warnings
warnings.filterwarnings('ignore')
import google.generativeai as genai

genai.configure(api_key=os.environ.get('GOOGLE_API_KEY'))

# 이미지 경로 (실제 경로로 대체)
image_path = Path("public/cheatsheets/week1/deep-dive-llms/tokenization.png")
image_data = image_path.read_bytes()

model = genai.GenerativeModel('gemini-2.0-flash')

prompt = """
이 치트시트 이미지를 분석해주세요. 다음 항목들을 JSON 형식으로 반환해주세요:

1. extracted_text: 이미지에서 추출한 모든 텍스트 (섹션별로 구분)
2. diagrams: 다이어그램/그래프 설명
3. technical_terms: 기술 용어 목록
4. numbers: 이미지에 나타난 모든 숫자/수치
5. potential_issues: 발견된 잠재적 오류나 이상한 점

JSON 형식으로만 답변해주세요.
"""

response = model.generate_content([prompt, {"mime_type": "image/png", "data": image_data}])
print(response.text)
PYEOF

결과를 .claude/outputs/review-cheatsheet/week{N}/{slug}/{chapter}-gemini-analysis.json에 저장합니다.

Step 3: md 파일과 비교 분석

Task agent를 호출하여 비교 분석을 수행합니다:

Task tool 호출:
- subagent_type: "general-purpose"
- prompt: .claude/agents/review-cheatsheet/compare-analyzer.md 내용
         + Gemini 분석 결과 JSON
         + kr md 파일 내용
- description: "cheatsheet-compare - 치트시트 검증"

Step 4: 리포트 생성

비교 분석 결과를 바탕으로 리포트를 생성합니다:

# 치트시트 검증 리포트

## 문서 정보
- **경로**: week1/deep-dive-llms/tokenization
- **이미지**: public/cheatsheets/week1/deep-dive-llms/tokenization.png
- **검증일**: {날짜}

## 검증 결과 요약
| 항목 | 상태 | 비고 |
|------|------|------|
| 텍스트 정확성 | ✅/⚠️/❌ | {설명} |
| 기술적 정확성 | ✅/⚠️/❌ | {설명} |
| 문맥적 일관성 | ✅/⚠️/❌ | {설명} |

## 발견된 이슈

### Critical (즉시 수정 필요)
- {이슈 설명}

### Warning (확인 권장)
- {이슈 설명}

### Info (참고)
- {이슈 설명}

## 상세 비교

### 이미지 추출 텍스트
{Gemini가 추출한 텍스트}

### md 파일 핵심 내용
{kr md 파일의 요약/핵심 정리 섹션}

### 불일치 항목
{구체적인 불일치 내용}

Write tool로 .claude/outputs/review-cheatsheet/week{N}/{slug}/{chapter}-review-report.md에 저장합니다.

Step 5: 결과 출력

✅ 치트시트 검증 완료!

📊 **검증 결과**: {전체 상태}

📋 **발견된 이슈**:
  - Critical: {N}건
  - Warning: {N}건
  - Info: {N}건

📁 **리포트 저장 위치**:
  .claude/outputs/review-cheatsheet/week1/deep-dive-llms/
  ├── tokenization-gemini-analysis.json
  └── tokenization-review-report.md

💡 **권장 조치**:
  {Critical 이슈가 있으면 수정 권장}

--all 옵션

week1의 모든 치트시트를 순차적으로 검증합니다:

1. public/cheatsheets/week1/**/*.png 파일 목록 가져오기
2. 각 이미지에 대해 Step 1-5 반복
3. 전체 요약 리포트 생성: master-report.md

에러 처리

상황	처리
이미지 파일 없음	"치트시트 이미지를 찾을 수 없습니다: {경로}"
md 파일 없음	"한국어 번역 파일을 찾을 수 없습니다: {경로}"
API 키 없음	".env 파일에 GOOGLE_API_KEY를 설정해주세요"
API 오류	에러 메시지 출력 후 스킵

요구사항

• Python 패키지: google-generativeai (또는 google-genai)
• 환경변수: .env 파일에 GOOGLE_API_KEY 설정
• API 키 발급: https://aistudio.google.com/app/apikey