AI 编码助手 XML Skills

安装 Agent Skill,让助手在本地运行 Compare XML CLI。

一份 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(默认)、lcs 或 unordered
  • -k, --key-case-insensitive —— 对比元素和属性名时忽略大小写
  • -v, --value-case-insensitive —— 对比文本和属性值时忽略大小写
  • -j, --json-export —— 以 JSON 而非表格输出差异
  • -o, --output <file> —— 将差异结果写入文件

无序对比采用多重集语义,因此重复项的出现次数仍然重要。全部命令请参阅 CLI 指南,选项行为请参阅 XML 对比规则。

差异类型

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