AGENT SKILL
34-protocol-gen-policy
暂无简介
- License 许可
- MIT
- 最近更新
- 2026-04-12
- Stars
- ★ 0
- Forks
- 0
02 资源文件 2
- 参考文档SOURCE.md185 B
- 参考文档TRUST.auto.yaml2.2 KB
03 SKILL.md 正文
34-protocol-gen-policy
Status: ACTIVE
AppliesTo: v10
SSOT: skills/devian/10-module/03-ssot/SKILL.md
Purpose
Protocol codegen의 언어별 산출물(C#/TS)에 대한 문서 정책을 정의한다.
이 문서는 “언어별로 무엇을 생성해야 한다”를 추상적으로만 서술한다. 정확한 클래스/함수/시그니처/프레임은 런타임/제너레이터 코드를 정답으로 본다.
C# Output Policy
- ProtocolName 단위로 하나의 C# 생성물 파일을 만든다.
- 생성물은 “메시지 정의 + codec + Stub(sealed, IHandler 위임) + Proxy(발신) + SessionHost + Networker”를 제공해야 한다.
- Stub:
sealed class/public생성자.IHandler인터페이스 +SetHandler()(abstract 상속 대신 handler 위임). - 프로토콜 파일당
{Protocol}SessionHost.g.cs+{Protocol}Networker.g.cs추가 생성. - Networker는 교차 프로토콜 조합:
{Protocol}.Stub(수신) +{CounterProtocol}.Proxy(송신). - 기존 그룹 단위
ClientSessionHost.g.cs는 삭제 (프로토콜별 SessionHost로 대체). - C# 생성물은 Unity 호환(IL2CPP/Span 제한 고려) 을 전제로 한다.
TypeScript Output Policy
- ProtocolName 단위로 하나의 TS 생성물 파일을 만든다.
- TS 생성물은 “메시지 타입 + codec + 소비자 구현 지점 + 발신 프록시”를 제공해야 한다.
Shared Policy
- opcode/tag 할당은 Registry 정책(SSOT)을 따른다.
- JSON codec는 디버깅/툴링 목적을 지원한다.
- Protobuf-style codec는 런타임 성능 목적을 지원한다.
Protocol 모듈 의존성 (Hard Rule)
C# PROTOCOL 모듈 의존성:
Devian.Protocol.{ProtocolGroup}.csproj는 다음을 ProjectReference 한다:..\Devian\Devian.csproj..\Devian.Domain.Common\Devian.Domain.Common.csproj
- C# 생성물(
*.g.cs)은using Devian;을 포함해야 한다. (namespace는 Devian 단일) - C# 생성물 namespace는
Devian.Protocol.{ProtocolGroup}으로 고정 (변경 금지)
TS PROTOCOL 패키지 의존성:
@devian/protocol-{protocolgroup}는@devian/core+@devian/module-common을 의존한다.
Reference
- Overview:
skills/devian/80-tools/11-builder/33-protocol-spec/SKILL.md - Policy SSOT:
skills/devian/10-module/03-ssot/SKILL.md - 동작 정본: 런타임/제너레이터 코드