
Contract Copilot
- 4 installs
- 37 repo stars
- Updated June 13, 2026
- cat-xierluo/contract-copilot.skill
Draft and review contracts with a layered four-step framework, producing risk lists, edits, and a review memo with DOCX comments or tracked changes.
About
Assists Chinese-language contract drafting and review using a layered four-step framework, outputting risk lists, drafting skeletons, edit suggestions, and a review memo with DOCX comments or tracked changes. A developer or lawyer uses it to review or draft contracts sent through IM and get back a revised document.
- Layered four-step review framework
- Delivers DOCX comments and tracked-change revisions
Contract Copilot by the numbers
- 4 all-time installs (skills.sh)
- Ranked #533 of 688 Office & Documents skills by installs in the Skillselion catalog
- Data as of Aug 3, 2026 (Skillselion catalog sync)
npx skills add https://github.com/cat-xierluo/contract-copilot.skill --skill contract-copilotAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 4 |
|---|---|
| repo stars | ★ 37 |
| Last updated | June 13, 2026 |
| Repository | cat-xierluo/contract-copilot.skill ↗ |
What it does
Draft and review contracts with a layered four-step framework, producing risk lists, edits, and a review memo with DOCX comments or tracked changes.
Files
Contract Copilot(合同助手)
一、定位
调用时,先按本文件确定运行流程。
用于合同起草与审查的专业辅助技能,重点服务以下场景:
- 审查既有合同,识别风险并提出修改建议。
- 起草新合同,确保条款完整、可执行、可落地。
- 形成更接近律师交付习惯的审查意见书,支持沟通、谈判与复核。
- 在 DOCX 文档中直接添加批注或修订痕迹。
二、核心理念
1. 促进交易
- 审查目标是帮助交易安全落地,不是机械否定交易。
2. 全面思考
- 同时考虑我方、对方、履行人员与第三方影响。
- 同时考虑法律后果、商业后果、执行成本。
3. 理性决策
- 按风险等级和业务影响给建议。
- 高风险给明确方案,中低风险给可选方案。
三、分层四步审查框架
3.1 三层分析
1. 宏观层(交易结构)
- 合同类型是否匹配交易实质。
- 主体是否适格、授权是否完整。
- 标的是否合法、可处分、可履行。
- 关键程序是否完备(审批、登记、备案、内部决策)。
- 交易结构是否可执行(付款、担保、交割路径、退出路径)。
2. 中观层(文本与形式)
- 合同形式是否匹配业务阶段(正式合同/框架+订单/补充协议)。
- 格式条款是否合规,提示说明义务是否可举证。
- 主合同与附件、订单、配套协议是否一致。
3. 微观层(条款与语言)
- 核心条款是否齐全(标的、价款、履行、违约、争议解决)。
- 权利义务是否清晰、对等、可执行。
- 违约、解除、赔偿、证据与通知机制是否闭环。
- 语言是否准确、无歧义、无冲突。
3.2 四步流程
1. 前置澄清
- 明确立场(代表哪一方)、审查目的、时限、优先级。
- 若用户未明确立场与审查口径,必须先确认“甲方 / 乙方 / 中立 / 其他”及“克制 / 常规 / 强势”。
- 如本地
config/review_memory.json已命中同名合同,默认沿用上次记录的客户名称、立场与审查口径;仅在用户指出不一致时再改。
2. 分层扫描
- 先宏观后中观再微观,先框架后细节。
3. 条款落地
- 对每个风险点给出可执行修改方案、推荐措辞和建议展现方式(直接修订 / 局部删减 / 局部补入 / 整条重写 / 仅批注)。
4. 交付与跟进
- 输出报告、沟通重点、谈判清单、复核要点。
- 若本轮任务由飞书或其他 IM 会话发起,且合同文件由该会话传入,默认沿原会话交付最终产物。
四、标准输出规范
4.1 风险清单字段
每个风险点建议采用以下字段输出:
- 风险名称
- 风险等级(P0/P1/P2)
- 风险后果
- 判别标准
- 推荐措辞
- 风险示例
- 法律依据
- 整改建议
- 相关条款
4.2 风险等级
- P0:可能影响效力、导致重大损失或重大争议。签署前优先处理。
- P1:会显著增加争议和履约成本。建议优先谈判修改。
- P2:表述或流程优化项。可结合时间窗口处理。
4.3 审查结论写法
结论应包含:
- 能否签:可签 / 有条件可签 / 不建议签。
- 先决事项:签署前必须完成的前置动作。
- 谈判优先级:P0 → P1 → P2。
4.4 起草输出写法
起草结果至少包含:
- 起草路由卡(主合同类型 + 配套协议类型 + 主文件 + 推荐交付包型 + 必带附件)
- 待补事实清单(缺失处统一标注“未提及/待补充”)
- 条款骨架
- 程序性前提(审批、备案、登记、生效、交割)
- 推荐措辞与需确认事项
五、合同类型覆盖(固定 12 类)
不扩展合同分类数量,优先在现有 12 类内完成全量抽取与深度补齐。
| 类别 | 路径 | 示例 |
|---|---|---|
| 买卖合同 | references/contract-types/01-sale/ | 动产买卖、二手房买卖、商品房买卖、经销买卖 |
| 租赁合同 | references/contract-types/02-lease/ | 房产租赁、建筑设备租赁 |
| 服务类合同 | references/contract-types/03-service/ | 一般服务、中介、仓储保管、承揽、物业、运输、行纪、广告 |
| 知识产权类合同 | references/contract-types/04-ip/ | 软件许可、技术开发、商标许可、商标转让、专利、著作权 |
| 担保类合同 | references/contract-types/05-guarantee/ | 保证、抵押、质押 |
| 借贷与赠与合同 | references/contract-types/06-lending-gift/ | 民间借款、赠与 |
| 互联网协议 | references/contract-types/07-internet/ | 用户许可协议、订单协议、隐私政策 |
| 婚姻家事类合同 | references/contract-types/08-marriage-family/ | 夫妻财产约定、离婚协议、遗赠扶养协议 |
| 劳动用工类合同 | references/contract-types/09-employment/ | 劳动合同、劳务派遣、外包、实习、返聘、非全日制、个人劳务 |
| 房地产类合同 | references/contract-types/10-real-estate/ | 土地出让、土地转让、联建、委托代建 |
| 建设工程类合同 | references/contract-types/11-construction/ | 施工、总承包、分包、勘察设计、监理 |
| 公司投资类合同 | references/contract-types/12-corporate-investment/ | 出资、增资、投资、股东协议、股权转让、股权激励、合并分立、对赌 |
未单列的细分合同类型,统一按 references/contract-routing.md 归入既有 12 类,并同时用于审查路由和起草路由。
六、Reference 调用顺序
6.1 四层结构
- 基础规则层:
references/review-framework.md - 审查入口层:
references/priority-clauses.md - 展现策略层:
references/revision-strategy.md - 类型路由层:
references/contract-routing.md - 合同主文件层:
references/contract-types/01-sale/至references/contract-types/12-corporate-investment/
6.2 推荐读取顺序
1. 已知合同标题,但不确定归类: 先读 references/review-framework.md,再读 references/contract-routing.md,必要时用 references/priority-clauses.md 聚焦高风险条款,进入对应合同主文件完成细审后,再用 references/revision-strategy.md 决定落地动作。 2. 已知合同目录,但不确定是否有交叉问题: 先读当前合同主文件;若存在混合交易,再回到映射清单做双标签复核。 3. 混合型交易或标题与实质不一致: 一律先按交易实质而非标题归类,采用“主合同类型 + 配套协议类型”双标签。 4. 起草新合同: 先用映射清单生成“起草路由卡”(主合同类型、主文件、推荐交付包型、必带附件、待确认问题),再用 templates/合同起草信息清单.md 固定文件包、待补事实和条款骨架。
6.3 维护规则
references/根层只保留高复用入口资料,不再拆出短小的导航或流程文件。- 新增独立合同模板时,只能放入
references/contract-types/下既有 12 类目录。 - 新出现的共性审查问题,优先吸收进
references/review-framework.md或对应合同目录主文件。
七、模板
- 合同起草信息清单:
templates/合同起草信息清单.md - 条款库:
templates/条款库.md - 审查报告模板:
templates/审查报告模板.md
templates/合同起草信息清单.md 的定位是“起草工作台”,用于把识别与分流文件产出的路由卡、文件包、程序性前提和待补事实先固定下来;templates/条款库.md 的定位是“起草支撑层”,不单独构成另一套 reference。起草时应先走 references/review-framework.md、references/contract-routing.md、templates/合同起草信息清单.md 和对应合同主文件,再从条款库抽取可复用措辞。当前条款库已补入文件优先级、验收、配合义务、条件成就、通知送达、责任限制、背景技术、里程碑、交割清单等首批高频结构条款,后续仍应继续从 12 类合同主文件中反向抽取公共条款。
八、文档操作(批注/修订/报告)
直接运行 scripts/*.py 或 scripts/run_apply_review_plan.ps1 前,先确认 references/setup-dependencies.md 中的运行前提已经满足。最小要求是:本机 Python 已安装 defusedxml 与 lxml。OOXML 打包、解包和校验功能已内嵌在 scripts/docx/ 中,无需外部依赖。
8.1 处理流程
1. 一体化执行(推荐):
python scripts/review/apply_review_plan.py \
--input contract.docx \
--plan review-plan.json \
--output contract_reviewed.docx执行后默认对外交付:
contract_reviewed.docx(修订批注一体版)contract_reviewed_审查报告.docx
同时会在 archive/<时间戳_合同名>/ 内部归档目录留存:
review-plan.jsoncontract_reviewed_审查报告.mdcontract_reviewed_执行日志.json- 输出 DOCX、副本报告 DOCX 与
manifest.json
2. 底层 API(按需编排):
from scripts import ContractReviewer
reviewer = ContractReviewer("workspace/unpacked")
reviewer.add_comment_by_text("甲方承担全部责任", "P0:责任范围过宽,建议增加责任上限和例外")
reviewer.replace_text("五个工作日内付款", "十个工作日内付款", tag="w:r")
reviewer.save()3. 计划格式与参数详见:scripts/README.md 4. 生成阶段可先执行计划补全:
python scripts/review/enrich_review_plan.py \
--input review-plan.json \
--output review-plan_enriched.json用于自动补齐 needs_negotiation / deterministic_edit,再执行批注/修订。
5. 执行语义:
- 如果
config/reviewer_profile.json不存在,或其中未填写审查人姓名 / 律所或公司名称,先向用户确认审查人姓名、律所/公司名称和可选部门;随后脚本会以config/reviewer_profile.example.json为模板生成正式配置并写回。 - 即使
config/reviewer_profile.json中已有姓名 / 律所或公司名称,只要该配置尚未在当前环境完成确认,也要先向用户确认一次,再继续执行;不要直接沿用未确认的预填值。 - 如果用户未明确客户名称、审查立场或审查口径,先读取
config/review_memory.json;命中同名合同历史记录时默认沿用,未命中时在交互模式下询问“客户名称 + 立场 + 审查口径”,并以config/review_memory.example.json为模板生成正式记忆文件。 - 审查口径只用于控制风险识别与结论表达的强弱,不再直接映射正文落痕策略;“正文修订 / 就地批注 / 仅写入意见书”的自动分流应由独立
edit_policy决定。 - 若存在未成功写入 Word 的审查项,命令仍会保留输出 DOCX、Word 报告和归档留痕,但会以非零退出码结束。
- 对外报告默认采用“审查意见书”体例:先写“致:收件方”开篇、合同概况、综合审查意见和重要风险提示,再按正式意见逐项展开,最后附声明与出具信息;执行命中率、失败项和内部统计默认只保留在归档中的 JSON 执行日志。
- Word 审查意见书默认采用正式法律文书版式:深蓝标题、仿宋正文、浅底元信息卡、棕色标签高亮和页脚页码,风格更接近律师服务方案/意见书出件。
- Word 审查意见书版式默认走更紧凑的正式件参数:页边距、行距、段距和详细意见表格内边距均已压缩,避免无效留白把全文页数拉长。
- Word 审查意见书中的无序列表与编号列表使用 OOXML 原生编号体系,避免层级和缩进显示漂移。
- “详细审查意见”在 Word 报告中默认按逐项表格展示,便于对照风险概述、原条款、建议修改和法律依据。
- “详细审查意见”表格默认采用更紧凑布局:标签列收窄、内容列加宽、单元格上下内边距归零,优先减少长条款换行。
- 默认交付模式下,用户目录只保留审核修订版 DOCX 与 Word 报告;Markdown 报告、执行日志和审查计划副本默认沉淀到
archive/。如需直接查看这些过程文件,可临时使用--no-archive调试。 - 对外交付的审核版 DOCX 默认采用“修订批注一体版”:确定性问题直接修订,留空项/事实待补项继续批注,重大直接修订保留必要解释性批注;程序优化型、说明型和低必要性问题默认仅写入审查意见书。
- 若本轮任务来自飞书或其他 IM 对话,且合同文件由该对话直接传入,默认交付通道为同一 IM 会话;最终应把审核修订版 DOCX 与审查报告 DOCX 直接回传到原对话,不只回复“文件已生成”或仅给本地路径。
- 若当前运行时暂不具备 IM 附件发送能力,应明确告知该限制,并保留好可发送的产物路径或文件对象,等待后续由具备发送能力的通道补发;不要把“未发送”误表述成“已交付”。
- 首次执行时,会优先读取
config/reviewer_profile.json;若尚无配置、缺少姓名/机构,或当前环境尚未确认过该身份配置,则在交互模式询问审查人姓名、律所/公司和可选部门,或在首次显式传入--author与--organization时按当前输入生成并保存。 - 该配置只保存在当前本地 skill 的
config/目录,不会自动上传;后续可随时通过自然语言要求更新。 initials为可选项;若留空,不自动生成,也不写入 Word 批注。- 写入 Word 的批注与修订时间线会先读取本机当前时区与本地时间,再以本次命令执行时点为起点按 5 到 10 分钟区间向后错开;
w:date使用本地时区格式写入,避免显示出错误时区或回写到运行前的时间戳。 - 时间线默认采用“两层错峰”:同一条审查意见内部,每个实际修订/批注批次默认顺延
1-2分钟;不同审查意见之间继续保持5-10分钟的大间隔。 - Word 批注作者默认显示为
姓名|机构;审查报告中的审查人、所属机构/公司和所属部门仍保持分项展示。 - 审查报告中的审查人、所属机构/公司和所属部门与上述本地配置保持一致。
- 若审查计划未显式提供
comment,默认按“风险等级 / 风险点 / 条款位置 / 说明 / 修改建议 / 可选建议措辞”的多行结构生成批注。 - 默认自动分流策略为更克制的
revise-first:只有高确定性、强落地性的审查项才优先直接修订;程序优化型、说明型和低必要性问题可改为批注或仅写入意见书。 - 在确定
comment / delete / insert / replace前,应优先参照references/revision-strategy.md:留空项、事实待补项和授权不明的商务取舍项默认只批注;准确的法条引用默认不因篇幅较长而删减;能局部删减或补入的,不要整段重写。 - 修订执行层已升级为“多段最小差异修订 + 审查密度收敛”:同一
w:r内短语替换/删除优先落成局部w:del / w:ins;目标跨多个w:r时,优先退到段落内片段修订;复杂长条款在存在多个稳定不变片段时,也应尽量拆成多组局部修订块,而不是继续压成一个大中段替换;若单一条款会炸出大量低价值的单字级差异,则自动并成更少的核心修订块。对于留空/占位项,即使上游误标为直接修订,也应回退为批注。
8.2 模式选择
- 对外交付模式:默认只采用“修订批注一体版”,不再要求用户在纯批注 / 纯修订 / 混合模式之间自行切换。
- 批注动作:用于风险提示、商务谈判建议、事实待确认、需保留弹性的场景,以及对重大直接修订补一层解释。
- 修订动作:默认优先模式,用于明显错误、术语统一、确定性替换,以及确有必要直接改文的风险整改。
- 仅意见书:用于程序优化型、说明型、低必要性或“提示即可、不必在 Word 页面留痕”的问题。
8.3 自动分流(action=auto)
- 默认采用
revise-first策略;可通过--edit-policy revise-first|balanced|comment-first或计划中的meta.edit_policy覆盖。 edit_policy与审查口径独立:即便本轮口径选择克制,对确定性问题仍可直接修订;不要再把“口径低”机械等同于“只批注、不改文”。- 当审查项含“谈判/待确认/保留弹性”等特征时,自动按批注处理。
- 当审查项含确定性改动特征(如笔误修正、术语统一)且提供改文载荷时,自动按修订处理。
- 当审查项属于程序优化型、说明型、低必要性建议时,可自动走“仅意见书”通道,不写入 Word 正文。
- 在
revise-first下,若未显式提供replacement_text,但已提供可直接落文的recommended_text,系统会先判断该问题是否值得直接入正文;只有通过收束规则后,才会将其作为替换文本执行直接修订。 - 显式动作(
comment/delete/insert/replace)优先于自动分流。 - 若未显式提供
needs_negotiation/deterministic_edit,脚本会在加载计划时自动补全(可通过--no-enrich-plan关闭)。
九、标准审查流程
9.1 启动阶段
- 必问信息:
我方代表哪一方;本轮目标是“签约前把关”还是“谈判修订”;截止时间和优先级;是否允许重构交易结构,还是只改文本。
- 首次使用校验:
若 config/reviewer_profile.json 缺少审查人姓名或所属机构/公司,或当前环境尚未确认过该身份配置,先提醒用户补录或确认审查人姓名、律所/公司名称和可选部门,并说明该配置只保存在本地、后续可随时通过自然语言修改。
- 输入材料清单:
合同正文和附件;背景资料;主体资料。
- 输出约定:
修订批注一体版文档 / 审查意见书;风险分级统一为 P0/P1/P2。
- 渠道约定:
若合同文件由飞书或其他 IM 会话传入,默认把该会话视为任务布置与成果回传的同一渠道;除非用户明确改口到邮箱、云盘或其他位置,否则最终仍回原对话发送文件。
9.2 分层扫描阶段
- 宏观层:合同类型、主体资格、标的合法性、审批/备案/登记/内部决议、付款交付担保退出闭环。
- 中观层:合同形式是否匹配阶段、主合同与附件/订单/规则文件是否冲突、格式条款与优先级是否明确。
- 微观层:核心条款齐全性、权利义务平衡性、违约解除可执行性、争议解决和通知送达可举证性。
9.3 风险处理阶段
- 风险排序:
P0 必须处理;P1 优先谈判;P2 优化项。
- 每个风险点至少输出:
风险后果、判别标准、推荐措辞、整改建议。
- 默认执行口径:
若已经能形成明确条款文本,优先直接修改正文;只有涉及商务谈判、事实缺口或需保留弹性时,才改为批注提示。
- 修订细度口径:
优先局部删减、局部补入和局部替换;仅在原条款整体逻辑失效、局部动作无法修复时,才整条重写。
- 重大修订解释口径:
对 P0 / P1 的重大直接修订,原则上保留简短批注说明修改原因;纯格式、编号、标点和错别字问题通常只改文,不再打扰阅读。
- 优先谈判顺序:
效力与程序 -> 资金与交付 -> 救济与退出 -> 文本优化。
9.4 交付阶段
- 最终交付物:
风险汇总表、关键条款修改建议、签署前先决事项清单、二次复核问题列表。
- 文件交付物:
审核修订版 DOCX、审查报告 DOCX。
- IM 回传口径:
若任务来自飞书或其他 IM 渠道,默认在原对话框回传上述两个文件;如运行时不具备发附件能力,需明确说明“文件已生成但尚未完成会话回传”。
- 结论模板:
可签 / 有条件可签 / 不建议签 + 前提条件 + 主要保留意见。
9.5 复核与常见失误
- 对方反馈后,核对是否引入新冲突。
- 版本迭代时,重点检查被改条款的连带影响。
- 最终签署版再做一次快检。
- 常见失误:
只改措辞,不修交易结构;只看正文,不看附件与订单;只看我方义务,不看对方救济;只做风险提示,不给可执行替代方案。
十、标准起草流程
10.1 起草启动阶段
- 必问信息:
我方代表哪一方;交易目标;本次输出是完整合同、框架协议、补充协议还是条款清单;是否存在混合交易;截止时间。
- 先做路由:
先读 references/contract-routing.md,确定主合同类型、配套协议类型、推荐交付包型和必带附件,并先产出“起草路由卡”。
- 先建清单:
使用 templates/合同起草信息清单.md 记录文件包、主体、交易结构、程序性前提和缺失事实。
10.2 骨架搭建阶段
- 先按
references/review-framework.md检查宏观 / 中观 / 微观三层是否完整。 - 先按映射清单给出的“优先主文件 + 骨架顺序 + 必带附件”搭起文件包,不要直接跳到正文措辞。
- 再进入对应合同主文件,提取该类合同的专属条款、风险点和推荐措辞。
- 混合型交易一律拆成“主合同条款 + 配套协议条款”,避免把不同法律关系硬塞进一份文本。
10.3 条款填充阶段
- 先填关键商业事实,再写措辞;缺失处统一标注“未提及/待补充”。
- 程序性事项必须写清责任主体、完成时间和未完成后果。
templates/条款库.md仅用于补充通用候选措辞,不代替主文件确定条款结构。
10.4 交付阶段
- 至少输出:
起草路由卡、合同草案 / 条款骨架、待确认问题表、程序性前提清单。
- 如无法一次起草完整文本:
先输出路由卡、条款清单和需补事实,不用臆造商业安排把草案“写满”。
十一、合规要求
- 不在技能文档或参考文件中标注外部资料的具体出处。
- 不使用外部资料中的专有命名作为技能主框架名称。
- 仅保留可公开表达的审查理念、结构和实务规则。
- 无法确认的信息明确标注“未提及/待补充”。
十二、版本
- 当前版本:
1.5.1 - 更新日期:
2026-04-19
变更日志
本文档记录 Contract Copilot 的重要变更。
[1.5.1] - 2026-04-20
重构
- scripts/ 按功能分为三个子包:
review/(审查流程)、report/(报告生成)、docx/(文档引擎)。 - 删除整个
ooxml/子包(3 层嵌套),validation 合并为docx/validation.py,pack.py移入docx/。 docx_core/改名为docx/。- XML 模板骨架内联为
document.py中的 Python 字符串常量,删除templates/目录(之前被.gitignore屏蔽,从未进入 git)。 - 文档路径全面更新:
SKILL.md、scripts/README.md、references/setup-dependencies.md、run_apply_review_plan.ps1中的旧路径和版本号已同步修正。
修复
- 修复批注时间戳随机化功能断裂:
Document类缺少set_operation_timestamp/clear_operation_timestamp方法,导致ReviewTimeline的两层错峰逻辑无法生效。已补入实现,批注/修订时间戳现在会正确使用本地时区偏移格式,并按设定间隔递增。 - 修复
utilities.py的get_node()方法缺少occurrence参数,导致多条重复文本定位时报错。
文档完善
- 2026-04-22:按独立仓库 README 新规范重写首页,补充适用用户、典型审查场景、DOCX 交付能力、安装依赖、使用边界、核心设计、关键文件、Legal Skills 关联项目导流、作者联系入口和微信二维码
[1.5.0] - 2026-04-19
重构
- OOXML 模块轻量化:移除全部 XSD schema 文件和 PPTX/XLSX 验证代码,替换为轻量级结构检查(文件存在 + XML 解析),参照行业标准实现。
pack.py简化:移除 XML 美化还原(condense_xml)和soffice依赖,改为直接 zip 打包。docx_core/document.py简化:移除 baseline 打包开销,验证改为轻量版。
改进
- 文件体系标准化:所有 reference 文件名改为英文,非发布文件移入
archive/。 - 许可证从 CC BY-NC-SA 4.0 更新为 CC BY-NC 4.0,与项目统一。
- README 精简为发布模板格式,新增作者信息和关联项目。
- 自包含:移除对外部
docxskill 的依赖,OOXML 能力完全内嵌。 - 注册为 subtree 独立仓库发布。
[1.4.50] - 2026-04-09
改进
- 解除“审查口径”和“正文落痕策略”的强绑定:
克制 / 常规 / 强势现在只影响风险识别与结论表达强弱,不再直接映射为comment-first / balanced / revise-first。 - 未显式指定
edit_policy时,自动分流默认仍保持revise-first,因此即便本轮口径偏克制,对高确定性问题也仍可直接修订。
修复
- 修复低口径场景被机械收敛成“只批注、不改文”的行为偏差,避免审查尺度被错误等同于正文是否可修改。
- 修复历史
review_memory.json中旧版edit_policy记忆会继续影响当前默认落痕策略的问题。
技术优化
review_runtime.py现将review_intensity与edit_policy独立解析,只接受显式--edit-policy或meta.edit_policy覆盖。- 补充回归测试,覆盖“低口径仍可保持默认直接修订策略”和“历史记忆不再偷偷带回旧动作策略”两条路径。
文档完善
- 更新
README.md、SKILL.md、scripts/README.md、ARCHITECTURE.md、ROADMAP.md、TASKS.md与DECISIONS.md,统一“口径独立、落痕独立”的运行语义。
[1.4.49] - 2026-04-09
改进
- 收紧审查人身份确认规则:首次使用时,如果
reviewer_profile.json缺少姓名或机构,仍然必须先询问并写入后再继续运行。 - 新增当前环境确认门槛:即使本地已经存在姓名 / 机构,只要该配置尚未在当前环境完成确认,交互模式下也会先要求确认一次,再继续执行。
- 明确不应根据 skill 作者、仓库 owner、历史样例或其他上下文静默推断审查人姓名和单位。
修复
- 修复“配置文件里已有值就直接继续”带来的静默代填风险,避免新环境或遗留本地配置在未经确认时直接进入法律文书输出。
技术优化
review_runtime.py现为审查人配置新增confirmed状态,并补充交互式确认逻辑。- 新增回归测试,覆盖“空配置时交互补录”和“已有但未确认配置时交互确认”两条路径。
文档完善
- 更新
config/reviewer_profile.example.json、SKILL.md、README.md、scripts/README.md、TASKS.md与DECISIONS.md,统一新的首次确认口径。
[1.4.48] - 2026-04-09
改进
- 明确 IM 渠道语义:当合同任务由飞书或其他 IM 对话发起,且合同文件由该对话直接传入时,默认把原对话视为任务布置与成果交付的同一渠道。
- 明确最终回传口径:审核修订版 DOCX 与审查报告 DOCX 默认都应回传到原 IM 对话,不再只默认本地落盘或仅回复文件路径。
- 增加保底规则:若当前运行时没有附件发送能力,需要显式说明“文件已生成但尚未完成会话回传”,避免把未发送状态误表述为已交付。
文档完善
- 更新
SKILL.md、README.md、ARCHITECTURE.md、TASKS.md与DECISIONS.md,同步本次 IM 渠道交付规则。
[1.4.47] - 2026-04-09
新增
- 新增
references/setup-dependencies.md,集中说明contract-copilot的目录依赖、Python 包依赖、可选系统依赖、推荐安装顺序与常见报错排查。 - 新增
scripts/requirements.txt,固化当前 Python 运行依赖defusedxml与lxml,便于外部使用者直接执行pip install -r。
改进
README.md、SKILL.md与scripts/README.md现在统一指向同一份依赖入口,不再把运行前提分散在脚本注释和零散说明中。- 明确
docx/为同级必需 skill,ooxml能力随docx一起提供,不需要额外单独准备第二个目录。
文档完善
- 更新
TASKS.md与DECISIONS.md,记录本次“依赖显式化 + reference 化”的背景、取舍与结果。
待办事项
- 后续如新增或删除 Python 包、系统命令或同级 skill 目录依赖,同步更新
references/setup-dependencies.md与scripts/requirements.txt。
[1.4.46] - 2026-04-07
新增
- 新增
scripts/run_apply_review_plan.ps1,作为面向 Windows / 中文路径场景的薄包装器入口。 - 包装器现在会将
input / plan / output / report / report-docx / logstaging 到 ASCII 临时目录后再调用apply_review_plan.py,并在执行结束后把用户可见产物拷回原始目录。 - 新增 PowerShell 入口集成测试:在存在
pwsh / powershell时,校验“中文路径输入 + PowerShell 包装器 + Python 主流程”的端到端链路;未安装 PowerShell 时自动跳过。
改进
- 将 Windows 兼容策略明确收敛到“包装器处理路径与运行时差异,Python 继续作为唯一审查执行链路”,避免再维护第二套文档操作逻辑。
- 默认 Word 审查意见书输出现在也经过包装器显式 staging,避免
output_审查报告.docx这类默认衍生文件名在中文路径下直接暴露给 Python 主入口。 - 调整打包过滤规则:
dist/contract-copilot.zip现在会跳过.DS_Store、__pycache__、.pyc、运行时archive/内容、internal-notes/内部台账以及 gitignore 命中的本地配置,避免把缓存、归档、来源材料和本地记忆误打进发布包。
技术优化
- 为共享打包脚本补充回归测试,覆盖“跳过 transient 文件”“跳过
internal-notes/”“跳过 gitignore 本地配置”三类场景;重新打包后,当前contract-copilot.zip已收敛为仅包含技能本体和必要示例文件。
文档完善
- 更新
README.md与scripts/README.md,补充 PowerShell 包装器调用示例、适用场景和 WPS 人工验证建议。 - 更新
TASKS.md与DECISIONS.md,记录本次“兼容层增强而不改方法层”以及“打包发布面清理”的取舍。
待办事项
- 在真实 Windows + WPS Office 环境完成一次人工冒烟验证,确认中文路径下的修订痕迹、批注和接受/拒绝修订功能显示正常。
[1.4.45] - 2026-03-31
改进
- 将
README.md从内部说明风格重写为面向外部使用者的项目型首页,收敛首页信息密度,重点保留“是什么、怎么装、怎么跑、会产出什么”。 - 新增面向 Claude Code 的两种安装口径:通过
legal-skills技能集安装,以及手动复制contract-copilot/目录安装。 - 新增面向 OpenClaw 与其他本地运行时的通用导入说明,不再把 README 写成仅供当前仓库内部使用的文档。
- README 中补充首次配置、审查人配置、审查上下文记忆、快速开始、默认输出物和常见说明,降低外部使用门槛。
文档完善
- 修正
README.md中config/树状结构的 ASCII 漂移,确保example文件与运行时文件的展示层级正确。 - 清理
TASKS.md中与当前目录结构冲突的旧描述,不再保留“删除 config 目录”这类过时表述。 - 更新
DECISIONS.md与TASKS.md,同步记录本次“README 项目化改写 + 配置文档治理”的背景和结果。
[1.4.44] - 2026-03-31
新增
- 新增
config/review_memory.example.json,作为“客户名称 / 审查立场 / 审查口径”本地记忆模板。 apply_review_plan.py新增--client-name、--party-role、--review-intensity参数,支持显式覆盖本次审查上下文。- 新增运行时“审查上下文记忆”能力:按合同名记录客户名称、立场与口径,后续命中同名合同可自动回填。
改进
- 将“审查口径”正式接入动作分流:
克制 -> comment-first、常规 -> balanced、强势 -> revise-first,不再只是文档层概念。 apply_review_plan.py现在会在执行前统一解析客户名称、立场与口径,并将其写入执行日志和审查意见书。- 审查意见书首页新增“客户名称”和“审查口径”字段,方便后续留痕和复核。
- 交互模式下,若用户未说明客户名称、立场或口径,会先询问;非交互脚本场景则优先复用历史记录并保持既有默认执行口径兼容。
技术优化
review_runtime.py扩展为“审查人配置 + 审查上下文记忆 + 时间线”统一运行时模块。- 新增回归测试,覆盖审查上下文记忆落盘、历史命中回填,以及执行入口写入
review_context的场景。
文档完善
- 更新
SKILL.md、README.md、scripts/README.md、ARCHITECTURE.md、templates/审查报告模板.md、TASKS.md、DECISIONS.md、ROADMAP.md与根目录README.md,同步新的审查上下文确认与本地记忆机制。
[1.4.43] - 2026-03-26
改进
- 在
action_executor.py中新增“仅写入意见书(report-only)”第三通道,不再把所有识别出的风险都直接落到 Word 修订或批注里。 - 收紧默认执行口径:
revise-first仍保留“确定性问题优先直接改”的总体方向,但会先过滤掉程序优化型、说明型、低必要性条款;这类问题默认改为“仅写入意见书”或“保留批注”,不再直接改正文。 - 修正显式
replace与deterministic_edit的耦合误伤:不再因为上游计划把某条风险写成replace,就自动视为必须正文直改。 - 收紧“轻微文字修订”识别条件:只有目标文本本身足够短时,才把“5日/5天、编号、标点”类问题视为轻微 clerical 修订,避免长条款因包含此类字样被误判为应直接修订。
- 扩展占位识别边界:
邮箱、待补等待填信息现在会稳定回退为就地批注,而不是误沉到“仅意见书”。 - 基于同一份设计委托合同样张多轮重跑收束:当前
v16样张相较v11,已从53处插入 /51处删除 /19条批注,收敛到9处插入 /7处删除 /14条批注,并将11项优化型问题退出 Word 页面,仅保留在意见书。
新增
- 新增回归测试,覆盖
report-only动作、长条款不再误判为轻微 clerical、邮箱占位项回退批注、P1 优化型条款退出 Word 正文等场景。
文档完善
- 更新
README.md、SKILL.md、scripts/README.md、references/revision-strategy.md、TASKS.md、DECISIONS.md、ROADMAP.md与根目录README.md,同步“修订 / 批注 / 仅意见书”三段分流的新口径与版本号。
[1.4.42] - 2026-03-26
新增
- 新增
ARCHITECTURE.md,将contract-copilot正式固定为“立场与授权 / 方法论 / 知识清单 / 动作收束 / 文档执行 / 交付呈现 / 治理与验证”七层总纲。
文档完善
- 更新
README.md、SKILL.md、TASKS.md、DECISIONS.md、ROADMAP.md与根目录README.md,将七层模型接入现有入口文档,避免继续只散落在对话和局部说明中。
[1.4.41] - 2026-03-26
改进
- 新增“审查密度收敛”规则:复杂条款的多段最小差异修订现在会优先合并过碎的微小修改岛,避免同一条款炸出十几个单字级
w:del / w:ins,审阅视图更接近律师人工修订。 - 保留局部修订能力的同时,新增可读性上限:若同一条替换会拆成过多可见修订块,执行器会自动收敛成更少、更成组的修改痕迹,而不是继续展示低价值的标点/单字级碎改。
- 新增显式占位兜底:即使
review-plan.json错把留空项写成replace,运行时也会自动降为comment,避免把负责人、联系方式、附件等待填信息直接代填进合同。 - 修正占位识别误判边界:现在只有描述字段明确指向“留空/待填”,或目标文本本身真的包含占位符时,才会降为批注;不会再因为正常条款里出现“负责人”等普通词语就误把实质修订打回批注。
新增
- 新增回归测试,覆盖“显式
replace的留空项自动降为批注”“含负责人普通表述的非留空条款仍保持直接修订”“复杂长条款自动收敛为更少修订块”等场景。
文档完善
- 更新
README.md、SKILL.md、scripts/README.md、references/revision-strategy.md、TASKS.md、DECISIONS.md、ROADMAP.md与根目录README.md,同步新的审查密度收敛规则与版本号。
[1.4.40] - 2026-03-26
改进
- 调整 Word 审查时间线为两层错峰:同一条审查意见内部,每个实际落到 Word 的修订/批注批次默认相隔
1-2分钟;不同审查意见之间继续保持5-10分钟的大间隔。 - 修正批注写入链的时间消费方式:同一条批注在
comments.xml、commentsExtended.xml、commentsExtensible.xml等内部文件写入时,统一共用同一个逻辑时间,不再因为底层 OOXML 多次落盘而被意外拉长。
新增
- 新增时间线单测,覆盖“同一 finding 内 1-2 分钟步进 + finding 之间 5 分钟以上间隔”。
- 新增真实 DOCX 集成测试,直接校验“同一条 replace 后附带 comment”时,批注时间会晚于修订时间
1-2分钟。
文档完善
- 更新
README.md、SKILL.md、scripts/README.md、TASKS.md、DECISIONS.md、ROADMAP.md与根目录README.md,同步新的两层错峰时间线规则与版本号。
[1.4.39] - 2026-03-26
改进
- 收紧 Word 审查意见书版式密度:左右页边距由
1800收窄到1440,正文与元信息段落行距、段前段后距同步压缩,整体页感更接近 Alpha 样张的正式意见书。 - 调整“详细审查意见”表格布局:标签列收窄、内容列加宽,表格行距压到
260,单元格上下内边距归零、左右内边距收窄,减少不必要换行与空白。 - 每条详细意见后的空段改为更紧的表格间距,不再额外拉长全文页数。
新增
- 新增 Word 报告回归断言,校验紧凑版式下的页边距、表格行距与单元格内边距参数。
文档完善
- 更新
README.md、SKILL.md、scripts/README.md、TASKS.md、DECISIONS.md、ROADMAP.md与根目录README.md,同步“紧凑型审查意见书版式”能力与版本号。
[1.4.38] - 2026-03-26
改进
- 将最小差异修订从“单个中段替换”升级为“多段差异修订”:同一条款中存在多处改动时,会尽量拆成多组局部
w:del / w:ins,而不是继续生成一个很长的中段重写块。 reviewer.py现在基于多段 diff 生成段内修订片段;复杂长条款在存在多个稳定相同片段时,会优先保留这些不变片段,只对变化点逐处落痕。- 真实样张验证显示,设计委托合同
v7的平均删除块长度已从53.3字降到6.0字,平均插入块长度已从68.9字降到9.3字,审阅视图显著更接近人工逐句修订。
新增
- 新增真实 DOCX 集成测试,覆盖“同一条款内多处差异拆成多个小修订块”的场景,确保复杂句子不会再默认收敛成单个大替换块。
文档完善
- 更新
README.md、SKILL.md、scripts/README.md、TASKS.md、DECISIONS.md、ROADMAP.md与根目录README.md,同步“多段最小差异修订”能力与版本号。
待办事项
- 继续优化复杂长条款的样式碎片保留与超长替换块收敛,进一步缩小与 Alpha 样张在极复杂条款上的观感差距。
[1.4.37] - 2026-03-26
改进
- 审查修订链路新增“首轮最小差异修订”能力:同一
w:r内的短语替换/删除会优先拆成局部w:del/w:ins,不再默认整条 run 删除后重写。 - 当目标文本跨多个
w:r时,执行器会优先退到“段落内局部片段修订”,只对命中的短语片段生成修订痕迹,而不是整段删掉重写。 apply_review_plan.py的执行日志文案同步区分“已完成局部替换 / 已完成局部删除”与“已按段落级重写”,便于判断本次落地颗粒度。
新增
- 新增真实 DOCX 集成测试,覆盖同一 run 内短语替换、跨 run 片段替换和局部短语删除三类最小差异修订场景。
文档完善
- 更新
README.md、SKILL.md、scripts/README.md、references/revision-strategy.md、TASKS.md、DECISIONS.md、ROADMAP.md与根目录README.md,同步“首轮最小差异修订”能力与版本号。
待办事项
- 继续优化复杂长条款的局部拼接与样式保留,减少大段替换在审阅视图中的存在感。
[1.4.36] - 2026-03-25
改进
- 默认对外交付的审核版 DOCX 收敛为“修订批注一体版”:确定性问题继续直接修订,留空项/事实待补项保持批注,重大直接修订默认附带解释性批注。
- 自动批注模板参考 Alpha / 智合 样式调整为
风险等级 / 风险点 / 条款位置 / 说明 / 修改建议 / 可选建议措辞,降低“技术提示味”,更接近律师审阅表达。 - 审查意见书结构参考 Alpha 的正式出件方式升级为“致函开篇 + 合同概况 + 综合审查意见 + 重要风险提示 + 详细审查意见 + 声明 + 出具信息”,更贴近对客法律意见书。
新增
- 新增回归测试,覆盖“留空项保持 comment-only”“重大直接修订同时保留批注说明”“正式意见书结构包含重要风险提示与声明”等场景。
文档完善
- 更新
README.md、SKILL.md、scripts/README.md、references/revision-strategy.md、TASKS.md、DECISIONS.md、ROADMAP.md与根目录README.md,同步新的修订批注一体版口径与意见书结构。
待办事项
- 继续细化最小差异修订能力,减少整条
replace与段落级 fallback 带来的大块修订痕迹。
[1.4.35] - 2026-03-25
新增
- 新增
references/revision-strategy.md,将“直接修订 / 局部删减 / 局部补入 / 整条重写 / 仅作批注”的展现策略单独沉淀为方法层文件。
改进
- 明确留空项、事实待补项、授权不明的商务取舍项默认只批注,不直接代填。
- 明确准确的法条引用默认不因篇幅较长而删减,只有错误、过时、冲突或误导时才修改。
- 明确修订动作内部遵循“局部删减 / 局部补入优先于整段重写”的默认口径。
文档完善
- 更新
README.md、SKILL.md、references/review-framework.md、references/priority-clauses.md、scripts/README.md、TASKS.md、DECISIONS.md、ROADMAP.md与根目录README.md,同步新的方法层文件与版本号。
[1.4.34] - 2026-03-25
改进
- Word 审查意见书中的无序列表与编号列表改为 OOXML 原生列表,不再只是“圆点字符 + 普通段落”的模拟样式,层级显示更稳定。
- “具体审查意见”段落改为表格化展示:每条意见以独立表格呈现标题、风险等级、条款位置、风险概述、审查意见、原条款、建议修改和法律依据,更接近正式律师出件样式。
新增
- 新增 Word 报告回归断言,校验
numbering.xml、原生列表关系和具体审查意见表格块均已写入 DOCX。
文档完善
- 更新
README.md、SKILL.md、scripts/README.md、TASKS.md、DECISIONS.md、ROADMAP.md与根目录README.md,同步新的报告渲染样式与版本号。
[1.4.33] - 2026-03-25
修复
- 修正 Word 批注/修订时间戳的时区策略:现在会先读取本机当前时区与本地时间,再向后错峰写入,
w:date使用本地时区偏移格式,避免显示出 UTC 时间或错误时区时间。 - 保留
w16du:dateUtc等 UTC 扩展字段,兼顾 Word 显示效果与底层 OOXML 兼容性。
文档完善
- 更新
README.md、SKILL.md、scripts/README.md、TASKS.md、DECISIONS.md、ROADMAP.md与根目录README.md,同步“本机时区优先”的时间线说明与版本号。
[1.4.32] - 2026-03-25
改进
- 升级 Word 版审查意见书的默认版式,吸收“法律服务方案”预设中的深蓝标题、仿宋正文、浅底元信息卡和棕色标签高亮,输出更接近正式律师交付件。
- 为 Word 意见书补入页脚页码、统一的 1.5 倍行距和更清晰的章节层级,保持 OOXML 直出路径不变。
新增
- 新增版式回归测试,校验 Word 报告中的分区底色、字体配置和页脚页码部件。
文档完善
- 更新
README.md、SKILL.md、scripts/README.md、TASKS.md、DECISIONS.md、ROADMAP.md与根目录README.md,同步新的 Word 意见书版式说明与版本号。
[1.4.31] - 2026-03-25
改进
- 对外报告从“风险清单式审查报告”进一步收敛为更接近律师交付件的“审查意见书”体例:前部先写合同概况与综合审查意见,后部再按正式意见逐项展开。
- 具体审查意见现在按单项问题逐条展开,并补入“原条款 / 建议修改 / 法律依据”等字段,便于客户和律师直接对照使用。
- Word 报告元数据标题同步调整为“审查意见书”口径。
新增
- 新增回归测试,覆盖新的意见书结构、Word 正文标题和端到端报告内容断言。
文档完善
- 更新
README.md、SKILL.md、scripts/README.md、templates/审查报告模板.md、TASKS.md、DECISIONS.md、ROADMAP.md与根目录README.md,同步新的意见书体例说明。
[1.4.30] - 2026-03-24
修复
- 修正审查时间线生成逻辑:批注与修订的时间戳不再向前倒推,而是以本次命令执行时点为起点,仅向后顺延。
- 补充回归校验,确保写入到 Word 的批注和修订时间不会早于命令实际启动时间。
文档完善
- 更新
README.md、SKILL.md、scripts/README.md、TASKS.md、DECISIONS.md、ROADMAP.md与根目录README.md,同步新的时间线语义。
[1.4.29] - 2026-03-24
改进
- 默认自动分流策略调整为
revise-first:能形成明确改文的审查项,优先直接修订,而不是仅留批注。 - 在
revise-first下,若审查项已提供可直接落文的recommended_text,即使未显式给出replacement_text,也会优先提升为直接替换文本。 - 保留
balanced与comment-first两种回退策略,便于在不同审查风格之间切换。
新增
- 新增
--edit-policy参数,并支持在计划的meta.edit_policy中显式声明自动分流策略。 - 新增回归测试,覆盖
recommended_text直转修订、comment-first保守回退,以及 CLI 默认采用revise-first的执行链路。
文档完善
- 更新
README.md、SKILL.md、scripts/README.md、TASKS.md、DECISIONS.md、ROADMAP.md与根目录README.md,同步新的“改文优先”执行口径。
[1.4.28] - 2026-03-24
改进
- 审查报告调整为“合同概要速览 + 综合审查意见 + 风险清单”的阅读顺序,方便客户和审查人先快速理解合同基本面与总体结论。
- 执行命中率、失败项和其他内部质量统计默认不再写入对外报告,仅保留在
*_执行日志.json。 - 自动生成的批注格式升级为多行结构化模板:
风险等级 / 问题类型 / 风险说明 / 处理建议 / 可选建议措辞。
新增
- 扩展审查计划
summary字段示例,支持contract_type、parties、contract_amount、contract_term、business_overview、key_milestones等报告速览字段。 - 新增回归测试,覆盖新的报告前置结构与自动批注模板。
文档完善
- 更新
README.md、SKILL.md、scripts/README.md、templates/审查报告模板.md、TASKS.md、DECISIONS.md与根目录README.md,同步新的报告结构和批注格式说明。
[1.4.27] - 2026-03-24
改进
- 调整
apply_review_plan.py的默认交付边界:用户目录现在只保留审核修订版 DOCX 与 Word 审查报告。 - Markdown 审查报告、执行日志和审查计划副本默认不再外露到用户目录,而是直接沉淀到
archive/<时间戳_合同名>/。 - 保留
--no-archive作为调试模式:关闭归档时,Markdown 报告和执行日志仍会直接输出到当前目录。
新增
- 新增归档模式集成测试,覆盖“默认只对外交付两个 DOCX,其余过程文件进入 archive/”场景。
文档完善
- 更新
README.md、SKILL.md、scripts/README.md、TASKS.md、DECISIONS.md与根目录README.md,同步新的交付边界与归档说明。
[1.4.26] - 2026-03-24
新增
- 新增
scripts/review_runtime.py,统一管理审查人本地配置与审查时间线。 - 新增
config/reviewer_profile.example.json,作为审查人本地配置模板。 - 首次执行
apply_review_plan.py时,支持交互录入审查人姓名、律所/公司名称和可选部门,或在首次显式传入--author/--organization时自动写入config/reviewer_profile.json。 - 新增真实 DOCX 集成测试,覆盖“审查人配置落盘 + 批注/修订时间戳错峰写入”场景。
改进
- 写入 Word 的批注与修订默认按 5 到 10 分钟区间错开时间戳,降低整批审查意见在同一分钟内落地的机械痕迹。
docx/scripts/document.py与scripts/reviewer.py新增可注入时间戳能力,使批注、修订、回复批注共用同一条审查时间线。- Markdown / Word 审查报告现在会复用同一份审查人配置,统一展示审查人、所属机构/公司和所属部门。
- 若本地配置缺少姓名或机构信息,脚本不再静默回退默认值,而是要求先补全配置。
- 取消 initials 自动生成;若本地配置未填写 initials,则不会再自动推导,也不会把
w:initials写入 Word 批注。 - Word 批注作者显示调整为
姓名|机构,例如杨卫薪律师|剑桥颐华律师事务所。
文档完善
- 更新
README.md、SKILL.md、scripts/README.md、TASKS.md、DECISIONS.md、ROADMAP.md,同步审查人配置、报告署名和时间戳行为说明。
待办事项
- 继续把
references/priority-clauses.md扩充为按 12 类细化的速查页。 - 继续按目录补充房地产、建设工程、公司投资的细分起草条款模块。
- 继续推进 marketplace 版本同步。
[1.4.21] - 2026-03-24
改进
- 调整
scripts/apply_review_plan.py的执行语义:若存在未成功落地到 Word 的审查项,脚本仍保留输出文件,但会以非零退出码结束,避免上层流程误判为“全部成功”。 - 强化文本定位稳健性:支持
occurrence指定重复文本的命中位置,并在replace/delete遇到跨w:r拆分文本时回退到段落级重写。 - 审查报告现在逐项回写执行状态与执行说明,区分“识别出的风险”和“实际落地的文档修改”。
新增
- 新增
scripts/report_docx.py,使用 OOXML 直接生成 Word 版审查报告。 apply_review_plan.py默认新增输出*_审查报告.docx。- 新增真实 DOCX 集成测试,覆盖歧义定位失败、跨
w:r替换成功和 Word 报告产出。
文档完善
- 更新
README.md、SKILL.md、scripts/README.md、TASKS.md、DECISIONS.md、ROADMAP.md,同步新的执行语义、定位说明和报告产物。
待办事项
- 继续把
references/priority-clauses.md扩充为按 12 类细化的速查页。 - 继续按目录补充房地产、建设工程、公司投资的细分起草条款模块。
- 继续推进 marketplace 版本同步。
[1.4.20] - 2026-03-24
改进
- 将
references/重组为“入口文件 + contract-types”结构:根层保留review-framework.md、contract-routing.md、priority-clauses.md,12 类合同主文件统一收进references/contract-types/。 - 将原
references/12类合同全量映射清单.md重命名为references/contract-routing.md,降低顶层结构的目录同构感,同时保留审查分流与起草路由能力。 - 新增
references/priority-clauses.md作为审查入口层的总控速查页。
文档完善
- 更新
SKILL.md、README.md、ROADMAP.md、TASKS.md、DECISIONS.md,同步新的目录结构与调用顺序。
待办事项
- 继续把
references/priority-clauses.md扩充为按 12 类细化的速查页。 - 继续按目录补充房地产、建设工程、公司投资的细分起草条款模块。
- 继续推进 marketplace 版本同步。
[1.4.19] - 2026-03-22
改进
- 扩充
references/12类合同全量映射清单.md的起草能力,新增“推荐交付包型”“起草分流问题与必带文件”“起草骨架优先顺序”等内容,让映射清单可直接产出起草路由卡。 - 将
templates/合同起草信息清单.md从简单事实清单升级为“起草工作台”,承接主文件、文件包、待补事实、程序性前提和待确认问题。 - 更新
SKILL.md与README.md的起草流程说明,明确起草交付至少包含“起草路由卡 + 条款骨架 + 待确认问题表”。
待办事项
- 建立 12 类合同“优先审查条款”速查页。
- 继续按目录补充房地产、建设工程、公司投资的细分起草条款模块。
- 继续推进 marketplace 版本同步。
[1.4.18] - 2026-03-22
改进
- 从 12 类合同主文件中抽取首批高频共性起草条款,补强
templates/条款库.md,新增文件优先级、交付与验收、配合义务、条件成就与长停、通知送达、责任限制及例外等通用结构模块。 - 重写
templates/条款库.md中的知识产权条款,区分背景知识产权、定制成果、第三方素材与侵权责任,减少“一刀切归属”带来的起草偏差。 - 新增里程碑与阶段验收、交割条件与交割清单两组专项条款,补足技术开发、建设工程、投资和资产交易场景的起草支撑。
文档完善
- 更新
SKILL.md、README.md、TASKS.md、DECISIONS.md,同步条款库的当前定位和任务进度。
待办事项
- 建立 12 类合同“优先审查条款”速查页。
- 继续按目录补充房地产、建设工程、公司投资的细分起草条款模块。
- 继续推进 marketplace 版本同步。
[1.4.17] - 2026-03-22
新增
- 新增
templates/合同起草信息清单.md,用于在起草前固定主合同类型、配套协议类型、待补事实和程序性前提。
改进
- 将
references/12类合同全量映射清单.md从“审查分流索引”扩展为“审查 / 起草双用途入口”,补入 12 类合同的起草调用速查信息。 - 更新
SKILL.md与README.md的起草流程说明,明确起草链路为“通用框架 -> 映射清单 -> 起草信息清单 -> 合同主文件 -> 条款库”。 - 更新
templates/条款库.md的定位说明,明确其只负责提供通用候选措辞,不替代映射清单和主文件确定合同骨架。
待办事项
- 建立 12 类合同“优先审查条款”速查页。
- 从 12 类合同主文件中抽取高频共性条款,持续迭代
templates/条款库.md。 - 继续推进 marketplace 版本同步。
[1.4.16] - 2026-03-22
文档完善
- 删除重复的根层文档
审查原则.md与优化说明.md。 - 明确将审查方法统一收口到
SKILL.md,将优化过程与结果统一收口到CHANGELOG.md、ROADMAP.md、TASKS.md与DECISIONS.md。
待办事项
- 建立 12 类合同“优先审查条款”速查页。
- 从 12 类合同主文件中抽取高频共性条款,持续迭代
templates/条款库.md。 - 继续推进 marketplace 版本同步。
[1.4.15] - 2026-03-22
改进
- 将
references/00-通用框架.md重命名为references/review-framework.md。 - 将
references/01-12类合同全量映射清单.md重命名为references/12类合同全量映射清单.md。 - 保留 12 类合同目录编号,但去掉根层两个总控文件的序号前缀,降低命名冲突。
文档完善
- 更新
README.md、SKILL.md、TASKS.md、DECISIONS.md、templates/条款库.md及相关路径引用,统一新的文件名。
待办事项
- 建立 12 类合同“优先审查条款”速查页。
- 从 12 类合同主文件中抽取高频共性条款,持续迭代
templates/条款库.md。 - 继续推进 marketplace 版本同步。
[1.4.14] - 2026-03-22
改进
- 将 12 类合同主文件目录从技能根目录移回
references/根层,统一为同一套参考资料体系。 - 明确合同起草与合同审查共用
references/review-framework.md、references/12类合同全量映射清单.md和 12 类合同主文件,不再额外平行维护另一套起草 reference。 - 重新定义
templates/条款库.md的定位:作为从各类合同主文件中抽取的通用候选条款库,用于辅助起草,不替代对应类型主文件。
文档完善
- 更新
README.md、SKILL.md、TASKS.md、DECISIONS.md、ROADMAP.md、CLAUDE.md、优化说明.md与references/12类合同全量映射清单.md,同步新的目录结构和起草调用顺序。
待办事项
- 建立 12 类合同“优先审查条款”速查页。
- 从 12 类合同主文件中抽取高频共性条款,持续迭代
templates/条款库.md。 - 继续推进 marketplace 版本同步。
[1.4.13] - 2026-03-22
改进
- 将
合同类型/目录从references/中移出,直接放到技能根目录,references/只保留通用框架与映射清单。 - 同步更新
README.md、SKILL.md、references/12类合同全量映射清单.md及协作文档中的当前路径说明,明确“通用参考资料”和“合同主文件”分层。
待办事项
- 建立 12 类合同“优先审查条款”速查页。
- 评估是否为映射清单补充机器可读格式(如 CSV/JSON)。
- 继续推进 marketplace 版本同步。
[1.4.12] - 2026-03-22
改进
- 将
references/01-引用导航.md与references/03-审查流程指引.md的核心内容并入SKILL.md,不再单独保留短小说明文件。 references/根层现收敛为review-framework.md、12类合同全量映射清单.md、02-合同类型/,只保留高复用硬资料。
文档完善
- 更新
README.md、SKILL.md、TASKS.md、DECISIONS.md、ROADMAP.md、CLAUDE.md、优化说明.md,同步新的入口分工与目录结构。
待办事项
- 建立 12 类合同“优先审查条款”速查页。
- 评估是否为映射清单补充机器可读格式(如 CSV/JSON)。
- 继续推进 marketplace 版本同步。
[1.4.11] - 2026-03-22
改进
- 为
references/根层入口统一增加顺序编号,强化目录可扫性与调用顺序表达。 - 同步更新
README.md、SKILL.md、引用导航.md、12类合同全量映射清单.md及协作文档中的路径引用,确保目录排序与调用顺序一致。
待办事项
- 建立 12 类合同“优先审查条款”速查页。
- 评估是否为映射清单补充机器可读格式(如 CSV/JSON)。
- 继续推进 marketplace 版本同步。
[1.4.10] - 2026-03-22
改进
- 将 12 类合同目录整体下沉到
合同类型/,使references/根层更聚焦于审查框架、映射清单、引用导航和审查流程。 - 更新
references/01-引用导航.md、references/12类合同全量映射清单.md、README.md、SKILL.md中的目录路径说明,统一新的主文件位置。 - 删除
references/03-审查流程指引.md各阶段的分钟估计,避免使用人工审查时长去限定 AI 审查流程。
文档完善
- 更新
TASKS.md、DECISIONS.md、ROADMAP.md,记录目录层级调整与流程文档去时间化的当前口径。
待办事项
- 建立 12 类合同“优先审查条款”速查页。
- 评估是否为映射清单补充机器可读格式(如 CSV/JSON)。
- 继续推进 marketplace 版本同步。
[1.4.9] - 2026-03-22
改进
- 删除
references/专项议题适用索引.md与 4 份专项议题-*.md,取消横向专题体系,references/回归“引用导航 + 通用框架 + 映射清单 + 12 类主目录 + 流程指引”的主线结构。 - 重写
references/01-引用导航.md与references/12类合同全量映射清单.md的调用说明,统一为“通用框架 -> 映射清单 -> 合同主文件 -> 流程指引”。
文档完善
- 更新
README.md、SKILL.md、TASKS.md、DECISIONS.md,同步去专题化后的当前结构与版本号。
待办事项
- 建立 12 类合同“优先审查条款”速查页。
- 评估是否为映射清单补充机器可读格式(如 CSV/JSON)。
- 继续推进 marketplace 版本同步。
[1.4.8] - 2026-03-22
新增
- 新增
references/01-引用导航.md,将references/明确拆分为“基础规则层 / 类型路由层 / 合同主文件层 / 专题叠加层”四层入口。 - 新增
references/专项议题适用索引.md,统一记录专项议题的触发条件、优先叠加目录与常见组合。
改进
- 为
references/review-framework.md、03-审查流程指引.md、12类合同全量映射清单.md以及 4 份专项议题文件补充结构化角色说明,明确各自的定位、输入输出与适用场景。 - 更新
README.md与SKILL.md的调用顺序说明,改为“先看引用导航,再走映射与专题路由”的统一入口。
待办事项
- 建立 12 类合同“优先审查条款”速查页。
- 评估是否为映射清单补充机器可读格式(如 CSV/JSON)。
- 继续推进 marketplace 版本同步。
[1.4.7] - 2026-03-22
改进
- 将
合同类型/01-sale/、02-lease/、04-ip/、05-guarantee/、06-lending-gift/、07-internet/、08-marriage-family/、09-employment/、10-real-estate/、11-construction/、12-corporate-investment/下剩余 45 份旧模板重写为统一的“宏观/中观/微观 + 9 列字段表”结构。 references/下 64 份合同参考文件现已全部使用同一风险字段标准,并同步补齐推荐措辞、风险示例、整改建议等核心字段。
文档完善
- 更新
TASKS.md、DECISIONS.md、README.md、SKILL.md,记录本次全量标准化完成状态并同步版本号。
待办事项
- 建立 12 类合同“优先审查条款”速查页。
- 建立合同文件年度复核机制(条款有效性与实务可执行性)。
- 继续推进 marketplace 版本同步。
[1.4.6] - 2026-03-22
改进
- 将
合同类型/03-service/下 7 份旧模板重写为统一的“宏观/中观/微观 + 9 列字段表”结构: 一般服务合同.md中介合同.md广告服务合同.md承揽合同.md物业服务合同.md行纪合同.md运输合同.md- 统一服务类合同的风险字段表达口径,补齐服务边界、验收流程、费用结算、知识产权、数据合规、退出交接等高频审查点。
文档完善
- 更新
TASKS.md、DECISIONS.md、README.md、SKILL.md,记录本次批次化内容标准化进展并同步版本号。
待办事项
- 继续按目录推进
04-ip/、09-employment/、12-corporate-investment/等旧模板标准化。 - 继续推进 marketplace 版本同步。
[1.4.5] - 2026-02-09
新增
- 新增
scripts/enrich_review_plan.py:在生成阶段自动补全审查项的needs_negotiation/deterministic_edit字段。 - 新增
plan_loader.enrich_plan()与enrich_findings(),统一计划字段补全入口。
改进
scripts/apply_review_plan.py默认在执行前自动补全计划策略字段,减少因标记遗漏导致的批注/修订分流偏差。- 新增参数
--no-enrich-plan,可在需要严格复现原计划时关闭自动补全。
技术优化
- 扩展
scripts/tests/test_plan_loader.py,覆盖显式动作推断、显式字段保留、auto关键词推断等路径。
文档完善
- 更新
SKILL.md、README.md、scripts/README.md,补充“生成阶段自动补字段”流程与命令示例。 - 更新
TASKS.md、DECISIONS.md,记录本次计划补全能力落地。
待办事项
- 继续推进 marketplace 版本同步。
[1.4.4] - 2026-02-09
新增
- 新增
action=auto动作分流能力:可根据审查项特征自动选择comment或修订动作(replace/insert/delete)。 - 新增动作别名兼容:支持中文动作标识(如
批注、修订、删除、插入、自动)。
改进
- 优化
scripts/action_executor.py的动作归一化与判定逻辑,统一输出requested_action与实际执行action,便于执行日志复盘。 - 在不影响既有显式动作(
comment/delete/insert/replace)的前提下,为自动化计划提供“谈判项优先批注、确定性改动优先修订”的默认落地策略。
技术优化
- 扩展
scripts/tests/test_action_executor.py回归用例,覆盖: - 中文动作别名归一化;
auto + needs_negotiation场景自动走批注;auto + deterministic_edit场景自动走修订。
文档完善
- 更新
SKILL.md、README.md、scripts/README.md:补充“批注/修订判定口径”与action=auto用法说明。 - 更新
TASKS.md、DECISIONS.md:记录本次规则落地的任务状态与设计决策。
待办事项
- 继续推进 marketplace 版本同步。
[1.4.3] - 2026-02-09
修复
- 修复
scripts/action_executor.py在replace + selector场景下的标签不一致问题:统一采用selector.tag > finding.tag > action 默认值。 - 修复
replace在未提供target_text时依赖二次文本检索的问题,改为直接按 selector 定位节点执行替换。
技术优化
- 新增
ContractReviewer.replace_node(),支持节点级替换(删除目标节点 + 插入新文本)。 - 新增回归测试:
scripts/tests/test_action_executor.pyscripts/tests/test_plan_loader.py- 重新打包并校验
dist/contract-copilot.zip,确保与当前源码同步。
文档完善
- 更新
TASKS.md、DECISIONS.md、SKILL.md、README.md、scripts/README.md,同步本次修复与测试策略。
待办事项
- 继续推进 marketplace 版本同步。
[1.4.2] - 2026-02-09
改进
- 对
scripts/apply_review_plan.py做最小解耦重构,入口仅保留流程编排。 - 新增
scripts/plan_loader.py,统一审查计划加载与结构校验。 - 新增
scripts/action_executor.py,统一动作分发与节点定位逻辑。 - 新增
scripts/archive_service.py,统一归档命名与manifest.json生成逻辑。 - 更新
scripts/README.md,补充分层脚本结构说明。
技术优化
- 降低单文件复杂度,减少计划解析/动作执行/归档逻辑互相耦合,便于后续动作扩展与单元测试。
待办事项
- 为
plan_loader与action_executor增加独立回归用例,覆盖更多异常输入场景。
[1.4.1] - 2026-02-09
改进
- 删除未使用且为空的目录:
contract-copilot/assets/、contract-copilot/config/。 - 保留实际在流程中使用的目录:
references/、scripts/、templates/、archive/。
技术优化
- 精简技能目录结构,减少无效目录对维护和分发的干扰。
待办事项
- 同步 marketplace 版本信息。
[1.4.0] - 2026-02-09
新增
- 新增
references/12类合同全量映射清单.md,将现有合同类型内容完整归入固定 12 类体系。 - 新增劳动用工缺口文件:
合同类型/09-employment/培训服务期协议.md合同类型/09-employment/竞业限制协议.md合同类型/09-employment/保密协议.md- 新增房地产缺口文件:
合同类型/10-real-estate/勾地协议.md合同类型/10-real-estate/土地置换协议.md合同类型/10-real-estate/拆迁安置补偿协议.md- 新增建设工程缺口文件:
合同类型/11-construction/内部承包合同.md- 新增公司投资缺口文件:
合同类型/12-corporate-investment/资产收购合同.md合同类型/12-corporate-investment/名股实债投资安排.md
改进
- 更新
SKILL.md:明确“全量覆盖但不扩类”策略,增加未单列类型归类规则和映射清单入口。 - 更新
README.md:补充映射清单调用顺序,统一审查入口。 - 更新
TASKS.md与DECISIONS.md:记录“全量映射 + 高风险单列”的执行策略与结果。 - 完成
dist/contract-copilot.zip打包与目录结构校验。
技术优化
- 将“合同类型识别”与“条款审查”解耦,形成“映射定位 -> 同类主文件 -> 专项议题”的标准路径。
待办事项
- 继续补齐剩余低深度文件,拉齐字段完整性与示例质量。
- 同步 marketplace 版本信息。
[1.3.1] - 2026-02-09
新增
- 新增
archive/目录及自动归档能力:每次执行后按archive/<时间戳_合同名>/存档。 - 新增归档清单
manifest.json,记录归档时间、关键文件和执行统计。 - 新增归档参数:
--archive-dir、--no-archive、--archive-no-input。
改进
- 更新
scripts/README.md、README.md、SKILL.md,补充归档能力和回溯使用说明。 - 更新
TASKS.md、ROADMAP.md、DECISIONS.md,同步归档能力的任务状态和设计理由。
技术优化
- 归档流程统一沉淀审查计划、执行日志、审查报告与输出 DOCX,减少交付文件被覆盖导致的追溯缺口。
待办事项
- 评估是否增加归档清理策略(按天数或数量保留),控制长期存储占用。
[1.3.0] - 2026-02-09
新增
- 新增
scripts/apply_review_plan.py,支持基于review-plan.json批量执行 DOCX 批注/修订(comment/delete/insert/replace)。 - 新增
scripts/reporting.py,支持根据审查计划与执行日志自动生成 Markdown 审查报告。 - 新增
ContractReviewer.add_comment_by_text()、insert_text_after()、replace_text()便捷接口。 - 新增
selector精准定位能力(tag/attrs/line_number/contains组合)用于多处同文案场景。
改进
- 更新
scripts/README.md:补充一体化执行命令、输入 JSON 结构和输出文件说明。 - 更新
README.md与SKILL.md:将 DOCX 处理流程升级为“计划执行 + 报告生成”的推荐路径。 - 更新
ROADMAP.md与TASKS.md:新增脚本自动化交付阶段并记录完成状态。
修复
- 修复
scripts/reviewer.py对docx脚本加载的兼容性,避免模块路径冲突导致导入失败。
技术优化
- 统一“AI 生成结构化结论 + 脚本执行文档操作 + 模板化报告输出”的交付链路,提升可重复执行性。
待办事项
- 用真实合同样本补充
apply_review_plan.py的回归用例(含多处同文案匹配与表格场景)。 - 在发布阶段完成
dist/contract-copilot.zip打包与 marketplace 版本同步。
[1.2.0] - 2026-02-09
新增
- 新增
references/03-审查流程指引.md,提供标准化审查执行流程。 - 新增 4 个专项议题文件(不新增合同类型):
references/专项议题-交易结构与担保.mdreferences/专项议题-公司投资并购程序.mdreferences/专项议题-房地产与建设工程程序.mdreferences/专项议题-劳动用工关键条款.md
改进
- 重写
SKILL.md: - 增加 frontmatter
- 统一为“分层四步审查框架”表达
- 修正合同类型覆盖说明与路径引用
- 重写
README.md,与当前目录结构保持一致。 - 重写
references/review-framework.md,统一字段化风险输出。 - 深化高频薄弱合同文件:
合同类型/03-service/保管仓储合同.md合同类型/12-corporate-investment/投资协议.md合同类型/10-real-estate/土地出让合同.md
修复
- 修复
scripts/reviewer.py导入冲突:避免本地scripts包与依赖模块同名导致ModuleNotFoundError。 - 修复
scripts/README.md的依赖路径与示例代码。
技术优化
- 清理技能文档中不必要的背景说明性表述,降低分发与版权风险。
- 更新
TASKS.md与DECISIONS.md,使任务与决策记录与现状一致。
待办事项
- 继续提升剩余合同文件深度,拉齐字段完整性。
- 进行打包验证并同步发布版本。
[1.1.0] - 2026-01-20
新增
- 增强知识产权类合同文件的审查细度。
改进
- 增加更多可复用的推荐措辞与审查提示。
待办事项
- 推进其他合同类别的深度补齐。
[1.0.0] - 2026-01-19
新增
- 建立
contract-copilot基础目录结构与核心文档。 - 提供基础合同审查参考内容、模板和脚本入口。
{
"contracts": {},
"clients": {}
}
{
"author": "",
"initials": "",
"organization": "",
"department": "",
"confirmed": false,
"time_gap_min_minutes": 5,
"time_gap_max_minutes": 10
}
Creative Commons Attribution-NonCommercial 4.0 International
Copyright (c) 2025 杨卫薪律师(微信ywxlaw)
=======================================================================
This work is licensed under the Creative Commons Attribution-NonCommercial 4.0 International License.
Commercial License
For commercial use licenses, please contact:
Email: secretxierluo@gmail.com
WeChat: ywxlaw (微信)
=======================================================================
The full text of the CC BY-NC 4.0 license is reproduced below:
Attribution-NonCommercial 4.0 International
=======================================================================
Creative Commons Corporation ("Creative Commons") is not a law firm and
does not provide legal services or legal advice. Distribution of
Creative Commons public licenses does not create a lawyer-client or
other relationship. Creative Commons makes its licenses and related
information available on an "as-is" basis. Creative Commons gives no
warranties regarding its licenses, any material licensed under their
terms and conditions, or any related information. Creative Commons
disclaims all liability for damages resulting from their use to the
fullest extent possible.
Using Creative Commons Public Licenses
Creative Commons public licenses provide a standard set of terms and
conditions that creators and other rights holders may use to share
original works of authorship and other material subject to copyright
and certain other rights specified in the public license below. The
following considerations are for informational purposes only, are not
exhaustive, and do not form part of our licenses.
Considerations for licensors: Our public licenses are
intended for use by those authorized to give the public
permission to use material in ways otherwise restricted by
copyright and certain other rights. Our licenses are
irrevocable. Licensors should read and understand the terms
and conditions of the license they choose before applying it.
Licensors should also secure all rights necessary before
applying our licenses so that the public can reuse the
material as expected. Licensors should clearly mark any
material not subject to the license. This includes other CC-
licensed material, or material used under an exception or
limitation to copyright. More considerations for licensors:
wiki.creativecommons.org/Considerations_for_licensors
Considerations for the public: By using one of our public
licenses, a licensor grants the public permission to use the
licensed material under specified terms and conditions. If
the licensor's permission is not necessary for any reason--for
example, because of any applicable exception or limitation to
copyright--then that use is not regulated by the license. Our
licenses grant only permissions under copyright and certain
other rights that a licensor has authority to grant. Use of
the licensed material may still be restricted for other
reasons, including because others have copyright or other
rights in the material. A licensor may make special requests,
such as asking that all changes be marked or described.
Although not required by our licenses, you are encouraged to
respect those requests where reasonable. More considerations
for the public:
wiki.creativecommons.org/Considerations_for_licensees
=======================================================================
Creative Commons Attribution-NonCommercial 4.0 International Public
License
By exercising the Licensed Rights (defined below), You accept and agree
to be bound by the terms and conditions of this Creative Commons
Attribution-NonCommercial 4.0 International Public License ("Public
License"). To the extent this Public License may be interpreted as a
contract, You are granted the Licensed Rights in consideration of Your
acceptance of these terms and conditions, and the Licensor grants You
such rights in consideration of benefits the Licensor receives from
making the Licensed Material available under these terms and
conditions.
Section 1 -- Definitions.
a. Adapted Material means material subject to Copyright and Similar
Rights that is derived from or based upon the Licensed Material
and in which the Licensed Material is translated, altered,
arranged, transformed, or otherwise modified in a manner requiring
permission under the Copyright and Similar Rights held by the
Licensor. For purposes of this Public License, where the Licensed
Material is a musical work, performance, or sound recording,
Adapted Material is always produced where the Licensed Material is
synched in timed relation with a moving image.
b. Adapter's License means the license You apply to Your Copyright
and Similar Rights in Your contributions to Adapted Material in
accordance with the terms and conditions of this Public License.
c. Copyright and Similar Rights means copyright and/or similar rights
closely related to copyright including, without limitation,
performance, broadcast, sound recording, and Sui Generis Database
Rights, without regard to how the rights are labeled or
categorized. For purposes of this Public License, the rights
specified in Section 2(b)(1)-(2) are not Copyright and Similar
Rights.
d. Effective Technological Measures means those measures that, in the
absence of proper authority, may not be circumvented under laws
fulfilling obligations under Article 11 of the WIPO Copyright
Treaty adopted on December 20, 1996, and/or similar international
agreements.
e. Exceptions and Limitations means fair use, fair dealing, and/or
any other exception or limitation to Copyright and Similar Rights
that applies to Your use of the Licensed Material.
f. Licensed Material means the artistic or literary work, database,
or other material to which the Licensor applied this Public
License.
g. Licensed Rights means the rights granted to You subject to the
terms and conditions of this Public License, which are limited to
all Copyright and Similar Rights that apply to Your use of the
Licensed Material and that the Licensor has authority to license.
h. Licensor means the individual(s) or entity(ies) granting rights
under this Public License.
i. NonCommercial means not primarily intended for or directed towards
commercial advantage or monetary compensation. For purposes of
this Public License, the exchange of the Licensed Material for
other material subject to Copyright and Similar Rights by digital
file-sharing or similar means is NonCommercial provided there is
no payment of monetary compensation in connection with the
exchange.
j. Share means to provide material to the public by any means or
process that requires permission under the Licensed Rights, such
as reproduction, public display, public performance, distribution,
dissemination, communication, or importation, and to make material
available to the public including in ways that members of the
public may access the material from a place and at a time
individually chosen by them.
k. Sui Generis Database Rights means rights other than copyright
resulting from Directive 96/9/EC of the European Parliament and of
the Council of 11 March 1996 on the legal protection of databases,
as amended and/or succeeded, as well as other essentially
equivalent rights anywhere in the world.
l. You means the individual or entity exercising the Licensed Rights
under this Public License. Your has a corresponding meaning.
Section 2 -- Scope.
a. License grant.
1. Subject to the terms and conditions of this Public License,
the Licensor hereby grants You a worldwide, royalty-free,
non-sublicensable, non-exclusive, irrevocable license to
exercise the Licensed Rights in the Licensed Material to:
a. reproduce and Share the Licensed Material, in whole or
in part, for NonCommercial purposes only; and
b. produce, reproduce, and Share Adapted Material for
NonCommercial purposes only.
2. Exceptions and Limitations. For the avoidance of doubt, where
Exceptions and Limitations apply to Your use, this Public
License does not apply, and You do not need to comply with
its terms and conditions.
3. Term. The term of this Public License is specified in Section
6(a).
4. Media and formats; technical modifications allowed. The
Licensor authorizes You to exercise the Licensed Rights in
all media and formats whether now known or hereafter created,
and to make technical modifications necessary to do so. The
Licensor waives and/or agrees not to assert any right or
authority to forbid You from making technical modifications
necessary to exercise the Licensed Rights, including
technical modifications necessary to circumvent Effective
Technological Measures. For purposes of this Public License,
simply making modifications authorized by this Section 2(a)
(4) never produces Adapted Material.
5. Downstream recipients.
a. Offer from the Licensor -- Licensed Material. Every
recipient of the Licensed Material automatically
receives an offer from the Licensor to exercise the
Licensed Rights under the terms and conditions of this
Public License.
b. No downstream restrictions. You may not offer or impose
any additional or different terms or conditions on, or
apply any Effective Technological Measures to, the
Licensed Material if doing so restricts exercise of the
Licensed Rights by any recipient of the Licensed
Material.
6. No endorsement. Nothing in this Public License constitutes or
may be construed as permission to assert or imply that You
are, or that Your use of the Licensed Material is, connected
with, or sponsored, endorsed, or granted official status by,
the Licensor or others designated to receive attribution as
provided in Section 3(a)(1)(A)(i).
b. Other rights.
1. Moral rights, such as the right of integrity, are not
licensed under this Public License, nor are publicity,
privacy, and/or other similar personality rights; however, to
the extent possible, the Licensor waives and/or agrees not to
assert any such rights held by the Licensor to the limited
extent necessary to allow You to exercise the Licensed
Rights, but not otherwise.
2. Patent and trademark rights are not licensed under this
Public License.
3. To the extent possible, the Licensor waives any right to
collect royalties from You for the exercise of the Licensed
Rights, whether directly or through a collecting society
under any voluntary or waivable statutory or compulsory
licensing scheme. In all other cases the Licensor expressly
reserves any right to collect such royalties, including when
the Licensed Material is used other than for NonCommercial
purposes.
Section 3 -- License Conditions.
Your exercise of the Licensed Rights is expressly made subject to the
following conditions.
a. Attribution.
1. If You Share the Licensed Material (including in modified
form), You must:
a. retain the following if it is supplied by the Licensor
with the Licensed Material:
i. identification of the creator(s) of the Licensed
Material and any others designated to receive
attribution, in any reasonable manner requested by
the Licensor (including by pseudonym if
designated);
ii. a copyright notice;
iii. a notice that refers to this Public License;
iv. a notice that refers to the disclaimer of
warranties;
v. a URI or hyperlink to the Licensed Material to the
extent reasonably practicable;
b. indicate if You modified the Licensed Material and
retain an indication of any previous modifications; and
c. indicate the Licensed Material is licensed under this
Public License, and include the text of, or the URI or
hyperlink to, this Public License.
2. You may satisfy the conditions in Section 3(a)(1) in any
reasonable manner based on the medium, means, and context in
which You Share the Licensed Material. For example, it may be
reasonable to satisfy the conditions by providing a URI or
hyperlink to a resource that includes the required
information.
3. If requested by the Licensor, You must remove any of the
information required by Section 3(a)(1)(A) to the extent
reasonably practicable.
4. If You Share Adapted Material You produce, the Adapter's
License You apply must not prevent recipients of the Adapted
Material from complying with this Public License.
Section 4 -- Sui Generis Database Rights.
Where the Licensed Rights include Sui Generis Database Rights that
apply to Your use of the Licensed Material:
a. for the avoidance of doubt, Section 2(a)(1) grants You the right
to extract, reuse, reproduce, and Share all or a substantial
portion of the contents of the database for NonCommercial purposes
only;
b. if You include all or a substantial portion of the database
contents in a database in which You have Sui Generis Database
Rights, then the database in which You have Sui Generis Database
Rights (but not its individual contents) is Adapted Material; and
c. You must comply with the conditions in Section 3(a) if You Share
all or a substantial portion of the contents of the database.
For the avoidance of doubt, this Section 4 supplements and does not
replace Your obligations under this Public License where the Licensed
Rights include other Copyright and Similar Rights.
Section 5 -- Disclaimer of Warranties and Limitation of Liability.
a. UNLESS OTHERWISE SEPARATELY UNDERTAKEN BY THE LICENSOR, TO THE
EXTENT POSSIBLE, THE LICENSOR OFFERS THE LICENSED MATERIAL AS-IS
AND AS-AVAILABLE, AND MAKES NO REPRESENTATIONS OR WARRANTIES OF
ANY KIND CONCERNING THE LICENSED MATERIAL, WHETHER EXPRESS,
IMPLIED, STATUTORY, OR OTHER. THIS INCLUDES, WITHOUT LIMITATION,
WARRANTIES OF TITLE, MERCHANTABILITY, FITNESS FOR A PARTICULAR
PURPOSE, NON-INFRINGEMENT, ABSENCE OF LATENT OR OTHER DEFECTS,
ACCURACY, OR THE PRESENCE OR ABSENCE OF ERRORS, WHETHER OR NOT
KNOWN OR DISCOVERABLE. WHERE DISCLAIMERS OF WARRANTIES ARE NOT
ALLOWED IN FULL OR IN PART, THIS DISCLAIMER MAY NOT APPLY TO YOU.
b. TO THE EXTENT POSSIBLE, IN NO EVENT WILL THE LICENSOR BE LIABLE
TO YOU ON ANY LEGAL THEORY (INCLUDING, WITHOUT LIMITATION,
NEGLIGENCE) OR OTHERWISE FOR ANY DIRECT, SPECIAL, INDIRECT,
INCIDENTAL, CONSEQUENTIAL, PUNITIVE, EXEMPLARY, OR OTHER LOSSES,
COSTS, EXPENSES, OR DAMAGES ARISING OUT OF THIS PUBLIC LICENSE OR
USE OF THE LICENSED MATERIAL, EVEN IF THE LICENSOR HAS BEEN
ADVISED OF THE POSSIBILITY OF SUCH LOSSES, COSTS, EXPENSES, OR
DAMAGES. WHERE A LIMITATION OF LIABILITY IS NOT ALLOWED IN FULL OR
IN PART, THIS LIMITATION MAY NOT APPLY TO YOU.
c. The disclaimer of warranties and limitation of liability provided
above shall be interpreted in a manner that, to the extent
possible, most closely approximates an absolute disclaimer and
waiver of all liability.
Section 6 -- Term and Termination.
a. This Public License applies for the term of the Copyright and
Similar Rights licensed here. However, if You fail to comply with
this Public License, then Your rights under this Public License
terminate automatically.
b. Where Your right to use the Licensed Material has terminated under
Section 6(a), it reinstates:
1. automatically as of the date the violation is cured, provided
it is cured within 30 days of Your discovery of the
violation; or
2. upon express reinstatement by the Licensor.
For the avoidance of doubt, this Section 6(b) does not affect any
right the Licensor may have to seek remedies for Your violations
of this Public License.
c. For the avoidance of doubt, the Licensor may also offer the
Licensed Material under separate terms or conditions or stop
distributing the Licensed Material at any time; however, doing so
will not terminate this Public License.
d. Sections 1, 5, 6, 7, and 8 survive termination of this Public
License.
Section 7 -- Other Terms and Conditions.
a. The Licensor shall not be bound by any additional or different
terms or conditions communicated by You unless expressly agreed.
b. Any arrangements, understandings, or agreements regarding the
Licensed Material not stated herein are separate from and
independent of the terms and conditions of this Public License.
Section 8 -- Interpretation.
a. For the avoidance of doubt, this Public License does not, and
shall not be interpreted to, reduce, limit, restrict, or impose
conditions on any use of the Licensed Material that could lawfully
be made without permission under this Public License.
b. To the extent possible, if any provision of this Public License is
deemed unenforceable, it shall be automatically reformed to the
minimum extent necessary to make it enforceable. If the provision
cannot be reformed, it shall be severed from this Public License
without affecting the enforceability of the remaining terms and
conditions.
c. No term or condition of this Public License will be waived and no
failure to comply consented to unless expressly agreed to by the
Licensor.
d. Nothing in this Public License constitutes or may be interpreted
as a limitation upon, or waiver of, any privileges and immunities
that apply to the Licensor or You, including from the legal
processes of any jurisdiction or authority.
=======================================================================
Creative Commons is not a party to its public
licenses. Notwithstanding, Creative Commons may elect to apply one of
its public licenses to material it publishes and in those instances
will be considered the “Licensor.” The text of the Creative Commons
public licenses is dedicated to the public domain under the CC0 Public
Domain Dedication. Except for the limited purpose of indicating that
material is shared under a Creative Commons public license or as
otherwise permitted by the Creative Commons policies published at
creativecommons.org/policies, Creative Commons does not authorize the
use of the trademark "Creative Commons" or any other trademark or logo
of Creative Commons without its prior written consent including,
without limitation, in connection with any unauthorized modifications
to any of its public licenses or any other arrangements,
understandings, or agreements concerning use of licensed material. For
the avoidance of doubt, this paragraph does not form part of the
public licenses.
Creative Commons may be contacted at creativecommons.org.
Contract Copilot
面向律师、法务和合同高频处理团队的合同审查与起草 skill。它按“交易结构、合同形式、条款语言”三层扫描合同,并输出可执行的风险清单、修订批注版和正式审查意见书。
目标不是给一段笼统建议,而是把风险定位、修改动作、推荐措辞和交付文档一次整理清楚。
适合谁用
- 需要高频审查中文商业合同的律师、法务和律所团队
- 希望统一审查口径、风险分级和 Word 交付格式的团队
- 需要从零起草合同,并先固定交易文件包、程序前提和待补事实的人
典型场景
用户:请站在乙方立场,以常规口径审查这份设计委托合同,重点关注验收、付款和违约责任。
AI:我会先确认审查立场和口径,再按交易结构、合同形式、条款语言三层扫描。
交付物包括审查报告,以及带修订和批注的 Word 文件。它能产出什么
- 风险清单:风险等级、后果、判别标准、相关条款、整改建议
- 推荐措辞:可直接谈判或落入合同正文的条款文本
- 审查报告:可签结论、先决事项、谈判优先级和复核要点
- Word 修订批注版:在
.docx中直接显示修改痕迹和批注 - 起草工作台:主合同类型、配套协议、必带附件、待补事实和条款骨架
当前覆盖范围
固定覆盖 12 类中文合同:
- 买卖、租赁、服务、知识产权
- 担保、借贷与赠与、互联网协议、婚姻家事
- 劳动用工、房地产、建设工程、公司投资
支持:
- 甲方、乙方、中立等审查立场
- 克制、常规、强势等审查口径
- 仅批注、直接修订、批注与修订结合等落痕策略
- DOCX 原生批注、修订和 Word 审查意见书输出
安装方式
1. 打开本仓库的 GitHub Releases。 2. 下载最新版本的 skill 压缩包。 3. 解压后将 contract-copilot/ 文件夹放入你的 skill 目录。 4. 在支持 SKILL.md 的 Agent / Claude 环境中启用该 skill。 5. 如需生成 Word 批注、修订或报告,安装脚本依赖:
pip install -r scripts/requirements.txt首次生成审查文件时,按 Agent 提示确认审查人姓名和机构;配置会写入本地 config/,不会作为公开发布内容使用。
可以怎么用
- “站在甲方立场,以强势口径审查这份买卖合同”
- “帮我把服务合同里的验收、付款和违约责任条款补齐”
- “请输出审查报告,并把确定性问题直接修订进 Word”
- “我要起草一份技术开发合同,请先列起草信息清单和待确认问题”
使用边界
这个 skill 适合:
- 中文商业合同的常规审查、起草和交付格式统一
- 批量合同的一轮风险扫描和修订底稿生成
- 律师或法务复核前的结构化整理
这个 skill 不适合:
- 替代律师对重大交易作最终签署意见
- 处理未提供事实背景、交易安排或业务目标的合同
- 覆盖所有涉外法域、外文合同和高监管行业专项审查
- 自动完成需要线下审批、登记、备案或主体授权核验的事项
核心设计
分层四步审查
先看交易结构,再看合同形式,最后看条款语言。每个风险点都尽量落到“能否签、如何改、谁来确认、优先级如何”的动作上。
分析与文档操作分工
Agent 负责识别风险、形成审查计划和推荐措辞;脚本负责在 DOCX 中稳定写入批注、修订和报告,减少复制粘贴导致的格式错误。
记忆但不静默代填
本地配置可记住审查人、客户和审查口径,但新环境或缺少关键身份信息时仍会要求确认,避免把历史配置误用到正式交付。
关键文件
- SKILL.md:执行入口和合同审查规则
- references/review-framework.md:通用审查框架
- references/contract-routing.md:12 类合同路由
- references/priority-clauses.md:高风险条款入口
- references/revision-strategy.md:批注与修订策略
- scripts/README.md:DOCX 自动化脚本说明
许可证
本作品采用 CC BY-NC 4.0 许可证。商用授权联系方式以 LICENSE.txt 为准。
关于作者 / 咨询与交流
杨卫薪律师(微信 ywxlaw)
如需就合同审查、合同起草、企业内部合同流程落地、复杂法律问题或商用授权进一步沟通,欢迎添加微信(请注明来意)。
<div align="center"> <img src="https://raw.githubusercontent.com/cat-xierluo/legal-skills/main/wechat-qr.jpg" width="200" alt="微信二维码"/> <p><em>微信:ywxlaw</em></p> </div>
关联项目
本仓库是 Legal Skills 的子项目。如果需要合同、商标、专利、OPC、小微企业合规、文档处理等更多法律类开源 Skill,可以关注主仓库。
相关项目:
- opc-legal-counsel:一人公司、AI 创业团队和小微企业法律顾问
- trademark-assistant:商标类别规划、可注册性初筛和申请材料准备
- patent-analysis:专利文件分析、侵权比对、FTO 和规避设计
- md2word:Markdown 转专业排版 Word 文档
contract-routing
---
一、使用规则
1. 先按交易实质识别合同类型,再按本清单归入 12 类目录。 2. 未单列的细分类型,优先复用同类主文件,不空转为“未覆盖”。 3. 输出审查结论时必须包含:风险等级、触发条件、可执行整改动作。 4. 起草时必须先输出:主合同类型、配套协议类型、待补事实清单、条款骨架、程序性前提。 5. 对混合型交易,采用“主合同类型 + 配套协议类型”的双标签方式。 6. 起草进入正文前,先产出一张“起草路由卡”:主文件、推荐交付包型、必带附件、优先骨架顺序、待确认问题。
---
二、固定 12 类全量映射
1) 买卖合同(references/contract-types/01-sale/)
- 动产买卖合同
- 二手房(存量房)买卖合同
- 商品房买卖合同
- 经销买卖合同
- 写字楼整售买卖合同(归入:商品房买卖)
- 农村旧房买卖合同(归入:二手房买卖)
- 共有产权住房买卖合同(归入:商品房买卖)
- 宅基地房屋买卖合同(归入:二手房买卖 + 房地产程序复核)
- 经济适用房买卖合同(归入:商品房买卖)
- 产权式酒店客房买卖合同(归入:商品房买卖 + 服务配套)
- 房屋团购交易协议(归入:商品房买卖)
- 让与担保式房产买卖(归入:买卖 + 担保双标签)
2) 租赁合同(references/contract-types/02-lease/)
- 房产租赁合同
- 建筑设备租赁合同
- 住房租赁合同(归入:房产租赁)
- 商场商铺租赁合同(归入:房产租赁)
- 写字楼租赁合同(归入:房产租赁)
- 房屋定制租赁合同(归入:房产租赁 + 房地产程序复核)
- 国有土地使用权租赁合同(归入:房产租赁 + 房地产程序复核)
- 行政事业单位国有资产租赁合同(归入:房产租赁 + 程序复核)
3) 服务类合同(references/contract-types/03-service/)
- 一般服务合同
- 中介(居间)合同
- 承揽合同
- 加工承揽合同(归入:承揽合同)
- OEM 委托生产合同(归入:承揽合同)
- 物业服务合同
- 保管、仓储合同
- 运输合同
- 货运代理合同(归入:运输合同)
- 行纪合同
- 广告发布合同(归入:广告服务合同)
- 广告代理合同(归入:广告服务合同)
- 广告代言合同(归入:广告服务合同)
- 法律顾问服务合同(归入:一般服务合同)
- 项目咨询合同(归入:一般服务合同)
- 公寓委托经营管理合同(归入:一般服务合同 + 房地产配套)
- 房产委托代持合同(归入:一般服务合同 + 房地产配套)
4) 知识产权类合同(references/contract-types/04-ip/)
- 商标转让合同
- 商标许可合同
- 著作权转让合同
- 软件著作权转让合同(归入:著作权合同)
- 著作权许可使用合同
- 委托创作合同(归入:著作权合同)
- 合作创作协议(归入:著作权合同)
- 软件许可合同(分发/自用)
- 委托技术开发合同
- 软件委托开发合同(归入:技术开发合同)
- 专利权转让合同(归入:专利合同)
- 专利实施许可合同(归入:专利合同)
- 技术咨询合同(归入:技术开发合同)
- 技术服务合同(归入:技术开发合同)
- 技术许可合同(归入:技术开发合同)
5) 担保类合同(references/contract-types/05-guarantee/)
- 保证合同
- 抵押合同
- 质押合同
- 主债权及房屋抵押合同(归入:抵押合同)
- 动产浮动抵押合同(归入:抵押合同)
- 股权质押合同(归入:质押合同)
- 证券质押合同(归入:质押合同)
- 证券账户质押合同(归入:质押合同)
- 应收账款质押安排(归入:质押合同)
- 阶段性担保安排(归入:保证/抵押配套)
6) 借贷与赠与合同(references/contract-types/06-lending-gift/)
- 民间借款合同
- 抵押(质押)借款合同(归入:民间借款 + 担保双标签)
- 赠与合同
- 可转股债权投资安排(归入:借款 + 公司投资双标签)
- 借条/收条/欠条配套文本(归入:民间借款配套文件)
7) 互联网协议(references/contract-types/07-internet/)
- 隐私政策
- 最终用户协议(用户许可协议)
- 订单协议
- 平台服务条款(归入:用户许可协议)
- 平台交易规则(归入:订单协议/用户许可协议)
- 数据处理条款(归入:隐私政策配套条款)
8) 婚姻家事类合同(references/contract-types/08-marriage-family/)
- 夫妻财产约定
- 离婚协议
- 遗赠扶养协议
- 同居关系协议(归入:夫妻财产约定逻辑)
- 收养协议(归入:婚姻家事类协议)
- 解除收养协议(归入:婚姻家事类协议)
- 送养协议(归入:婚姻家事类协议)
- 家庭寄养协议(归入:婚姻家事类协议)
9) 劳动用工类合同(references/contract-types/09-employment/)
- 劳动合同
- 非全日制劳动合同
- 劳务派遣协议
- 业务外包合同
- 实习协议
- 退休返聘合同
- 个人劳务合同
- 培训服务期协议
- 竞业限制协议
- 保密协议
- 脱密期约定(归入:保密协议)
- 就业协议(归入:劳动合同配套)
- 董事/监事聘任合同(归入:劳动用工与公司治理交叉)
- 事业单位聘用合同(归入:劳动用工类)
- 聘任制人员聘任合同(归入:劳动用工类)
10) 房地产类合同(references/contract-types/10-real-estate/)
- 土地出让合同
- 土地转让合同
- 联建合同
- 委托代建合同
- 土地一级开发委托合同
- 勾地协议(用地预申请)
- 土地置换协议
- 拆迁委托协议
- 拆迁安置补偿协议
- 一级市场联合拿地协议
- 房地产合作开发协议(归入:联建合同/委托代建)
- 房地产销售委托代理合同
- 特殊房屋销售协议(包销、附选择权、工抵房等)
- 城市更新项目协议
- 集体建设用地入市相关协议
11) 建设工程类合同(references/contract-types/11-construction/)
- 建设工程施工合同
- 工程总承包合同
- 分包合同(专业分包)
- 劳务分包合同(归入:分包合同)
- 指定分包三方协议(归入:分包合同)
- 独立发包协同协议(归入:分包合同)
- 内部承包合同
- 建设工程勘察合同
- 建设工程设计合同
- 建设工程监理合同
- 全过程工程咨询服务合同
- PPP 履约阶段工程协议(归入:工程总承包/施工合同)
12) 公司投资类合同(references/contract-types/12-corporate-investment/)
- 出资合同
- 增资合同
- 股权转让合同
- 合并合同
- 分立合同
- 投资协议
- 股东协议
- 对赌协议
- 股权激励合同
- 分红激励协议(归入:股权激励合同)
- 跟投机制协议(归入:股权激励合同)
- 资产收购合同
- 承债式收购配套协议(归入:资产收购/投资协议)
- 名股实债投资安排
- 广义协议控制安排(归入:投资协议)
- 国有资产交易协议(归入:股权转让/资产收购)
- 外商投资交易协议(归入:投资协议)
- 破产重整投资协议(归入:投资协议)
- 股权托管合同(归入:股东协议/股权转让配套)
- 股权收益权转让与回购协议(归入:投资协议/对赌协议)
---
三、起草路由速查
| 类型 | 起草时优先确认 | 必补事实 | 推荐交付包型 | 常见配套 / 双标签 |
|---|---|---|---|---|
| 买卖合同 | 标的、交付、验收、价款 | 标的权属/规格/数量、价款税费、交付验收、风险转移、瑕疵救济 | 完整买卖合同 / 框架协议 + 订单 / 主合同 + 安装调试附件 | 担保、房地产程序、服务配套 |
| 租赁合同 | 租赁物、用途、租期、返还 | 权属与现状、租期用途、租金押金、维修改造、安全责任、返还条件 | 完整租赁合同 / 主合同 + 交接清单 / 主合同 + 管理规则 | 房地产程序、设备安全、带机/带服务安排 |
| 服务类合同 | 服务边界、成果、配合、验收 | 服务清单、交付件、配合义务、费用结构、知识产权、数据边界、退出交接 | 主合同 + SOW/服务清单 / 框架服务协议 + 任务单 | 房地产配套、知识产权、劳动边界 |
| 知识产权类合同 | 权利链、授权/转让范围、成果归属 | 权利基础、地域期限、许可范围、源文件/样品交付、登记备案、侵权处置 | 许可/转让主合同 + 授权范围表 / 开发主合同 + 成果交付表 | 服务合同、技术开发、数据合规 |
| 担保类合同 | 主债权、担保范围、实现路径 | 主债权金额/期限、担保财产状态、登记或控制、违约触发、处置顺序、反担保 | 主债权合同 + 担保合同 / 担保合同 + 反担保文本 | 借款、买卖、投资安排 |
| 借贷与赠与合同 | 金额、期限、交付凭证、返还机制 | 本金/利率/用途、借款交付、到期与提前到期、担保、撤销或返还条件 | 借款合同 + 担保文本 / 赠与合同 + 财产交付清单 | 担保、公司投资、赠与附义务 |
| 互联网协议 | 产品规则、用户边界、数据处理 | 服务范围、账号规则、数据处理、SLA、版本更新、通知方式、内容处置 | 用户协议 + 隐私政策 + 订单协议 / ToB 主协议 + SLA + 数据处理附件 | 隐私政策、订单协议、用户协议联动 |
| 婚姻家事类合同 | 身份关系、财产范围、生效程序 | 财产清单、债务承担、抚养/扶养安排、证照材料、生效条件、登记或确认程序 | 主协议 + 财产清单 / 离婚协议 + 子女抚养安排 | 房地产、赠与、继承安排 |
| 劳动用工类合同 | 用工模式、报酬、考勤、退出 | 用工类型、岗位职责、期限报酬、社保考勤、成果归属、保密竞业、解除交接 | 主合同 + 保密/竞业/培训附件 / 外包主合同 + 服务清单 | 保密、培训服务期、公司治理 |
| 房地产类合同 | 权属状态、程序、交付过户 | 土地/房屋状态、审批或备案、价款税费、交付过户、开发建设义务、违约退出 | 主合同 + 权属/审批附件 / 主合同 + 联建或代建配套协议 | 买卖、服务、建设工程、公司投资 |
| 建设工程类合同 | 工程范围、工期、价款、质量 | 图纸/清单、工期节点、进度款结算、变更签证、质量安全、验收保修、索赔机制 | 主合同 + 图纸/工程量清单 / 总承包主协议 + 分包配套 | 分包、监理、设计、房地产开发 |
| 公司投资类合同 | 交易结构、估值、治理、交割 | 投前投后口径、先决条件、交割文件、陈述保证与披露、治理权、退出机制 | 主协议 + 股东协议 + 章程修订稿 + 披露函 + 交割清单 | 股东协议、对赌、股权转让、资产收购 |
---
四、起草分流问题与必带文件
| 类型 | 先问问题 | 优先主文件 | 必带附件 / 配套文件 |
|---|---|---|---|
| 买卖合同 | 是现货、定制供货还是经销安排?是否含安装调试、培训、售后? | 动产买卖合同.md / 经销买卖合同.md | 产品明细表、供货计划、验收标准、售后服务清单 |
| 租赁合同 | 是纯租赁、带机租赁还是租赁 + 服务/运营?是否允许改造转租? | 房产租赁合同.md / 建筑设备租赁合同.md | 房屋或设备交接清单、装修规则、安全交底、返还标准 |
| 服务类合同 | 核心是持续服务、单一成果、居间撮合还是仓储运输?是否涉及数据和 IP? | 一般服务合同.md / 承揽合同.md / 中介合同.md | 服务清单、SOW、里程碑表、验收标准、数据处理说明 |
| 知识产权类合同 | 是许可、转让还是开发?是否需要登记备案或背景知识产权许可? | 软件许可合同.md / 技术开发合同.md / 著作权合同.md | 授权范围表、成果清单、源文件交付表、第三方授权清单 |
| 担保类合同 | 担保哪一笔主债权?靠登记、占有控制还是信用保证?是否要反担保? | 保证合同.md / 抵押合同.md / 质押合同.md | 主债权清单、担保物清单、登记资料、反担保文本 |
| 借贷与赠与合同 | 是借款、附担保借款还是附义务赠与?款项何时交付、何时返还? | 民间借款合同.md / 赠与合同.md | 放款凭证、还款计划、担保清单、财产交付清单 |
| 互联网协议 | 是 ToC 统一协议还是 ToB 商务合同?用户协议、订单、隐私政策是否拆分? | 用户许可协议.md / 订单协议.md / 隐私政策.md | 服务规则、SLA、数据处理说明、通知机制、版本更新记录 |
| 婚姻家事类合同 | 是财产约定、离婚安排还是扶养安排?是否需要公证、登记或法院确认? | 夫妻财产约定.md / 离婚协议.md / 遗赠扶养协议.md | 财产清单、债务清单、子女抚养方案、身份材料 |
| 劳动用工类合同 | 是劳动、劳务、派遣、外包还是返聘?是否需配套保密、竞业、培训安排? | 劳动合同.md / 业务外包合同.md / 劳务派遣协议.md | 岗位说明书、考勤薪酬规则、保密协议、竞业限制补偿表 |
| 房地产类合同 | 是土地/房屋权利交易、合作开发还是代建?是否涉及审批、登记、过户? | 土地出让合同.md / 联建合同.md / 委托代建合同.md | 权属材料、审批清单、过户资料、交付清单、拆迁安置资料 |
| 建设工程类合同 | 是施工、总承包、分包还是设计监理?是否需要招投标、签证和变更体系? | 建设工程施工合同.md / 工程总承包合同.md / 分包合同.md | 图纸清单、工程量清单、施工组织设计、签证单、进度款申请表 |
| 公司投资类合同 | 是增资、股转还是混合交割?是否需要配套股东协议、章程修订、披露函? | 投资协议.md / 增资合同.md / 股权转让合同.md | 交易架构图、cap table、先决条件清单、披露函、交割清单、章程修订稿 |
---
五、起草骨架优先顺序
| 类型 | 先写哪几组条款 | 最易遗漏的程序 / 退出 / 联动 |
|---|---|---|
| 买卖合同 | 标的 -> 交付验收 -> 价款税费 -> 风险/所有权 -> 售后违约 | 质量异议期、替代采购权、保留所有权、安装调试接口 |
| 租赁合同 | 租赁物现状 -> 租期用途 -> 租金押金 -> 维修改造 -> 返还违约 | 押金抵扣逻辑、消防/装修审批、提前解约、转租管理 |
| 服务类合同 | 服务范围 -> 交付件/验收 -> 配合顺延 -> 费用结算 -> 成果归属 -> 解除移交 | 增项机制、数据边界、既有模板权利、退出交接 |
| 知识产权类合同 | 权利基础 -> 授权/转让范围 -> 成果交付 -> 费用 -> 侵权处置 | 背景知识产权许可、登记备案、第三方素材合规 |
| 担保类合同 | 主债权 -> 担保范围 -> 担保物状态 -> 生效与设立 -> 实现路径 | 登记/控制手续、反担保、处置顺序、主合同联动 |
| 借贷与赠与合同 | 本金/标的 -> 交付凭证 -> 利率或条件 -> 到期返还 -> 违约救济 | 提前到期、放款凭证、担保联动、撤销条件 |
| 互联网协议 | 服务规则 -> 账号与使用边界 -> 订单/计费 -> 数据处理 -> 版本更新 -> 封禁/争议 | 用户协议与隐私政策联动、通知机制、内容处置 |
| 婚姻家事类合同 | 身份与财产范围 -> 义务安排 -> 生效程序 -> 违约/争议 | 公证或登记、财产清单、抚养安排执行路径 |
| 劳动用工类合同 | 用工模式 -> 岗位报酬 -> 考勤社保 -> 保密竞业 -> 解除交接 | 用工类型错配、规章制度送达、补偿标准、成果归属 |
| 房地产类合同 | 权属与项目状态 -> 价款税费 -> 程序条件 -> 交付过户 -> 违约退出 | 审批备案、权属变更、拆迁安置或开发义务、长停机制 |
| 建设工程类合同 | 效力基础 -> 工程范围/图纸 -> 工期顺延/签证 -> 计价结算 -> 质量安全 -> 保修争议 | 招投标合规、停工/长停、现场签证、质保金返还 |
| 公司投资类合同 | 交易结构/估值 -> 先决条件/交割 -> 陈述保证/披露 -> 治理保护 -> 退出回购 -> 违约争议 | 长停日、配套章程/股东协议、披露函、监管申报 |
---
六、未单列类型处理办法
对尚未拆分为独立文件的细分合同,统一按以下顺序处理:
1. 进入本清单定位到 12 类与主文件。 2. 先输出一张“起草路由卡”,至少写明:主合同类型、主文件、推荐交付包型、配套协议类型、必带附件、待确认问题。 3. 再在 templates/合同起草信息清单.md 中记录待补事实、程序性前提和骨架顺序。 4. 从对应主文件提取条款级风险框架或条款骨架。 5. 回到 review-framework.md 复核宏观/中观/微观结构性风险是否遗漏。 6. 审查场景下,在报告中说明“本次按同类主文件审查,后续可拆分为独立模板”;起草场景下,在草案说明中标注“本次按同类主文件起草,未提及事项待补充”。
---
七、输出一致性要求
1) 审查输出
- 输出字段:风险名称、风险等级、风险后果、判别标准、推荐措辞、风险示例、法律依据、整改建议、相关条款。
- 风险等级:P0(签前必改)/ P1(优先改)/ P2(优化项)。
- 结论格式:可签 / 有条件可签 / 不建议签 + 先决事项清单。
2) 起草输出
- 先输出“起草路由卡”:主合同类型、配套协议类型、主文件、推荐交付包型、必带附件、程序性前提、待确认问题。
- 再输出:待补事实、条款骨架、推荐措辞、交付物。
- 缺失信息统一标注:
未提及/待补充。 - 交付格式:合同草案 / 条款清单 / 待确认问题表 / 文件包清单。
商品房买卖合同
合同概述
商品房买卖合同用于约定房地产开发企业将新建商品房出售给买受人,买受人支付价款并取得交房、备案、产权办理等权利。此类合同同时受民事合同规则和房地产销售监管规则约束,程序性要求明显高于一般买卖。
审查重点差异:
- 商品房交易的关键在于“开发主体有没有卖房资格”“房屋有没有合法销售条件”“交房与办证承诺能否兑现”。
- 预售、现售、精装交付、共有产权或政策性住房的风险点并不相同,不能用统一模板机械套用。
- 宣传资料、示范区承诺、配套设施和学区口径,往往是后续纠纷的重要触发点。
---
宏观层面审查要点
| 风险名称 | 风险等级 | 风险后果 | 判别标准 | 推荐措辞 | 风险示例 | 法律依据 | 整改建议 | 相关条款 |
|---|---|---|---|---|---|---|---|---|
| 开发商销售资格或销售条件不完备 | P0 | 合同履行受阻甚至无效风险 | ✅开发企业资质、土地来源、预售或现售条件完备;❌未取得必要销售许可即签约收款 | “出卖人确认其已具备销售本合同项下房屋的法定条件,并承担因销售条件瑕疵导致的全部责任。” | 未取得预售许可即收取大额房款 | 《中华人民共和国民法典》及房地产销售监管规则 | 核验开发资质、预售许可和土地手续 | 主体条款、声明保证条款 |
| 房屋性质和交易限制未披露 | P0 | 买受人无法实现预期用途或后续转让受限 | ✅住宅、商业、公寓、共有产权、保障性住房等性质明确;❌只写“商品房” | “标的房屋的性质、用途、土地使用年限及相关限制条件以本合同及附件披露为准。” | 商办公寓被当作普通住宅宣传销售 | 《中华人民共和国民法典》诚实信用规则及房地产管理规则 | 补披露房屋性质、限售限购及转让限制 | 标的条款、特别提示条款 |
| 购房资格、贷款和政策条件未校验 | P1 | 无法网签、无法备案或贷款落空 | ✅限购、限贷、首付和资格文件匹配;❌购房人资格明显不符仍签约 | “因买受人资格、贷款政策或监管规则变化影响履行的,双方按本合同约定的顺延、补足或解除机制处理。” | 买受人不具备限购资格,网签无法办理 | 《中华人民共和国民法典》履行规则 | 设资格核验清单和政策变化兜底条款 | 条件成就条款、解除条款 |
---
中观层面审查要点
| 风险名称 | 风险等级 | 风险后果 | 判别标准 | 推荐措辞 | 风险示例 | 法律依据 | 整改建议 | 相关条款 |
|---|---|---|---|---|---|---|---|---|
| 网签文本、示范合同与补充协议冲突 | P1 | 真实交易安排和承诺难兑现 | ✅主合同、补充协议、认购书、宣传资料口径一致;❌重要承诺只在销售话术里 | “本合同补充协议中涉及交付标准、配套承诺、违约责任等内容,应与网签文本保持一致并优先适用。” | 销售承诺赠送车位或学位,但合同不体现 | 《中华人民共和国民法典》合同解释规则 | 核对认购书、补充协议和宣传资料的一致性 | 文件效力条款、补充协议条款 |
| 附件资料和交付标准锁定不足 | P1 | 交房阶段争议频发 | ✅平面图、装修标准、设备清单、配套说明完整;❌只写“按样板房交付” | “交付标准、装修材料品牌型号及配套设施以附件《交付标准表》为准。” | 样板间展示高配,合同附件却很模糊 | 《中华人民共和国民法典》证据与履行规则 | 将宣传口径落到附件并签章确认 | 附件条款、交付标准条款 |
---
微观层面审查要点
1) 价款、面积与付款安排
| 风险名称 | 风险等级 | 风险后果 | 判别标准 | 推荐措辞 | 风险示例 | 法律依据 | 整改建议 | 相关条款 |
|---|---|---|---|---|---|---|---|---|
| 面积误差和价款调整机制不清 | P1 | 交付后长期争议 | ✅按建筑面积、套内面积或实测面积的调整逻辑明确;❌只写“据实结算” | “房屋面积差异的处理方式、误差比例阈值及解除权按本条明确约定执行。” | 实测面积偏差较大,买受人无法主张退房或退差价 | 《中华人民共和国民法典》公平与履行规则 | 设面积误差阈值、价款调整和解除机制 | 面积条款、价款条款 |
| 付款节点与销售监管要求脱节 | P1 | 付款后无法控制开发商履约 | ✅定金、首付、按揭放款、监管账户安排明确;❌先全额付款再等待开发商办手续 | “买受人支付价款应与签约、备案、贷款审批及监管账户安排相衔接。” | 首付款未进入监管账户,资金被挪用 | 《中华人民共和国民法典》价款规则及销售监管规则 | 引入资金监管和阶段付款条件 | 付款条款、资金监管条款 |
2) 交房、配套与办证
| 风险名称 | 风险等级 | 风险后果 | 判别标准 | 推荐措辞 | 风险示例 | 法律依据 | 整改建议 | 相关条款 |
|---|---|---|---|---|---|---|---|---|
| 交房条件过于笼统 | P1 | 是否达到交付标准难判断 | ✅竣工验收、备案、配套完成、实物状态明确;❌只写“具备交付条件” | “出卖人应在满足法定交付条件及本合同附件约定的交付标准后通知买受人收房。” | 项目尚未达到约定配套条件就通知收房 | 《中华人民共和国民法典》履行规则 | 明确法定交付条件和合同附加交付条件 | 交付条款 |
| 办证期限和责任不清 | P1 | 买受人长期无法取得产权证 | ✅备案、初始登记、分户办证节点明确;❌只写“积极协助办证” | “出卖人应于具备办证条件后 X 日内协助买受人办理产权登记,逾期应承担违约责任。” | 房屋已入住多年仍办不下产权证 | 《中华人民共和国民法典》违约责任规则及登记规则 | 写明办证路径、资料义务和逾期责任 | 办证条款、违约条款 |
3) 违约、解除与宣传承诺
| 风险名称 | 风险等级 | 风险后果 | 判别标准 | 推荐措辞 | 风险示例 | 法律依据 | 整改建议 | 相关条款 |
|---|---|---|---|---|---|---|---|---|
| 逾期交房和逾期办证责任设置失衡 | P1 | 违约责任过低,无法形成约束 | ✅违约金、解除权、补救责任与违约后果匹配;❌仅象征性违约金 | “出卖人逾期交房或逾期办证达到约定期限的,买受人有权要求继续履行、违约金或解除合同。” | 开发商迟延交房数月,仅承担极低违约金 | 《中华人民共和国民法典》违约责任规则 | 调整违约金计算基础并增加解除权 | 违约条款、解除条款 |
| 宣传资料和销售承诺未纳入合同 | P1 | 买受人难主张口头或宣传承诺 | ✅重要配套、品牌、教育、交通承诺写入合同;❌全部排除宣传文件效力 | “经双方确认的宣传资料、沙盘、样板间说明和销售承诺,构成本合同附件或解释依据。” | 学区、会所、地铁口等承诺未兑现 | 《中华人民共和国民法典》诚实信用与合同解释规则 | 只保留可落地承诺并书面化 | 特别约定条款、附件条款 |
---
法律依据(通用)
- 《中华人民共和国民法典》
- 《中华人民共和国城市房地产管理法》
- 商品房销售、预售、备案和登记相关监管规则
---
说明:商品房买卖合同审查的关键不只是开发商资质,而是把“销售条件、交付标准、办证义务、宣传承诺”四条线同时锁住。否则合同签得再全,交房阶段仍会失控。
保密协议
合同概述
保密协议用于约定信息接收方对商业秘密、技术资料、经营数据等信息的保密义务,覆盖在职、合作及离职后阶段。
目标:
- 定义保密信息边界。
- 明确允许使用场景与例外情形。
- 建立泄密后的可执行救济机制。
---
宏观层面审查要点
| 风险名称 | 风险等级 | 风险后果 | 判别标准 | 推荐措辞 | 风险示例 | 法律依据 | 整改建议 | 相关条款 |
|---|---|---|---|---|---|---|---|---|
| 保密信息定义过宽或过窄 | P1 | 执行困难或保护不足 | ✅定义可识别、可管理;❌“一切信息均保密” | “保密信息包括技术、商业、客户与财务信息,并列示示例。” | 争议时无法判断信息性质 | 民法典与反不正当竞争规则 | 采用“定义 + 列举 + 排除”结构 | 定义条款 |
| 保密对象边界不清 | P1 | 第三方披露责任难追 | ✅约定关联方/顾问/外包方责任;❌只约束签约方本人 | “接收方应确保其关联人员承担同等保密义务。” | 外包人员泄密无法追责 | 合同相对性与责任规则 | 增加传递责任条款 | 第三方责任条款 |
---
中观层面审查要点
| 风险名称 | 风险等级 | 风险后果 | 判别标准 | 推荐措辞 | 风险示例 | 法律依据 | 整改建议 | 相关条款 |
|---|---|---|---|---|---|---|---|---|
| 文件体系冲突 | P1 | 适用争议 | ✅与劳动合同、合作协议、竞业协议口径一致;❌多份文件互相冲突 | “本协议与主协议冲突时按【优先规则】处理。” | 主协议允许披露,本协议全面禁止 | 合同解释规则 | 建立统一优先级 | 文件效力条款 |
| 保密期限缺失 | P1 | 离职后保护失效 | ✅在职与离职后期限分别约定;❌只写“永久保密”但无合理边界 | “保密义务在离职后持续至信息公开或依法解除。” | 离职后立即主张无义务 | 保密义务规则 | 采用“事件触发 + 期限”机制 | 保密期限条款 |
---
微观层面审查要点
1) 使用限制与例外
| 风险名称 | 风险等级 | 风险后果 | 判别标准 | 推荐措辞 | 风险示例 | 法律依据 | 整改建议 | 相关条款 |
|---|---|---|---|---|---|---|---|---|
| 使用目的不明确 | P1 | 合法使用与违规使用边界不清 | ✅仅限约定目的使用;❌未限制再利用 | “保密信息仅可用于本合同约定目的,不得另作他用。” | 以项目资料拓展竞争业务 | 合同履行规则 | 增加用途限定条款 | 使用范围条款 |
| 例外情形未写明 | P2 | 合规披露风险 | ✅司法/监管披露路径明确;❌绝对禁止披露 | “依法披露前应及时通知并采取最小披露原则。” | 被监管要求时无操作规则 | 合规义务规则 | 加入例外与通知机制 | 例外条款 |
2) 信息返还与删除
| 风险名称 | 风险等级 | 风险后果 | 判别标准 | 推荐措辞 | 风险示例 | 法律依据 | 整改建议 | 相关条款 |
|---|---|---|---|---|---|---|---|---|
| 返还销毁机制缺失 | P1 | 离场后残留泄密风险 | ✅载明返还、删除、备份处理;❌仅原则要求 | “合作终止后 X 日内完成资料返还与删除并出具确认。” | 离职后继续持有客户清单 | 证据与履行规则 | 增加时限与确认文件 | 返还销毁条款 |
3) 违约与救济
| 风险名称 | 风险等级 | 风险后果 | 判别标准 | 推荐措辞 | 风险示例 | 法律依据 | 整改建议 | 相关条款 |
|---|---|---|---|---|---|---|---|---|
| 救济手段单一 | P1 | 无法及时止损 | ✅包含停止侵害、保全、赔偿;❌仅写违约金 | “泄密时守约方有权请求停止侵害并主张损失赔偿。” | 仅能事后索赔 | 民法典侵权与违约规则 | 增加禁令与证据保全路径 | 救济条款 |
---
法律依据(通用)
- 《中华人民共和国民法典》
- 《中华人民共和国反不正当竞争法》
- 劳动与商业秘密保护相关规则
---
说明:保密协议与竞业限制协议关注点不同。前者保护信息,后者限制竞争行为,应并行审查而非互相替代。
"""docx - DOCX editing, packaging and validation utilities."""
from .document import Document, DocxXMLEditor
__all__ = ["Document", "DocxXMLEditor"]