前言¶
做合同修订、条款比对这类工作时,常见痛点是:两份 PDF 或 Word 放在面前,人工逐段核对差异,再把结论整理成可用于评审或下游处理的格式。文件一多,这一步既费时又容易漏。calliper-compare2markdown 就是针对这个环节的 Skill:输入两份本地文档,同步返回一份结构化的 Markdown 差异表,不需要人工先做转换或标注。
这是什么¶
calliper-compare2markdown 是一个基于通用 SKILL.md 格式的文档比对 Skill,由社区发布者 user_15292d5a 发布,来源为 community,分类为 office-efficiency,当前版本 1.0.0。它解决的问题是:把两份本地文档的差异,一次性转成 LLM 可直接使用的 Markdown,供变更审查、条款比对、下游抽取或规则校验使用。
核心功能¶
下面是该 Skill 在官方简介中说明的能力:
- 同步调用:比对与转换在一次调用中完成,输入两份本地文档,输出一份 LLM 可用的 Markdown。
- 输入覆盖:支持 PDF、Word、PPT,以及 Calliper 接受的图像文档。
- 输出形态:结构化的 Markdown 差异表,不是原始文件或截图。
- 适用环节:变更审查(change review)、条款比对(clause comparison)、下游抽取(downstream extraction)、规则校验(rule-based validation)。
- API key:标签为 requires_api_key=true,即使用前必须配置 API key。
安装与启用¶
该 Skill 在 SkillHub 上的坐标与地址如下:
坐标: @user_15292d5a/yjkj-calliper-compare2markdown
官方页面: https://www.skillhub.cn/skills/user_15292d5a/yjkj-calliper-compare2markdown
API 地址: https://api.skillhub.cn/user_15292d5a/yjkj-calliper-compare2markdown
版本号:1.0.0。发布者标注 requires_api_key=true,因此启用前需要先准备好 Calliper 的 API key,否则调用无法通过校验。
关于具体安装命令、支持的客户端(如 Cursor、Codex CLI、Claude Code)以及配置字段的写法,本次抓取的资料中没有包含这些内容,网页也无法打开核实,因此不在此给出未经确认的命令。请以官方页面上的安装说明为准,不要把第三方写法当成官方配置。
典型用法¶
官方简介描述的调用形态是:提供两份本地文档,加上有效的 API key,由 Skill 在一次同步调用内完成比对,返回结构化的 Markdown 差异表。资料中没有给出带具体参数名的可复现示例,这里不编造参数与返回样例;接入方式请参照官方页面的说明。
适用场景与注意¶
适合谁:
- 需要对比同一文档两个版本、找出增删改的用户,例如合同修订、标书版本核对。
- 需要把差异结果直接交给 LLM 做抽取或校验的开发者,避免人工整理格式。
限制与坑:
- 必须配置 API key,这是硬前提。
- 输入文档类型限于 Calliper 接受的范围;图像文档按 Calliper 的接受口径处理。
- 返回结果是 Markdown 差异表,适合机器读取,不等于人工逐字校对,涉及法律效力的条款仍需人工复核。
- 截至 2026-10-30 的抓取资料,该 Skill 评分 100000、下载 639 次、安装 0 次,安装量为 0,采用前建议先按官方页面验证。
结尾¶
calliper-compare2markdown 的价值在于把「两份文档找差异」和「差异转成 LLM 可用格式」合并成一次同步调用,省去中间的人工整理。需要的话,从官方地址入手:https://www.skillhub.cn/skills/user_15292d5a/yjkj-calliper-compare2markdown