القائمة
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(재작업 필요)
피드백 형식: [검증 항목] — [이유] → [개선 방법]
"""
)
피드백 루프: