技能介绍

你在处理 JSON 时会卡在哪

接口联调时，日志里往往是一整行未缩进的 JSON；改配置要对比两个版本，肉眼看 diff 很容易漏字段；嵌套很深的响应里，你只关心 data.user.id 这类路径，却不想手写解析脚本。再常见一点：要把 JSON 塞进环境变量或消息体，多余空白会占体积；提交前还要确认文件是不是合法 JSON，避免线上才报错。

这类问题不需要上重型 IDE 插件或在线工具链，但重复劳动很烦——尤其是本地脚本、CI 检查、临时排查场景。

技能在做什么

cn-json-tools（SKILL 里称「JSON工具箱」）把几类高频操作收成一组明确能力，对应文档中的五个入口：

format：缩进美化，把紧凑 JSON 变成可读结构
diff：比对两个 JSON 文件或文本的差异，适合配置变更审查
extract：按路径从 JSON 中取出指定字段（复杂嵌套时比全文搜索更稳）
minify：去掉空白与换行，得到紧凑字符串
validate：校验语法是否合法，在写入或发布前做快速门禁

实现侧强调 Python 3 + 标准库，不依赖第三方包，部署和离线环境都相对省事。典型用法是：拿到 API 返回 → format 或 validate → 需要对比时走 diff → 只留关键字段用 extract → 要省体积再 minify。

适用边界

这是面向 JSON 文本处理的工具向技能，不负责 HTTP 抓包、Schema 校验（如 JSON Schema）、或数据库里的半结构化数据迁移。diff 的结果是「文本/结构差异」层面的辅助，语义等价但键序不同的对象，解读时要结合你的业务约定。路径 extract 依赖你给出的路径表达式是否与实际结构一致；字段改名或数组下标变化时需要更新路径。若你需要图形化合并或大规模批处理流水线，仍可能要配合专用 diff/ETL 工具；本技能更适合工程师日常调试与配置维护的短路径操作。