skyrim-creation-kit-agent

# Skyrim Creation Kit Agent 이 저장소는 *The Elder Scrolls V: Skyrim Special Edition* 및 *Anniversary Edition*을 위한 AI 지원 모드 제작 에이전트 개발을 위한 연구 및 엔지니어링 산출물을 포함합니다. 이 프로젝트는 안전 우선 방법론에 초점을 맞추며, 고수준 모딩 의도를 타입이 지정되고, 되돌릴 수 있으며, 증거 기반의 작업으로 변환합니다. ## 핵심 철학 시스템은 네 가지 원칙에 따라 운영됩니다: 1. **AI가 WHAT을 결정**: LLM/플래너가 원하는 작업을 결정합니다. 2. **결정론적 소프트웨어가 HOW를 결정**: 타입이 지정된 워커가 작업을 실행합니다. 3. **검증기가 WHETHER IT WORKED를 결정**: 자동화된 검사가 무결성을 보장합니다. 4. **인간이 WHETHER TO ACCEPT를 결정**: 적용 전 최종 승인이 필요합니다. 목표 제품은 기본 경로가 헤드리스이고 결정론적인 하이브리드 오케스트레이터입니다. Creation Kit은 시스템의 핵심이 아니라 좁은 기능으로 취급됩니다. ## 현재 상태 **연구 + 검증된 합성 개념 증명.** 이것은 아직 범용 모드 제작 에이전트가 아니며, 현재 Creation Kit을 직접 자동화하지도 않습니다. 현재 Gate-1 판정은 "VIABLE WITH LIMITATIONS"입니다. 대부분의 레코드 수준 작업은 그럴듯하게 Creation Kit을 피할 수 있지만, 여러 영역(예: FaceGen, navmeshes, 복잡한 퀘스트 의미론)은 여전히 미해결입니다. ### 상태 용어 - `VERIFICADO`: 직접 증거 또는 재현 가능한 테스트로 지원됨. - `PASS`: 실험이 실행되고 정의된 게이트를 통과함. - `NO VERIFICADO`: 그럴듯하지만 여기서 재현되지 않음. - `HIPOTESIS`: 제안된 실험 또는 설계 주장. - `EXPERIMENTAL`: 실험으로만 구현됨. - `BLOQUEADO`: 사용 가능한 환경에서 진행할 수 없음. - `DESCARTADO`: 명시적으로 거부됨. - `LEGAL_REVIEW_REQUIRED`: 기술적 경로는 존재하지만 라이선싱/EULA 영향이 미해결됨. ## 아키텍처 권장 제품 형태는 **하이브리드 오케스트레이터 + 헤드리스 우선 기본 경로**입니다: ```text User Intent ↓ Intent normalizer ↓ Planner / LLM ↓ Typed ModPlan ↓ Policy / safety engine ↓ Capability router ├─ Headless plugin worker ├─ Papyrus worker ├─ xEdit validator └─ Creation Kit worker [disabled until independently verified] ↓ Candidate workspace ↓ Validator ↓ Human approval ``` 플래너는 임의의 셸 명령이나 GUI 자동화 기본 요소를 받아서는 안 됩니다. 작업은 유형에 따라 특정 워커로 라우팅됩니다. ## 검증된 구현: POC-002 `research/poc_002/`는 첫 번째 실행 가능한 개념 증명입니다: - 합성 TES4 픽스처만 사용합니다. - 닫힌 작업 열거형을 가진 엄격한 파서를 구현합니다. - 경로 포함이 있는 후보 전용 워크스페이스를 강제합니다. - 실패 폐쇄 오케스트레이션과 덮어쓰기 없는 영수증을 보장합니다. - 원본 파일에 대한 SHA-256 불변성을 유지합니다. - 44개의 자동화된 테스트를 포함합니다(초기 기준선: 43; +1 적대적 회귀). POC-002를 실행하려면: ```bash cd research/poc_002 python -m compileall . python -m unittest test_suite.py -v ``` 참고: 이것은 임의의 실제 Skyrim 플러그인, Creation Kit 런타임 동작, xEdit, PapyrusCompiler, Mutagen 또는 게임 내 정확성과의 호환성을 증명하지 않습니다. ## Discovery Desk 연구 UI 저장소는 "Discovery Desk"라는 작은 Next.js + Drizzle/PostgreSQL 연구 앱을 보존합니다. - `src/app/`, `src/db/`, `src/lib/research/`는 이 UI에 속합니다. - 이것은 미래 제작 에이전트의 런타임이 **아닙니다**. - 개발에는 `DATABASE_URL` 환경 변수가 필요합니다(`.env.example` 참조). 변수가 없으면 빌드 프로세스가 빠르게 실패하지만, 연결 풀이 지연되므로 CI에는 라이브 PostgreSQL 서버가 필요하지 않습니다. ## 안전 규칙 - 사용자의 유일한 플러그인 복사본을 절대 수정하지 마십시오. - 원본은 불변 입력입니다; 쓰기는 후보로 갑니다. - AI 생성 계획에 임의의 셸 명령이 없어야 합니다. - 기본 경로로 좌표 클릭 GUI 자동화를 사용하지 마십시오. - 완료 증거 누락은 성공이 아니라 실패입니다. - Bethesda 게임/편집기 바이너리, 바닐라 플러그인 또는 바닐라 Papyrus 소스를 절대 커밋하지 마십시오. - 프로세스 격리는 기술적 경계이지 자동 라이선싱 결론이 아닙니다. ## 라이선싱 - **저장소 작성 핵심 코드**: MIT License. - **Mutagen / Synthesis / Spriggit**: GPL-3.0-only. 결합 저작물은 GPL 준수가 필요합니다. - **xEdit**: MPL-2.0 업스트림. 외부 실행용이며 절대 벤더링되지 않습니다. - **CKPE**: LGPLv3 코드와 Creation Kit EULA/법적 오버레이. 상태: `LEGAL_REVIEW_REQUIRED`. - **Creation Kit, PapyrusCompiler, 바닐라 자산**: 독점 사용자 설치 구성 요소. 절대 재배포되지 않습니다. 타사 npm 패키지와 OFL 폰트는 별도 고지를 가집니다. 가져온 연구 ZIP은 출처가 미해결입니다. ## Sky-Claw와의 관계 이것은 별도의 저장소이자 연구 트랙입니다. 나중에 문서화된 프로토콜을 통해 Sky-Claw와 통합될 수 있지만, 독립적으로 테스트 가능해야 하며 Sky-Claw 내부를 안전 경계로 가정해서는 안 됩니다. ## 면책 조항 Bethesda Game Studios, ZeniMax Media, Valve, Nexus Mods 또는 타사 도구 작성자와 제휴 관계가 없습니다.