01-policy
暂无简介
- License 许可
- MIT
- 最近更新
- 2026-04-12
- Stars
- ★ 0
- Forks
- 0
02 资源文件 72
- 参考文档eval/answer-key.json12.3 KB
- 参考文档eval/answer-key.json.AGENTS.md404 B
- 参考文档eval/fixture/package.json264 B
- 脚本eval/fixture/src/cli.ts988 B
- 脚本eval/fixture/src/config.ts613 B
- 脚本eval/fixture/src/errors.ts569 B
- 脚本eval/fixture/src/events.ts560 B
- 脚本eval/fixture/src/http.ts1.4 KB
- 脚本eval/fixture/src/index.ts142 B
- 脚本eval/fixture/src/model.ts1.0 KB
- 脚本eval/fixture/src/orders.ts2.5 KB
- 脚本eval/fixture/src/pricing.ts1.2 KB
- 脚本eval/fixture/src/tools.ts446 B
- 参考文档eval/score.md13.7 KB
- 参考文档eval/score.md.AGENTS.md533 B
- 参考文档prompts/auditor-rebuild.md5.8 KB
- 参考文档prompts/completeness.md3.2 KB
- 参考文档prompts/crud-classifier.md2.6 KB
- 参考文档prompts/discovery.md2.9 KB
- 参考文档prompts/generator-rebuild.md10.1 KB
- 参考文档prompts/sequence-generator.md3.1 KB
- 参考文档prompts/state-machine-generator.md2.8 KB
- 参考文档prompts/uc-linker.md2.5 KB
- 参考文档prompts/ui-screen-generator.md2.7 KB
- 参考文档prompts/usage-mapper.md2.6 KB
- 参考文档prompts/variability-classifier.md3.0 KB
- 参考文档references/behavior-checklists.md2.9 KB
- 参考文档references/behavior-checklists.md.AGENTS.md292 B
- 参考文档references/package-templates.md7.0 KB
- 参考文档references/package-templates.md.AGENTS.md422 B
- 参考文档references/provenance.md4.1 KB
- 参考文档references/provenance.md.AGENTS.md446 B
- 参考文档references/ui-extraction.md8.8 KB
- 参考文档references/ui-extraction.md.AGENTS.md686 B
- 参考文档references/ui-model.md3.8 KB
- 参考文档references/ui-model.md.AGENTS.md393 B
- 脚本scripts/guard.mjs24.6 KB
- 脚本scripts/guard.mjs.AGENTS.md2.3 KB
- 脚本scripts/ui-extract/adapters/angularjs.mjs4.5 KB
- 脚本scripts/ui-extract/adapters/angularjs.mjs.AGENTS.md479 B
- 脚本scripts/ui-extract/compare.mjs1.0 KB
- 脚本scripts/ui-extract/compare.mjs.AGENTS.md206 B
- 脚本scripts/ui-extract/config-reads.mjs2.6 KB
- 脚本scripts/ui-extract/config-reads.mjs.AGENTS.md340 B
- 脚本scripts/ui-extract/config.mjs1.0 KB
- 脚本scripts/ui-extract/config.mjs.AGENTS.md527 B
- 脚本scripts/ui-extract/fill.mjs774 B
- 脚本scripts/ui-extract/fill.mjs.AGENTS.md233 B
- 脚本scripts/ui-extract/flow.mjs7.0 KB
- 脚本scripts/ui-extract/flow.mjs.AGENTS.md433 B
- 脚本scripts/ui-extract/forms.mjs4.3 KB
- 脚本scripts/ui-extract/forms.mjs.AGENTS.md401 B
- 脚本scripts/ui-extract/gate.mjs6.1 KB
- 脚本scripts/ui-extract/gate.mjs.AGENTS.md425 B
- 脚本scripts/ui-extract/inventory.mjs2.0 KB
- 脚本scripts/ui-extract/inventory.mjs.AGENTS.md288 B
- 脚本scripts/ui-extract/js-literal.mjs4.0 KB
- 脚本scripts/ui-extract/js-literal.mjs.AGENTS.md334 B
- 脚本scripts/ui-extract/lib-html.mjs2.3 KB
- 脚本scripts/ui-extract/lib-html.mjs.AGENTS.md302 B
- 脚本scripts/ui-extract/lib.mjs6.5 KB
- 脚本scripts/ui-extract/lib.mjs.AGENTS.md852 B
- 脚本scripts/ui-extract/refs-for.mjs1.2 KB
- 脚本scripts/ui-extract/refs-for.mjs.AGENTS.md195 B
- 脚本scripts/ui-extract/screen-form.mjs1.4 KB
- 脚本scripts/ui-extract/screen-form.mjs.AGENTS.md207 B
- 脚本scripts/ui-extract/screen-plan.mjs25.0 KB
- 脚本scripts/ui-extract/screen-plan.mjs.AGENTS.md838 B
- 脚本scripts/ui-extract/style-kit.mjs10.2 KB
- 脚本scripts/ui-extract/style-kit.mjs.AGENTS.md446 B
- 参考文档SKILL.agent.md9.5 KB
- 参考文档SKILL.md.AGENTS.md2.8 KB
03 SKILL.md 正文
devian-unity — Policy
Status: ACTIVE
AppliesTo: v11
Type: Policy / Entry Point
Purpose
Devian Unity 패키지의 정책 및 규약을 정의하는 최상위 엔트리 문서이다.
SSOT 원칙 (Hard Rule)
1. UPM 패키지 원본 경로
| 구분 | 경로 | 역할 |
|---|---|---|
| 수동 패키지 | framework-cs/upm/{pkg} |
수동 관리 패키지 원본 |
| 생성 패키지 | framework-cs/upm/{pkg} |
빌더가 생성하는 패키지 원본 |
| 최종 복사본 | framework-cs/apps/UnityExample/Packages/{pkg} |
Unity 실행용 복사본 (직접 수정 금지) |
2. GeneratedRoot Clean+Copy 규칙 (Hard Rule)
빌더는 GeneratedRoot(Runtime/Generated, Editor/Generated)만 clean+copy 한다.
- 수동 패키지의 수동 관리 파일(non-generated)은 빌더가 절대 수정/삭제하지 않는다
- 생성 패키지는 전체가 빌더 관리 대상
3. upm → Packages Sync 규칙 (Hard Rule)
upm/{pkg} → UnityExample/Packages/{pkg} (패키지 단위 clean+copy)
Sync 후 검증:
Packages/{pkg}가upm/{pkg}와 내용 일치Packages/직접 수정 → 정책 위반, 다음 sync에서 덮어써짐
4. .meta 파일 SSOT (Hard Rule)
UPM 소스(upm/{pkg})에 .meta 파일 포함 필수
| 항목 | 규칙 |
|---|---|
| 정본 위치 | framework-cs/upm/{pkg}/*.meta |
| Unity 복사본 | framework-cs/apps/UnityExample/Packages/{pkg}/*.meta |
| 수정 금지 | Unity Packages 폴더에서 직접 .meta 수정 금지 |
| 역방향 동기화 | Packages → UPM 복사 필요시 npm run sync-meta 사용 |
빌드 검증:
syncUpmToPackageDir()실행 후checkUpmPackagesSynced()자동 호출assertDirTreeEqual(): 디렉토리 트리 완전 일치 검증 (파일 + 내용)- 불일치 시 빌드 즉시 FAIL
도구:
npm -w builder run sync-meta -- <config>- Packages의 .meta를 UPM으로 역복사 (일회성 마이그레이션용)- 위치:
framework-ts/tools/scripts/sync-meta.js
Abstract Base Class Naming (Hard Rule)
Devian Unity C#에서 abstract base class 네이밍은 {Category}Base를 금지하고 Base{Category}를 사용한다.
- Bad:
abstract class ActorBase - Good:
abstract class BaseActor
이 규칙은 repo 전체에 적용되며, 리네임 시 git mv로 .meta GUID를 유지하고,
UPM(framework-cs/upm/{pkg})과 UnityExample/Packages(framework-cs/apps/UnityExample/Packages/{pkg})를 동일하게 갱신한다.
Enum Naming (Hard Rule)
Generated enum의 타입명과 멤버명은 대문자 SNAKE_CASE를 사용한다.
- Good type:
MISSION_TYPE,ADVERTISE_FORMAT - Bad type:
MissionType,AdvertiseFormat - Good member:
APP_OPEN,JEWEL_FREE - Bad member:
AppOpen,JewelFree
이 규칙은 ENUM_*.json 계약 enum과 table gen:<EnumName>으로 생성되는 enum 모두에 적용한다.
5. 대규모 리네임 작업 규칙 (Hard Rule)
C# 파일 대규모 리네임 시 다음 절차를 따른다:
금지 사항
.meta파일 내용 직접 편집 금지- 파일별 개별 Read → Edit → Write 순차 처리 금지
- UPM과 UnityExample을 개별적으로 수정 금지
필수 절차
# 1. 파일 리네임 (git mv 사용 - .meta 자동 처리, GUID 유지)
git mv OldName.cs NewName.cs
# 2. 내용 일괄 치환 (sed 사용)
find . -name "*.cs" -exec sed -i 's/OldName/NewName/g' {} +
# 3. UPM → UnityExample 폴더 단위 복사
cp -r upm/{pkg}/Runtime/Unity/TargetDir/* UnityExample/Packages/{pkg}/Runtime/Unity/TargetDir/
# 4. UnityExample의 구 파일 정리 (필요시)
rm -f UnityExample/Packages/{pkg}/.../OldName.cs
rm -f UnityExample/Packages/{pkg}/.../OldName.cs.meta
핵심 원칙
| 작업 | 도구 | 이유 |
|---|---|---|
| 파일 리네임 | git mv |
Unity GUID 자동 유지 |
| 내용 치환 | sed / find -exec |
일괄 처리로 속도 향상 |
| 패키지 동기화 | cp -r (폴더 단위) |
파일별 처리 불필요 |
6. UPM 원본 우선 + 미러 동기화 (Hard Rule)
- 코드 정본 수정 위치는 항상
framework-cs/upm/{pkg}다. framework-cs/apps/UnityExample/Packages/{pkg}는 UPM에서 동기화되는 미러이며 직접 수정 금지다.framework-cs/apps/UnityExample/Assets/Samples/Devian Samples/{version}/...는 샘플 배포 산출 미러다.- 하위 도메인/샘플 문서는 위 하드룰을 재정의하지 않고 본 문서를 참조한다.
금지 경로 가드 (Hard Rule)
com.devian.foundation Editor/Generated 금지
com.devian.foundation의 직계 Editor/Generated 폴더가 생성되면 안 된다.
- Editor/Generated for TableID inspection은
com.devian.foundation/Samples~/도메인 패키지에 속함 Samples~/*/Editor/Generated/는 허용 (샘플의 빌더 생성물)- foundation 직계
Editor/Generated가 존재하면 빌드 즉시 FAIL
빌더 가드 위치: framework-ts/tools/builder/build.js - checkFoundationEditorGenerated()
세부 문서
Package Policy
skills/devian-unity/04-package-policy/SKILL.md
패키지별 문서
skills/devian-unity/02-unity-bundles/SKILL.mdskills/devian/10-module/03-ssot/SKILL.md(Foundation Package SSOT)skills/devian/20-domain-common/02-module-policy/SKILL.md
Unity Components
- AssetManager:
skills/devian-unity/20-common-package/13-asset-manager/SKILL.md
Related
- SSOT 정본:
skills/devian/10-module/03-ssot/SKILL.md - UPM Samples 정책:
skills/devian-unity/04-package-policy/SKILL.md