Skills

一份 SKILL.md 说明 AI 编码助手如何按需调用 @compare-json/cli。

它能做什么

安装后，该 skill 允许 AI 助手直接在对话中比较两个 JSON 文件或字符串。只需让它对比两份载荷、fixture、配置或 API 响应，它就会在本地运行 CLI 并汇报差异。

支持的助手

• Claude Code
• OpenAI Codex CLI
• OpenCode
• Cursor
• 任何兼容 Agent Skills 格式的助手

安装

最快的安装方式是通过 npx skills——它会自动检测您已安装的所有助手，并把 skill 分发到每一个：

npx skills add unitstack/compare-json

快速示例

对比两个内联 JSON 字符串：

npx @compare-json/cli '{"name":"Alice"}' '{"name":"Bob"}'

或对比两个 JSON 文件：

npx @compare-json/cli base.json contrast.json

常用选项

• -a, --array-compare-method <method> — 数组比较策略：byIndex（默认）、lcs 或 unordered
• -k, --key-case-insensitive — 对比对象键时忽略大小写
• -v, --value-case-insensitive — 对比字符串值时忽略大小写
• --numeric-string-equals-number — 将数字字符串视为与数字相等，例如 "1" 等于 1
• -j, --json-export — 以 JSON 格式而非表格输出差异
• -o, --output <file> — 将差异结果写入文件

差异类型

• added — 对照 JSON 中存在但基准 JSON 中不存在的值
• deleted — 基准 JSON 中存在但对照 JSON 中不存在的值
• typeChanged — 两个 JSON 输入之间的值类型发生变化，例如 number → string
• valueChanged — 值发生变化但类型保持不变