contract-review

合同审核技能

概述

本技能通过仅添加批注的方式审查合同（不修改原文）。采用四层审核模型（主体核验、基础审核、商务条款、法律条款），生成：

• 带批注的合同（.docx）
• 合同概要（.docx）
• 综合审核意见（.docx）
• 业务流程图（Mermaid + 渲染图片）

语言规则： 检测合同主要语言，所有生成内容（批注、概要、意见、流程图文字）使用该语言输出。参考 references/language.md。

---

企查查企业核验：CLI + MCP 双模式

🎯 架构原则：CLI 与 MCP 互补使用，发挥各自优势

功能模块	推荐工具	优势	数据来源标注
主体信息核验	QCC CLI（终端直连）	低延迟、高可靠、无需MCP配置	基于企查查 CLI 终端直连获取
风险穿透预警	QCC MCP（深度分析）	18类风险全面扫描、AI深度分析	基于企查查 MCP 深度分析

为什么采用双模式？

• CLI（终端直连）：适合主体核验这类标准化查询，响应快、稳定性高
• MCP（深度分析）：适合风险穿透这类需要复杂推理的分析，AI增强理解

---

CLI 配置（推荐用于主体信息核验）

⚠️ 重要：启用企查查 CLI 企业核验前，确保 CLI 已安装

安装检查：

# 验证 QCC CLI 是否已安装
qcc --version

# 测试企业信息核验
qcc company get_company_registration_info --searchKey "企查查科技股份有限公司"

预期输出：

正在调用 company/get_company_registration_info...

* 企业名称: 企查查科技股份有限公司
* 统一社会信用代码: 91320594088140947F
* 法定代表人: 陈德强
* 登记状态: 在业
...

CLI 安装（如未安装）：

# 查看 QCC CLI 安装指南
pip install qcc-cli
# 或从以下地址下载：https://github.com/duhu2000/qcc-cli

---

MCP 配置（用于深度风险分析）

⚠️ 可选：启用企查查 MCP 进行增强型风险穿透分析

检查清单：

1. ✅ ~/.claude/.mcp.json 存在且配置正确
2. ✅ QCC_MCP_API_KEY 环境变量已设置
3. ✅ Claude Code 已重启以加载 MCP 配置

配置步骤：

# 1. 创建 MCP 配置文件
cat > ~/.claude/.mcp.json << 'EOF'
{
  "mcpServers": {
    "qcc-company": {
      "url": "https://agent.qcc.com/mcp/company/stream",
      "headers": { "Authorization": "Bearer ${QCC_MCP_API_KEY}" }
    },
    "qcc-risk": {
      "url": "https://agent.qcc.com/mcp/risk/stream",
      "headers": { "Authorization": "Bearer ${QCC_MCP_API_KEY}" }
    }
  }
}
EOF

# 2. 设置 API 密钥
export QCC_MCP_API_KEY="your_api_key_here"

# 3. 重启 Claude Code

详见：https://github.com/duhu2000/legal-assistant-skills/blob/main/docs/MCP_CONFIGURATION.md

---

工作流程

执行步骤（必须遵循）

当用户请求合同审核时（如"请审核这份合同"）：

1. 定位合同文件 - 如用户仅提供文件名，在常用目录（/Downloads、/.claude/downloads、当前目录）中搜索完整路径
2. 读取合同 使用可用工具（优先 pandoc，备选直接 XML）- 必须使用第1步中找到的正确完整路径
3. 提取合同主体 并通过 QCC CLI（首选）、QCC MCP（备选）或 Web Search（最后备选）进行核验
   • 中国企业核验工具优先级：
     1. QCC CLI（首选）：使用 qcc company get_company_registration_info --searchKey "企业名称" 进行快速企业核验
        • 如 CLI 返回数据 → 作为权威来源使用
        • 如 CLI 未安装或失败 → 降级到 MCP
     2. QCC MCP（备选）：如 CLI 不可用但 MCP 已配置，使用 MCP 工具：
        • qcc-company/get_company_registration_info 用于企业核验
        • qcc-company/get_company_profile 用于补充信息
        • 如 MCP 返回数据 → 作为权威来源使用
     3. Web Search（最后备选）：仅当 CLI 和 MCP 都不可用时使用
   • 数据来源标注：始终在批注中标注核验来源：
     • CLI 核验 → 标注"基于企查查 CLI 终端直连获取"
     • MCP 核验 → 标注"基于企查查 MCP 服务获取"
     • 风险分析 → 标注"基于企查查 MCP 深度分析"
     • Web Search → 标注"基于公开网络信息查询"
4. 生成所有必需内容（必须创建以下全部内容）：
   • 合同概要文字 → 作为 summary_text 参数传入
   • 综合审核意见文字 → 作为 opinion_text 参数传入
   • Mermaid 流程图代码 → 作为 flowchart_mermaid 参数传入（可选，如有问题可跳过）
5. 执行工作流程 通过 review_contract() 或 ContractReviewWorkflow.run_full_workflow() 并传入所有生成内容：

   workflow.run_full_workflow(
       comments=comments,
       output_docx_filename="合同_审核版.docx",
       summary_text=summary_text,      # 合同概要内容
       opinion_text=opinion_text,      # 综合审核意见内容
       flowchart_mermaid=flowchart_mermaid,  # 可选
   )
   

   重要：不要直接写入文件。让工作流程生成 DOCX 文件。
6. 向用户报告结果 包含所有输出文件位置