SuperAPI AI 工具集

busirocket-validation

编程与开发

查看项目

更新于 10-15 17:30

技能介绍

用途:在系统边界处保持一致的数据校验,复杂模式用 Zod,简单运行时检查用小型 guard 函数。

适用场景:在服务中校验 API 响应或外部数据;在路由处理、SDK 等边界校验请求/输入形状;新增或重构 utils/validation/ 辅助函数;在 types/<area>/ 中与类型并列定义 Zod schema。

硬性要求:服务层用 Zod schema(如 .safeParse())校验 API/外部数据;小型转换或 guard 辅助函数放在 utils/validation/,每文件一个函数;Zod schema 可放在 types/<area>/,用 z.infer<typeof Schema> 推断类型;边界处优先使用 unknown 输入并显式收窄;组件/hooks 内不得内联校验逻辑。

规则分组:边界与放置(validation-boundaries);Zod 复杂校验(validation-zod-schemas、validation-zod-types);guard 辅助(validation-guard-helpers、validation-guard-examples,如 isRecord、isNonEmptyString);反模式(validation-no-inline)。相关技能:busirocket-nextjs(路由处理中的校验)、busirocket-core-conventions(文件边界与结构)。

使用方式:阅读各规则文件获取详细说明与代码示例,如 rules/validation-boundaries.md、rules/validation-zod-schemas.md、rules/validation-guard-helpers.md,每个文件含原因说明、正确与错误模式示例及最佳实践。

限制:资料未提供具体安装命令、版本要求、平台支持、收费信息或效果数据。