嵌套结构变更对比

要解决什么问题

当 agent 校验 API payloads、configuration snapshots 或 migration outputs 时，嵌套和 key paths 很重要。普通的 line-based diffs 会产生很多干扰信息，因为微小的结构调整会被放大成整行差异，导致真正重要的 additions、removals、value changes 与 deltas 被淹没，批准门槛也随之失真。我们需要一个直接针对 structured objects 的 deep comparison，把差异精确定位到路径级别。

技能如何工作

这个技能利用 DeepDiff 对 structured objects 进行深入比较，并返回精确的差异结果。它的主要能力包括：

• 比较嵌套的 JSON、API 响应和配置快照，深入到 key paths 层级
• 返回 additions、removals、value changes 与 deltas，而不是整块文本差异
• 让 agent 在批准之前先对结构变化做出判断，使校验流程更加明确

工作流程大致如下：

1. 接收待比较的 structured objects，例如 API 响应或配置快照
2. 使用 DeepDiff 运行 deep comparison
3. 从结果中提取 additions、removals、value changes 与 deltas
4. 根据路径信息判断变更是否可批准

适用边界与注意点

适合 API payloads、configuration snapshots、migration outputs 这类结构化数据，尤其是嵌套较深、key paths 很重要的场景。不太适合纯文本或非结构化输入，因为其优势在于路径精确而非语义理解。运行环境需要 Python 3.10+ 或 PyPy3。DeepDiff 的 CLI 与性能相关功能（如 improved json serialization）可以根据需要启用，但要根据实际场景权衡。