zod-skill
专为AI Agent设计的Zod v4模式编写与调试技能库
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：zod-skill。 它的用途是：专为AI Agent设计的Zod v4模式编写与调试技能库 完整的 Skill 内容见：https://321skill.com/skills/zod-skill/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我用Zod写一个用户注册表单的校验模式，需要验证邮箱、密码和确认密码是否一致。” 它会调用此技能库，遵循v4最佳实践，生成使用z.object、z.string().email()以及通过.superRefine()进行跨字段密码校验的安全代码，并提示使用safeParse进行验证。
介绍
Zod Skill是一个专门为AI Agent设计的技能库，旨在解决开发者在TypeScript应用中编写、验证和调试Zod v4模式时遇到的困惑与错误。它提供了Zod v4的最佳实践、API指导和常见模式，尤其针对运行时类型验证、错误处理和模式设计等关键环节。
使用时，AI Agent会根据用户代码中出现的Zod相关导入、关键词（如z.object, safeParse, ‘zod v4’等）自动触发该技能，并提供针对性的规则建议和代码片段，帮助开发者遵循正确模式，避免因版本升级（如v3到v4）或不当使用导致的错误。
该技能主要面向使用TypeScript ^5.5和Zod ^4.0.0进行API开发、表单验证、环境变量解析等需要运行时数据验证的开发者。对于AI Agent而言，它是准确理解和生成Zod v4代码的权威参考源。
与网络上零散的Zod教程或通用TypeScript技能不同，此技能库高度聚焦于Zod v4的最新特性和最佳实践，并明确标注了与旧版本的破坏性变更，确保AI Agent提供的建议始终与最新官方文档和项目源码保持一致，避免输出过时或错误的信息。
核心特点
本技能库是专为AI Agent训练和调用的结构化规则集，而非人类阅读的文档。它通过明确的规则前缀（如parse-, schema-）和优先级分类，确保AI能精准匹配场景并提供最关键的指导，尤其强调Zod v4的破坏性变更，强制AI以技能库为唯一真相源，而非依赖可能过时的训练数据。
注意事项
不适用于仅需要编译时类型检查、不使用Zod库或使用Zod v3及以下版本的项目。
常见问题
Zod v4 和 v3 主要有什么区别？
v4在字符串格式、枚举、错误处理（如移除required_error）和递归类型（移除z.lazy）等方面有破坏性变更，本技能库提供了详细的迁移指导。
什么时候应该用 safeParse 而不是 parse？
处理不可信的用户输入（如表单、API请求）时，必须使用 safeParse 来捕获错误而非抛出异常，这是本技能库的CRITICAL级规则。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/zod-skill/raw/index.md 读取 zod-skill 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/zod-skill/raw/index.md（查看排版版本）