技能介绍

问题背景

JSON、JSON5、YAML 被广泛用于配置文件、接口数据和 CI 中间产物。一旦 schema 与数据漂移，错误通常要等到下游工具真正读取时才会暴露，排错成本高且容易阻塞流水线。手工写脚本校验不仅重复，也难以覆盖多文件、多模式叠加和不同 JSON Schema 语言版本的组合。

工作原理

该技能将验证能力收敛到 ajv-cli，让你可以在 shell 或 CI 中直接对目标文件运行模式检查。核心能力包括：

统一在命令行执行 schema 校验，便于本地复现与 CI 集成。
支持传入多个 JSON Schema 或 JTD 文件，既可重复指定参数，也可使用 glob 模式批量匹配。
通过 --spec 选择 JSON Schema 语言与版本，覆盖不同规范要求。
面向 JSON、JSON5、YAML 三类输入做格式解析，再按模式比对结构与约束。

关键步骤是：准备 schema 文件与目标数据文件；用 ajv-cli 指向对应 schema 与数据路径；将校验命令纳入提交前检查或流水线步骤，使畸形输入在进入下游工具前就失败。

适用边界与注意点

它解决的是“数据是否符合已声明模式”的问题，不替代 schema 设计评审，也不负责修复不合法数据。多 schema 场景下，glob 模式需要加引号且不能省略扩展名；使用 TypeScript 编写 schema 时需要本机可用 ts-node。不同 JSON Schema 语言版本之间的兼容性仍需按上游文档显式指定，避免把版本差异误判为数据错误。