JSON
解析、验证、转换和设计健壮的JSON负载
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:JSON。 它的用途是:解析、验证、转换和设计健壮的JSON负载 完整的 Skill 内容见:https://321skill.com/skills/json-x-10/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'这个JSON在第42字节解析失败,帮我修复。' 它会自动定位到字节偏移处,检查尾逗号或非法字符,返回修复后的JSON。或者:'验证这两个JSON文档的差异,生成JSON Patch。' 它会输出一个标准的补丁操作列表。或者:'这个5GB的NDJSON文件需要过滤出所有status为active的记录并转成CSV。' 它会流式读取、过滤、转换并输出结果。
介绍
JSON 在真实世界中往往不是教科书里那样干净整洁。你可能遇到过这样的场景:一个 API 返回的 JSON 在某个字节偏移处解析失败,却因为尾逗号而报错;金额字段在浮点运算中丢失精度,导致对账不平;带重音符号或 emoji 的文本回来时变成了乱码;某个字段应该是 null 却变成了空对象,或者本应缺失的字段却出现了 null;重复的键名被静默覆盖,而你需要保留所有值;JSON Schema 通过了本该拒绝的非法结构,或者 $ref 引用解析失败;一个多 GB 的 JSON 文件无法直接加载到内存中;jq、JMESPath 或 JSONPath 查询返回空结果;两个 JSON 文档需要做差异比对或生成补丁;Webhook 签名在重新序列化后失败;不受信任的输入需要安全解析;或者响应结构需要在不破坏现有客户端的前提下变更。这个 Skill 专门处理这些棘手问题,让 JSON 真正存活于生产环境。
使用方式非常直接:你只需要把问题 JSON 或需求描述给 AI,它会自动调用底层能力进行解析、验证、转换、流式处理、查询、比对、修补等操作。支持 NDJSON(每行一个 JSON 对象)、JSON Patch(增删改操作)、规范形式(canonical form)、SQL 中的 JSON 列操作,以及 JSON5/JSONC 等配置文件格式。你不需要手动编写复杂的正则或递归代码,AI 会替你完成。
这个 Skill 主要面向后端开发、数据分析师和测试工程师。如果你在日常工作中频繁处理 API 响应、配置文件、日志流、大规模数据集,或者需要保证 JSON 在不同系统间的精确传递,它会显著提升你的效率和准确性。
使用建议:尽量提供完整的上下文,比如错误信息中的字节偏移、期望的 Schema 结构、数据量级等。对于超大型文件,它会自动启用流式处理,无需手动分片。注意,它不适合约束 LLM 输出(请使用 structured-output 技能),也不处理 YAML、TOML、XML、CSV 等格式,这些有专门的技能。同时,如果你需要设计 REST API 端点,请使用 rest-api 技能。
核心特点
与普通的 JSON 解析库不同,这个 Skill 专门解决真实生产环境中的「脏」问题:字节偏移解析失败、尾逗号、精度丢失、乱码、空字段语义、重复键、Schema 误判、大文件流式处理、查询表达式空结果、文档差异比对与修补、Webhook 签名重序列化失败等,覆盖 NDJSON、JSON Patch、规范形式、JSON5/JSONC 等边界场景。
注意事项
不适合约束 LLM 输出(应使用 structured-output 技能),也不处理 YAML、TOML、XML、CSV 或设计 REST API 端点。
常见问题
JSON 解析时提示“Unexpected token at byte 42”怎么办?
直接把这个错误信息连同 JSON 片段一起发给 AI,它会自动定位到第 42 个字节附近,检查是否有尾逗号、非法字符或多余引号,并给出修复建议或直接返回修正后的 JSON。
如何验证一个 JSON 文档是否符合某个 Schema?
提供 JSON 文档和 Schema(JSON Schema 格式),AI 会调用验证器检查所有字段的类型、约束、引用等,并输出详细的通过/不通过报告,包括具体路径和原因。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/json-x-10/raw/index.md 读取 JSON 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/json-x-10/raw/index.md(查看排版版本)