unity-technologies/migrate-birp-to-urp

요청을 분류하고, 현재 프로젝트 상태를 검사하며, 올바른 마이그레이션 경로를 선택하고, Built-in에서 URP로의 마이그레이션 결과를 신중하게 검증하세요.

필수 실행 참조

실제 마이그레이션 또는 수리 작업을 수행하기 전에 첫 번째 eval 호출 전에 references/implementation-patterns.md를 읽으십시오. 이는 프로젝트 설정, 머티리얼, 포스트 프로세싱, 조명, 프로브 또는 씬을 수정하는 모든 경우에 해당합니다. "이 프로젝트를 URP로 마이그레이션"과 같이 롤백 안전성이 이미 확인된 짧은 프롬프트에도 필수입니다.

해당 리소스를 로드할 수 없는 경우, 이 SKILL.md에 포함된 규칙을 사용하고 자신감 수준을 낮추십시오. 의도 또는 도구 로그만으로 PPv2 변환, 조명/프로브 새로고침 또는 마이그레이션 완료를 주장하지 마십시오.

중요 기본값

"이 Built-in 프로젝트를 URP로 마이그레이션" 또는 "이 프로젝트를 URP로 이동"과 같은 간단한 요청의 경우, 바로 변환으로 건너뛰지 말고 안전한 마이그레이션 워크플로우를 시작하거나 재개하십시오.

일반적인 업그레이드 프롬프트는 사용자가 모든 마이그레이션 위험을 언급하도록 요구해서는 안 됩니다. PPv2, 베이크된 조명/라이트맵, 리플렉션 프로브, 파티클/안개/연기 머티리얼, Quality 레벨, 카메라 포스트 프로세싱, 대표 씬 검증 등 일반적인 Built-in 종속성을 검사하고 처리하십시오.

기본 결과는 단계 기반입니다:

1. 프로젝트가 Built-in 상태인지, 부분 마이그레이션되었는지, 이미 URP인지 또는 HDRP인지 감지합니다.
2. 요청을 표준 3D URP, URP 2D, 선택적 머티리얼 변환, 계획 전용 또는 문제 해결로 분류합니다.
3. 변경 사항을 권장하기 전에 마이그레이션 위험을 검사합니다: 불투명 머티리얼, 파티클/VFX 머티리얼, 커스텀 셰이더, 포스트 프로세싱, 카메라 효과, 베이크된 조명/라이트맵/리플렉션 프로브, Quality 레벨 및 대표 씬.
4. 사용자가 브랜치, 백업, 아카이브 또는 폐기 가능한 복사본과 같은 롤백 지점을 확인할 때까지 파이프라인을 변경하는 작업을 중단합니다. 파이프라인 변경 작업에는 URP 설치, Graphics/Quality 설정에 URP 에셋 할당, 컨버터 실행, 머티리얼 또는 씬 편집이 포함됩니다.
5. 다음 마이그레이션 단계를 선택하고, 해당 단계를 실행하며, 그 출력을 저장/재질의하고, 해당 단계의 상태를 보고합니다.
6. 커스텀 셰이더, GrabPass, 서피스 셰이더, OnRenderImage, 교체 셰이더 및 패키지 소유 셰이더는 자동 컨버터 작업이 아닌 범위가 지정된 후속 작업으로 취급합니다.
7. 전체 마이그레이션 성공을 선언하기 전에 대표 씬, 콘솔 출력, 카메라 렌더링, 조명/베이크된 GI 상태, 머티리얼, 포스트 프로세싱 지속성 및 Quality 레벨 할당을 검증하십시오.

기본 단계:

• Phase 0: 검사 및 계획. 파이프라인 상태, 대표 씬, 롤백 안전성, PPv2, 머티리얼/셰이더 위험, Quality 레벨, 조명/라이트맵/프로브 상태 및 커스텀 렌더 코드를 감지합니다.
• Phase 1: URP 설정 및 지원되는 머티리얼 변환. URP 설치/재사용, Graphics/Quality에 URP 에셋 생성/할당, 지원되는 불투명 및 파티클/효과 머티리얼을 변환하고, 지원되는 머티리얼이 Built-in 셰이더에 남아 있지 않은지 확인합니다.
• Phase 2: 포스트 프로세싱 및 카메라 마이그레이션. 영구적인 URP Volume 프로필을 생성하고, 씬 Volume/카메라 포스트 프로세싱을 연결하며, URP 검증을 위해 레거시 PPv2를 비활성화하고, SSR과 같이 지원되지 않는 PPv2 효과를 분류합니다.
• Phase 3: 조명, 라이트맵 및 리플렉션 프로브. 오래된 Built-in 조명 상태를 해결하고, URP 조명/프로브 설정을 구성하며, 가능한 경우 리베이크/새로고침하거나 조명/프로브를 부분 완료로 명확히 표시합니다.
• Phase 4: 최종 검증 및 보고. 프로젝트 상태를 저장/리로드/재질의하고, 대표 씬을 캡처하며, 콘솔을 확인하고, 완료/미완료/수동 항목을 보고합니다.

프로젝트가 작고 Unity가 안정적으로 유지된다면 한 턴에 여러 단계를 완료할 수 있지만, 모든 단계를 하나의 응답에 강제로 포함시키지 마십시오. 과장된 "완료" 결과보다는 정직한 단계 경계를 선호하십시오.

프로젝트 상태나 사용자 의도에 실제 결정되지 않은 부분이 있을 때만 구성 질문을 하십시오. 사용자가 "파일을 수정하지 마십시오"라고 말하면 감사/계획 모드로 유지하고 변환이나 에셋 편집을 수행하지 마십시오.

일반 업그레이드 계약

사용자가 일반적인 마이그레이션 요청을 하고 변경을 허용하면, 프로젝트 상태에서 다음 단계를 진행하십시오:

1. 검사 전에 사용자에게 알려진 Built-in 기능을 열거하도록 요청하지 마십시오. 직접 발견하십시오.
2. PPv2, 베이크된 조명, 리플렉션 프로브, 파티클/안개/연기 머티리얼 또는 여러 Quality 레벨이 존재하는 경우, 자동으로 마이그레이션에 포함하십시오.
3. 한 번에 모든 것을 완료하는 것보다 단계 완료를 선호하십시오. 각 단계는 자체 출력을 저장/재질의하고 Phase complete, Phase partial 또는 Blocked로 끝나야 합니다.
4. Unity 컴파일, 패키지 설치, 도메인 리로드 또는 긴 조명 베이크가 작업을 중단시키면, 해당 중단을 단계 경계로 보고하고 다음 턴에서 저장된 부분 상태부터 재개하십시오. 처음부터 다시 시작하지 마십시오.
5. 사용자가 올바른 동작을 얻기 위해 상세한 체크리스트 프롬프트를 작성해야 한다고 가정하지 마십시오. 상세 체크리스트는 벤치마킹 또는 스트레스 테스트용입니다. 일반 사용자 프롬프트에서도 이 단계별 계약이 실행되어야 합니다.
6. 일반적인 마이그레이션 요청은 검사 및 계획에 대한 권한을 부여하지만, 롤백 안전성을 증명하지는 않습니다. 롤백 지점이 확인되지 않으면 패키지 설치 또는 URP 할당 전에 중단하고 확인을 요청하십시오. 백업 질문을 위해 프로젝트를 마젠타색 부분 상태로 두지 마십시오.
7. 롤백 안전성이 이미 확인되었거나 사용자가 프로젝트가 폐기 가능한 복사본이라고 말하면, 일상적인 작업에 대해 다시 묻지 않고 현재 단계 내에서 계속하십시오.
8. 단계가 끝나면 간결한 다음 단계 프롬프트를 제공하거나 어떤 단계가 다음에 실행되어야 하는지 말하십시오. 새로운 비용이 많이 들거나 위험한 작업(긴 조명 베이크, 레거시 에셋 삭제/정리, 커스텀 셰이더 재작성 등)이 도입될 때만 다음 단계 전에 확인을 요청하십시오.
9. 롤백 안전성이 확인되었고 활성 단계 내에서 일반 작업이 완료되지 않은 경우, "계속할까요?"라고 묻지 마십시오. 해당 단계의 게이트가 통과되거나, 도구/도메인 리로드 경계가 실행을 중단시키거나, 진정으로 새로운 위험한 결정이 나타날 때까지 수리를 계속하십시오.

일반 마이그레이션 성공 게이트

일반 마이그레이션이 "성공적", "완료" 또는 "완전히 마이그레이션됨"이라고 말하기 전에, 도구 로그뿐만 아니라 저장된 프로젝트 상태를 검증하십시오:

1. Graphics 설정과 모든 관련 Quality 레벨이 의도한 URP 에셋을 가리키고 있습니다.
2. URP 에셋이 저장된 상태에 유효한 기본 렌더러를 가지고 있으며, 현재 콘솔 출력에 "Default Renderer is missing"과 같은 해결되지 않은 렌더 파이프라인 오류가 없습니다. 할당 후 렌더러 오류가 나타나면, 저장된 렌더러 목록/기본 인덱스를 재질의하고, 가능한 경우 오래된 콘솔 출력을 지우고, 신선한 씬/카메라 검증을 트리거하고, "URP 설정 완료"에서 멈추지 말고 수리를 계속하십시오.
3. 지원되는 Built-in 머티리얼(파티클/안개/연기 머티리얼 포함)이 URP 호환 셰이더를 가지고 있거나 해결되지 않은 커스텀/패키지 셰이더 케이스로 명시적으로 나열되어 있습니다. 텍스처/색상이 있는 소스 머티리얼은 소스 맵/색상을 보존해야 합니다. _BaseMap이 누락되었거나 _BaseColor가 모두 흰색인 URP 셰이더 할당은 소스 _MainTex 또는 _Color에 내용이 있었다면 불완전합니다. 파티클, 안개, 연기, 스팀, 데칼, VFX, 가산, 투명 효과 머티리얼을 맹목적으로 Universal Render Pipeline/Lit으로 강제하지 마십시오. 적절한 경우 Universal Render Pipeline/Particles/Unlit과 같은 URP 파티클/효과 셰이더를 선호하십시오.
4. 소스 씬이 PPv2를 사용했다면, 저장된 URP Volume 프로필이 존재하고, 지원되는 포스트 프로세싱 효과(예: 톤 매핑, 블룸, 비네트, 색수차)를 동등하게 유지하며, 잘못된 OnRenderImage 또는 레거시 PPv2 동작에 의존하지 않고 적절한 카메라 포스트 프로세싱을 연결합니다. 지원되지 않는 PPv2 효과(예: SSR)는 별도로 분류해야 합니다.
5. 베이크된 조명 사용자 지정 레이어/태그가 보존되고, 정적 조명 설정이 유지되며, 리플렉션 프로브가 URP 렌더링과 일치합니다(적절한 타입/HDR).
6. 저장된 상태를 로드하고 대표 씬을 다시 열었을 때(도메인 리로드 시뮬레이션), 파이프라인 설정이 유지되고, 제공된 씬에 마젠타/분홍색 머티리얼이 없으며, 콘솔에 오류가 없고, 카메라 미리보기가 중단되지 않습니다.