Codex TypeScript 严格类型技能:用 Zod 验证外部 JSON
EnglishCodex 安装步骤
- 从固定 GitHub 提交复制 `skills/typescript/` 完整目录到项目 `.agents/skills/typescript/`。
- 在 Codex 确认 `tsconfig` 严格规则、输入边界和现有错误表达方式。
中文摘要
将外部 JSON 作为 `unknown` 读入,使用运行时校验得到可推导的类型,并给错误分支独立建模。
SKILL.md 中文导读
可复现示例
给本地配置定义 `title` 字符串与 `pageSize` 正整数。对 `{"title":"Docs","pageSize":20}` 和 `pageSize:"20"` 分别调用 `safeParse`。工作步骤
- 对本地 JSON 夹具定义 Schema,用显式成功与失败分支处理解析结果。
- 测试有效输入、错误类型和缺字段,核对编译时类型与运行时验证一致。
验收方法
有效对象得到可推导类型,字符串页长被拒绝并返回可定位字段的问题。
GitHub 原文 · 更新日期
适用环境
需要本地 TypeScript 项目、项目选择的 Zod 版本和可用测试工具。
常见问题
已经写好 interface 还需要 Zod 吗?
来自文件或网络的输入仍需要运行时校验。可从 Schema 推导接口类型以减少重复维护。