Agent Skills
返回列表
💻

JSON对比工具

开发编程 更新于 2026.08.30

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

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

技能介绍

要解决什么问题

在 AI 对话里做 JSON 对比时，常见痛点是：两段 JSON 可能来自接口断言、配置快照或模型生成的结构化输出，人工逐字段对照既慢又容易漏差异。本技能把「对比哪两段 JSON」收敛成两个明确入参，由后端 API 执行 diff，模型只负责理解意图、补全参数并把 raw 结果整理展示。

技能如何工作

整体是 MCP 路由 + 远程对比 API 的分工：

  1. 密钥检查：若 scripts.config.settings.api_key 为空，须通过 AskUserQuestion 向用户索取密钥，并调用 scripts.config.set_api_key 持久化（密钥来源见 xiaobenyang.com）。
  2. 选工具与传参：用户意图为 JSON 对比时，调用 scripts.tools.jsonDiff，以关键字参数传入必填的 expectKey 与 actualKey（均为 string）。参数不全时同样用 AskUserQuestion 补齐。
  3. 结果处理：工具返回 result["success"]、result["message"] 与 result["raw"]；展示时应以 raw 中的 API 原始 JSON 为主，避免在无数据时自行编造对比结论。

适用边界与注意点

  • 无密钥不可用：缺少 API 密钥时禁止搜索或虚构对比结果，必须先完成密钥配置。
  • 能力边界：当前工具表仅覆盖 jsonDiff 一类对比场景；expectKey / actualKey 的具体语义（例如是否为存储键、URL 或内容标识）以 API 与小笨羊文档为准，路由层应确认用户给出的两个键是否对应当次要比较的对象。
  • 职责划分：业务逻辑与 diff 算法在 API 侧；对话中的模型不应跳过工具直接「目测」两段 JSON 并声称已做正式对比。

使用场景

  • 联调接口时，已在平台存好预期与实际两份 JSON，通过 `expectKey` 与 `actualKey` 让 Agent 调用 jsonDiff 输出差异明细。
  • 配置或特性开关发布前，用两个内容键指向变更前后的 JSON 快照，在对话里完成字段级对比而非人工复制粘贴。
  • 编写或调试 Skill 路由时，验证模型能否在缺参时追问、并在有密钥后正确以关键字参数调用 `scripts.tools.jsonDiff`。
  • 自动化测试失败复盘时，把用例里的期望 JSON 键与实际响应键交给工具，统一查看 API 返回的 raw diff 结果。

适合人员

  • 负责契约测试与回归的后端工程师，需要在 Agent 对话里用键名触发正式 JSON diff 而不是肉眼扫日志。
  • 集成 MCP Skill 的平台开发者，要把用户「对比这两段 JSON」的意图稳定映射到 jsonDiff 与密钥配置流程。
  • 维护多环境配置的 SRE/发布值班同学，发布前后需快速核对 JSON 快照键对应内容是否一致。
  • 编写提示词与工具编排的 AI 应用工程师，希望对比逻辑走小笨羊 API，避免模型在无密钥时编造差异结论。