Agent Skills
返回列表
JSON 差异对比

JSON 差异对比

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_15292d5a/yjkj-cn-json-diff。

技能介绍

要解决什么问题

接口联调、配置发布或数据迁移时，两份 JSON 往往只差几处字段，却嵌套很深、数组长度也会变。肉眼逐行对比既慢又容易漏；把文件丢进通用 diff 工具，又常被格式化差异干扰，看不出「语义上哪条路径变了」。

技能如何工作

本技能面向两份 JSON 文件做结构化对比，核心能力包括：

  • 支持任意复杂度的 JSON（嵌套对象、数组）
  • 识别嵌套路径上的字段增删改
  • 检测数组长度变化
  • 对变更项输出旧值 / 新值，并给出路径

实现为纯 Python，SKILL.md 说明无外部依赖。用法上通过命令行传入两个 JSON 文件路径；输出为差异清单（路径 + old/new），进程退出码 0 表示对比完成（有无差异均可），1 表示读文件失败。

适用边界与注意点

  • 输入必须是可解析的 JSON 文件；语法错误或路径无效会触发读文件错误。
  • 技能定位是结构化 JSON diff，不是通用文本 diff；若你只关心整文件字符串是否相同，未必需要路径级对比。
  • 大文件或极深嵌套时，输出量可能很大，建议结合具体路径筛选结果再排查。

使用场景

  • 接口联调或版本升级后，拿 staging 与 production 各一份响应 JSON，核对嵌套字段与数组长度是否一致。
  • 发布窗口前，将本次改动的应用/服务配置 JSON 与上一版文件对比，定位具体路径上的 old/new 值。
  • 契约或集成测试失败时，把用例里保存的期望 JSON 与接口实际返回 JSON 做 diff，逐条排查差异路径。
  • 数据迁移或 ETL 验收时，对比迁移前后导出的 JSON 快照，确认深层对象与数组项是否缺失或变更。

适合人员

  • 负责微服务/API 迭代的后端工程师，联调时需要路径级对比两份 JSON 响应而非整段文本 diff。
  • 维护多环境配置的运维或 SRE，在变更前后对比导出的 JSON 配置，确认只改了预期字段。
  • 编写 API 自动化测试的 QA，失败用例里要对照期望 JSON 与实际响应，快速看到 old/new 与路径。
  • 做数据管道或迁移验收的数据工程师，用两份 JSON 导出验证嵌套结构与数组长度是否符合基准。