关于 edit-docx-agreement
此技能用于对现有 DOCX 协议进行模板字段之外的定制编辑,也适用于 OpenAgreements 生成的文件。它将字段修改路由到重新填充模板,将自定义条款修改交给 Safe Docx,并区分两者的配置与信任边界。
主要功能
- 01字段修改通过重新填充模板处理
- 02使用 Safe Docx 定制编辑
- 03处理字段与条款混合修改
- 04重新读取段落以核验编辑
- 05生成修订痕迹版和清洁版 DOCX
适用场景
- 01修改协议中的标准条款
- 02同时更新字段和自定义条款
- 03准备供审阅或签署的修改版协议
MCP 相关
模板填充通过 OpenAgreements 远程 MCP 服务或本地 CLI 完成;定制 DOCX 编辑则需要单独配置 Safe Docx 本地 MCP 服务。Safe Docx 可读取和编辑文档文本,并保存便于审阅的输出文件。
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ open-agreements/ open-agreements --skill edit-docx-agreement安装后在 Claude Code 中输入/edit-docx-agreement确认已加载。
附带文件CONNECTORS.md
详细介绍
edit-docx-agreement
当用户要求对 OpenAgreements 生成的(或任何现有的)DOCX 协议进行模板字段未提供的自定义编辑时,使用此技能。
交互说明:如缺少输入信息(文件路径、修改意图、输出偏好),务必向用户询问。
安全模型
此技能连接两个彼此独立的系统:
- OpenAgreements(远程 MCP 或本地 CLI)——用于填写模板。遵循 OpenAgreements 零下载安全模型。
- Safe Docx(本地 MCP 服务)——用于精细编辑 DOCX。需要单独设置。它不属于 OpenAgreements 技能集,并采用独立的信任/安全模型。
Agent 必须能够使用 Safe Docx MCP 工具才能执行编辑。如果未检测到 Safe Docx 工具,请告知用户并提供设置指南(参见连接器)。
决策规则:重新填写、编辑,或两者兼做
-
仅修改字段(例如,当事人姓名、日期、金额、估值上限): 使用更新后的字段值重新运行 OpenAgreements
fill_template。无需 Safe Docx。 -
仅修改制式条款(例如,自定义条款、修改标准措辞): 使用 Safe Docx MCP 工具精细编辑现有 DOCX。
-
混合修改(更新字段 + 定制编辑): 先通过 OpenAgreements 重新填写(以获取字段已更新的干净基础文件),将输出保存在本地,然后使用 Safe Docx 对新文件应用定制编辑。
执行
步骤 0:确认你有本地 .docx 文件路径
- 如果通过远程 MCP 运行 OpenAgreements,填写响应会返回下载 URL(包含
expires_at)。请立即将 DOCX 保存到本地路径。 - 如果下载链接已过期,请重新运行
fill_template以获取新的 URL。 - 如果通过本地 CLI 运行 OpenAgreements,请直接使用输出文件路径。
步骤 1:确认 Safe Docx MCP 可用
检查当前会话是否提供 Safe Docx 工具(例如,read_file、replace_text、apply_plan)。
- 如果可用:继续步骤 2。
- 如果不可用:告知用户,定制编辑需要 Safe Docx MCP,并根据 CONNECTORS.md 提供设置说明。在用户完成配置前,请停在这里。
步骤 2:应用决策规则
遵循上述路由逻辑(仅修改字段 / 仅修改制式条款 / 混合修改)。
对于 Safe Docx 编辑:
- 使用
read_file定位目标段落 - 使用
replace_text或insert_paragraph进行精细修改 - 使用
apply_plan批量编辑(如果任何步骤无效,会安全失败) - 重新读取已编辑段落以验证修改
步骤 3:交付便于审阅的输出
使用 Safe Docx download 保存:
- 一份供法务审阅的修订跟踪 DOCX
- 一份供签署使用的清洁版 DOCX(可选,但建议提供)
向用户总结编辑内容(段落 ID、修改前后的文本)。
许可说明
部分模板(尤其是 YC SAFE)采用 CC-BY-ND-4.0 许可。你可以填写这些模板供自己使用,但不得再分发模板本身的修改版本。填写后的输出可能构成“改编作品”——在审阅许可条款前,请勿公开再分发填写后的输出。详情请参阅 docs/licensing.md。
此工具不提供法律建议——请咨询律师。
连接器
有关 MCP 服务设置(OpenAgreements 远程 MCP + Safe Docx 本地 MCP),请参阅 CONNECTORS.md。