ai-contract-platform/docs/integration-plan.md

# AI法律文书助手文档 — 分析融合方案

**分析日期**：2026-05-29  
**源文档**：`docs/AI法律文书助手_合并整理版.md`（~960KB）  
**文档定位**：契智 LexForge AI 法律文书的完整产品规划 + Prompt Engineering 手册

---

## 一、文档核心价值总结

该文档不是技术实现文档，而是**产品规划 + Prompt 工程 + 测试标准**的综合设计文档。包含四大块可吸收内容：

| 区块 | 篇幅 | 可吸收程度 | 说明 |
|------|------|-----------|------|
| Prompt Engineering 完整手册 | ~600 行 | ⭐⭐⭐⭐⭐ | 可直接导入 prompt_asset 系统 |
| 质量保障与测试方案 | ~40 行 | ⭐⭐⭐⭐ | KPI 体系和评估标准可复用 |
| 合同类型条款清单 | ~30 行 | ⭐⭐⭐⭐ | 必备条款 checklists 可充实模板 |
| 审查维度框架 | ~50 行 | ⭐⭐⭐ | 5 维度审查框架可丰富现有 review |

---

## 二、Prompt Engineering 手册 — 可导入内容

文档的 **Part 2 (Prompt Engineering 完整手册)** 包含 14 个部分的完整 Prompt 模板，可直接导入 `prompt_asset` 系统作为种子数据。

### 2.1 System Prompt（全局系统提示词）

文件行 ~1503-1527，可直接创建为 `prompt_type = "legal_chat"` 或 `system_prompt` 类型的 prompt asset：

```json
{
  "prompt_key": "system_prompt_legal_assistant_v1",
  "prompt_type": "system_prompt",
  "name": "AI 法律助手全局系统提示词",
  "description": "契智 LexForge AI 法律文书助手的核心 System Prompt",
  "content": "你的身份：你是\"契智AI法律助手\"，一个专业的中国法律文书AI工具...（完整内容在文档 ~1503-1527 行）"
}
```

**建议优先级：高** — 可立即提升 AI 回复的专业性和一致性。

### 2.2 文书智能生成 Prompt 模板（~行 1539-1747）

共 6 个生成场景：

| 场景 | 文档行号 | 系统已有 | 可补充 |
|------|---------|---------|--------|
| 通用文书生成框架 | ~1541 | 有 `contract_generation` prompt | 增加结构化输出要求、HTML 格式约束 |
| 买卖合同生成 | ~1565 | 类似 `procurement_goods` | 增加合规重点、行业惯例参考值 |
| 劳动合同生成 | ~1597 | 有 `labor_contract` prompt | 增加法定必备条款 checklist（最有价值） |
| 保密协议生成 | ~1645 | 有 `nda_commercial` prompt | 增加保密信息定义规则、排除条款 |
| 服务合同生成 | ~1675 | 有 `service_general` prompt | SLA 标准、交付物清单 |
| 股权转让协议 | ~1709 | 系统暂无 | 新增！高价值场景的 prompt |

**建议优先级：高** — 特别是"劳动合同"和"股权转让"的 prompt 比我们现有的更详细。

### 2.3 文书审查 Prompt 模板（~行 1749-1850）

审查维度（~行 1761-1776）比现有实现更完整：

| 维度 | 文档描述 | 系统现状 | 补充价值 |
|------|---------|---------|---------|
| 维度1：文书类型识别与结构完整性 | 判断类型 + 必备条款检查 | 有 keyword 匹配 | 可改用 AI 判定 |
| 维度2：当事人信息审查 | 完整性/一致性/身份明确 | 仅 basic_info 提取 | 增加交叉验证逻辑 |
| 维度3：核心条款风险审查 | 权利义务对等/责任边界/数字明确 | 有 risk_items | 审查粒度更细 |
| 维度4：法规合规校验 | 逐条校验 + 法条引用 | 已有 legal_basis | 增加最新法规同步机制 |
| 维度5：措辞审查 | 模糊表述/口语化/数字格式 | 无此维度 | 新增维度 |

风险等级定义（~行 1780）：

```
🔴 高风险: 重大经济损失/违反强制性法律/缺少必备条款
🟡 中风险: 潜在风险/措辞模糊/对等性不足
🔵 低风险: 可优化/可更专业/格式规范化
```

**建议优先级：中** — 可用于优化 review prompt 的结构。

### 2.4 条款推荐 Prompt（~行 1852-1916）

两套 Prompt：

1. **缺失条款推荐**（~行 1854-1886）— 按合同类型的完整条款清单
2. **条款优化推荐**（~行 1886-1916）— 措辞优化、缺失细节、矛盾检测

**完整条款清单（~行 1864）** 最有价值：以买卖合同为例，列出了 **17 个条款**的完整清单并标注了"★必备/☆推荐/○视情况"。可直接用于充实我们的 `clause_completion_suggestions` 功能。

**建议优先级：中** — 条款分类体系可整合进 clause_suggestion 逻辑。

### 2.5 措辞优化与改写 Prompt（~行 2004-2079）

包含：
- **7.1 措辞专业化**（~行 2006-2049）— 口语→法律专业表述，有对照表
- **7.2 条款改写**（~行 2051-2079）— 偏向特定方角度的条款改写

**口语→专业对照表**（~行 2018-2035）：

| 口语表述 | 专业表述 |
|---------|---------|
| 尽快/尽早 | 应在 [具体期限] 内 |
| 差不多/大概 | 误差不超过 ±[具体比例] |
| 按规矩/按规定 | 按照 [具体法规名称] 的规定 |
| 到时候再说 | 双方应于 [具体时间] 另行协商 |
| 尽量/尽可能 | 应尽商业上合理的努力 |
| 归你/归我 | 知识产权归 [具体方] 所有 |

**建议优先级：中** — 可开发新的 `wording_optimization` prompt asset。

---

## 三、质量保障体系 — 可参考指标

### 3.1 生成质量 KPI（~行 968-978）

| 指标 | 目标值 | 系统现状 | 差距 |
|------|-------|---------|------|
| 结构完整性（必备条款覆盖率） | ≥ 95% | 仅有 keyword 检测 | 无 AI 评分 |
| 条款准确性（律师评分） | ≥ 4/5 | 无此维度 | 需引入人工+AI 混合评价 |
| 法规合规性（法条准确率） | ≥ 95% | 有 legal_source_count | 缺少准确率校验 |
| 措辞专业性（律师评分） | ≥ 4/5 | 无此维度 | 新维度 |

### 3.2 审查质量 KPI（~行 979-988）

| 指标 | 目标值 | 系统现状 | 差距 |
|------|-------|---------|------|
| 风险识别召回率 | ≥ 90% | 无此指标 | 需构建标注测试集 |
| 风险识别精确率 | ≥ 85% | 无此指标 | 同上 |
| 风险等级准确率 | ≥ 80% | 无此指标 | 需验证 |
| 修改建议采纳率 | ≥ 60% | 有 clause_action 统计 | 已有数据基础 |

**建议优先级：低** — KPI 体系可作为后续运营指标扩展参考，非紧急。

---

## 四、领域知识 — 可充实现有常量

### 4.1 合同类型必备条款清单

文档（~行 1864）提供了按合同类型的完整条款清单。示例——买卖合同：

```
必备 ★：当事人信息、标的物、价款、付款、交付、验收、质量保证、违约责任、争议解决
推荐 ☆：不可抗力、保密、通知送达、合同变更、合同解除、附则
视情况 ○：知识产权、保险、知识产权
```

**可充实** `DEFAULT_RISK_RULES` 中的条款覆盖度检查。

### 4.2 劳动法专项检查规则（~行 1810-1826）

8 项专项检查，包含具体法条引用和判定逻辑：

1. 试用期合规 — 《劳动合同法》第19条
2. 工资标准合规 — 最低工资/构成/加班比例
3. 工作时间合规 — 工时制度/审批/加班上限
4. 社会保险与福利 — 五险一金/违法约定
5. 违约金合规 — ⚠️ 第25条禁止
6. 竞业限制合规 — 期限/补偿/范围
7. 解除与终止条款 — 法定情形/违法条款
8. 其他违法条款 — 押金/扣押证件/放弃社保

**建议优先级：高** — 可直接新增到 `DEFAULT_RISK_RULES`，丰富劳动合同审查。

---

## 五、融合实施方案 — 执行状态

### Phase 1 — 立即导入（1-2 天）✅ 已完成

```
1. ✅ 创建 seed_prompts_from_doc.py 种子脚本
   - system_prompt_legal_assistant（legal_chat）
   - contract_review_structured_v2（contract_review）
   - clause_recommendation_completeness（clause_recommendation）
   脚本路径: tools/seed_prompts_from_doc.py
   状态: 语法验证通过，部署后执行

2. ✅ 扩展 DEFAULT_RISK_RULES 劳动合同规则
   - 更新 5 条现有规则补充细节（试用期工资、工时审批、放弃社保等）
   - 新增 3 条规则（违约金禁止、押金禁止、重复试用检查）
   - 劳动合同规则总数: 5 → 8 条
```

### Phase 2 — 功能增强（3-5 天）✅ 已完成

```
1. ✅ 措辞优化 Prompt
   - 新建 wording_rewrite_professional（wording_rewrite）
   - 含口语→专业表述对照表（10组映射）
   - 种子脚本中已定义

2. ✅ 条款分类体系整合
   - 新增 CLAUSE_COMPLETENESS_CHECKLIST（8 种合同类型，共 39 条条款定义）
   - 新增 _get_clause_checklist() / _check_clause_completeness() 方法
   - 集成到 _build_generation_quality_summary，质量检查会按合同类型输出缺失条款
   - 合同类型覆盖：通用、采购、服务、技术开发、劳动、保密、租赁、投融资
```

### Phase 3 — 质量体系（可延后）🔲 未开始

```
1. 构建标注测试集
2. 实现指标自动化计算
3. 建立 A/B 评估流水线
```

---

## 六、总结

| 类别 | 数量 | 建议优先级 |
|------|------|-----------|
| 可直接导入的 Prompt 模板 | 12+ 个 | 高 — 立即可做 |
| 可扩展的审查规则（劳动法专项） | 8 项 | 高 |
| 可按合同类型扩展的条款清单 | 6+ 种 | 中 |
| 可新增的审查维度 | 2 项（当事人信息/措辞） | 中 |
| 可参考的质量 KPI | 8 项 | 低 — 非紧急 |

**最高 ROI 动作**：把文档中的 System Prompt 和审查 Prompt 导入到 `prompt_asset` 表作为种子数据，立即可让 AI 回复更专业、更结构化。