工程开发
code-quality avatar

code-quality

为 Turso 数据库执行严格的代码质量、正确性及 Rust 设计模式,优先考虑数据完整性、性能以及易于维护的惯用语法。

简介

此技能作为 Turso 数据库开发流程中严格的架构与风格把关者。它专注于数据库工程中关键的正确性要求,并确保系统稳定性不被牺牲。本技能专为需要确保实现符合生产级数据库标准的 Turso 仓库贡献者而设计。它强调在数据库核心中,遇到无效状态时进行受控崩溃,远比允许静默的数据损坏要好得多。

  • 强制执行严格的 Rust 模式,例如使非法状态无法被表示、利用穷举模式匹配,以及在关键路径中避免堆内存分配。

  • 通过频繁的断言、不变量检查以及处理所有错误路径来推广防御性编程,而不是掩盖边缘案例或使用快速修补程序。

  • 提供编写 CPU 友好且具备缓存意识的代码准则,在微秒级延迟至关重要的场景下,确保进程内 SQL 执行的最佳性能。

  • 要求文档需解释复杂逻辑背后的“原因”而非重复代码,并反对冗余或时间性的注释。

  • 防止过度工程,要求变更仅集中于所请求的功能,避免过早抽象化,并强制清理未使用代码或旧有黑客式写法。

  • 包含针对索引变更的特定警告,要求与 SQLite 内部排序行为进行严格对照,以防止数据不一致。

  • 输入通常是涉及 Turso 数据库 Rust 模块的代码片段、提取请求 (PR) 或设计提案。

  • 输出包括代码审查、重构建议或技术指导,确保符合 Turso 对持久性与性能的核心原则。

  • 永远将数据完整性置于功能开发速度之上;假定在足够长的时间内,每个边缘案例错误都会发生。

  • 使用适当的错误处理机制(如 Result 类型),并避免会静默忽略意外分支的 if-else 链;对于不可能的逻辑状态,优先使用显式断言或不可达宏 (unreachable macro)。

  • 保持实现专注:若变更未直接服务于需求或改进核心正确性,则不应包含在内。

仓库统计

Star 数
18,444
Fork 数
854
Open Issue 数
640
主要语言
Rust
默认分支
main
同步状态
空闲
最近同步时间
2026年5月1日 08:05
在 GitHub 查看