JSON

健壮的JSON解析、校验与转换工具

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:JSON。
它的用途是:健壮的JSON解析、校验与转换工具
完整的 Skill 内容见:https://321skill.com/skills/json-x-8/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'我有一个10GB的NDJSON文件,每行是一个用户事件,需要过滤出type为“purchase”的行,并输出为JSON数组。' Skill会以流式方式逐行解析、过滤、转换,最终生成一个合规的JSON数组文件,避免内存溢出。

介绍

这个Skill专门解决真实世界中JSON处理的各种棘手问题:当解析失败并提示字节偏移、末尾逗号导致报错、数值精度丢失、中文或表情符号乱码、字段本应缺失却为null、重复键被静默覆盖、JSON Schema误判、$ref无法解析、多GB文件无法读入内存、jq/JMESPath/JSONPath查询无结果、两个文档需要diff或patch、Webhook签名因重新序列化失败、不可信输入需安全解析、响应形状需兼容旧客户端等场景,它都能帮你快速定位并修复。

使用方法很简单:直接对AI描述你遇到的JSON问题或需求,例如“这个JSON文件解析到第1024个字节报错了,帮我看看哪里有问题”或“需要将这个10GB的NDJSON文件按字段过滤后输出JSON Patch”。Skill会自动调用内部解析引擎,支持流式处理大文件、生成规范化JSON、应用JSON Patch、校验JSON Schema、转换JSON5/JSONC等。

适合后端开发者处理API响应异常、全栈开发者调试数据交互、数据分析师清洗和转换批量JSON数据、测试工程师验证接口返回格式,以及任何需要处理复杂JSON文档的技术人员。

建议优先用于中大型JSON文件或边界情况处理,小文件手写正则即可的场景不必调用此Skill。注意它不适用于约束LLM输出(请用structured-output)、不处理YAML/TOML/XML/CSV(各有专有Skill),也不用于设计REST API端点(请用rest-api)。

核心特点

不同于通用JSON库,它专为真实世界中的各种边界情况设计——从字节偏移报错、精度丢失、乱码到多GB大文件流式处理,以及JSON Patch、NDJSON、JSON5/JSONC等扩展格式,覆盖了生产环境中90%的JSON疑难杂症。

注意事项

不适用于约束LLM输出、处理YAML/TOML/XML/CSV文件、设计REST API端点,也不适合简单的JSON格式化(手写更高效)。

常见问题

如何处理超过内存大小的JSON文件?

使用流式解析模式,Skill会自动按行/块读取,支持NDJSON和超大JSON文件的分段处理,无需一次性加载到内存。

JSON Schema校验失败但看不出问题,怎么办?

Skill会输出详细的校验错误路径和原因,并支持$ref解析,可帮你定位递归引用或缺失定义的问题。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/json-x-8/raw/index.md 读取 JSON 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。