Contract Review Pro

---

V4.0 更新摘要

本次升级主题：完全自包含 + 输出呈现升级。Skill 不再依赖任何外部规则文件、知识库路径或工具，自身即可完成全部审核工作。

架构升级

V3.0:  7步工作流 + Markdown 意见书 + 依赖工作区条款库/知识库路径

V4.0:  ContractReviewSession（有状态会话，完全自包含）
       ├── Step 0:   客户识别 + 立场声明（必守/可谈二分）
       ├── Step 1.5: 合同类型路由 → references/gates/ 专项门禁
       ├── Step 2.5: 框架审阅四问
       ├── Step 3:   ContractAnalyzer.run_validity_review() 效力优先
       ├── Step 5:   分层检索 + ≥5 条充分性标准（AI 执行）
       ├── Step 6:   ClauseReviewer.review_clause_dual()
       │             RevisionRouter（5 分类动作）
       │             RiskScoringSystem（8 维度 1-5 分制 + 严重程度下限）
       ├── Step 7:   ClauseExtractor.scan_for_candidates()
       └── Output:   三件套 .docx（document_generator 版式规范内置）
                     + 批注版（docx_generator 双引擎：docx skill / ooxml_lite）
                     + HTML 可视化报告（html_report_generator，可选）

---

核心特性

🛡️ 系统性

• 7步有状态工作流：立场声明 → 类型路由 → 框架审阅 → 效力优先 → 逐条审核 → 条款提取
• 5类通用门禁 + 16个专项门禁：13 类合同专项 + 3 个条款级深挖（反稀释/回购/对赌）
• 15标签风险体系：覆盖效力合规、交易履行、争议文本三大维度
• 六维度风险评价：定性/敞口/概率/可规避性/商业权衡/紧迫性，拒绝笼统"高风险"

📋 专业性

• 正反两面法：正面审查 → 反面审查 → 救济执行，三层递进不遗漏
• 修订 5 分类路由：replace/insert/delete/comment/report-only + 4 问自检 + 最小必要修改
• 三层方法论：深度审核时启用宏观交易结构 → 中观合同形式 → 微观合同条款分析
• 内置条款标准：18 类标准条款 CSV + 可选项目级条款库扩展，三步匹配法精准调用

🚀 实用性

• 终稿三件套：批注版合同 + 法律意见书 + 法律分析，全部 .docx（意见书含版式规范与客户速览页）
• HTML 可视化报告：8 维雷达 + 风险热力图 + 条款对比卡，单文件离线可开
• Track Changes 原生修订：OOXML 标准，Word 直接接受/拒绝修订；内置引擎零依赖兜底
• 条款自动提取：扫描值得入库的条款写法，持续丰富条款库

📊 数据驱动

• 30种合同类型：覆盖7大业务领域，每种配有专属风险模板
• 124个风险点模板：含15标签标注、8维度归类、六维度占位
• 53项审查检查清单：按5类门禁分组，标注可自动检测项
• 18类标准条款模板：含触发条件和插入优先级

---

支持的合同类型（30种）

覆盖中国大陆民商事合同的主要类型，按业务领域分为七大类别：

📦 物权与买卖类（5种）

买卖合同、租赁合同、赠与合同、土地承包合同、商品房买卖合同

🔧 服务与承揽类（8种）

服务合同（通用）、承揽合同、委托合同、中介合同、仓储合同、物业服务合同、特许经营合同、旅游合同

🏢 公司与组织类（5种）

股权转让合同、增资扩股协议、对赌协议、一致行动协议、合伙合同

💰 金融与证券类（4种）

借款合同、担保合同、保险合同、证券服务合同

👥 劳动与人事类（3种）

劳动合同、劳务派遣合同、竞业限制协议

💻 技术类（2种）

技术开发合同、技术转让合同

🏗️ 建设工程类（3种）

建设工程合同、工程监理合同、勘察设计合同

每种合同类型对应专属的风险模板、审查清单和条款标准，可自动匹配。详见 data/contract_types.csv。

---

核心工作流（7步）

┌─────────────────────────────────────────────────────┐
│  Step 0: 识别客户 + 立场声明（强制）                  │
│  代表方/核心利益排序/必守项 vs 可谈项，每次重做         │
└──────────────────────┬──────────────────────────────┘
                       ↓
┌─────────────────────────────────────────────────────┐
│  Step 1: 建立 review-state                           │
│  源文件、客户、立场、交易结构、风险预分类（8维度1-5分） │
└──────────────────────┬──────────────────────────────┘
                       ↓
┌─────────────────────────────────────────────────────┐
│  Step 1.5: 合同类型路由                               │
│  激活 references/gates/ 专项门禁（13类+3条款级）       │
└──────────────────────┬──────────────────────────────┘
                       ↓
┌─────────────────────────────────────────────────────┐
│  Step 2: 通读合同                                    │
│  梳理主体/标的/价款/交付/结算/违约/解除/担保/争议/附件 │
└──────────────────────┬──────────────────────────────┘
                       ↓
┌─────────────────────────────────────────────────────┐
│  Step 2.5: 框架审阅（四问）                           │
│  义务单向性/退出权不对等/虚假前提/违约对称性           │
└──────────────────────┬──────────────────────────────┘
                       ↓
┌─────────────────────────────────────────────────────┐
│  Step 3: 效力审查优先 ⚠️                             │
│  5项检查（名实不符/关联交易/格式条款/审批/成立要素）    │
└──────────────────────┬──────────────────────────────┘
                       ↓
┌─────────────────────────────────────────────────────┐
│  Step 4: 列出法律问题清单                             │
│  需研究的实质性法律问题，标注风险标签                    │
└──────────────────────┬──────────────────────────────┘
                       ↓
┌─────────────────────────────────────────────────────┐
│  Step 5: 法律研究（分层检索）                         │
│  检索改写 → 优先源 → ≥5条充分性判断 → 来源标注         │
└──────────────────────┬──────────────────────────────┘
                       ↓
┌─────────────────────────────────────────────────────┐
│  Step 6: 逐条审核                                    │
│  正反两面法 × 六维度评价 × 修订5分类路由                │
└──────────────────────┬──────────────────────────────┘
                       ↓
┌─────────────────────────────────────────────────────┐
│  Step 7: 条款提取                                    │
│  扫描候选条款 → 输出到 candidates/                     │
└──────────────────────┬──────────────────────────────┘
                       ↓
┌─────────────────────────────────────────────────────┐
│   输出终稿三件套 .docx + HTML 可视化报告（可选）✅     │
└─────────────────────────────────────────────────────┘

---

审查门禁（5类）

---

修订方式路由决策树

错别字/笔误/标点/日期格式/法律名称过时 → Track Changes 直接修订
对我方有利且可直接落地的增补条款 → Track Changes 直接补充：
  · 实现债权费用、送达确认、签章生效、声明与保证
  · 限制收款方式、反商业贿赂、独立关系声明、一人公司补充
条款矛盾/文本不一致 → Comments 指出矛盾，给出倾向性建议
商业取舍/重大风险/对方可能不接受 → Comments 列出方案
事实待核 → Comments 标注
多方案需客户选择 → Comments 列出方案并标注倾向

4问自检（每条审核意见必问）：

1. 我能替客户直接改吗？→ 能则 Track Changes
2. 涉及商业判断吗？→ 是则 Comments
3. 对方大概率会接受吗？→ 是则 Track Changes（标注告知客户）
4. 有多个合理方案吗？→ 是则 Comments，列出方案

---

风险标签体系（15标签）

效力与合规类：合同效力 格式条款 主体授权 关联交易 合规审查

交易结构与履行类：价款与支付 交付与验收 违约责任 解除与终止 担保与增信

争议解决与文本类：争议解决 知识产权与保密 定义与附件 文本一致性 文字与格式

---

风险评价六维度

---

终稿三件套

output/ 默认产出（全部 .docx），可选第四件 HTML 可视化报告：

1. 批注版合同

Track Changes + Comments，双引擎自动分派（环境存在 docx skill 时用其 Document library，否则用内置 ooxml_lite 引擎），禁止 python-docx 裸 API。OOXML 编辑纪律内置：del+ins 配对、独立段落插入、最短锚点、跨 `` 分片拼接匹配。

2. 法律意见书（客户速览页 + 5 模块）

客户速览页（结论段 + Top 风险 + 谈判要点）→ 风险总览（数量卡片+雷达图+类型分布+综合等级）→ 合同基本信息 → 逐条审核意见（七列表格）→ 总体评价与签约利弊分析（含"清单之外的一个问题"强制追问）→ 法律依据清单。 版式规范内置：深蓝标题 + 仿宋正文 + 浅底元信息卡 + 棕色标签 + 页脚页码 + 紧凑正式件参数。

3. 法律分析

内部参考，修订点对应的法条/司法解释/指导案例/类案裁判规则。

4. HTML 可视化报告（可选）

8 维雷达图 + 风险热力图 + 条款对比卡 + 等级筛选器 + 谈判策略三层标签，单文件离线可开（Chart.js 已内联）。

核心原则：律师分析利弊，客户做决定。 禁止以"建议签署""不建议签署"替代利弊分析。

---

数据规模

• 合同类型：30种，覆盖7大业务领域
• 风险点模板：124个，每个含15标签标注、8维度归类、六维度占位、默认修订方式
• 审查检查清单：53项，按5类门禁分组，标注可自动检测项
• 专项门禁：16 个（13 类合同 + 3 条款级），全部内置于 references/gates/
• 标准条款：18类模板，含触发条件和插入优先级
• 路由规则：23条（含 5 分类动作列），覆盖错别字到多方案选择的完整决策链
• 代码规模：~5,000行，13个核心模块

---

项目结构

contract-review-pro/
├── SKILL.md                    # AI 面向指令文档（V4.0）
├── main.py                     # 主入口 + ContractReviewSession
├── skill.json                  # Skill 元数据（V4.0）
├── README.md                   # 本文件
│
├── scripts/                    # 核心模块（13个）
│   ├── review_config.py        # 审核配置 + ClientConfig
│   ├── contract_analyzer.py    # 合同解析 + 效力审查 + 门禁
│   ├── risk_assessment.py      # 风险评估 + 六维度
│   ├── clause_review.py        # 正反两面法 + 条款库匹配
│   ├── revision_router.py      # 修订 5 分类路由 + 4 问自检
│   ├── clause_extractor.py     # 自动条款提取
│   ├── intelligent_scoring.py  # 8 维度 1-5 分制评分 + 严重程度下限
│   ├── sanguan_analysis.py     # 宏观-中观-微观三层分析
│   ├── document_generator.py   # 三件套 docx 生成（版式规范内置）
│   ├── docx_generator.py       # 批注版（双引擎自动分派）
│   ├── ooxml_lite.py           # 内置 OOXML 引擎（零依赖兜底）★V4.0
│   └── html_report_generator.py # HTML 可视化报告 ★V4.0
│
├── references/gates/           # 专项门禁（16 个，V4.0 内化）★V4.0
│   ├── 08-建设工程.md ... 20-VCPE增资.md   # 13 类合同专项门禁
│   └── clause-gates/           # 条款级门禁（反稀释/回购/对赌）
│
├── assets/                     # HTML 报告资产 ★V4.0
│   ├── report_template.html    # 报告模板（数据占位符注入）
│   └── chart.umd.min.js        # Chart.js 本地化（无 CDN 依赖）
│
├── data/                       # 数据文件（7 个 CSV）
│   ├── contract_types.csv      # 30 种合同类型
│   ├── risk_templates.csv      # 124 个风险点
│   ├── clause_standards.csv    # 18 类标准条款
│   ├── review_checklists.csv   # 53 项检查清单
│   ├── risk_labels.csv         # 15 标签体系
│   └── revision_routing.csv    # 23 条路由规则（含 5 分类动作列）
│
├── docs/archive/               # V1-V2 历史文档归档（含外部书目的旧引用，仅历史记录）
└── output/                     # 终稿输出目录

---

快速开始

安装

# 克隆仓库
git clone https://github.com/CSlawyer1985/contract-review-pro.git

# 复制到 Claude Code skills 目录
cp -r contract-review-pro ~/.claude/skills/

基础用法（向后兼容）

from main import quick_review

result = quick_review(
    contract_text=contract_text,
    contract_name='A公司B公司买卖合同',
    user_context={'party': '甲方', 'position': '平等'},
    review_depth='standard'
)

完整工作流（7 步会话）

from main import review_with_workspace_config

result = review_with_workspace_config(
    contract_path='/path/to/contract.docx',
    workspace_path='/path/to/your/project',   # 可选：你的项目目录（含 client-rules/clauses 时自动加载）
    client_name='示例客户',                    # 可选，自动识别备选
    user_context={'party': '甲方'},
    depth='standard'
)
# result['outputs'] → {'opinion': ..., 'analysis_doc': ..., 'annotated': ..., 'html_report': ...}

workspace_path 是可选增强：指向你自己的项目目录时，skill 会加载其中的客户规则与条款库；不提供时 skill 以内置门禁、条款标准和检查清单独立完成全部审核。

---

条款库使用

内置标准条款库 data/clause_standards.csv（18 类标准条款）为默认条款来源；用户可在自己的项目目录建 .claude/clauses/ 扩展条款库，存在则自动加载，不存在不影响任何流程。

三步匹配法：

1. 理解场景（合同类型、当事人关系、风险等级）
2. 匹配写法（基础版 vs 强化版，按标的额和对方资信选择）
3. 适配调整（变量替换、表述统一、删去不适用内容）

禁止不经适配直接复制条款文本。

---

硬约束

1. 禁止跳过立场声明
2. 禁止跳过通读直接审核
3. 禁止跳过实质性法律问题研究（含充分性判断）
4. 禁止跳过效力审查
5. 禁止先写审核意见后补法律依据
6. 禁止修改原始合同
7. 禁止用 python-docx 裸 API 生成批注版合同
8. 禁止将 .md 作为终稿交付
9. 禁止将应 Track Changes 的增补条款降级为 Comments
10. 禁止在未命中客户规则时套用其他客户偏好
11. 禁止无声降级上游风险评级（跨阶段降级必须明示理由）
12. 禁止依赖 skill 目录之外的规则文件、知识库路径或工具（可选增强除外）
13. 禁止编造法律依据；检索不足时如实标注

---

适用场景

---

版本历史

---

常见问题

Q1：这个 Skill 适合哪些人群使用？

A：

• 律师/法律顾问：合同审查、风险评估、法律意见书撰写
• 企业法务：日常合同审核、合规管理、条款模板维护
• 法学教师/学生：学习合同审查方法论、了解实务审查流程
• 当事人：初步合同风险评估、条款理解辅助

Q2：AI 生成的审核意见可以直接使用吗？

A：不可以。 AI 生成的内容必须经过专业法律人士审核：

• 核对法律引用是否正确
• 确认风险判断是否合理
• 结合具体交易背景调整建议
• 最终意见由执业律师签字确认

Q3：支持的合同类型会继续增加吗？

A：会的。目前覆盖30种民商事合同类型，后续计划扩展至更多细分领域（如PPP合同、特许经营协议、数据合规协议等）。

Q4：如何处理客户特定的审查偏好？

A：ClientConfig 模块自动识别客户并加载项目目录 .claude/client-rules/ 下的偏好配置（用户自建，可选）。未命中时不套用任何客户规则，避免张冠李戴。

---

贡献指南

欢迎任何形式的贡献！

1. 报告 Bug：在 GitHub Issues 中提交问题
2. 提出建议：在 GitHub Discussions 中讨论新功能
3. 提交代码：Fork 仓库，创建分支，提交 Pull Request
4. 完善文档：改进文档内容，修正错误
5. 分享案例：提供优秀或典型的合同审查案例

---

免责声明

• 本 Skill 提供的合同审核仅供参考，不构成正式法律意见
• AI 生成内容必须经专业法律人士审核
• 使用本系统产生的法律后果由使用者承担
• 使用者应结合具体交易情况独立判断

---

作者信息

职业身份

• 浙江海泰律师事务所高级合伙人
• 专业领域：建筑房地产、公司法、投融资及商事争议解决
• 执业年限：15+ 年

学术背景

• 著作：《赋能法律人：AI 底层思维与应用范式》（2025年12月出版）
• 研究方向：AI 与法律的深度融合应用
• 实务经验：承办大量民商事案件、建设工程纠纷、公司股权纠纷等

技术专长

• AI + 法律：AI 与法律的深度融合探索
• Prompt Engineering：设计结构化、高精度的 Prompt 完成复杂法律任务
• 跨学科思维：结合哲学、控制论、社会进化论等进行深度思考

主要成果

• China Lawyer Analyst Skill — 专业中国法律分析 Claude Skill（v4.0）
• Contract Review Pro — 专业合同审核 AI 系统（v4.0）
• Excellent Judgment Doc Skill — 优秀裁判文书生成与质量评判工具
• Case Type Guide System — 类案办案要件指南智能辅助系统

联系方式

• Email：[email protected]
• 地址：浙江海泰律师事务所
• GitHub：CSlawyer1985

---

许可说明

本 Skill 基于 MIT 开源协议，供法律实务工作者和 AI 系统使用。

允许：

• 自由使用和学习
• 在法律实务中应用
• 基于此 Skill 进行改进和优化
• 分享和传播（请保留作者信息和数据来源）

---

Star History

如果这个项目对你有帮助，请给它一个 Star！

---