SuperAPI AI 工具集

zod-v4

编程与开发

查看项目

更新于 10-15 17:27

技能介绍

该技能提供 Zod v4.4.3 的规则优先(rule-first)指导,按任务风险从高到低匹配规则,再按需加载引用文档。

用途:处理 Zod v3 到 v4 的迁移与废弃 API 清理;在用户输入、环境变量、HTTP、数据库、队列、JSON 等边界做校验;设计对象组合与严格性;生成 UI/API/CLI 错误信息;导出 JSON Schema/OpenAPI;处理双向 wire/internal 转换;以及在 React Hook Form、tRPC、Hono、Next.js actions 等生态中使用。也覆盖 Zod Mini、包导出与库作者场景。

主要能力:按类别组织规则,包括迁移与废弃(migrate-)、解析与边界(parse-)、错误处理(error-)、对象与组合(object-)、schema 定义(schema-)、元数据与注册表(meta-)、JSON Schema/OpenAPI(jsonschema-)、codecs(codec-)、包接口(package-)。入口为 rules/_index.md,每条规则含失败模式、精简正反例与关联引用。

使用方式:安装用 bun add zod@^4.4.3;按任务查对应规则或 references 文档。内置脚本:审计命令 bun "$skill_dir/scripts/zod-audit.ts" --root . --format text,支持 --list-rules、--list-checks、--explain,仅在评估后使用 --fail-on warn|error|info;AI 栈扫描 python3 "$skill_dir/scripts/ai_stack_scan.py" --root . --family zod-v4 --pretty;规则维护 bun "$skill_dir/scripts/build-rules-index.ts" 与 bun "$skill_dir/scripts/check-skill-integrity.ts";schema 运行 bun "$skill_dir/scripts/zod-run.ts" 支持 safeParse、encode、toJSONSchema 等模式,因会导入目标模块,需避免副作用重的模块。

限制与注意:该技能面向 Zod 4.4.3,不应把默认导入、命名空间根导入、单参数 z.record(valueSchema) 当作包级无效代码,只能视为本地风格或迁移建议;扫描输出仅作本地私有证据,编辑前需对照当前代码与 Zod 官方文档/源码核实。技能未提供收费、价格或效果承诺等信息。