前言¶
法務和商務在審合同時，常見情況是同一合同來回改了好幾版：郵件附件、掃描件轉文字、對方回傳的修訂稿疊在一起，人工逐段對照既慢，也容易漏掉金額、期限或違約責任上的改動。用通用 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 次下載）
