你们公司是不是也这样:合同散在销售、采购、HR 每个人的飞书里,谁签谁看,标准全看个人经验。老手能一眼看出"逾期违约金每日 5%""最终结算价以甲方审核为准"的坑,新人直接签字。一份没审清的合同,亏掉的可能是一整年利润。给飞书装一个合同审查机器人,全员都能用:把合同往群里一发,3 分钟标出风险、给修改建议,连带修订痕迹的批注版都帮你生成好。谁用都一样稳——团队审合同,第一次有了统一标准。
一、教程简介
1、30 秒看懂
这是一篇大约 10 分钟的部署教程:解压安装包 → 在飞书后台创建机器人 → 填一个 config.env → 启动 → 在飞书里把合同发给机器人。机器人会读取合同正文,按合同类型加载专项审查清单,逐条过门禁、标风险、给修改建议,还能生成带修订痕迹的批注版和可视化报告。
2、它能解决什么问题
下面从不同角度对比,看看这个技能到底强在哪、能帮你做什么。
| 你的问题 | 技能解决方案 | 你将得到的 |
| 签合同怕踩坑,怕读不懂隐藏条款 | 按类型加载清单 + 强制立场声明 + 逐条标风险 | 签字前心里有底,不再盲签 |
| 直接丢给AI又有风险漏掉信息和编造法条 | 门禁兜底 + 分层检索≥5命中 + 标准化交付物 | 审查更稳更全,引用有依据,结果可信可复核 |
| 要自己审查合同并且要一段一段批注 | 直接生成带修订痕迹的批注版.docx | 拿去和对方谈/当律师底稿 |
| agent 每次格式漂移,每次口径都不一致,输出全凭心情 | 固定 8 维评分标尺 + 报告模板 | 跨合同可比较、可复核 |
3、覆盖行业及合同类型
| 建设工程 | 建设工程 / 施工 / 承包 / 分包 |
| 借贷 | 借款 / 借贷 / 融资 / 还款 |
| 担保 | 保证 / 抵押 / 质押 / 担保 |
| 买卖 | 买卖 / 购销 / 采购 / 供应 |
| 租赁 | 租赁 / 承租 / 出租 |
| 股权转让 | 股权转让 / 并购 / 股权收购 |
| 承揽 | 承揽 / 加工 / 定作 |
| 技术 | 技术开发 / 技术服务 / 技术许可 |
| 委托物业 | 委托 / 物业服务 |
| 有限合伙 | 有限合伙 / 合伙协议 |
| 广告 | 广告/推广/营销服务 |
| 劳动 | 劳动/聘用/劳务 |
| VC/PE增资 | 增资/增资扩股/VC/PE投资 |
二、开始前需要准备什么
· 已安装好 WorkBuddy。 https://www.workbuddy.cn
· 已安装好Python 3.10 或更高版本。 https://www.python.org/
· 一个飞书账号平台。 https://open.feishu.cn/
· 一个 DeepSeek API key。 https://platform.deepseek.com/
· 本教程后的项目压缩包。
三、在飞书后台创建机器人
操作如下:
登录https://open.feishu.cn/,创建「企业自建应用」,应用名称可以随意填写,例如「合同审查小助手」。创建后先进入「添加应用能力」,启用「机器人」。


添加权限:
在「权限管理」里开通以下权限:
l im:message
l im:message:send_as_bot
l im:message.p2p_msg:readonly
l im:message.group_at_msg:readonly
l im:resource

配置事件订阅:
进入「事件与回调」,订阅方式选择「使用长连接接收事件」,添加事件:im.message.receive_v1。

发布应用:
权限和事件配置完成后,到「版本管理与发布」创建版本并发布。发布后回到「凭证与基础信息」,复制 App ID 和 App Secret。这两个值稍后要填进 config.env。
注意:权限或事件修改后需要重新发布版本,否则机器人可能收不到消息。

四、准备 DeepSeek key
操作如下:
到 DeepSeek 开放平台创建 API key,并确保账户有余额。机器人不会直接使用飞书的模型能力,而是由 Python 后端调用 DeepSeek 完成合同审查和修改建议。
五、填写 config.env
操作如下:
安装包里已经有一个「打开配置」脚本:双击「打开配置-Mac.command」或「打开配置-Windows.bat」,脚本会自动复制出 config.env 并打开编辑器。也可以直接编辑根目录的 config.env 文件。
至少需要填写以下内容:飞书的 App ID 和 App Secret,以及 DeepSeek 的 API key。
FEISHU_APP_ID=cli_你的应用ID
FEISHU_APP_SECRET=你的应用Secret
DEEPSEEK_API_KEY=sk_你的DeepSeekKey

六、安装依赖、启动机器人并测试
用户电脑只需要提前安装 Python 3.10 或更高版本。Mac 使用「启动-Mac.command」,Windows 使用「启动-Windows.bat」,双击。第一次启动时会自动创建 .venv 并安装依赖,不需要手动 pip install。

启动:
再次双击安装包里的「启动-Mac.command」或「启动-Windows.bat」。脚本会自动进入自己的目录,第一次运行时会自动创建 .venv 并安装依赖,不需要手动配置。
看到类似 connected to wss://msg-frontier.feishu.cn 的日志,就说明机器人已经连上飞书。

在飞书里调用:
在飞书里搜索刚刚发布的机器人,进入私聊后把合同文件发给它,并说明你的立场和需求。机器人会识别合同类型(买卖 / 租赁 / 劳务 / 建设工程……),自动加载对应的专项审查清单,逐条过门禁后给出风险清单、批注版合同和可视化报告。



七、如何在WorkBuddy中完成这个项目
请先阅读这个合同审查skill,理解它的完整能力:
重点理解这 5 件事:
1. 7 步工作流每一步做什么、产出什么
2. scripts/ 下 14 个模块各自负责什么,以及它们怎么互相调用(看 main.py 的调用链)
3. data/ 下 7 张标准表各是什么、字段含义、各多少条
4. references/gates/ 下 16 个门禁怎么被激活、怎么和通用门禁配合
5. 终稿三件套 + HTML 报告分别由哪个模块产出
读完先给我一份「能力清单 + 模块依赖图」,我确认你理解对了再往下做。
确认后继续给出我们的需求:把上面这个 skill 复刻成一个完整的独立项目。
产出结构与原件同构、可直接运行的项目。
【硬性约束 —— 最重要,违反即不合格】
1. 内核只搬运,不重写:
- scripts/ 的算法逻辑、data/ 的标准数据、references/gates/ 的门禁条目
→ 原样保留
- 禁止"凭印象重编"、禁止"顺手优化"业务标准
2. 数据行数必须与原件完全一致,交付前逐表自检并列表对比:
风险模板 124 条 / 检查清单 54 条 / 合同类型 70 条 / 条款标准 18 条 /
风险标签 15 条 / 修订路由 24 条。不一致必须说明原因,不许静默丢。
3. 如与原项目路径、命名冲突 → 用适配层(wrapper)解决,不动内核文件。
4. 如果你认为某处内核确实该改,先说明理由、等我确认,不要擅自改。
【交付形态】
一个完整项目目录:
合同审查/
├── SKILL.md # 工作流与方法论说明
├── skill.json # 元信息
├── main.py # 7 步会话入口
├── scripts/ # 14 个算法模块
├── data/ # 7 张标准数据表
├── references/gates/ # 16 个门禁
└── assets/ # HTML 报告模板 + 图表库
【工程规范】
1. Python 3.10+,脚本零外部强依赖(缺 python-docx / pandas 时自动检测并安装)
2. 中文路径、中文文件名、中文内容一律不能乱码(文件统一 UTF-8)
3. 模块间接口保持稳定,原有函数签名不破坏
【验收标准】
在一份真实合同上跑通:解析 → 门禁 → 风险评分 → 修订路由 →
产出三件套(批注版合同 / 法律意见书 / 法律分析)+ HTML 报告,
且数据条目数与原件逐项一致。
八、完整Skill和完整项目代码
完整Skill:
https://superi.mfdemo.cn/chaoji/2026/09/11/6aa3c084f3d08.zip
完整项目代码:
https://superi.mfdemo.cn/chaoji/2026/09/11/6aa3c0be1f3b2.zip