JSON

解析、验证、转换和设计JSON负载

安装使用

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

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

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

使用示例

'解析这个JSON,它包含一个尾随逗号,请修复并返回有效JSON',它会自动移除多余逗号并验证。或说:'将这份NDJSON文件转换为标准JSON数组',它会逐行解析并合并为数组。或说:'对比这两个JSON文档,生成JSON Patch',它会输出差异操作列表。

介绍

这个Skill专门解决JSON处理中各种棘手的实际问题。当你的解析器在某个字节偏移处失败、浮点数精度丢失、带重音或表情符号的字符串变成乱码、字段在不该出现null时出现、重复键被静默覆盖、JSON Schema误判、大文件无法加载到内存、jq等查询表达式返回空结果、两个文档需要diff或patch、webhook签名因重新序列化失效、不可信输入需要安全解析、或响应形状必须在不破坏客户端的情况下变更时,它都能派上用场。

使用方式非常灵活:你可以直接传入JSON字符串或文件路径,要求它解析、修复、验证或转换。它支持NDJSON、JSON Patch、规范形式、SQL中的JSON列,以及JSON5/JSONC配置文件。例如,你可以让AI“修复这个包含尾随逗号的JSON”或“将这份NDJSON文件转换为标准JSON数组”。

适合后端开发者处理API响应、数据工程师清洗流式数据、全栈开发者调试接口返回、以及任何需要精确控制JSON输出质量的技术人员。它也适用于需要处理大型JSON文件的场景,因为它支持流式处理而不必一次性加载全部内容。

注意:这个Skill专精于JSON格式本身,不适合用于约束LLM输出(请使用structured-output skill),也不适合处理YAML、TOML、XML、CSV等格式(它们各自有专属skill),更不适合设计REST端点(请使用rest-api skill)。使用时尽量提供清晰的上下文,如预期格式、错误信息等,以便AI快速定位问题。

核心特点

与普通的JSON格式化工具不同,这个Skill深入处理字节偏移错误、精度丢失、乱码、大文件流式处理等生产环境中的真实痛点,并覆盖NDJSON、JSON Patch、规范形式、JSON5/JSONC等扩展格式,而不仅仅是基础解析。

注意事项

不适合约束LLM输出、处理YAML/TOML/XML/CSV格式,也不适合设计REST端点。

常见问题

如何处理大文件JSON(超过内存限制)?

这个Skill支持流式处理NDJSON和分块解析,你可以指定逐行处理或使用JSON Patch增量更新,避免一次性加载整个文件。

它能验证JSON Schema并修复错误吗?

可以。它会根据提供的JSON Schema进行验证,并尝试自动修复常见错误(如字段缺失、类型不匹配),但复杂的业务逻辑约束需要你手动定义。

给 AI 助手的安装指引

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

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