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 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/json-x-8/raw/index.md(查看排版版本)