TigerStyle 是提炼自 TigerBeetle 生产代码库的 Zig 编码指南,设计目标优先级为安全 > 性能 > 开发体验,适合编写、审查或重构 Zig 代码时参考,尤其是对性能敏感的生产级项目。
主要能力涵盖:安全方面要求使用简单显式控制流、限制递归、拆分复合条件与断言、成对断言,并用 comptime assert 校验编译期常量关系;内存方面主张通过 out 指针原地初始化大结构体,变量在最小作用域声明;循环与队列必须设固定上界,遵循快速失败;所有错误必须处理,禁止用 _ 丢弃返回值。性能方面强调在设计阶段解决性能问题,按网络→磁盘→内存→CPU 顺序优化,批处理为核心手段,并将热路径循环提取为无 self 的函数、显式传参。命名方面函数用 camelCase、类型用 PascalCase、变量用 lowercase_with_underscores,不缩写、单位与限定词按重要性降序后置,同类型多参数须用命名 options 结构体。另含注释、格式(运行 zig fmt、4 空格缩进、每行不超过 100 列)、差一错误类型区分、零依赖与脚本工具化等规则,并附提交前检查清单。
使用方式:在编写、审查或重构 Zig 代码,或询问 Zig 惯用法、断言、内存布局、API 设计时使用。流程为识别需求、加载安全/性能/命名原则、对照提交前检查清单核查、按 TigerStyle 标准给出具体修改建议。
限制与边界:不用于标准库 API 查询(改用 zig-0.16 skill)、代码审查工作流(改用 zig-code-review skill)或 Zig 入门指南。TigerStyle 标准较高,面向生产性能敏感项目,并非所有项目都需完全遵循;断言用于检测程序员错误而非预期运行时错误,不应过度使用;零依赖策略是该领域特例。该技能不收集、存储或传输用户数据,内容源自公开的 TigerBeetle 代码风格文档。其他平台、收费等信息暂未提供。