Contract Auditor

---
name: contract-auditor
description: >-
  合同审计 Skill - AI 辅助审查合同条款，识别风险和问题 功能： - 自动提取合同文本（Word 格式） - 审查金额条款（一致性、付款节点、违约金） -
  审查交付条款（时间、标准、延期责任） - 审查合规性（签章、日期、关键条款） - 风险提示（不利条款、模糊表述） - 生成审计报告 + 批注文档
---

# Contract Auditor - 合同审计

AI 辅助合同审查工具，自动识别合同中的风险点和问题条款，生成审计报告和批注文档。

## 功能特性

| 审查维度 | 检查项 |
|:---|:---|
| **金额条款** | 大小写金额一致性、付款节点、违约金、发票类型 |
| **交付条款** | 交付时间、验收标准、延期责任、交付物清单、知识产权 |
| **合规性** | 签章、签署日期、合同期限、主体信息、争议解决、法律适用、不可抗力、保密、变更解除 |
| **风险提示** | 模糊表述、不利条款、权利义务对等、争议解决偏向性 |

## 使用方法

### 1. 私聊发送合同文件

直接发送 Word 合同文件（.doc/.docx），AI 自动审查并返回：
- **审计报告**：风险等级、问题统计、详细建议
- **批注文档**：在原合同文本上标注问题位置

### 2. 查看审计结果

**审计报告包含**：
- 风险等级评估（高/中/低）
- 问题统计（按严重程度、类别）
- 详细发现项（问题描述 + 修改建议）

**批注文档包含**：
- 合同正文（带批注标记）
- 批注图例说明
- 审计摘要
- 完整问题清单

## 示例

**输入**：发送合同文件 `技术服务合同.docx`

**输出**：

```
📋 合同审计完成

风险等级: 🟡 中
发现问题: 8 项

【审计报告】
1. 🔴 [高] 签署日期: 合同未明确约定签署日期
   建议: 必须填写合同签署日期

2. 🟡 [中] 金额条款: 大小写金额不一致
   建议: 核对并统一金额表述

...

【批注文档】
已生成带批注的合同文档，标注了所有问题位置
```

## 输出格式

### 审计报告（Markdown）
```markdown
# 合同审计报告：xxx.docx

**风险等级**: 🟡 中
**发现问题**: 8 项

## 摘要
### 按严重程度
- 🟠 高: 2 项
- 🟡 中: 5 项
- 🟢 低: 1 项

## 详细发现
### 1. 🟠 [高] 签署日期
**问题**: ...
**建议**: ...
```

### 批注文档（Markdown）
```markdown
# 带批注的合同：xxx.docx

## 合同正文（带批注）
第一条 合同金额
本合同总金额为人民币壹拾万元整。
>>> 🟡 [MEDIUM] 金额条款
>>>   问题：合同仅有中文大写金额
>>>   建议：建议同时标注阿拉伯数字金额
```

## 技术实现

```
services/
├── contract_auditor.py      # 主审计器
├── text_extractor.py        # 文本提取
├── annotator_simple.py      # 批注文档生成
└── analyzers/
    ├── payment_analyzer.py      # 金额条款分析
    ├── delivery_analyzer.py     # 交付条款分析
    ├── compliance_checker.py    # 合规性检查
    └── risk_analyzer.py         # 风险提示
```

## 版本规划

- **v1.0** (当前): Word 格式支持，4 维度审查，批注文档生成
- **v1.1**: PDF 格式支持、图片 OCR
- **v1.2**: ✅ Word 原文件批注（已完成）、批量处理
- **v2.0**: Excel 汇总报告、合同模板对比

## 输出格式

### 1. 审计报告（Markdown）
```markdown
# 合同审计报告：xxx.docx

**风险等级**: 🟡 中
**发现问题**: 8 项

## 摘要
### 按严重程度
- 🟠 高: 2 项
- 🟡 中: 5 项
- 🟢 低: 1 项

## 详细发现
### 1. 🟠 [高] 签署日期
**问题**: ...
**建议**: ...
```

### 2. 批注文档（Markdown）
生成带批注标记的 Markdown 文档，在原文中标注问题位置。

### 3. Word 批注文档（.docx）✅ **NEW**
在**原始 Word 文件上直接添加批注**，使用 Word 的批注功能：
- 在文档开头添加审计摘要
- 在相关条款处添加批注气泡
- 批注包含：风险等级、问题描述、修改建议
- 保留原文件格式和样式

**使用方法**:
```python
from services.contract_auditor import audit_with_word_annotation

# 审计并在原 Word 文件上加批注
audit_report, output_path = audit_with_word_annotation(
    input_path="合同.docx",
    output_path="合同_已批注.docx"  # 可选，默认自动命名
)
```

## 限制说明

- 仅支持中文合同
- 仅支持 Word 格式（v1.0），PDF 需手动转换
- 批注文档为 Markdown 格式（v1.1 支持 Word 原文件批注）
- 不提供法律有效性判定
- 建议作为辅助参考，重要合同仍需法务审核