/iflytek-contract-intelligence-review

Contract Intelligence Review Skill

场景化合同智能审核 Workflow Skill

概述

本 Skill 是一个场景编排层，负责协调合同审核全流程，而非单一原子 API 调用。它整合了文档识别、文本提取、条款分析、风险检测、合规校对、翻译等能力，输出结构化审核报告。

适用场景

目录结构

contract-intelligence-review/
├── SKILL.md                    # Skill 定义入口
├── README.md                   # 本文件
├── _meta.json                  # 扩展元数据（可选）
├── templates/
│   ├── review_report.md       # Markdown 报告模板
│   └── review_output.json     # JSON 输出模板
├── examples/
│   ├── sample_contract_excerpt.md   # 示例合同片段
│   └── sample_review_report.md     # 示例审核报告
├── scripts/
│   ├── main.py                # 主入口，argparse CLI
│   ├── config.py              # 配置管理
│   ├── errors.py              # 自定义异常
│   ├── clients/               # 抽象客户端层
│   │   ├── __init__.py
│   │   ├── ocr_client.py      # OCR 客户端抽象
│   │   ├── image_client.py    # 图像理解客户端抽象
│   │   ├── translate_client.py # 翻译客户端抽象
│   │   └── llm_review_client.py # LLM 审核客户端抽象
│   ├── processors/            # 业务处理器
│   │   ├── __init__.py
│   │   ├── ingest.py          # 输入预处理
│   │   ├── text_cleaner.py    # 文本清洗
│   │   ├── clause_splitter.py # 条款分段
│   │   ├── risk_detector.py   # 风险检测
│   │   ├── compliance_checker.py # 合规检查
│   │   ├── bilingual_checker.py  # 双语一致性检查
│   │   └── report_builder.py # 报告生成
│   └── utils/
│       ├── __init__.py
│       ├── file_utils.py      # 文件工具
│       ├── logger.py          # 日志工具
│       └── validation.py      # 输入验证

依赖能力说明

本 Skill 为编排层，底层能力通过抽象客户端接入：

注意：具体实现需根据实际可用的 SDK/API 注入。当前为抽象接口，保留接入任意实现的空间。

环境变量

本地运行方式

安装依赖

# 创建虚拟环境（推荐）
python -m venv venv
source venv/bin/activate  # Linux/macOS
# 或 venv\Scripts\activate  # Windows

# 安装依赖
pip install -r requirements.txt

运行示例

# 基础运行
python scripts/main.py --input ./contract.pdf

# 指定审核模式
python scripts/main.py --input ./contract.pdf --review-mode deep

# 重点审查付款条款
python scripts/main.py --input ./contract.pdf --focus payment --focus liability

# 需要翻译摘要
python scripts/main.py --input ./contract.pdf --need-translation --lang en

# 输出 JSON 格式
python scripts/main.py --input ./contract.pdf --output-format json

# 保存中间结果
python scripts/main.py --input ./contract.pdf --save-intermediate --output-dir ./output

参数说明

输出说明

Markdown 报告结构

# 合同智能审核报告

## 文档基本信息
- 文件名：xxx
- 页数：xx
- 语言：xx

## 输入质量评估
- OCR 识别率：xx%
- 识别不确定区域：xx 处

## 审核模式
- 审核深度：standard
- 重点关注：付款条款、违约责任

## 风险清单
### 高风险
- [风险项] [推断] 原文片段...

### 中风险
- [风险项] [建议] ...

## 规范性校对问题
- ...

## 人工复核建议
- ...

JSON 输出结构

{
  "document_meta": {
    "filename": "xxx",
    "page_count": xx,
    "language": "zh",
    "input_type": "pdf_scan"
  },
  "extraction_quality": {
    "ocr_confidence": 0.95,
    "uncertain_regions": [],
    "extracted_text": "..."
  },
  "clauses": [...],
  "risks": [
    {
      "category": "payment",
      "level": "high",
      "description": "...",
      "source": "推断",
      "evidence": "原文片段"
    }
  ],
  "compliance_issues": [...],
  "translation_summary": "...",
  "uncertain_items": [...],
  "human_review_required": ["..."],
  "final_summary": "..."
}

常见错误

风险规则扩展

风险检测规则定义在 scripts/processors/risk_detector.py 中，每个风险类别包含：

• category: 风险类别标识
• keywords: 触发关键词
• patterns: 正则匹配模式
• level: 默认风险等级
• description: 风险描述模板
• suggestion: 审核建议模板

新增风险规则时，参考现有规则格式添加至对应类别。

条款规则扩展

条款识别规则定义在 scripts/processors/clause_splitter.py 中，可扩展：

• 条款标题模式
• 条款边界识别规则
• 条款主题分类器

模板扩展

报告模板位于 templates/ 目录：

• review_report.md: Markdown 报告模板
• review_output.json: JSON 输出模板

修改模板后需保持变量占位符一致。

设计原则

1. 场景编排而非原子封装：本 Skill 整合多个底层能力，输出完整审核结果
2. 抽象客户端：底层能力通过接口抽象，便于替换实现
3. 不确定性显式标记：识别质量、风险判断的不确定因素必须明确标出
4. 部分结果返回：任一步骤失败时尽量返回可用的部分结果
5. 分级审核：支持 quick/standard/deep 三种审核深度
6. 输入类型自适应：自动识别文件类型并选择处理链路