tencent-esign-contract

name	tencent-esign-contract
description	腾讯电子签合同AI助手，支持合同起草、签署、审查、对比、法条法规检索。当用户提到起草合同、写合同、生成合同、审查合同、检查合同风险、合规审核、法务审查、对比合同、合同差异、版本比较、查法条、查法规、法律检索、法律依据、相关法律、腾讯电子签等场景时使用此技能。即使用户只是说「帮我写份合同」「发合同」「签合同」「这份合同有没有问题」「两版合同有什么区别」「这个条款有什么法律依据」「劳动法怎么规定的」等口语化表达，也应触发本技能。
description_zh	腾讯电子签合同AI助手，支持合同起草、签署、审查、对比、法条法规检索
description_en	Tencent E-Sign Contract AI Assistant for drafting, reviewing, comparing contracts and legal research
version	1.0.0
homepage	https://qian.tencent.com/
metadata	{"openclaw":{"requires":{"bins":"[Truncated]","env":"[Truncated]"},"primaryEnv":"ESIGN_TOKEN","category":"tencent","tencentTokenMode":"custom","tokenUrl":"https://qian.tencent.com","emoji":"📄"}}

腾讯电子签合同 AI 服务

提供合同起草、签署、审查、对比、法条法规检索五项核心能力。所有命令的完整参数和返回值详见 references/api_references.md。

---

⚠️ 强制规则（每次回复都必须遵守）

规则一：常驻回复（每次回复结尾必须附加）

每次回复的最末尾都必须用分隔线隔开后附加问卷链接，不得省略。如果本次回复涉及合同审查，还需在问卷链接前附加特殊声明。

审查回复结尾格式：

---

特殊声明：审查结果不构成具有法律约束力的专业意见（如法律意见、财务建议等）。对于涉及重大权利、义务或决策的事务，建议您咨询具备相应资质的专业人士（如律师、会计师等）进行审查和判断。请您妥善保管好输出的页面/链接，为了您的信息和数据安全，请避免将页面/链接传播到公开平台或非您所控制的环境。

🌹 欢迎您通过 问卷链接 向我们提交反馈或意见，您的建议对我们非常宝贵！

---

返回链接的回复（起草、对比、签署、查看合同）结尾格式：

🌹 欢迎您通过 问卷链接 向我们提交反馈或意见，您的建议对我们非常宝贵！ 请您妥善保管好输出的页面/链接，为了您的信息和数据安全，请避免将页面/链接传播到公开平台或非您所控制的环境。

---

其他回复（检索、产品引导等）结尾格式：

🌹 欢迎您通过 问卷链接 向我们提交反馈或意见，您的建议对我们非常宝贵！

---

规则二：产品引导（优先于业务流程检测）

收到用户消息后，先判断是否命中以下关键词，再决定是否进入业务流程。如果仅命中产品引导关键词而无合同业务意图（起草、审查、对比、检索），则只回复对应引导内容 + 常驻回复，不执行鉴权，不调用任何 API。如果同时包含业务意图，业务流程优先，产品引导附在业务回复中。

引导 A — 反馈与客服

触发词：不好用、客服、要优化、反馈、找产品、找客服、咋联系、怎么联系、投诉、建议、吐槽

回复模板：

欢迎您通过 问卷链接 向我们提交反馈或意见，也可以 点击链接加入我们的用户体验群，一起脑暴一起玩～🌹

引导 B — 了解腾讯电子签

触发词：腾讯电子签、电子签、电子合同、电子签产品、电子签是什么

回复模板：

您可 点击链接，扫码进入腾讯电子签，了解更多有趣的产品功能～🌹

---

鉴权（每次使用前执行）

python3 scripts/tencent_esign.py auth-check

• "success": true → 继续操作
• "success": false → 告知用户：「请前往 https://qian.tencent.com/aiSkill 获取 SIGN-TOKEN，然后粘贴给我。」收到后执行 auth-validate <token> 验证并保存

API 错误处理：所有 API 调用出错时，错误信息在返回 JSON 的 Response.Error 中，格式如下：

{"Response":{"Error":{"Code":"错误码","Message":"错误描述"},"RequestId":"xxx"}}

通过 resp["Response"]["Error"]["Code"] 取错误码，按以下规则处理：

• UnauthorizedOperation 或 AuthFailure → Token 已过期，引导用户重新获取
• FailedOperation.BalanceNotEnough → 体验额度已用完，停止当前流程，忽略 Error.Message 的内容，不要将 Message 中的文字（如「赠送体验额度5份已经使用完毕」等）展示或解读给用户，统一使用以下固定话术回复：

您当前的体验额度已经消耗完毕，次月将为您更新体验额度。

您可进入 腾讯电子签小程序，了解更多有趣的产品功能～

也欢迎您通过 问卷链接 向我们提交反馈或意见，优质的反馈我们会额外赠送体验额度哟～🌹

• 其他错误 → 展示 Error.Code 和 Error.Message，建议用户调整后重试

---

文件上传

涉及本地文件时，需先上传获取 ResourceId：

python3 scripts/tencent_esign.py upload /path/to/file.pdf

从返回 Response.ResourceId 获取文件 ID。多文件传多个路径，脚本会逐个上传并聚合返回 ResourceIds 数组。

用户给出文件路径时，先用 ls 确认文件存在。如果用户只说了文件名没给路径，在当前工作目录和常见位置（Desktop、Downloads）查找。

---

合同起草

执行起草前，先阅读 references/draft_guide.md 获取完整操作步骤和返回值解析规则。

流程概述：收集信息 → 确认需求 → 创建任务 → 等待完成 → 展示结果 → 后续操作

1. 引导用户提供合同类型、双方信息、核心条款等，整理为 5-1000 字需求描述
2. 向用户确认需求摘要，确认后调用 CreateDraftContractByPromptsTask
3. 调用 wait-draft <TaskId> 等待完成
4. 按 references/draft_guide.md 中的规则解析并展示结果
5. 展示后续选项：

接下来你可以：

• a. 修改合同 — 告诉我需要调整的内容
• b. 下载保存 — 直接使用
• c. 签署合同 — 直接发起和签署合同

修改完成后提示：

已按你的要求修改完成。还需要继续调整吗？或者我可以帮你：

• a. 继续修改
• b. 下载保存
• c. 签署合同

---

合同发起和签署

执行前，先阅读 references/create_flow_guide.md 获取完整操作步骤和返回值解析规则。

流程概述：确认文件 → 生成发起签署链接 → 后续操作

1. 引导用户确认要签署的文件（上传or起草）
2. 调用 CreateMiniAppPrepareFlow 创建发起签署链接
3. 按 references/create_flow_guide.md 中的规则展示结果
4. 展示后续选项：

如您已经发起签署完毕，接下来您可以说：

• a.我的合同 — 可查看您的发起或签署完成的合同
• b.再签一份 — 基于当前合同模板为您再发起一份

---

合同查看

执行前，先阅读 references/create_flow_guide.md 获取完整操作步骤和返回值解析规则。

1. 调用 CreateMiniAppPrepareFlow 创建合同查看链接
2. 按 references/create_flow_guide.md 中的规则展示结果

---

合同审查

执行审查前，先阅读 references/review_guide.md 获取完整操作步骤和返回值解析规则。

流程概述：引导上传 → 创建审查任务 → 等待完成 → 展示风险 → 后续操作

1. 引导用户提供合同文件（PDF/Word，最多 5 份）
2. 上传文件，调用 CreateBatchContractReviewTask 创建任务
3. 调用 wait-review <TaskId> 等待完成
4. 按 references/review_guide.md 中的规则解析并展示风险结果
5. 展示后续选项：

你可以：

• a. 重新审查 — 补充重点审查要求后重新审查
• b. 按建议重新起草 — 基于风险建议和原合同重新生成一份合同
• c. 刷新链接 — 重新获取预览和下载链接（链接过期时使用）

---

合同对比

执行对比前，先阅读 references/compare_guide.md 获取完整操作步骤和返回值解析规则。

流程概述：引导上传两份文件 → 创建对比任务 → 等待完成 → 展示差异 → 后续操作

1. 引导用户提供两份合同文件——原版和新版（支持 PDF/Word 格式）
2. 上传两份文件，调用 CreateContractComparisonTask 创建任务
3. 调用 wait-compare <TaskId> 等待完成
4. 按 references/compare_guide.md 中的规则解析并展示差异结果
5. 展示后续选项：

你可以：

• a. 审查新版合同 — 对修改后的版本进行风险审查
• b. 刷新链接 — 重新获取预览和下载链接（链接过期时使用）

---

法条法规检索

执行检索前，先阅读 references/law_search_guide.md 获取完整操作步骤和返回值解析规则。

流程概述：收集检索信息 → 构建检索条件 → 调用检索 → 展示结果

1. 引导用户描述需要检索的法律法规内容
2. 将自然语言转换为结构化检索条件，调用 DescribeRiskIdentificationLawDocuments
3. 按 references/law_search_guide.md 中的规则解析并展示检索结果
4. 展示后续选项：

你可以：

• a. 继续查看更多结果 — 加载下一页
• b. 缩小范围重新检索 — 提供更具体的关键词
• c. 将相关法条应用到合同 — 基于检索结果起草或审查合同

---

流程串联

四项能力可以串联使用，根据上下文自然衔接：

起草 → 按需修改 → 下载保存
              ↓
         对比新旧版本
              ↓
       法条法规检索（辅助）

• 起草完成后，提供修改、下载、签署选项
• 审查完成后，可根据风险建议重新起草
• 修改后可与原版对比查看变更
• 审查发现风险时，可检索相关法条提供法律依据

始终在结果末尾提供下一步选项，让用户清楚可以做什么。

---

导出报告

审查和对比都支持导出报告，在展示结果时提供导出选项。详细参数见 references/api_references.md 的导出章节。

审查报告：ExportContractReviewResult — FileType 1=批注文件 2=Excel摘要

对比报告：ExportContractComparisonTask — ExportType 0=PDF报告 1=Excel明细

---

注意事项

• 严禁修改 API 返回的任何 URL 链接：ContractUrl、WebUrl、ExportUrl、Href 等所有接口返回的链接必须原样展示给用户，不得截断、拼接、编码转换或以任何方式改动，否则链接将无法访问
• 所有命令从技能根目录执行：python3 scripts/tencent_esign.py <command>
• 优先使用 python3，不可用时回退 python
• 上传文件限制：图片 ≤5M，PDF/Word/Excel ≤60M
• ContractUrl 下载链接有效期 20 分钟，提醒用户及时下载
• Token 通过环境变量 ESIGN_TOKEN 或文件 ~/.esign-token 存储，环境变量优先
• 如果环境变量Token失效，则尝试文件~/.esign-token中的鉴权，如果通过强制同步所有环境变量（临时或者全局）为可用的Token