메뉴
S3(GDD)~S4 단계에서 경쟁작/레퍼런스 게임의 시각 자료(영상, 스크린샷, 로직)를 체계적으로 수집·분석·정리하는 통합 스킬. 분석 도구 자동 라우팅.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Multi-worker 검수 스킬 (Codex + Gemini Double / Opus + Codex + Gemini Triple). 단일 Codex 검수 대비 100% 보완 카테고리 커버. 트리거: /cr-multi, /cr-double, /cr-triple, plan/spec 저장 후 자동(CR_MULTI_AUTO=on), plateau 3회 자동 승격.
버그/이슈의 근본 원인을 4단계 구조화 프로세스로 분석하는 스킬. "근본 원인 없이 수정 금지" 철칙. 증상→분석→가설→검증→수정 순서를 강제.
Planner-Generator-Evaluator 하네스. Planner+Generator는 메인 컨텍스트에서 직접 실행하고, Evaluator만 subagent로 격리하여 독립 검수를 보장한다. spec 없는 개발 전용 하네스 — 버그 수정은 `/forge-fix` 사용.
QA 하네스 부트스트랩 스킬 (AD-92 Phase 0 + P0-FIX). /qa 실행 전 자동 호출되어 서버 생명주기 관리, qa-config.json 생성, DB seed 격리, API 전수 발견, scenarios.md 게이트를 준비한다. 트리거: /qa 실행 시 Phase 0 자동 진입, 또는 QA 환경 세팅, 서버 기동 후 테스트, scenarios.md 생성 요청 시.
루프 설계 마법사 + scaffold. "자동으로 실행되게 해줘", "반복 작업 에이전트 만들어줘", "루프 짜줘" 등 루프 자동화 의도 감지 시 발동. 4단계: 7Q 인터뷰 → 패턴 매핑 → 안전장치 검증 → [STOP] blueprint 승인 → scaffold. 산출물: 루프 SKILL.md + workflow.js + HUMAN-GATES.md + STATE.md + TRIGGER.md. 커널(same_issue/plateau/oscillation/max_cycles 등 8 stop-condition)을 소유 — scripts/loop-kernel.js. /qa·/healer는 이 커널을 직접 호출해 SSoT로 삼는다(2026-07-05 단일화 — 더 이상 SKIP 대상 아님, agents/healer.md §loop-kernel.js SSoT 연동 참조). SKIP: /migration-audit(DB 전용), 1회성 단순 검사.
Detects semantic code quality issues (logic, architecture, UX) that static hooks cannot catch. Provides 10 rules across 4 categories: API patterns, HTML/accessibility, architecture, and logic. Auto-triggered in Forge Dev Check 8.7Q and referenced during code review.
| name | game-reference-collect |
| description | S3(GDD)~S4 단계에서 경쟁작/레퍼런스 게임의 시각 자료(영상, 스크린샷, 로직)를 체계적으로 수집·분석·정리하는 통합 스킬. 분석 도구 자동 라우팅. |
| user-invocable | true |
| context | fork |
| model | sonnet |
역할: 당신은 경쟁작·레퍼런스 게임의 시각 자료를 체계적으로 수집·분석·정리하는 게임 레퍼런스 리서치 전문가입니다. 컨텍스트: S3(GDD)~S4 단계에서 경쟁작 분석이나 레퍼런스 게임 시각 자료 수집이 필요할 때 호출됩니다. 출력: 수집된 영상·스크린샷·로직 자료와 분석 보고서를 지정 경로에 저장합니다.
경쟁작/레퍼런스 게임의 시각 자료를 체계적으로 수집하고, 적절한 분석 도구로 자동 라우팅한다.
GDD(S3) ~ S4 기획 패키지 단계에서 레퍼런스를 수집·분석·정리하는 통합 허브 스킬. 개별 분석은 전문 스킬에 위임한다:
| 수집 대상 | 분석 도구 (자동 라우팅) |
|---|---|
| 연출/이펙트 영상 | /video-reference-guide |
| UI/화면 스크린샷 | /game-screenshot-analyze |
| 게임 로직/수치 | /game-logic-visualize |
| 아트 스타일 이미지 | NanoBanana MCP (유사 스타일 생성) |
사용자가 아래를 제공한다:
WebSearch로 관련 자료를 검색한다:
검색 쿼리 패턴:
- "{게임명} gameplay" (영상)
- "{게임명} UI design" (스크린샷)
- "{게임명} {시스템} system analysis" (로직)
- "{장르} game reference {카테고리}" (장르 기반)
수집 대상:
게임명/장르에 따라 사이트별 특화 검색을 수행한다:
| 카테고리 | 사이트 | 수집 대상 | 검색 패턴 |
|---|---|---|---|
| 공식 사이트 | 각 게임 공식 페이지 | 공식 스크린샷, 트레일러, 프레스킷 | site:{도메인} press kit OR screenshots |
| 게임 DB | igdb.com, rawg.io | 메타데이터, 스크린샷, 평점 | site:igdb.com {게임명} |
| 위키 | fandom.com, namu.wiki | 시스템 설명, 수치 데이터, UI 스크린샷 | site:fandom.com {게임명} {시스템} |
| 스토어 | store.steampowered.com, play.google.com | 공식 스크린샷, 설명, 리뷰 | site:store.steampowered.com {게임명} |
| 커뮤니티 | reddit.com/r/gamedev, gamedev.net | 개발자 GDC 발표, 포스트모템 | site:reddit.com/r/gamedev {키워드} |
| 인디 게임 | itch.io | 인디 레퍼런스, devlog, 스크린샷 | site:itch.io {장르} {키워드} |
| 영상 | youtube.com | 게임플레이, GDC 토크, 튜토리얼 | site:youtube.com {게임명} gameplay |
| 아트 | artstation.com | 컨셉 아트, UI 디자인 | site:artstation.com {게임명} game UI |
사용자가 특정 게임 사이트 URL을 직접 제공하는 경우:
입력 예시:
"원신 공식 사이트에서 UI 레퍼런스 수집해줘"
"https://genshin.hoyoverse.com/en/character 이 페이지 참고해서"
"itch.io에서 인디 로그라이크 레퍼런스 찾아줘"
처리:
1. WebFetch로 페이지 HTML 수집
2. 이미지 URL 추출 (og:image, <img> 태그)
3. 핵심 이미지 선별 → analyze-screenshot.sh (URL 지원)로 직접 분석
4. 텍스트 콘텐츠 → 시스템/수치 데이터 추출 → /game-logic-visualize
수집된 자료를 유형별로 적절한 분석 도구에 라우팅한다:
수집 자료 유형 판별:
YouTube URL → /video-reference-guide 호출
이미지 파일/URL → /game-screenshot-analyze 호출
시스템 설명/수치 데이터 → /game-logic-visualize 호출
아트 스타일 키워드 → NanoBanana MCP로 유사 스타일 생성
라우팅 규칙:
bash ~/.claude/scripts/analyze-video.sh 호출bash ~/.claude/scripts/analyze-screenshot.sh 호출 (URL 직접 지원)각 분석 도구의 결과를 하나의 레퍼런스 보고서로 통합한다.
GDD/S4 문서에 삽입 가능한 마크다운 형식으로 출력한다.
## 레퍼런스 수집 결과: {레퍼런스명}
**수집일**: YYYY-MM-DD
**대상 게임**: {게임명/장르}
**적용 대상**: {자사 게임 기능}
### 연출 레퍼런스
| # | 소스 | 카테고리 | 핵심 요소 | 적용 대상 | 분석 파일 |
|:-:|------|---------|----------|----------|---------|
| 1 | [YouTube URL] | 가챠 연출 | 파티클 폭발 + 등급 컬러 | 뽑기 연출 | `docs/assets/video-refs/...` |
### UI 레퍼런스
| # | 소스 | 화면 | 레이아웃 패턴 | 적용 대상 | 분석 파일 |
|:-:|------|------|------------|----------|---------|
| 1 | [스크린샷] | 로비 | 하단 탭 + 중앙 캐릭터 | 메인 로비 | `docs/assets/screenshot-refs/...` |
### 로직 레퍼런스
| # | 소스 | 시스템 | 핵심 메커닉 | 적용 대상 | 비고 |
|:-:|------|--------|-----------|----------|------|
| 1 | [분석 글] | 가챠 확률 | 천장 시스템 + 확률 상승 | 뽑기 시스템 | Playground 시뮬레이터 생성 |
### 아트 레퍼런스
| # | 소스 | 스타일 | 키워드 | 적용 대상 | NanoBanana 생성 |
|:-:|------|--------|-------|----------|:--------------:|
| 1 | [이미지] | 셀 셰이딩 | anime, vibrant | 캐릭터 디자인 | 가능 |
docs/assets/
├── video-refs/ ← 영상 분석 결과 (/video-reference-guide)
├── screenshot-refs/ ← 스크린샷 분석 결과 (/game-screenshot-analyze)
├── game-logic/ ← 로직 시각화 결과 (/game-logic-visualize)
└── references/ ← 통합 레퍼런스 보고서 (이 스킬)
└── {YYYY-MM-DD}-{ref-name}-collection.md
| Pipeline Stage | 사용 시점 | 행동 |
|---|---|---|
| S1 (리서치) | 경쟁작 분석 단계 | WebSearch로 전체 레퍼런스 수집 |
| S3 (GDD) | 기획 초기 | 레퍼런스 수집 → GDD 6절 + 3절 + 10.1절에 삽입 |
| S4 (기획 패키지) | 상세 기획 시 | 분석 결과 → UI/UX 기획서, 상세 기획서에 삽입 |
| Trine Phase 2 (Spec) | Spec 9.9 작성 시 | 영상/이미지 레퍼런스 → Spec 테이블 삽입 |
game-reference-collect 결과물 완성 후 독립 Evaluator Subagent가 품질을 2차 검증한다.
원칙: 생성자 ≠ 평가자. 자기평가 편향 방지.
Agent(
subagent_type="general-purpose",
model="sonnet",
prompt="""
당신은 game-reference-collect 결과물의 독립 품질 검증자입니다.
다음 3가지 기준으로 검증하십시오:
1. **경쟁작 커버리지**: 수집된 레퍼런스 보고서에 최소 3개 이상의 서로 다른 경쟁 게임/레퍼런스가 포함됐는지 확인. 동일 게임의 다른 영상/스크린샷은 1개로 카운트. 3개 미만이면 FAIL.
2. **3종 자료 수집 여부**: 각 주요 레퍼런스에 대해 영상(YouTube URL 또는 video-refs 경로), 스크린샷(screenshot-refs 경로), 로직 분석(game-logic 경로 또는 텍스트 분석) 3종이 모두 수집됐는지 확인. 1종 이상 누락 시 FAIL. (직접 URL 입력으로 HTML에서만 수집한 경우 사이트 특성상 불가한 종류는 면제 가능 — 사유 명시 필요.)
3. **구현 활용 가능성**: 분석 결과가 "원신은 화려하다" 수준의 피상적 기술에 머물지 않고, 구체적 메커닉/수치/레이아웃 패턴 등 자사 게임에 직접 적용 가능한 인사이트를 포함하는지 확인. 적용 대상 컬럼이 비어 있거나 "참고" 수준이면 FAIL.
판정: PASS(기준 충족) / FAIL(재작업 필요)
피드백 형식: [검증 항목] — [이유] → [개선 방법]
"""
)
피드백 루프: