[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CBVSVBCCHKCHR5BBTWAV1V":3,"skill-same:01M6CBVSVBCCHKCHR5BBTWAV1V":46},{"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},"01M6CBVSVBCCHKCHR5BBTWAV1V","20-build-pipeline",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\u002F80-tools\u002F11-builder\u002F20-build-pipeline\u002FSKILL.md",[],[18,19,20],"pipeline","20 build","20 build pipeline","2026-11-10 10:12:30",false,"# 20-build-pipeline\n\nStatus: ACTIVE  \nAppliesTo: v10\n\n---\n\n## 0. 목적\n\n- 특정 게임이 아니라 **도메인\u002F프로토콜이 동적으로 바뀌는 빌드**를 표준화한다.\n- `DomainKey`와 `ProtocolGroup`이 추가될 때마다 빌드 산출물이 자동으로 늘어나는 구조를 정의한다.\n- 빌드 입력\u002F설정\u002F산출물 원칙을 명확히 하여 빌더 구현과의 불일치를 제거한다.\n\n---\n\n## 1. 적용 범위\n\n### 적용 대상\n\n- `framework-ts\u002Ftools\u002Fbuilder\u002Fbuild.js` 기반 빌드 전반\n- **입력:** `{buildInputJson}` (예: `input\u002Fbuild_input.json`)\n- **설정:** `{configJson}` (예: `input\u002Fbuild_config.json`)\n\n### 비대상\n\n- 런타임 실행 로직\n- 에러\u002F로그 표준 (→ `skills\u002Fdevian\u002F80-tools\u002F11-builder\u002F21-build-error-reporting\u002FSKILL.md`)\n\n---\n\n## 2. 용어\n\n| 용어 | 정의 |\n|------|------|\n| **DomainKey** | 도메인 식별자 (예: `Game`, `Common`) |\n| **ProtocolGroup** | 프로토콜 그룹 식별자 (예: `Game`) |\n| **buildInputJsonDir** | buildInputJson 파일이 위치한 디렉토리. 상대경로 해석의 기준 |\n| **{tempDir}** | 빌드 중간 산출물이 생성되는 staging 디렉토리 |\n| **{configJson}** | 빌드 설정 파일 (출력 경로 등 정의) |\n\n---\n\n## 3. 빌드 실행\n\n### 스크립트 실행\n\n```bash\nbash input\u002Fbuild.sh -[target] \u003CbuildInputJson>\n```\n\n### 직접 실행\n\n```bash\nnode framework-ts\u002Ftools\u002Fbuilder\u002Fbuild.js -[target] \u003CbuildInputJson>\n```\n\n- `-[target]`은 빌드 타겟 옵션: `-all` (기본값), `-domain-code`, `-protocol`, `-domain-data`\n- `\u003CbuildInputJson>`은 빌드 입력 JSON 파일 경로 (예: `input\u002Fbuild_input.json`)\n- 빌더는 `buildInputJson`을 읽고, 그 안의 `configPath`로 설정 파일을 로드한다.\n- `build.sh`에서 target 옵션 생략 시 기본값 `-all`\n\n> Build Target 정의 및 Phase 매핑: [03-ssot\u002FSKILL.md § Build Target](..\u002F03-ssot\u002FSKILL.md)\n\n---\n\n## 4. 입력 파일 스펙 (build json)\n\n### 최상위 필드\n\n| 필드 | 타입 | 설명 |\n|------|------|------|\n| `version` | string | 빌드 스펙 버전 |\n| `configPath` | string | 설정 파일 경로 (buildInputJsonDir 기준 상대경로) |\n| `tempDir` | string | staging 디렉토리 경로 |\n| `domains` | object | 도메인 정의 (map 형태) |\n| `protocols` | array | 프로토콜 정의 (배열 형태) |\n\n### domains (map)\n\n```json\n{\n  \"DomainKey\": {\n    \"contractDir\": \"Domains\u002FGame\",\n    \"contractFiles\": [\"*.json\"],\n    \"tableDir\": \"Domains\u002FGame\",\n    \"tableFiles\": [\"*.xlsx\"]\n  }\n}\n```\n\n- key는 `DomainKey` (예: `\"Game\"`, `\"Common\"`)\n- `contractDir`, `tableDir`는 buildInputJsonDir 기준 상대경로\n\n### protocols (array)\n\n```json\n[\n  {\n    \"group\": \"Game\",\n    \"protocolDir\": \".\u002FProtocols\u002FGame\",\n    \"protocolFiles\": [\"C2Game.json\", \"Game2C.json\"]\n  }\n]\n```\n\n- `group`은 `ProtocolGroup` 식별자\n\n---\n\n## 5. 설정 파일 스펙 (`{configJson}` 예시)\n\n### csConfig (C# 출력)\n\n| 필드 | 필수 | 설명 |\n|------|------|------|\n| `moduleDir` | ✓ | C# 모듈 출력 디렉토리 |\n| `generateDir` | 옵션 | C# 생성 코드 디렉토리 (미지정 시 moduleDir 사용) |\n\n### tsConfig (TypeScript 출력)\n\n| 필드 | 필수 | 설명 |\n|------|------|------|\n| `moduleDir` | ✓ | TS 모듈 출력 디렉토리 |\n| `generateDir` | 옵션 | TS 생성 코드 디렉토리 (미지정 시 moduleDir 사용) |\n\n### upmConfig (UPM 패키지)\n\n| 필드 | 필수 | 설명 |\n|------|------|------|\n| `sourceDir` | ✓ | UPM 소스 디렉토리 |\n| `packageDir` | ✓ | UPM 패키지 출력 디렉토리 |\n\n### tableConfig (데이터 출력)\n\n| 필드 | 필수 | 설명 |\n|------|------|------|\n| `tableDirs` | ✓ | 테이블 출력 디렉토리 배열 |\n| `stringDirs` | ✓ | String 테이블 출력 디렉토리 배열 |\n\n> **CRITICAL:** `{configJson}`에 `dataConfig` 키가 존재하면 빌드가 **즉시 FAIL**한다 (deprecated).\n> tableConfig의 각 Dir 배열에 대해 해당 데이터 유형이 출력된다.\n\n### Sample Package (내부 상수)\n\n샘플 패키지 대상은 `com.devian.foundation` 하나뿐이며, 빌더 내부 상수(`UPM_FOUNDATION`)로 고정한다.\n`{projectConfigJson}`에 `samplePackages` 키는 불필요하며 존재하지 않는다.\n`staticUpmPackages` 키는 금지이며 존재 시 FAIL.\n\n### foundationVersion (필수)\n\n| 필드 | 타입 | 필수 | 설명 |\n|------|------|------|------|\n| `foundationVersion` | string | ✓ | Foundation 패키지 버전. 빌더가 package.json 동기화 및 SampleSync 경로에 사용. |\n\n> 상세 정책: [devian-unity\u002F03-ssot § foundationVersion](..\u002F..\u002F..\u002F..\u002Fdevian-unity\u002F03-ssot\u002FSKILL.md)\n\n### sampleFolder (선택)\n\n| 필드 | 타입 | 필수 | 설명 |\n|------|------|------|------|\n| `sampleFolder` | string | ❌ | Assets\u002FSamples 루트 경로. 생략 시 SampleSync 단계를 건너뜀. |\n\n```json\n\"sampleFolder\": \"..\u002Fframework-cs\u002Fapps\u002FUnityExample\u002FAssets\u002FSamples\"\n```\n\n**동기화 경로:**\n```\n{sampleFolder}\u002F{displayName}\u002F{version}\u002F{sampleName}\u002FRuntime\u002FGenerated\u002F*.cs\n{sampleFolder}\u002F{displayName}\u002F{version}\u002F{sampleName}\u002FEditor\u002FGenerated\u002F*.cs\n```\n\n- `{displayName}`: `com.devian.foundation\u002Fpackage.json`에서 읽음\n- `{version}`: `{projectConfigJson}`의 `foundationVersion`에서 읽음\n- `{sampleName}`: `Samples~\u002F` 하위 폴더명\n- **Generated 코드(`.cs`)만 복사**, `.meta` 보존, 수동 코드 미접촉\n- 대상 Sample 폴더가 없으면 skip\n\n> 상세 정책: [devian-unity\u002F03-ssot § sampleFolder](..\u002F..\u002F..\u002F..\u002Fdevian-unity\u002F03-ssot\u002FSKILL.md)\n\n---\n\n## 6. 산출물 규칙\n\n### 원칙\n\n- **도메인\u002F프로토콜 추가에 따라 출력이 늘어남 (동적)**\n- 개별 도메인 고정표 대신 **템플릿 기반**으로 산출물 경로가 결정됨\n- **정확한 디렉토리\u002F파일 배치는 빌더 구현이 SSOT**\n\n### Target별 산출물 범위\n\n| Target | 산출물 |\n|--------|--------|\n| `-domain-code` | C# Domain 모듈, TS Domain 모듈, UPM Domain 패키지 |\n| `-protocol` | C# Protocol 모듈, TS Protocol 모듈, Protocol Sample (`Samples~\u002F{ProtocolGroup}Protocol\u002F`) |\n| `-domain-data` | NDJSON 파일, pb64 파일 (tableConfig dirs) |\n| `-all` | 위 모두 |\n\n### C# Domain 템플릿\n\n```\n{csConfig.generateDir}\u002FDevian.Domain.{DomainKey}\u002F\n```\n\n### TypeScript Domain 템플릿\n\n```\n{tsConfig.generateDir}\u002Fdevian-domain-{domainKeyLower}\u002F\n```\n\n### UPM Domain 템플릿 (Sample-target)\n\n**모든** 도메인은 `com.devian.foundation\u002FSamples~\u002F`에 샘플로 생성된다. 독립 UPM 패키지(`com.devian.domain.{key}`)는 생성하지 않는다 (레거시, 삭제 완료).\n\n```\n{upmConfig.sourceDir}\u002Fcom.devian.foundation\u002FSamples~\u002F{SampleName}\u002F\n```\n\n**SampleName 컨벤션:** `{DomainKey}Package` (동적 파생, 하드코딩 금지)\n- 빌더 구현: `DevianToolBuilder.getSampleName(domainName, 'Package')` → `${domainName}Package`\n- 예: `Common` → `CommonPackage`, `Sound` → `SoundPackage`, `Game` → `GamePackage`\n\n> 상세 규칙: [03-ssot\u002FSKILL.md § Sample-target Domain](..\u002F03-ssot\u002FSKILL.md)\n\n### Protocol 템플릿 (동일 원칙)\n\n```\nC#:  {csConfig.generateDir}\u002FDevian.Protocol.{ProtocolGroup}\u002F\nTS:  {tsConfig.generateDir}\u002Fdevian-protocol-{protocolGroupLower}\u002F\n```\n\n**Protocol Sample-target:** Protocol은 독립 UPM 패키지가 아니라 `com.devian.foundation\u002FSamples~\u002F`에 샘플로 생성된다:\n\n```\n{upmConfig.sourceDir}\u002Fcom.devian.foundation\u002FSamples~\u002F{ProtocolGroup}Protocol\u002F\n```\n\n**SampleName 컨벤션:** `{ProtocolGroup}Protocol` (동적 파생, 하드코딩 금지)\n- 빌더 구현: `DevianToolBuilder.getSampleName(groupName, 'Protocol')` → `${groupName}Protocol`\n- 예: `Game` → `GameProtocol`\n\n> 기존 `com.devian.protocol.{suffix}` 독립 UPM은 레거시 (삭제 대상).\n> 상세 규칙: [03-ssot\u002FSKILL.md § Sample-target Protocol](..\u002F03-ssot\u002FSKILL.md)\n\n### 데이터 산출물\n\n**일반 테이블 (tableConfig.tableDirs):**\n```\n{tableDir}\u002Fndjson\u002F{TableName}.json\n{tableDir}\u002Fpb64\u002F{TableName}.asset\n```\n\n**String Table (tableConfig.stringDirs):**\n```\n{stringDir}\u002Fndjson\u002F{Language}\u002F{TableName}.json\n{stringDir}\u002Fpb64\u002F{Language}\u002F{TableName}.asset\n```\n\n- 복수 타겟 가능 (각 Dir 배열의 모든 경로에 복사)\n- **도메인 폴더 미사용**: 최종 경로에 `{DomainKey}` 폴더 없음\n- **동일 파일명 충돌 시 빌드 FAIL** (조용한 덮어쓰기 금지)\n\n---\n\n## 7. Hard Rules\n\n### Staging 규칙\n\n- `{tempDir}`는 **staging 전용**이며 **커밋 금지**\n- 빌드 완료 후 staging에서 최종 위치로 복사됨\n\n### 필수 필드 FAIL\n\n| 조건 | 결과 |\n|------|------|\n| `tableConfig.tableDirs` 누락 | **즉시 FAIL** |\n| `tableConfig.stringDirs` 누락 | **즉시 FAIL** |\n\n### Forbidden 필드 FAIL\n\n아래 필드가 존재하면 **즉시 FAIL** 처리됨:\n\n| 위치 | Forbidden 필드 |\n|------|-----------------|\n| `{configJson}` | `dataConfig` (deprecated) |\n| `domains[*]` | `csTargetDir` |\n| `domains[*]` | `tsTargetDir` |\n| `domains[*]` | `dataTargetDirs` |\n| `protocols[*]` | `csTargetDir` |\n| `protocols[*]` | `tsTargetDir` |\n| `protocols[*]` | `upmName` |\n| `protocols[*]` | `upmTargetDir` |\n\n> **총 8개** 금지 필드. 하나라도 발견되면 빌드가 중단된다.\n\n---\n\n## 8. 예시\n\nGame 도메인\u002F프로토콜 예제의 상세 설명은 별도 스킬 문서를 참조한다:\n\n> **예제 정책:** `skills\u002Fdevian-examples\u002F01-policy\u002FSKILL.md`\n\n예제 입력 위치:\n- `devian\u002Finput\u002FDomains\u002FGame\u002F*.json`\n- `devian\u002Finput\u002FDomains\u002FGame\u002F*.xlsx`\n- `devian\u002Finput\u002FProtocols\u002FGame\u002F**`\n\n---\n\n## Verification Checklist\n\n1) `{configJson}` (예: `input\u002Fbuild_config.json`)에 `samplePackages` 키가 존재하지 않는다 (빌더 내부 상수로 이관됨).\n2) `{configJson}` (예: `input\u002Fbuild_config.json`)에 `staticUpmPackages` 키가 존재하지 않는다 (금지 필드).\n3) 빌드 후 각 도메인에 대해 `Samples~\u002F{DomainKey}Package\u002FRuntime\u002FGenerated\u002F{DomainKey}.g.cs` 가 존재한다.\n4) 빌드 후 각 프로토콜에 대해 `Samples~\u002F{ProtocolGroup}Protocol\u002FRuntime\u002FGenerated\u002F*.g.cs` 가 존재한다.\n5) 빌드 후 위 3, 4의 Packages 미러 경로에도 동일 파일이 존재한다.\n6) `framework-cs\u002Fupm\u002Fcom.devian.domain.{key}\u002F` 디렉토리가 존재하지 않는다 (레거시 삭제 완료).\n7) `framework-cs\u002Fupm\u002Fcom.devian.protocol.{suffix}\u002F` 디렉토리가 존재하지 않는다 (레거시 삭제 완료).\n\n## Verification Checklist (Dependencies)\n\n- `framework-cs\u002Fupm\u002F**\u002Fpackage.json`에서 `com.devian.core`, `com.devian.unity` dependency가 0개여야 한다.\n- `framework-cs\u002Fapps\u002FUnityExample\u002FPackages\u002F**\u002Fpackage.json`에서도 위 dependency가 0개여야 한다.\n\n---\n\n## 9. Reference\n\n### 빌더 (SSOT)\n\n- `framework-ts\u002Ftools\u002Fbuilder\u002Fbuild.js`\n\n### 입력\u002F설정 예시\n\n- `input\u002Fbuild_input.json` — 빌드 입력 예시\n- `input\u002Fbuild_config.json` — 설정 파일 예시\n\n### 관련 스킬\n\n| 스킬 | 설명 |\n|------|------|\n| `skills\u002Fdevian\u002F10-module\u002F03-ssot\u002FSKILL.md` | 전체 SSOT 정책 |\n| `skills\u002Fdevian\u002F80-tools\u002F11-builder\u002F21-build-error-reporting\u002FSKILL.md` | 빌드 에러\u002F로그 표준 |\n| `skills\u002Fdevian-examples\u002F01-policy\u002FSKILL.md` | Game 예제 정책 |\n| `skills\u002Fdevian-unity\u002F02-unity-bundles\u002FSKILL.md` | UPM 번들\u002F복사 흐름 |\n",{},"main","8cb5bd877a3a7004867d2f55697cb9e4ff2f1734","skills\u002Fdevian\u002F80-tools\u002F11-builder\u002F20-build-pipeline","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 20-build-pipeline",{"tool":38,"command":39},"bunx","bunx skills add devwinsoft\u002Fdevian --skill 20-build-pipeline",{"tool":41,"command":42},"pnpm","pnpm dlx skills add devwinsoft\u002Fdevian --skill 20-build-pipeline","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F11-builder\u002F20-build-pipeline\u002FSKILL.md",true,[],[47,53,61,69,78,85],{"skillNo":48,"name":49,"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":50,"categories":51,"keywords":52,"publishedAt":21},"01M6CBX3K2JJV38ANHVGCAT8A0","devian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002FSKILL.md",[],[49],{"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},"01M6CBX210BFMM8AMN770J9WY8","90-project-archive","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F90-project-archive\u002FSKILL.md",[],[59,60],"archive","90 project archive",{"skillNo":62,"name":63,"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":64,"categories":65,"keywords":66,"publishedAt":21},"01M6CBWZSGRR9R3YJZB3177667","30-env-management","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F30-env-management\u002FSKILL.md",[],[67,68],"management","30 env management",{"skillNo":70,"name":71,"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":72,"categories":73,"keywords":74,"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",[],[75,76,77],"push","page","19 page push send",{"skillNo":79,"name":80,"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":81,"categories":82,"keywords":83,"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",[],[76,84],"18 page savedata",{"skillNo":86,"name":87,"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":88,"categories":89,"keywords":90,"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",[],[76,91],"17 page deobfuscate"]