[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CBTB2XHJXW8FA17MB9RY60":3,"skill-same:01M6CBTB2XHJXW8FA17MB9RY60":52},{"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":21,"linkOnly":22,"markdownContent":23,"markdownBody":23,"frontMatter":24,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":13,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":30,"updatedAt":31,"install":32,"resources":45},"01M6CBTB2XHJXW8FA17MB9RY60","08-protobuf-serializer-policy",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\u002F10-module\u002F40-proto\u002F08-protobuf-serializer-policy\u002FSKILL.md",[],[18,19,20],"policy","protobuf","08 protobuf serializer policy","2026-11-10 10:12:30",false,"# Devian v10 — Serializer \u002F Protobuf Policy\n\nStatus: ACTIVE  \nAppliesTo: v10  \nSSOT: skills\u002Fdevian\u002F10-module\u002F03-ssot\u002FSKILL.md\n\n## Purpose\n\nDevian v10에서 사용하는 직렬화 정책(Encoding\u002FDecoding)을 정의한다.\n\n이 문서는 **\"무슨 포맷을 지원\u002F금지하는가\"**만 서술한다.\n구체적인 바이트 레이아웃\u002F런타임 API는 **런타임\u002F제너레이터 코드**를 정답으로 본다.\n\n---\n\n## Supported Formats (Policy)\n\n### 1) JSON\n\n- 디버깅\u002F툴링을 위한 기본 교환 포맷\n- Protocol\u002FContracts\u002FNDJSON 데이터 모두 JSON 계열을 사용한다\n\n### 2) Protobuf-style Wire (Devian)\n\n- v10은 \".proto → protoc\" 체인을 사용하지 않는다\n- 대신 Protobuf wire 개념을 차용한 **Devian 전용 인코더\u002F디코더**를 사용한다\n- 목적: 작은 payload, 빠른 파싱, Span 기반 처리\n\n---\n\n## Framework Modules\n\n### C# (Devian — 단일 모듈)\n\n> Devian C# 런타임은 단일 모듈(`Devian.csproj`)로 통합되어 있다.\n> **Protobuf 관련 타입은 `namespace Devian`에 위치한다.** (분리된 하위 네임스페이스 금지)\n> 타입명(`Dff*`, `Protobuf*`, `IProto*`)은 기존 이름을 유지한다.\n\n| 파일 | namespace | 역할 |\n|------|-----------|------|\n| `DffValue.cs` | `Devian` | DFF 값 타입 정의 |\n| `DffParser.cs` | `Devian` | DFF 문법 파싱 |\n| `DffConverter.cs` | `Devian` | 셀 문자열 → DffValue 변환 |\n| `DffOptions.cs` | `Devian` | DFF 파싱 옵션 |\n| `DffProtobuf.cs` | `Devian` | DFF → Protobuf IMessage 변환 API |\n| `DffProtobufBuilder.cs` | `Devian` | Descriptor 기반 IMessage 빌드 |\n| `IProtoEntity.cs` | `Devian` | Protobuf 엔티티 인터페이스 |\n| `ProtobufEntityConverter.cs` | `Devian` | Protobuf 엔티티 변환 |\n\n### TypeScript (@devian\u002Fcore)\n\n> Devian TS 런타임은 단일 패키지(`@devian\u002Fcore`)로 통합되어 있다.\n> Protobuf 관련 타입은 `@devian\u002Fcore\u002Fproto`에서 export된다.\n\n| 파일 | 역할 |\n|------|------|\n| `DffValue.ts` | DFF 값 타입 정의 |\n| `DffConverter.ts` | 셀 문자열 → DffValue 변환 |\n| `ProtobufCodec.ts` | Protobuf encode\u002Fdecode, JSON fallback |\n| `IProtoEntity.ts` | Protobuf 엔티티 인터페이스 |\n\n---\n\n## DFF (Data Field Format)\n\nXLSX에서 `enum:*` \u002F `class:*` 타입 셀에 들어가는 텍스트 표현을 **DFF**로 정의한다.\n\n- DFF는 \"셀 텍스트 → 런타임 오브젝트\" 변환 규약이다\n- 빌드 도구가 DFF를 항상 해석해야 한다고 강제하지 않는다\n  - (예) 빌드 산출 NDJSON에 셀 원문을 보존하고, 런타임 로더에서 DFF를 해석할 수 있다\n\nDFF 문법\u002F예시는 `skills\u002Fdevian\u002F80-tools\u002F11-builder\u002F30-table-cell-format\u002FSKILL.md`를 따른다.\n\n---\n\n## MUST \u002F MUST NOT\n\nMUST\n\n- 인코딩\u002F디코딩은 **결정적**이어야 한다(같은 입력 → 같은 바이트\u002F같은 객체)\n- Protocol의 opcode\u002Ftag 정책(SSOT)을 위반하면 실패해야 한다\n\nMUST NOT\n\n- .proto 파일을 입력 정본으로 취급하지 않는다\n- \"편의상 임의 타입 매핑\u002F임의 필드 스킵\" 같은 묵시적 처리 금지\n\n---\n\n## Unity Google.Protobuf.dll 정책 (Hard Rule)\n\nUnity 프로젝트에서 Protobuf 기반 기능(`DffProtobuf`, `IProtoEntity` 등)을 사용하려면 **Google.Protobuf.dll**이 필수이다.\n\n### 필수 조건\n\n1. `Google.Protobuf.dll` 파일이 Unity가 로드하는 위치에 존재해야 한다\n   - 예: `Assets\u002FPlugins\u002FGoogle.Protobuf.dll`\n2. `.dll.meta` 파일만 있고 `.dll` 파일이 없으면 **빌드 실패**\n\n### 정책\n\n- Google.Protobuf 기반 기능은 **필수 의존성**으로 취급한다\n- `Google.Protobuf.dll`이 없거나 Unity가 dll을 찾지 못하면 `Devian.Core` 어셈블리가 컴파일에 실패할 수 있다\n- 이 상태는 **허용되는 실패**이다 (편의성 우선 정책)\n\n### 사용자 준비사항\n\n| 항목 | 설명 |\n|------|------|\n| dll 파일 | `Google.Protobuf.dll`을 Unity 프로젝트에 포함 |\n| 경로 | `Assets\u002FPlugins\u002F` 또는 Unity가 인식하는 위치 |\n| 버전 | Google.Protobuf 3.x 이상 권장 |\n\n> **참고:** `.dll.meta`만 커밋하고 실제 `.dll`을 .gitignore로 제외한 경우,\n> 새로운 환경에서 clone 후 dll을 별도로 복사해야 한다.\n\n---\n\n## Reference\n\n- Policy SSOT: `skills\u002Fdevian\u002F10-module\u002F03-ssot\u002FSKILL.md`\n- DFF 규약: `skills\u002Fdevian\u002F80-tools\u002F11-builder\u002F30-table-cell-format\u002FSKILL.md`\n- 동작 정본: 런타임\u002F제너레이터 코드\n",{},"main","8cb5bd877a3a7004867d2f55697cb9e4ff2f1734","skills\u002Fdevian\u002F10-module\u002F40-proto\u002F08-protobuf-serializer-policy","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":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add devwinsoft\u002Fdevian --skill 08-protobuf-serializer-policy",{"tool":38,"command":39},"bunx","bunx skills add devwinsoft\u002Fdevian --skill 08-protobuf-serializer-policy",{"tool":41,"command":42},"pnpm","pnpm dlx skills add devwinsoft\u002Fdevian --skill 08-protobuf-serializer-policy","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F10-module\u002F40-proto\u002F08-protobuf-serializer-policy\u002FSKILL.md",true,[46],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"agents\u002Fopenai.yaml","REFERENCE","参考文档",197,"https:\u002F\u002Fgithub.com\u002Ffernando-delosrios-sp\u002Fsailpoint-utils\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fto-questionnaire\u002Fagents\u002Fopenai.yaml",[53,59,67,75,84,91],{"skillNo":54,"name":55,"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":56,"categories":57,"keywords":58,"publishedAt":21},"01M6CBX3K2JJV38ANHVGCAT8A0","devian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002FSKILL.md",[],[55],{"skillNo":60,"name":61,"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":62,"categories":63,"keywords":64,"publishedAt":21},"01M6CBX210BFMM8AMN770J9WY8","90-project-archive","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F90-project-archive\u002FSKILL.md",[],[65,66],"archive","90 project archive",{"skillNo":68,"name":69,"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":70,"categories":71,"keywords":72,"publishedAt":21},"01M6CBWZSGRR9R3YJZB3177667","30-env-management","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F30-env-management\u002FSKILL.md",[],[73,74],"management","30 env management",{"skillNo":76,"name":77,"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":78,"categories":79,"keywords":80,"publishedAt":21},"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",[],[81,82,83],"push","page","19 page push send",{"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":21},"01M6CBWWRQ05A7604GHJKTPJTF","18-page-savedata","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F18-page-savedata\u002FSKILL.md",[],[82,90],"18 page savedata",{"skillNo":92,"name":93,"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":94,"categories":95,"keywords":96,"publishedAt":21},"01M6CBWVH4S2VF1V7B2GBTESCT","17-page-deobfuscate","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F17-page-deobfuscate\u002FSKILL.md",[],[82,97],"17 page deobfuscate"]