Skills

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

它能做什么

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

支持的助手

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

安装

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

npx skills add unitstack/compare-xml

快速示例

对比两个内联 XML 字符串:

npx @compare-xml/cli '<root><name>Alice</name></root>' '<root><name>Bob</name></root>'

或对比两个 XML 文件:

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

常用选项

  • -a, --array-compare-method <method> — 数组比较策略:byIndex(默认)、lcsunordered
  • -k, --key-case-insensitive — 对比元素和属性名时忽略大小写
  • -v, --value-case-insensitive — 对比文本和属性值时忽略大小写
  • -j, --json-export — 以 JSON 格式而非表格输出差异
  • -o, --output <file> — 将差异结果写入文件

差异类型

  • added — 对照 XML 中存在但基准 XML 中不存在的值
  • deleted — 基准 XML 中存在但对照 XML 中不存在的值
  • valueChanged — 两个 XML 输入之间的值发生变化