前言¶
合同修订往往跨多轮：法务改一版、业务再改一版，最后签字页和正文还对不上。人工逐条对照 PDF 或 Word，费时且容易漏掉「删了一条违约责任」这类细节。通用对话模型可以帮你读文档，但缺少固定的解析、条款切分和结构化输出时，结果不稳定，也难以直接交给审批流。
下面介绍 SkillHub 社区技能 Contract Compare（坐标 @user_26bdbd50/contract-compare，版本 1.0.0）。它在 Agent 侧提供统一的 SKILL.md 工作流，并附带可执行的 Python 比对脚本，把两份或多份合同做成 Markdown 差异报告，在付费档位下还可导出 Excel 并做风险评估。
这是什么¶
Contract Compare（包内亦称「合同智能比对 / Contract Smart Compare」）是一款面向合同文档的 AI 差异分析 Skill：自动识别编号条款，对比新增、删除、修改，并生成结构化报告。
- 来源：SkillHub 社区（
community），发布者user_26bdbd50 - 分类：
professional - 平台信息（SkillHub 页面与索引）：评分 100000，下载 792 次；标签含
requires_api_key=true，表示运行比对需自行配置大模型 API Key
官方入口：
- SkillHub 页面：https://www.skillhub.cn/skills/user_26bdbd50/contract-compare
- 技能坐标页：https://api.skillhub.cn/user_26bdbd50/contract-compare
核心功能¶
以下能力来自技能包内 SKILL.md 与实现说明，按套餐划分。
条款提取与比对¶
- 智能条款提取：识别「第一条 / Article X」等编号条款；支持 TXT、DOCX；STANDARD 及以上支持 PDF；STANDARD 及以上可对 JPG/PNG 扫描件做 OCR。
- 差异分类：逐条对比，标记新增条款、删除条款、修改条款；PRO 支持多版本时间轴（3 份及以上）。
- 风险评估与摘要（PRO）：对差异条款给出高/中/低风险判断，并生成关键条款摘要。
- 输出格式：各档位均可输出 Markdown；STANDARD+ 可导出 Excel；PRO 另有风险摘要类报告。
套餐与限制（官方定价表）¶
| 套餐 | 月费 | 要点 |
|---|---|---|
| FREE | 免费 | 每月 5 次、2 份合同、仅 TXT/DOCX、Markdown 报告 |
| STANDARD | ¥29/月 | 不限次数、PDF/图片 OCR、差异分类、Excel 导出 |
| PRO | ¥99/月 | STANDARD 全部能力 + 多版本比对、风险评估、关键条款摘要 |
STANDARD/PRO 需配置订阅 Token CONTRACT_COMPARE_TOKEN（前缀 CONTRACT-COMPARE-），经 yk-global API 校验。收费订阅说明见技能文档中的 YK-Global.com。
安装与启用¶
1. 安装 SkillHub CLI（若尚未安装）¶
command -v skillhub && skillhub --version
未安装时可按 SkillHub 官方说明执行（完整安装示例）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2. 安装 Contract Compare¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。
skillhub install contract-compare --namespace user_26bdbd50 --dir ~/.cursor/skills/
其他常见路径（来自 SkillHub 安装文档）：Claude Code 为 ~/.claude/skills/；Codex 为 ~/.codex/skills/ 或项目下 .agents/skills/。按你实际使用的客户端替换 --dir。
也可让 Agent 按官方提示安装：参考 https://skillhub.cn/install/skillhub.md，安装 @user_26bdbd50/contract-compare。
3. Python 依赖与 OCR（可选）¶
进入技能目录后安装依赖：
pip install -r requirements.txt
需要图片 OCR 时，还需本机安装 Tesseract（技能文档给出 Ubuntu/macOS 示例命令）。
4. 环境变量¶
| 变量名 | 说明 | 必填 |
|---|---|---|
OPENAI_API_KEY |
OpenAI API Key | 与 Anthropic 二选一 |
ANTHROPIC_API_KEY |
Anthropic API Key | 与 OpenAI 二选一 |
CONTRACT_COMPARE_TOKEN |
STANDARD/PRO 月付 Token | 付费档必填 |
CLAUDE_MODEL |
模型名，默认 claude-sonnet-4-20250514 |
可选 |
AI 比对使用用户自备 Key；技能文档说明 Key 不由 Skill 存储或外传。上传文件默认落在 /tmp/contract-compare/ 临时目录。
典型用法¶
在技能根目录下，通过 python -m src.main 调用（路径与 SKILL.md 一致）。
两份合同比对¶
python -m src.main compare contract_a.pdf contract_b.pdf --label-a "合同V1" --label-b "合同V2"
指定输出文件：
python -m src.main compare contract_a.docx contract_b.docx -o diff_report.md
STANDARD+ 同时导出 Excel：
python -m src.main compare contract_a.pdf contract_b.pdf --excel -o report/
PRO 输出含未变更条款：
python -m src.main compare contract_a.docx contract_b.docx --include-same -o full_report.md
多版本比对（PRO）¶
python -m src.main multi v1.pdf v2.pdf v3.pdf \
--labels "初稿" "修改版" "终稿" \
--dates "2024-01-01" "2024-03-15" "2024-06-01" \
--output multi_version_report.md \
--excel
仅解析合同文本¶
python -m src.main parse contract.pdf --max-chars 3000
在 Cursor 等 Agent 中，安装 Skill 后可在对话里直接提供两份合同路径或附件，由 Agent 按 SKILL.md 引导选择命令与输出格式；具体交互取决于客户端是否将 skills 目录加载进上下文。
适用场景与注意¶
适合谁
- 法务、商务、项目经理：需要对比修订稿与定稿、或两轮谈判文本的差异清单。
- 已在用 Cursor / Claude Code 等支持 Skills 的环境，希望把「读合同 + 出报告」固化成可重复流程的团队。
限制与注意
- API Key：
requires_api_key=true；未配置OPENAI_API_KEY或ANTHROPIC_API_KEY无法完成 AI 比对。 - 格式与档位：FREE 仅 TXT/DOCX，且有每月 5 次、单次 2 文件限制；PDF/OCR/Excel/多版本/风险功能需 STANDARD 或 PRO。
- 文件大小：实现中单文件上限为 10MB（
config.py）。 - 技术栈：PDF 依赖 PyMuPDF、pdfplumber；Word 为 python-docx；Excel 为 openpyxl；网络请求超时 10 秒。
- 社区来源：发布者为社区用户
user_26bdbd50，使用前请结合企业合规要求审阅技能包代码与外传策略。
结尾¶
Contract Compare 把合同比对从「人工翻页」收敛为「条款级差异 + 可选风险与 Excel」，适合挂在 Agent Skills 里做 repeatable 的审阅辅助。安装走 SkillHub 坐标 @user_26bdbd50/contract-compare，比对细节以包内 SKILL.md 为准。
官方页面：https://www.skillhub.cn/skills/user_26bdbd50/contract-compare
