[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CBAT3C8BZ5R1AK7CYCVQB7":3,"skill-same:01M6CBAT3C8BZ5R1AK7CYCVQB7":45},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":20,"linkOnly":21,"markdownContent":22,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":13,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":29,"updatedAt":30,"install":31,"resources":44},"01M6CBAT3C8BZ5R1AK7CYCVQB7","05-unity-csharp-compat",null,"devwinsoft\u002Fdevian","devwinsoft","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F22570160?v=4","01M6C6RR8W05NH8NPKQNCE3Q72","maoshy","01M6C6RRDJ5TJJCZXRTY801YDH",0,"MIT","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F05-unity-csharp-compat\u002FSKILL.md",[],[18,19],"csharp","05 unity csharp compat","2026-11-10 10:12:30",false,"# 05-unity-csharp-compat — Unity C# 문법\u002F언어버전 제한\n\nStatus: ACTIVE  \nAppliesTo: v10  \nSSOT: this file\n\n## Purpose\n\nUnity(UPM\u002FPackages 포함)에서 컴파일 깨짐을 원천 방지하기 위한 C# 문법 및 언어버전 제한 정책을 정의한다.\n\n---\n\n## Policy (정책)\n\n### A) 적용 범위 (Scope)\n\n이 정책은 **Unity에서 컴파일되는 모든 C# 코드**에 적용된다.\n\n**적용 대상 경로:**\n\n| 경로 | 설명 |\n|------|------|\n| `framework-cs\u002Fupm\u002F**` | 수동 관리 UPM 패키지 |\n| `framework-cs\u002Fapps\u002FUnityExample\u002FPackages\u002F**` | Unity 최종 패키지 |\n| `framework-cs\u002Fapps\u002F**\u002FPackages\u002F**` | 추가 Unity 앱\u002F샘플 패키지 |\n\n> 적용 대상은 수동 코드 + 생성물 모두 포함한다.\n> UPM 패키지 내부의 `Samples~\u002F`, `Templates\u002F` 및 패키지로 복사된 샘플 코드도 동일하게 적용 대상이다.\n\n### B) 언어 버전 고정 (Language Level)\n\n**Hard Rule:**\n- Unity 대상 C# 코드는 **C# 8 호환 문법만 사용**한다.\n- 최신 C# 기능을 \"추측으로\" 사용하지 않는다.\n- Unity 버전에 따라 지원되지 않는 문법은 **컴파일 실패**를 유발한다.\n\n### C) 금지 문법 목록 (Forbidden — 발견 시 FAIL)\n\n아래 문법은 **Unity C# 적용 범위에서 하드 금지**이며, 발견 시 빌드\u002F정책상 **FAIL**이다.\n\n| 금지 문법 | 설명 | 예시 |\n|-----------|------|------|\n| Primary constructor | class\u002Fstruct\u002Frecord 헤더에 `(` 붙는 형태 | `class X(...)`, `struct X(...)` |\n| `record`, `record struct` | 레코드 타입 | `record Person(...)` |\n| `required` 멤버 | 필수 속성 한정자 | `required string Name` |\n| File-scoped namespace | 세미콜론으로 끝나는 namespace | `namespace X;` |\n| `global using` | 전역 using | `global using System;` |\n| Target-typed `new()` | 타입 생략된 new | `List\u003Cint> x = new();` |\n| `init` accessor | init-only setter | `{ get; init; }` |\n| Collection expression | 대괄호 컬렉션 생성 | `int[] arr = [1, 2, 3];` |\n| List pattern | 리스트 패턴 매칭 | `x is [1, 2, ..]` |\n| Raw string literal | 삼중 따옴표 문자열 | `\"\"\"...\"\"\"` |\n| **Delegate 식별자에 `?`** | delegate 선언의 이름에 `?` 붙이기 | `delegate void Handler?(int x)` |\n| **타입 표기에 `??`** | 타입\u002F멤버 선언부에서 `??` 사용 | `Handler??`, `Action??` |\n\n**원칙:** Unity에서 불확실한 최신 문법은 금지한다.\n\n**Nullable\u002FDelegate 문법 하드 금지:**\n- Delegate 선언에서 식별자(이름)에 `?`를 붙이는 것은 문법 오류다. nullable 표기는 참조 사용 위치에서만 의미가 있다.\n- 타입 표기에서 `??`가 만들어지는 패턴은 문법 오류다. `??`는 표현식 연산자이며 타입\u002F멤버 선언부에 등장하면 컴파일 실패한다.\n\n### D) 표현식 vs 선언 규칙 (CS1519 방지)\n\n**Hard Rule:**\n- `??`, `??=` 등 null-coalescing 계열은 **메서드\u002F표현식 내부에서만** 사용한다.\n- 필드\u002F프로퍼티\u002F클래스 본문(멤버 선언 영역)에 \"표현식 조합\"을 넣는 형태는 금지한다.\n- 애매한 경우 로컬 변수\u002F메서드에서 처리한다.\n\n**금지 예시 (delegate 선언에 `?` 붙이기):**\n```csharp\n\u002F\u002F ❌ WRONG - delegate 선언에 ? 붙임\npublic delegate void MyHandler?(int x);\n\n\u002F\u002F ❌ WRONG - 프로퍼티 타입에 ?? 중복\npublic MyHandler?? OnEvent { get; set; }\n```\n\n**올바른 예시:**\n```csharp\n\u002F\u002F ✅ CORRECT - delegate 선언은 ? 없이\npublic delegate void MyHandler(int x);\n\n\u002F\u002F ✅ CORRECT - nullable 프로퍼티는 타입에 ? 하나만\npublic MyHandler? OnEvent { get; set; }\n\n\u002F\u002F ✅ CORRECT - ?? 는 메서드 내부에서 사용\npublic void DoSomething()\n{\n    var handler = OnEvent ?? DefaultHandler;\n}\n```\n\n---\n\n## Verification (검증)\n\n### 금지 패턴 검사 (Hard Gate)\n\n아래 정규식 패턴이 적용 범위 경로에서 1개라도 발견되면 **FAIL**:\n\n| 패턴 | 탐지 대상 |\n|------|-----------|\n| `\\bclass\\s+\\w+\\s*\\(` | class primary constructor |\n| `\\bstruct\\s+\\w+\\s*\\(` | struct primary constructor |\n| `\\brecord\\b` | record 타입 |\n| `\\brequired\\b` | required 멤버 |\n| `^\\s*namespace\\s+.*;\\s*$` | file-scoped namespace |\n| `\\bglobal\\s+using\\b` | global using |\n| `\\bnew\\s*\\(\\s*\\)\\s*;?` | target-typed new |\n| `\\binit\\s*;` | init accessor |\n| `\\bdelegate\\b[^{;]*\\w+\\s*\\?\\s*\\(` | delegate 식별자에 `?` 붙은 경우 |\n| `\\b[A-Za-z_][A-Za-z0-9_]*\\s*\\?\\?\\b` | 타입\u002F선언부에서 `??` 패턴 |\n\n> 패턴 `\\b[A-Za-z_][A-Za-z0-9_]*\\s*\\?\\?\\b`가 false positive를 내면, 해당 코드를 메서드 내부 표현식으로 옮기고 선언부에서 제거한다.\n\n**검사 대상 경로:**\n- `framework-cs\u002Fupm\u002F`\n- `framework-cs\u002Fapps\u002F**\u002FPackages\u002F`\n- UPM 패키지 내부의 `Samples~\u002F` 및 템플릿\u002F샘플 코드도 검사 대상에 포함한다.\n\n### DoD (Definition of Done)\n\n- [ ] 적용 범위 경로에서 금지 패턴 발견 시 빌드 **FAIL**\n- [ ] 모든 Unity C# 코드가 C# 8 호환 문법만 사용\n\n---\n\n## Examples (예시)\n\n### 좋은 예\n\n```csharp\n\u002F\u002F ✅ Block-scoped namespace\nnamespace Devian\n{\n    \u002F\u002F ✅ 일반 클래스 선언\n    public sealed class NetClient\n    {\n        private readonly INetRuntime _runtime;\n        \n        \u002F\u002F ✅ nullable 프로퍼티\n        public Action\u003Cint>? OnError { get; set; }\n        \n        \u002F\u002F ✅ 생성자\n        public NetClient(INetRuntime runtime)\n        {\n            _runtime = runtime ?? throw new ArgumentNullException(nameof(runtime));\n        }\n    }\n}\n```\n\n### 나쁜 예\n\n```csharp\n\u002F\u002F ❌ File-scoped namespace\nnamespace Devian;\n\n\u002F\u002F ❌ Primary constructor\npublic class NetClient(INetRuntime runtime)\n{\n}\n\n\u002F\u002F ❌ Target-typed new\nprivate readonly List\u003Cint> _list = new();\n\n\u002F\u002F ❌ Init accessor\npublic string Name { get; init; }\n\n\u002F\u002F ❌ Required member\npublic required string Id { get; set; }\n```\n\n---\n\n## asmdef precompiledReferences 정책 (Hard Rule)\n\n### 정책\n\nUnity의 `.asmdef` 파일에서 `precompiledReferences`로 선언된 DLL은 **실제로 프로젝트에 존재해야** 한다.\n\n| 상태 | 결과 |\n|------|------|\n| DLL 파일 존재 | ✅ 정상 빌드 |\n| DLL 파일 없음 (meta만 존재) | ❌ 빌드 실패 |\n| DLL 파일 없음 (meta도 없음) | ❌ 빌드 실패 |\n\n### 편의성 우선 정책\n\n이 프레임워크는 **\"DLL 없으면 빌드 실패\"를 허용하는 정책**을 채택했다.\n\n**이유:**\n- `Devian.Core.asmdef`는 `Google.Protobuf.dll`을 `precompiledReferences`로 선언한다\n- Protobuf 기능이 필요한 경우 해당 DLL이 필수이다\n- DLL이 없는 상태에서 컴파일 실패는 **의도된 동작**이다\n\n### 사용자 책임\n\n| 항목 | 설명 |\n|------|------|\n| DLL 준비 | `Google.Protobuf.dll`을 프로젝트에 포함해야 함 |\n| 경로 | `Assets\u002FPlugins\u002F` 또는 Unity가 인식하는 위치 |\n| .gitignore | DLL을 ignore했다면 clone 후 수동 복사 필요 |\n\n> **참고:** 이 정책은 `skills\u002Fdevian\u002F10-module\u002F40-proto\u002F08-protobuf-serializer-policy\u002FSKILL.md`의 \"Unity Google.Protobuf.dll 정책\"과 연계된다.\n\n---\n\n## Reference\n\n- SSOT: `skills\u002Fdevian\u002F10-module\u002F03-ssot\u002FSKILL.md`\n- Protobuf DLL 정책: `skills\u002Fdevian\u002F10-module\u002F40-proto\u002F08-protobuf-serializer-policy\u002FSKILL.md`\n- 적용 대상: `framework-cs\u002Fupm\u002F`, `framework-cs\u002Fapps\u002F**\u002FPackages\u002F`\n",{},"main","8cb5bd877a3a7004867d2f55697cb9e4ff2f1734","skills\u002Fdevian-unity\u002F05-unity-csharp-compat","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft","Kim Hyong Joon","2026-04-12 18:44:10",{"source":7,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add devwinsoft\u002Fdevian --skill 05-unity-csharp-compat",{"tool":37,"command":38},"bunx","bunx skills add devwinsoft\u002Fdevian --skill 05-unity-csharp-compat",{"tool":40,"command":41},"pnpm","pnpm dlx skills add devwinsoft\u002Fdevian --skill 05-unity-csharp-compat","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F05-unity-csharp-compat\u002FSKILL.md",true,[],[46,52,60,68,77,84],{"skillNo":47,"name":48,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":49,"categories":50,"keywords":51,"publishedAt":20},"01M6CBX3K2JJV38ANHVGCAT8A0","devian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002FSKILL.md",[],[48],{"skillNo":53,"name":54,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":55,"categories":56,"keywords":57,"publishedAt":20},"01M6CBX210BFMM8AMN770J9WY8","90-project-archive","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F90-project-archive\u002FSKILL.md",[],[58,59],"archive","90 project archive",{"skillNo":61,"name":62,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":20},"01M6CBWZSGRR9R3YJZB3177667","30-env-management","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F30-env-management\u002FSKILL.md",[],[66,67],"management","30 env management",{"skillNo":69,"name":70,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":20},"01M6CBWYD3TGWBQV7V35551THF","19-page-push-send","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F19-page-push-send\u002FSKILL.md",[],[74,75,76],"push","page","19 page push send",{"skillNo":78,"name":79,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":20},"01M6CBWWRQ05A7604GHJKTPJTF","18-page-savedata","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F18-page-savedata\u002FSKILL.md",[],[75,83],"18 page savedata",{"skillNo":85,"name":86,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":20},"01M6CBWVH4S2VF1V7B2GBTESCT","17-page-deobfuscate","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F17-page-deobfuscate\u002FSKILL.md",[],[75,90],"17 page deobfuscate"]