AGENT SKILL

34-protocol-gen-policy

暂无简介

License 许可
MIT
所属仓库
devwinsoft/devian
最近更新
2026-04-12
Stars
★ 0
Forks
0

02 资源文件 2

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
  • 동작 정본: 런타임/제너레이터 코드

04 同仓库更多 Skills