SuperAPI AI 工具集

runtime-validation

编程与开发

查看项目

更新于 10-16 08:49

技能介绍

用途:用于代码审查场景。当代码调用 fetch()、读取 localStorage、访问 process.env 或处理表单提交,却没有显式校验数据时触发,帮助发现外部数据入口缺少运行时校验的问题。

主要能力:一是识别代码中所有外部数据进入应用的位置(fetch 调用、localStorage 读取、环境变量访问、表单提交),报告哪些缺少运行时 schema 校验;二是为这些入口添加 Zod schema,给出 schema 定义、类型推断结果以及调用 .parse() 或 .safeParse() 的位置;三是解释 TypeScript 类型为何无法防止运行时数据不匹配、Zod 如何衔接编译期与运行时安全,以及 .parse() 与 .safeParse() 的使用场景;四是在代码审查中标记任何未经运行时校验就直接断言为 TypeScript 类型的位置。

背景要点:TypeScript 类型仅存在于编译期,运行时会被完全擦除;API 响应可能与其声明类型不一致而不产生编译错误;Zod schema 可同时完成数据校验和 TypeScript 类型推断;校验应只放在信任边界,而非每个内部函数调用中。

使用方式:按该技能的四类操作执行——Check(定位并报告缺失校验的外部数据入口)、Fix(添加 Zod schema 并说明调用位置)、Explain(解释编译期与运行时安全的差异)、Code Review(审查文件中的外部数据入口与类型断言)。完整实现细节、代码示例和框架相关指引见 references/rule.md,规则页为 https://frontendchecklist.io/rules/javascript/runtime-validation。

限制:资料未提供除 Zod 之外的具体库选型、安装命令、价格或平台信息。