前言¶
法务和商务在审合同时，常见情况是同一合同来回改了好几版：邮件附件、扫描件转文字、对方回传的修订稿叠在一起，人工逐段对照既慢，也容易漏掉金额、期限或违约责任上的改动。用通用 diff 工具可以标出字面变化，但往往缺少「关键条款 / 一般条款 / 格式调整」的分层，也不方便直接整理成给对方确认的说明。
下面介绍 SkillHub 社区技能「合同差异比对」（@user_70c2f807/contract-diff-comparison）。它通过标准 SKILL.md 约束 Agent 的行为：在用户提供两份合同文本的前提下，做增删改对齐、分级汇总，并可按需要生成差异确认函草稿。该技能标注 requires_api_key=false，不依赖额外 API Key。
这是什么¶
「合同差异比对」是面向办公效率（SkillHub 分类 office-efficiency）的 Agent Skill，坐标 @user_70c2f807/contract-diff-comparison，当前版本 1.0.0，来源为 community，发布者为 user_70c2f807。
一句话定位：上传或粘贴原版与修改版两份合同文本，由 Agent 按技能说明执行逐段对比，输出结构化差异报告；不提供法律咨询或条款合法性判断，只做文字层面的差异描述。
官方入口：
- SkillHub 页面：https://www.skillhub.cn/skills/user_70c2f807/contract-diff-comparison
- API 资源标识：https://api.skillhub.cn/user_70c2f807/contract-diff-comparison
核心功能¶
以下能力均来自该技能包内的 SKILL.md 说明，由 Agent 在对话中按步骤执行。
- 双文本对比：对齐两份文本，标记新增、删除、同位置修改；可确认对比方向（A→B 或 B→A）。
- 分级与分类：将变更分为关键条款（如金额、期限、责任、违约金、知识产权）、一般条款与格式调整（标点、编号、空格等）。
- 关键数据识别：在差异中突出金额、日期、百分比等字段变动，关键变更可附带影响说明（如比例变化），但不作法律评价。
- 筛选与统计：支持按章节、按类型或按维度（例如只看金额和日期）缩小结果范围，并统计变更数量。
- 差异确认函：在用户需要时，基于比对结果生成发给对方的确认邮件模板。
- 触发与边界：适用于用户提到合同比对、合同差异、版本对比、
contract diff等意图；不用于合同撰写、合同审查、法律咨询、合同签署等场景。
安装与启用¶
安装 SkillHub CLI¶
若尚未安装 CLI，可先检查版本：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 官方安装文档执行（完整安装或仅 CLI）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
说明见：https://skillhub.cn/install/skillhub.md
安装本技能¶
安装时必须用 --dir 指向当前 Agent 实际使用的 skills 目录，否则默认会装到 ./skills/，Agent 可能无法加载。
skillhub install contract-diff-comparison --namespace user_70c2f807 --dir <你的 skills 目录>
常用客户端 skills 路径（摘自 SkillHub 安装文档，以你本机配置为准）：
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
也可将下面提示词交给支持 Skill 安装的 AI，让其按官方说明完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_70c2f807/contract-diff-comparison`。
安装完成后，按你所用客户端的要求重启或刷新 Agent，使技能生效。
典型用法¶
技能说明中的「快速开始」给出了可复现的对话模式，核心是先凑齐两份文本，再让 Agent 按 SKILL.md 的四步流程（接收文本 → 差异分析 → 分级分类 → 输出报告）执行。
1. 发起对比
用户：帮我对比两份合同
→ Agent：请分别提供原版和修改版合同内容
2. 提供双版本内容
将原版与修改版粘贴到对话中（或说明两份附件对应关系），并必要时标明哪份为基准版本。
3. 缩小关注点
用户：哪些是关键条款的改动？
→ 筛选金额、期限、责任、违约金等相关修改
用户：只看金额和日期的变化
→ 按指定维度筛选差异
4. 生成对外确认材料
用户：帮我生成差异确认函
→ 基于差异结果生成邮件模板
报告默认以 Markdown 结构输出（含关键 / 一般 / 格式变更分区及对照表），可复制到飞书文档、Notion 或 Word。技能 FAQ 说明：PDF、Word 需先转为文本再粘贴；单次对比建议不超过 5000 字，超长合同宜分章节多次对比。
适用场景与注意¶
适合谁
- 需要快速核对同一合同两个版本之间改动的法务、商务、项目经理。
- 已在 Cursor、Claude Code、Codex 等支持 Skill 的环境里工作，希望用统一话术驱动比对流程的团队。
限制与坑
| 项目 | 说明 |
|---|---|
| 输入份数 | 必须提供原版与修改版；仅一份文件无法完成对比 |
| 法律效力 | 只做文字差异描述，不替代法务审查 |
| 文件格式 | 以纯文本、Markdown 为宜；PDF/Word 需先导出为文本 |
| 长度 | 单次建议不超过 5000 字，否则应分章节 |
| 多版本 | 三个及以上版本建议两两对比（如先 A vs B，再 B vs C） |
| 误用 | 不宜用于代码 diff、从零写合同、或期望 Agent 做合规风险裁决 |
技能说明中的错误处理表覆盖了「只提供一份」「内容完全一致」「差异过大疑似非同一份合同」「文本过长」等场景，Agent 会按表内提示语回应。
隐私相关说明（来自技能文档）：不存储上传内容，对比后不保留数据；涉及真实公司名、金额时，建议先脱敏再粘贴。
结尾¶
「合同差异比对」把双版本合同比对拆成可重复的 Agent 工作流：对齐增删改、按关键程度分层、可选确认函，并明确不做法律判断。若你经常在多轮修订里核对条款，可在 SkillHub 安装 @user_70c2f807/contract-diff-comparison 后，用固定触发词直接拉起这套流程。
- SkillHub：https://www.skillhub.cn/skills/user_70c2f807/contract-diff-comparison
- 坐标：
@user_70c2f807/contract-diff-comparison，版本 1.0.0（社区来源；页面展示评分 100000，下载量以 SkillHub 实时统计为准，撰写时抓取记录为 1865 次下载）
