JSON
解析、验证、转换、设计JSON,解决真实难题
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:JSON。 它的用途是:解析、验证、转换、设计JSON,解决真实难题 完整的 Skill 内容见:https://321skill.com/skills/json-x-9/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'解析这个JSON文件,它在字节偏移120处报错,可能是尾逗号,帮我修复并输出美观的JSON。' 技能会定位到具体位置,删除多余逗号,然后输出格式化后的JSON。或者
对AI说:'验证这个JSON Schema,这个字段明明应该是number类型但传了字符串,为什么Schema通过了?' 技能会逐字段对比,发现Schema中属性定义错误,并给出修正建议。
介绍
JSON 解析失败、精度丢失、乱码、重复键、大文件内存不足……这些在生产环境中反复出现的问题,往往不是简单的语法检查能解决的。本技能专注处理真实场景中的 JSON 痛点:从字节偏移定位错误、修复尾逗号,到处理失去精度的数字 ID 和金额、修复乱码的 accent 和 emoji,再到安全解析不可信输入、无损变更响应形状而不破坏已有客户端。它覆盖 NDJSON 流式处理、JSON Patch 增量更新、规范形式、SQL 中的 JSON 列,以及 JSON5/JSONC 配置文件,让 JSON 真正“存活”于真实解析器和客户端之间。
使用时,你只需描述遇到的 JSON 问题——比如“解析报错 offset 120,可能尾逗号”、“这个 JSON Schema 明明该拒绝却通过了”、“$ref 无法解析”、“多 GB 文件内存溢出”——技能就会自动定位、修复或转换。它还能对两个 JSON 文档做 diff/patch、在 re-serialization 后校验 webhook 签名,并支持 jq、JMESPath、JSONPath 等查询表达式的结果校准。
适合后端开发者、数据分析师、测试工程师、运维人员,以及任何需要频繁与 JSON 打交道的技术角色。特别是当你遇到 JSON 解析器、客户端或数据大小带来的边界问题时,它比通用在线工具更精准、更贴近生产。
建议优先用于数据清洗、字段校验、大文件低内存处理、Schema 验证和响应结构兼容性改造。注意它专为 JSON 设计,不适用于约束 LLM 结构化输出、处理 YAML/TOML/XML/CSV,或设计 REST 端点(这些场景请使用专门的技能)。
核心特点
与 jq、JSONPath、在线验证器等工具不同,本技能关注真实解析器、客户端和数据大小,能处理字节偏移定位、数字精度丢失、乱码、重复键胜出、大文件内存不足、$ref 解析失败、webhook 签名重算等实际生产问题,而非仅做语法检查或查询。
注意事项
不适合用于约束 LLM 输出(结构化输出)、处理 YAML/TOML/XML/CSV 格式,或设计 REST 端点。
常见问题
如何处理一个超过内存限制的多GB JSON文件?
使用 NDJSON 流式处理或按需分段解析,技能会自动以低内存模式逐行处理,避免一次性加载。
JSON Schema 通过了本应拒绝的字段,怎么排查?
技能会逐字段验证并输出失败的路径和原因,包括类型、格式、枚举等约束,同时检查 $ref 指向是否正确。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/json-x-9/raw/index.md 读取 JSON 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/json-x-9/raw/index.md(查看排版版本)