viettranx/3dviz-pro-max

3Dviz Pro Max – AI 기반 3D 장면 제작

무엇인가요 – Claude Code, Codex 및 유사한 LLM 에이전트를 위한 독립형 스킬으로, 자연어로 표현된 의도(예: "움직이는 생물체가 있는 작은 판타지 마을 만들기")를 완전하고 렌더링 가능한 Three.js 장면으로 변환할 수 있습니다. 이 스킬은 10단계 워크플로우, 검색 가능한 223개의 "레시피" 카탈로그, 440개의 지식 기록, 22개의 완성된 킷 블루프린트, 스타일 프로파일, 그리고 렌더링된 프레임을 캡처하여 에이전트가 검토할 수 있도록 도와주는 Python 헬퍼를 제공합니다.

작동 방식

1. 의도 → 추론 – 에이전트는 사용자 요청을 분석하고 필요한 객체, 스타일, 행동을 결정합니다.
2. 기존 킷 재사용 / 적응 – 카탈로그에서 킷 블루프린트(예: 지형, 오두막, 기어 세트)를 선택하거나, 자체적으로 새 것을 작성합니다.
3. 첫 번째 뷰 구축 – 선택한 자산, 조명 장치, 카메라 설정 등을 포함한 Vite + Three.js 스켈레톤을 채웁니다.
4. 실행 및 캡처 – scripts/capture.py가 Playwright를 통해 헤드리스 Chromium 인스턴스를 시작하고, 실제 GPU에서 장면을 렌더링한 후 PNG 프레임과 로그를 기록합니다.
5. 개선 – 에이전트는 관측된 프레임과 의도된 설명을 비교하여 파라미터를 조정하고, 보고서가 증거와 일치할 때까지 반복합니다.
6. 보고서 – 최종 출력은 구현된 내용의 요약과 함께 캡처된 이미지입니다.

제공되는 항목

항목	수량	비고
레시피	223	24개의 주제 방향(환경, 해부학, 로봇공학 등)
지식 기록	440	스타일, 조명, 카메라, 재질의 기본 설정
킷 블루프린트	22	SHA‑256 검증된 캡처 포함된 검증된 Three.js 모듈(T0–T3 계층; T4는 제공되지 않음)
스타일 프로파일	37	숫자 기본값이 있는 이름이 지정된 스타일
예제 연구	37	완전히 실행 가능한 데모(심장 해부, 기어 메커니즘, 판타지 마을 등)
쇼케이스 프레임	21	실제 GPU 캡처(1920×1080) docs/demos/에 저장

설치 – skills/3dviz-pro-max/ 폴더 전체가 플러그인입니다.

# Claude Code (플러그인 디렉터리)
ln -s $(pwd)/skills/3dviz-pro-max ~/.claude/skills/3dviz-pro-max
# 또는 zip으로 로드
claude --plugin-dir 3dviz-pro-max-0.1.0-plugin.zip

Codex의 경우, 폴더를 Codex 스킬 디렉터리에 복사하세요. 캡처 단계만 Playwright(Chromium용) 및 선택적으로 Blender 4.2+가 필요하며, 나머지는 일반 Node로 실행됩니다.

데모 실행 방법

cd examples
pnpm install          # Vite + Three.js 종속성 설치
pnpm dev               # http://localhost:4180/<demo-id>/ 제공

각 데모 폴더에는 프롬프트, 생성된 장면, 소스 참조 및 제한 사항이 포함되어 있습니다.

일반적인 사용 사례

• 빠른 프로토타이핑: 단일 문장으로 게임 레벨 자산이나 과학적 시각화를 빠르게 구현.
• 교육: 학생이 LLM에 개념을 시각화하도록 요청(예: "3:2 비율의 기어 쌍을 보여줘")하고, 직접 탐색할 수 있는 실시간 Three.js 모델을 받음.
• LLM의 지식 기반 평가: 스킬 내부의 리트리벌 케이스 테스트를 통해 연구자가 에이전트가 의도를 관측 가능한 그래픽으로 변환할 수 있는 정도를 측정 가능.

정직한 한계

• 이 스킬은 프레임을 캡처할 뿐이며, 모든 레시피가 성공적으로 렌더링되었음을 보장하지 않습니다.
• 지식 기록은 런타임 관측에서 유도된 것이 아니라 편집적으로 검토되었습니다.
• 타이어 T4 블루프린트는 제공되지 않습니다. 최고 품질의 자산은 두 개의 Blender 베이킹된 GLB(타이어 T3)입니다.
• 평가 점수는 조건당 한 번의 실행 기반으로, 결정적이기보다는 지표적입니다.
• Playwright/Chromium 또는 Blender 없이 캡처 단계는 중단되며, 에이전트는 누락된 프레임을 보고해야 합니다.

라이선스 – 리포지토리의 코드, 데이터, 저작된 미디어는 MIT 라이선스입니다. 제3자 자산은 각각의 원래 라이선스를 유지합니다(예: BodyParts3D 메시는 CC BY‑SA 2.1 JP 하에).

---

모든 세부 정보는 리포지토리의 README에서 직접 가져왔으며, 외부 가정은 추가되지 않았습니다.