Universal Game Primitives

核心定位

primitives-dsl 是一套极简的游戏架构领域特定语言，提取自 68K 汇编时代至现代 ECS 引擎的共性模式，用六个原语统一描述任何游戏/sim 系统的状态流转与计算调度。

六大原语详解

| 原语 | 本质 | 典型场景 |

|:---|:---|:---|

| **LOOP** | 显式分阶段的更新循环 | 主循环、子系统 tick、固定时间步 |

| **TILEGRID** | 稳定邻接规则的空间索引 | 2D/3D 网格、导航瓦片、区块地图 |

| **CONTROLBLOCK** | 紧凑的权威状态记录 | 标志位、计数器、句柄、计时器协调 |

| **POOL** | 有界快速分配器 | 实体、子弹、粒子、任务（禁止热路径 unbounded `new`）|

| **EVENT** | 结构化消息（发生的事）| 最小负载 + 显式路由元数据 |

| **DISPATCHER** | 工作与事件的路由器 | CPU 线程/SPU/GPU 内核/ECS 系统调度策略 |

输出契约（强制交付物）

每次调用必须产生四项产物：
1. Primitive Map — 系统组件与原语的对应关系
2. Dataflow Sketch — 状态/事件流动的文本图或表格
3. Worked Example — 完整示例或引用现有示例文件
4. Portability Notes — 向 68K/Cell/CUDA/ECS 的映射说明

显著优点

• 架构无关性：同一描述可落地为手写汇编、CUDA 内核或 Unity ECS
• AI 可解释性：消除"引擎宗教"辩论，用中性词汇与 LLM/AI Agent 沟通
• 约束友好：内置 POOL 边界、CONTROLBLOCK 显式字段等防混沌机制
• 可审计输出：强制表格/伪代码/图示，拒绝模糊 prose

潜在局限

• 非实现框架：只提供设计语言，不生成可编译代码
• 学习门槛：需理解底层内存与调度模型才能有效使用
• 生态封闭：禁止扩展新原语，可能抑制某些架构创新
• 验证负担：输出契约的四项产物对简单场景可能过重

适用人群

• 跨平台引擎开发者（主机/移动/边缘设备）
• 需要向 AI 解释遗留代码的维护工程师
• 设计"未来可移植"共享软件/独立游戏的系统架构师
• 教授游戏引擎课程的教育者（统一术语体系）

常规风险

| 风险 | 说明 |

|:---|:---|

| 原语误用 | 将任意数据结构塞进 POOL/CONTROLBLOCK 导致语义混淆 |

| 边界省略 | 未显式声明 POOL 容量或 DISPATCHER 策略，破坏可移植性 |

| 过度抽象 | 对简单原型强制完整输出契约，降低开发效率 |

| 架构偏见 | 六种原语源自特定历史谱系，可能不契合数据导向或函数式架构 |

与现有方案对比

相比 Unity DOTS、Bevy ECS 等具体实现，primitives-dsl 是元语言层——不承诺运行时性能，承诺认知可移植性：让开发者在切换技术栈时保持心智模型稳定。

核心用法

primitives-dsl 是一套由六个通用原语构成的领域特定语言，旨在建立跨时代游戏架构的统一描述词汇。六个原语分别为：

• LOOP：显式分阶段的重复更新周期，掌管时间切片与执行顺序
• TILEGRID：带稳定邻接规则的空间索引（2D/3D 网格、导航瓦片、区块地图）
• CONTROLBLOCK：紧凑的权威状态记录（标志位、计数器、句柄、计时器），用于协调行为与强制约束
• POOL：有界分配器，用于高频创建的对象（实体、子弹、粒子、任务），禁止热路径中的无界 new
• EVENT：结构化消息，表示"某事发生"，附带最小负载与显式路由元数据
• DISPATCHER：将工作与事件路由至处理器（CPU 线程、SPU、GPU 内核、ECS 系统），承载调度策略

使用场景包括：设计可移植的游戏/模拟循环、在不同架构间翻译（68K ↔ Cell ↔ CUDA ↔ ECS）、向 AI Agent 解释引擎结构、将混乱代码重构为显式状态 + 流。

显著优点

1. 跨平台抽象：从 68K 汇编到现代 GPU 内核，同一套词汇适用，大幅降低跨平台移植的认知负担
2. AI 友好：结构化、无歧义的术语使 AI Agent 能准确理解系统架构，辅助设计与重构
3. 强制产出：每次调用必须产生 Primitive Map、Dataflow Sketch、Worked Example、Portability Notes 四项产物，避免空谈
4. 约束驱动设计：POOL 的有界性、CONTROLBLOCK 的显式字段等规则天然引导高性能、可预测的系统设计

潜在局限

• 学习曲线：需要使用者理解六种原语的精确语义边界，初学者可能混淆 CONTROLBLOCK 与 POOL 的职责
• 非执行性：本 Skill 纯为知识文档，不含可执行代码，实际落地需用户自行实现
• 生态锁定：严格禁止发明新原语，可能限制某些高度定制化场景的表达能力
• 平台细节缺失：虽提供移植注释，但具体平台的优化技巧（如 Cell 的 DMA 双缓冲）仍需外部知识补充

适合人群

• 游戏引擎开发者与系统架构师
• 负责跨平台移植的技术负责人
• 需要将遗留代码现代化重构的团队
• 使用 AI Agent 辅助设计的开发者（需向 AI 精确描述引擎结构）

常规风险

• 示例代码误用：所有代码块均为伪代码/参考实现，直接复制到生产环境可能导致功能缺失或性能问题
• 调度策略盲区：DISPATCHER 的策略声明（FIFO、优先级、固定步长、预算制）若配置不当，可能引入卡顿或饥饿
• POOL 容量估算：容量猜测错误可能导致运行时溢出或内存浪费，需结合目标平台实测调优

安全认证亮点

本 Skill 经 CLS-Certify v2.1.0 全面扫描，六维检测全部满分通过：

• 纯文档型，无执行代码、无网络调用、零依赖
• 来源可信（stusatwork-oss，T2 级别）
• 获 S+ 顶级安全评级，100 分满分认证
• 完全符合 GDPR、CCPA 等隐私合规要求