JSON

处理真实世界JSON问题的全能工具

安装使用

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

帮我安装这个 AI Skill:JSON。
它的用途是:处理真实世界JSON问题的全能工具
完整的 Skill 内容见:https://321skill.com/skills/json-x-5/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

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

使用示例

'检查这个JSON文件,它在第120字节处报错,可能是尾部逗号问题,请修复并输出标准格式。' Skill 会自动定位错误位置,移除尾部逗号,返回正确的JSON。再比如:'两个JSON文档需要合并差异,请生成JSON Patch并应用到目标文档。' 它会先计算diff,然后应用patch,输出合并后的结果。

介绍

JSON 是数据交换中最常见的格式,但真实场景中总会出现各种意外:解析器在某个字节偏移处报错、尾部逗号导致解析失败、数字精度丢失导致金额错误、Emoji 乱码变成“莫吉巴”、字段明明为 null 却需要被忽略、重复键被静默覆盖、JSON Schema 误判、$ref 无法解析、多GB文件无法加载到内存、jq/JMESPath/JSONPath 查询无结果、两个文档需要 diff 或 patch、Webhook 签名因重序列化失败、不可信输入需要安全解析、响应形状需要兼容旧客户端……这个 Skill 正是为解决这些实际问题而生。它覆盖 NDJSON、JSON Patch、规范形式、SQL 中的 JSON 列、JSON5/JSONC 配置文件等格式,并提供流式处理、差异对比、补丁应用、安全解析、Schema 验证、精度保护、编码修复等能力。

使用方式非常直接:将 JSON 字符串或文件路径作为输入,指定所需的操作(解析、校验、转换、设计、查询、比较、修复等),Skill 会自动处理边界情况并返回结果。支持管道操作、批量处理、与 jq/JMESPath/JSONPath 表达式混用,也支持 JSON Schema 验证和 $ref 解析。对于大文件,采用流式解析避免内存溢出;对于不可信输入,启用安全解析模式防止注入攻击。

适合后端开发、数据分析师、全栈开发者、测试工程师、运维工程师等所有需要频繁与 JSON 打交道的技术人员。尤其是:调试 API 响应时遇到解析错误、处理用户上传的 JSON 数据需要校验、在微服务间转换 JSON 格式、维护遗留系统时处理不规范 JSON、分析日志文件中的 JSON 行、实现 Webhook 签名验证、编写 SQL 查询 JSON 列等场景。

建议在命令行或脚本中直接调用,可集成到 CI/CD 流水线中自动校验配置文件。注意:本 Skill 不处理 YAML、TOML、XML、CSV 等非 JSON 格式(请使用对应专用 Skill),也不适合用于约束 LLM 输出(请使用 structured-output 相关 Skill),也不用于设计 REST 端点(请使用 rest-api 相关 Skill)。对于简单的 JSON 格式美化,它也能胜任,但更擅长的还是那些棘手的真实问题。

核心特点

相比 jq/JSONPath 等查询工具,它专注于修复和容错:能自动处理字节偏移错误、尾部逗号、精度丢失、乱码、重复键等现实问题,并提供安全解析、流式大文件处理、JSON Patch diff/patch 等实用功能,而不仅仅是查询和格式化。

注意事项

不适用于 YAML、TOML、XML、CSV 等非 JSON 格式,也不适合约束 LLM 输出或设计 REST 端点。

常见问题

如何修复 JSON 文件中的尾部逗号?

直接输入文件路径,Skill 会自动检测并移除尾部逗号,输出标准 JSON。

大 JSON 文件(超过 1GB)能处理吗?

可以,采用流式解析,不会将整个文件加载到内存,适合处理多GB级文件。

给 AI 助手的安装指引

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

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