Construction Mediation Kg

建设工程商事调解知识图谱专家技能。当用户涉及建设工程纠纷分析、商事调解策略、 调解流程设计、利益方识别、争议焦点梳理、BATNA/WATNA评估、调解协议起草等 场景时，应使用此技能。触发词包括：工程纠纷调解、商事调解、调解知识图谱、 调解策略、争议解决、工程款纠纷、工期争议、质量争议、调解协议、调解流程、 利益...

Security Scan

整体上这个技能看起来在功能上与其描述一致（建设工程调解知识图谱与工具），但存在若干不一致与隐私/安装相关的风险，需在安装前确认外部API使用、环境变量声明与第三方依赖的可接受性。

Purpose & Capability

技能名与描述一致地面向建设工程调解；包含案件管理、证据管理、类案检索和与外部法律AI（如通义法睿 / dashscope、智谱）集成的代码模块，这与“增强的法律AI能力”声明匹配。值得注意的轻微不一致：registry/metadata 未声明任何必需环境变量或凭据，但 SKILL.md 和代码（farui_integration.py）明确期望 DASHSCOPE_API_KEY / ZHIPU_API_KEY 等 API key。

Instruction Scope

SKILL.md 明确指示读取包内参考文档 (references/*.md) —— 与技能目的直接相关 —— 并建议通过 pip install dashscope 并设置 API keys 来调用外部模型。关键风险点是：当调用通义法睿/智谱等服务时，案件描述和证据摘录可能被发送到第三方服务端；虽然 SKILL.md 提醒脱敏，但实际运行并不会强制脱敏，存在数据泄露或合规风险。没有发现指令要求访问与本域无关的系统路径或凭据。

Install Mechanism

包清单中没有 install spec（instruction-only / code-included），SKILL.md 推荐用户执行 pip install dashscope。缺乏正式 install 字段意味着运行时依赖需由用户手动安装；pip/ PyPI 依赖有中等风险（第三方包可能执行任意代码）。没有发现从可疑外部 URL 直接下载或执行不明二进制文件；网络交互通过已命名的服务端点（dashscope 阿里云 API）进行。建议在受控环境中安装并核验 dashscope 包来源与版本。

Credentials

SKILL.md 和 farui_integration.py 使用并建议配置 DASHSCOPE_API_KEY 和可选 ZHIPU_API_KEY，但 registry metadata 未声明这些为要求环境变量（required env vars = none）。这构成声明不一致：技能在运行时会依赖敏感 API keys（用于外部模型调用），这些凭据会影响隐私并授予远程服务接收案件数据的能力。技能不要求其它系统凭据或访问权限。

Persistence & Privilege

技能没有设置 always:true，也不会自动修改其他技能或全局 agent 配置。代码会在本地创建/写入目录（./case_data, ./evidence_data 等）并保存案件/证据 JSON，这是与功能预期一致的持久化行为；建议用户确认运行目录与权限并了解数据存储在本地磁盘的含义（备份、加密、清除策略）。

What to consider before installing

What to consider before installing: - API keys & external services: This skill optionally integrates with third‑party legal AI providers (dashscope / 通义法睿, 智谱). You will need to provide DASHSCOPE_API_KEY / ZHIPU_API_KEY for those features. Any case text or evidence you send to those APIs will leave your environment — redact or avoid sending sensitive personal/company data unless the provider and contract meet your privacy/compliance needs. - Manifest inconsistency: The registry metadata does not declare required env vars, but the SKILL.md and code expect them. Ask the publisher to update manifest to list optional/required credentials so you can assess permissions before enabling the skill. - Third‑party packages: The skill recommends pip installing dashscope. Treat PyPI dependencies as a moderate risk — verify the dashscope package's provenance, pin specific versions, and install in an isolated/ephemeral environment (virtualenv / container) if possible. - Local data storage: The skill writes case and evidence files to local directories (./case_data, ./evidence_data). Ensure these directories are placed where you want persistent data stored, consider disk encryption, access controls, and purge policies for sensitive case files. - Code review & trust: Source files are included and largely human-readable. If you plan to use the integration features, review farui_integration.py (and other modules) and test calls with non-sensitive sample data. Prefer disabling external provider integration if you need strictly local-only operation. - Recommended mitigations: run in isolated environment, require explicit consent before sending real case data to external APIs, confirm dashscope provider's data retention policy, and request the publisher to declare env vars in the registry and to provide a minimal reproducible install spec (including pinned dependency versions).

建设工程商事调解知识图谱

技能定位

本技能为建设工程领域商事调解提供系统化知识图谱支撑，覆盖调解全流程的节点、 规则、策略与文书生成，帮助调解员、律师、造价工程师和项目管理人员高效处理 工程纠纷。

法律依据：《人民调解法》《仲裁法》《民事诉讼法》《建筑法》《建设工程施工 合同示范文本》GF-2017-0201、GB/T 50500-2024《建设工程工程量清单计价标准》。

---

触发词与使用场景

主要触发词

• 工程纠纷 / 工程争议 / 工程索赔
• 商事调解 / 调解策略 / 调解方案
• 调解知识图谱 / 调解流程
• 工程款纠纷 / 工程款争议
• 工期争议 / 工期索赔
• 质量争议 / 质量缺陷纠纷
• 变更签证争议
• 调解协议起草
• 利益方分析 / 当事方立场
• BATNA / WATNA / 最佳替代方案
• 调解准备 / 开庭准备
• 争议焦点梳理

使用场景类型

1. 纠纷诊断：识别争议类型、梳理争议焦点
2. 流程设计：制定调解方案和时间表
3. 策略分析：评估各方立场、利益和BATNA
4. 文书起草：调解协议、调解摘要、调解方案
5. 知识检索：法律依据、案例参考、计价规则

---

知识图谱核心结构

第一层：争议类型分类

建设工程争议
├── 合同类争议
│   ├── 工程款支付争议
│   ├── 变更签证争议
│   ├── 索赔争议
│   └── 合同解除争议
├── 工期类争议
│   ├── 工期延误责任认定
│   ├── 工期顺延申请
│   └── 工期赶工费用
├── 质量类争议
│   ├── 工程缺陷责任
│   ├── 材料设备质量
│   └── 竣工验收争议
├── 造价类争议
│   ├── 清单计价偏差
│   ├── 材料价格调差
│   └── 结算争议
└── 安全类争议
    ├── 安全事故责任
    └── 保险理赔争议

第二层：调解流程节点

调解全流程
├── 1. 受理与评估（3-5天）
│   ├── 受理调解申请
│   ├── 争议类型识别
│   ├── 可调解性评估
│   └── 组建调解团队
├── 2. 准备阶段（5-10天）
│   ├── 案卷材料收集
│   ├── 争议焦点梳理
│   ├── 当事方访谈
│   ├── 事实核查
│   └── 调解方案草拟
├── 3. 调解会议（1-3天）
│   ├── 联席会议：陈述立场
│   ├── 背靠背会议：利益探讨
│   ├── 方案提出与磋商
│   └── 协议条款谈判
├── 4. 协议达成（1-2天）
│   ├── 调解协议起草
│   ├── 双方审查确认
│   ├── 协议签署
│   └── 司法确认申请（可选）
└── 5. 执行跟踪
    ├── 履行监督
    └── 争议复发处理

第三层：利益方关系图谱

核心利益方
├── 发包人（业主）
│   ├── 核心利益：控制成本、保证工期、管理风险
│   ├── 常见诉求：减少额外付款、追究质量责任
│   └── 潜在顾虑：影响工程进度、信誉损失
├── 承包人（总承包）
│   ├── 核心利益：收回工程款、维护利润空间
│   ├── 常见诉求：变更确认、签证认可、加速付款
│   └── 潜在顾虑：影响后续承接、资质评定
├── 分包商
│   ├── 核心利益：分包款回收
│   └── 潜在顾虑：被总包拖累
├── 设计单位
│   ├── 核心利益：设计费收取、责任边界
│   └── 潜在顾虑：设计变更责任
└── 监理单位
    ├── 核心利益：服务费、免责
    └── 潜在顾虑：监督失职责任

---

执行逻辑与工作流

工作流一：纠纷诊断与焦点梳理

触发场景：用户描述工程纠纷，需要梳理问题

执行步骤：

1. 读取 references/dispute-types.md，对争议进行分类定性
2. 识别核心争议焦点（金额、责任、时间、程序）
3. 评估争议复杂度（简单/中等/复杂）
4. 输出结构化诊断报告，包含：
   • 争议类型与子类型
   • 核心争议焦点列表
   • 涉及金额估算
   • 相关法律依据

输出格式：

## 纠纷诊断报告

**争议类型**：[类型]
**争议焦点**：
1. [焦点一] — 金额：¥XXX，责任方：XXX
2. [焦点二] — ...

**法律依据**：
- [法规名称 + 具体条款]

**调解建议**：[简要评估]

---

工作流二：BATNA/WATNA 分析

触发场景：用户需要评估各方谈判底线与策略

执行步骤：

1. 读取 references/batna-framework.md，加载分析框架
2. 分别从发包人和承包人角度评估：
   • BATNA（最佳替代方案）：若调解失败，最有利的替代路径
   • WATNA（最差替代方案）：若调解失败，最不利的结果
   • 调解区间（ZOPA）：双方可接受的交集范围
3. 给出调解策略建议

分析维度：

• 诉讼成本与周期
• 仲裁成本与周期
• 胜诉概率与预期
• 对双方关系的影响
• 声誉与品牌风险

---

工作流三：调解方案设计

触发场景：用户需要制定具体调解方案

执行步骤：

1. 读取 references/mediation-strategies.md，加载策略库
2. 根据争议类型选择适配策略：
   • 评估式调解：调解员给出评估意见
   • 促进式调解：引导双方自主协商
   • 混合式调解：先促进后评估
3. 设计调解议程和时间安排
4. 准备背靠背会议提纲

---

工作流四：调解协议起草

触发场景：调解达成一致，需要起草正式协议

执行步骤：

1. 读取 references/agreement-template.md，加载协议模板
2. 填充核心要素：
   • 当事方信息
   • 争议简述
   • 调解结果（金额、时间、方式）
   • 履行条款
   • 违约责任
   • 司法确认条款（如需）
3. 生成协议草稿，标注待确认项

---

知识图谱节点关系规则

责任认定规则

争议类型	主要责任判断要点	参考依据
工期延误	关键路径影响 + 通知义务	GF-2017-0201 第11条
工程变更	指令书面性 + 价格确认	GF-2017-0201 第10条
质量缺陷	施工/设计/材料归因	《建筑法》第60条
结算争议	清单偏差 + 计价规则	GB/T 50500-2024
工程款拖欠	竣工验收 + 付款节点	《民法典》第807条

调解优先级规则

1. 可调解优先：金钱纠纷 > 工期纠纷 > 质量纠纷 > 合同解除纠纷
2. 时效优先：诉讼时效剩余 < 6个月时，加速推进
3. 关系维护：长期合作方优先促进式调解

---

输出规范

标准输出模块

每次响应应根据场景选择以下模块组合：

• [诊断] 争议类型识别与焦点分析
• [图谱] 相关知识节点与关系展示
• [策略] 调解策略建议
• [法律] 相关法律法规引用
• [文书] 调解文书草稿
• [风险] 风险提示与注意事项

引用规范

引用法规时必须标注：法规名称 + 具体条文编号 例如：《建设工程施工合同示范文本》GF-2017-0201 第13.1款

---

参考资源索引

• references/dispute-types.md — 争议类型详细分类与特征
• references/batna-framework.md — BATNA/WATNA分析框架
• references/mediation-strategies.md — 调解策略与技巧库
• references/legal-basis.md — 法律依据速查表
• references/agreement-template.md — 调解协议模板

---

边界说明

• 本技能聚焦建设工程领域，其他行业纠纷建议切换通用调解技能
• 涉及重大争议（>1000万元）建议提醒用户多方论证
• 法律意见仅供参考，不构成正式法律建议
• 调解协议草稿须经专业律师审核后使用

---

通义法睿AI增强（可选模块）

本技能支持集成多个法律AI服务，实现更深度的法律AI能力。

支持的AI服务

服务商	状态	模型	特点
通义法睿	✅ 可用	farui-plus	法律专用模型，性价比高
智谱AI	✅ 可用	GLM-4	通用能力强，支持微调
智合AI	⏳ 预留	-	SaaS平台，API待开放

集成方式

前置条件：

pip install dashscope

配置环境变量：

# 至少配置一个
export DASHSCOPE_API_KEY="your-key"   # 通义法睿
export ZHIPU_API_KEY="your-key"        # 智谱AI

使用统一接口：

from legal_ai_hub import legal_search, case_analysis

# 法律检索（自动选择可用provider）
result = legal_search("工程款优先受偿权")

# 案件分析
result = case_analysis("发包人拖欠工程款800万元")

功能对照

商事调解场景	通义法睿	智谱AI	智合AI
争议焦点梳理	✅	✅	⏳
法律依据检索	✅	✅	⏳
文书生成	✅	✅	⏳
风险评估	✅	✅	⏳

智合AI说明

智合AI（zhiexa.com）是智合旗下的法律AI产品，当前为SaaS模式， 暂未开放API接口。本框架预留接口，待官方开放后即可快速接入。

隐私说明

• API调用数据仅用于本次调解服务
• 敏感案件信息建议脱敏后调用API

---

新增功能模块（2026年4月升级）

基于市场调研，本技能已全面升级，新增以下核心模块：

模块一：类案检索系统 (case_retriever.py)

功能：
├── 按争议类型检索相似案例
├── 按关键争议点精准检索
├── 按标签智能匹配
├── 推送裁判观点
└── 生成调解建议报告

内置案例：5个典型建设工程纠纷
争议模式：4种（工程款/工期/质量/变更签证）

模块二：案件管理系统 (case_manager.py)

功能：
├── 案件全生命周期管理
├── 状态流转自动跟踪
├── 争议焦点跟踪
├── 调解事件记录
├── 文档管理
└── 统计报表

案件状态：待受理→已受理→准备中→调解中→达成协议→已结案/调解失败

模块三：证据管理系统 (evidence_manager.py)

功能：
├── 证据提交与登记
├── 证据审查与分类（效力/真实性/合法性）
├── 证据链自动构建
├── 证据清单自动生成
└── 证据分析报告

证据类型：合同/签证/付款凭证/往来函件/验收报告/鉴定报告等

模块四：调解进度看板 (mediation_dashboard.py)

功能：
├── 案件进度可视化
├── 阶段状态追踪
├── 风险预警
├── 统计报表
├── 甘特图渲染
└── 批量案件管理

标准调解周期：约23天（5+10+5+3）

快速使用

# 类案检索
from case_retriever import get_mediation_advice
report = get_mediation_advice("工期延误", "工期延误责任划分")

# 案件管理
from case_manager import create_new_case
case = create_new_case("某项目工程款纠纷", "工程款纠纷", parties, 8000000)

# 证据管理
from evidence_manager import submit_evidence
ev = submit_evidence(case_id, "合同文件", "施工合同", "发包人")

# 进度看板
from mediation_dashboard import show_dashboard
dashboard = show_dashboard(case_id)

与AI增强模块的协同

度量衡商事调解智库 v2.0
│
├─ 本地知识图谱
│   ├── 争议类型分类
│   ├── 调解流程节点
│   ├── BATNA/WATNA分析
│   └── 协议模板库
│
├─ 案件管理 + 证据管理 + 进度看板（新增）
│
└─ AI增强（通义法睿/智谱AI）
    ├── 案件智能分析
    ├── 法律检索
    ├── 文书生成
    └── 风险评估

市场对标与差异化

竞品	特点	度量衡优势
通义法睿	通用法律AI	✅ 建设工程专属 + 造价专业
MetaLaw	类案检索	✅ 内置工程类案 + 调解建议
智律云	流程自动化	✅ 调解全流程管理
法宝来签	合同审查	✅ 工程合同审查能力

---