JSON

专业JSON解析、校验与转换工具

安装使用

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

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

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

使用示例

'我解析这个JSON时报错'Unexpected token , in JSON at position 42',请帮我修复并解释原因。'它会自动定位尾逗号,修正后输出正确JSON,并说明尾逗号在标准JSON中不允许。

对AI说:'两个JSON文件需要做diff,生成JSON Patch格式的补丁。'它会对比两个文档,输出标准的JSON Patch操作序列。

对AI说:'验证这个JSON Schema,它应该拒绝{ "id": "abc" },但实际通过了。'它会检查Schema定义,发现缺少类型约束,并给出修正建议。

介绍

JSON 数据在日常开发中无处不在,但解析失败、精度丢失、乱码、Schema 误判等痛点却频频出现。本 Skill 专门解决这些问题:当 parse 在某个字节偏移处报错、尾逗号导致异常、id 或金额精度丢失、重音符号与 emoji 变成乱码、字段本应缺失却为 null、重复键静默覆盖、JSON Schema 通过本应拒绝的内容、$ref 解析失败、多 GB 大文件无法加载、jq/JMESPath/JSONPath 表达式返回空、两个文档需要 diff 或 patch、webhook 签名因重序列化而失败、不可信输入需安全解析、响应结构需兼容旧客户端等场景,都能快速定位并修复。

使用方式极为灵活:你可以直接粘贴 JSON 字符串让 AI 分析并修复,也可以上传文件、描述错误现象,AI 会通过解析、校验、转换、设计等步骤给出解决方案。支持 NDJSON、JSON Patch、JSON Schema、JSON5/JSONC 配置文件、JSON列(SQL 中)等子格式,并兼容大文件流式处理。

适合后端开发、数据分析师、测试工程师等经常与 JSON 打交道的角色。无论你在调试 API 响应、清洗数据管道中的脏数据、验证 Schema 定义,还是处理 Webhook 签名验证,这个 Skill 都能显著提升效率。

注意:本 Skill 专为 JSON 及相关格式设计,不适用于约束 LLM 输出(请使用 structured-output 技能),也不适用于 YAML、TOML、XML、CSV 等格式(它们有各自的技能),更不适用于设计 REST 端点(请使用 rest-api 技能)。对于超大文件(多 GB),建议配合流式读取或分块处理。

核心特点

同类技能多只处理单一 JSON 操作(如解析或格式化),而本 Skill 覆盖了从解析、校验、转换、设计到 Schema 验证、差量补丁、流式处理等全链路,且能处理真实生产环境中的字节偏移、精度丢失、乱码等极端问题。

注意事项

不适用于 LLM 结构化输出约束、其他数据格式(YAML/TOML/XML/CSV)以及 REST API 端点设计。

常见问题

JSON 解析报错在第 42 字节处,怎么快速定位?

将错误信息和 JSON 文本粘贴给 AI,它会自动解析并指出错误位置及原因,例如尾逗号、未转义字符等。

处理大文件时内存不足怎么办?

本 Skill 支持流式处理,你可以使用 NDJSON 格式或按行读取,AI 会逐块处理,避免内存溢出。

给 AI 助手的安装指引

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

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