Retainer Agreement

委托合同与授权委托书（retainer-agreement）

定位

本 skill 是 standalone 短任务执行型、模板替换型：

何时触发

用户说出以下任一类：

• "做个委托合同" / "出一份代理合同" / "新签客户" / "签合同"
• "面谈现场出合同" / "客户来了，先出合同"
• "draft a retainer agreement"
• "合同和授权一起出" / "一套委托手续" / "用我的模板出授权委托书"

刑事辩护、常年法律顾问、非诉专项等合同：只要使用者用第 0 步装了对应模板包就能出；第 2 步的风险审查按模板类别取舍（见 2.6）。

第 0 步：模板检查与初始化（首次必走）

0.1 检查有没有模板包

python3 ${SKILL_ROOT}/scripts/render.py --list-templates

• 先定本次出哪些文件。签约默认准备“合同＋授权委托书”；使用者已说只要一份就只出那份，顾问等不需要授权的业务不强配。
• 按 document_type、category、suitable_for 和实际条款筛选。已有明确的案件角色 / 律师人数时直接选择；多个同类版本无法区分时再问。旧包未写 document_type 的，核对正文后补分类，不能只凭文件名选用。
• 只有合同包不能视为整套齐备。缺哪类模板，走 0.2 初始化；使用者本次只提供合同的，说明授权待补、按已确认范围出合同，不能宣称整套完成。
• 没有模板不能出件，不自动使用示例模板，不编造合同或授权正文。只在使用者明确试用时用虚构样本。
• 套件选择与字段边界见 references/signing-suite.md。

0.2 向使用者要自己的模板（自然语言，不露技术词）

agent 主动说，措辞示例：

首次使用，请提供你常用的委托代理合同和配套授权委托书 Word。空白模板或签过的旧稿都可以，我会与你确认每次要改的位置，再做一份示例供你核对。原文件保持不变。

不要对使用者说：占位符、manifest、JSON、run、XML、slug。使用者只需要给文件、回答"这里是不是每次都要改"。

0.3 看结构（agent 自己做）

python3 ${SKILL_ROOT}/scripts/inspect_template.py <合同.docx>
python3 ${SKILL_ROOT}/scripts/inspect_template.py <授权委托书.docx> --json

输出逐段编号的正文，并标注：带下划线的文字、制表符（⇥）、tab 停靠（含 leader）、首行缩进、疑似空白下划线行（"标签 + 制表符 + 下划线值"或 tab leader 画线）、已有 {{KEY}} 占位符。

agent 据此判断哪些是每份合同都不同的内容（变量）。判断依据优先级：带下划线的文字 > 空白下划线行 > 明显的个案信息（姓名 / 证件号 / 电话 / 地址 / 案由 / 对方 / 金额 / 日期 / 编号）。典型变量：

固定信息（本所名称 / 地址 / 账号 / 制式条款）不是变量。收费条款如果是逐段分期写的，把它识别成一个 paragraphs 字段（渲染时按使用者每次口述的期数逐段生成）。

0.4 用人话确认

agent 复述给使用者听，例如：

我准备把这几处改成每次填写的位置：委托人姓名、身份证号、住址、电话（第 16–19 行那四条下划线）、对方当事人和案由（"甲方因与 ___ ___ 纠纷"）、承办律师、代理程序、发票类型；律师费那两段我会按你每次说的分期逐段生成。有没有我漏掉的、或者其实是固定文字不该动的？

顺带问默认值："承办律师默认写谁？" "发票默认普票？" "日期默认当天？" 使用者确认或修正后再动手。

0.5 建模板包

按确认结果写 map.json（放临时目录，不给使用者看）。空白模板优先用 inspect --json 的 run 编号及 build_map.py 生成精确位置，不手数空格；同 run 的多个槽位用 sub 切片。格式、手填空白和预处理方式见 references/template-mapping.md。然后：

python3 ${SKILL_ROOT}/scripts/init_template.py init \
  --docx <合同.docx> --map map.json --out ${SKILL_ROOT}/templates/<slug>

<slug> 用英文短名：<律所拼音>-<合同类型>，如 lanhai-minshang、lanhai-xingshi。

合同与授权书分别建包，目录名与 slug 一致。map 中写 document_type: contract / power_of_attorney；category 标记业务类别；suitable_for 说明角色、人数与范围；可用 companion_templates 登记已安装的配套包，出件仍需核对适用性。

非必填电话等要留手填横线时用 required: false, blank: 6；不能给必填字段塞空格绕过校验。授权选项按本模板写 choices，不预设“特别授权”；收费短文本字段可设 redline_scan: true，避免只扫描多段收费条款。

样本值本身是通用词（如「一审」「普通发票」）、在合同固定文字里还会再出现的，给该字段加 "leftover_ok": true，隐私清扫就不把它当残留。

init 会先检查定位是否唯一 / 重叠，再按原文位置从后往前替换；保留各 run 格式，识别空白下划线行，处理多段锚点，并扫描样本值残留。纯空白槽自动排除残留检查，不用 --allow-leftover。真实样本值残留要补位置；只有核实属于固定文字时才精确加 leftover_ok。--allow-leftover 会全局放行，只可在逐条核实后使用。

0.6 干跑验收（装好的标准）

用生成的 templates/<slug>/contract.skeleton.json 填一份示例数据（张三 / 李四 / 13800138000 / 示例路 1 号），渲染一份 .docx，让使用者在 Word 里打开看：要填的位置是否都在、下划线是否连续、字体版式是否和原样一致。不满意就改 map.json 重建（--force）。使用者看过点头 = 装好，进第 1 步。

0.7 以后再加一种合同

同一流程再建一个 templates/<slug>/。有多个包后，每次出件先问用哪份。在 Word 里直接改过某个 template.docx 的，跑 init_template.py relock templates/<slug> 重新锁定指纹。

第 1 步：dialog 收集字段（必跑）

读本次各模板包的 manifest.json，按 fields 收集，共用信息只问一次：

• 用每个字段的 ask 话术，口语化，一次问 2–4 个相关的（委托人四项一起问），不要让使用者填表。
• required 的必须拿到；有 default 的说明默认值、使用者不说就用默认。
• hint 是给 agent 看的换算说明（如程序代号："一审" → 1，"一审加二审" → 1、2，"全程" → 1、2、3）。
• 日期类默认今天（面谈现场出合同的常态），中文大写如"二〇二六年五月二十日"，引擎按 $today_cn 自动生成。
• 合同编号一类由律所系统回填的字段：留空，不要编。
• 发票抬头一般就是委托人姓名，模板若在发票节再次引用委托人姓名，引擎自动同步。
• 授权类型、具体权限、代理阶段及期限单独确认；历史默认值不代表本次已获授权。刑事的委托人、当事人和二者关系分别收集；双律师模板必须核对第二位信息。详见套件 reference。

第 2 步：律师费条款润色 + 风险审查（最关键的自定义点）

本步适用于合同；单独出授权委托书时不追问律师费。固定金额 / 付款方式槽按模板填写，不能为套 fee_clauses 把整段制式文字改掉；分期方式需核对每期金额、节点与合计。金额大写和小写来自同一金额。

使用者会口语化说收费方式，如：

• "代理一审，分两次，签合同付3万，开庭前付2万"
• "执行阶段，签合同一次性付3万"
• "一审3万，二审1.5万"
• "前期固定2万 + 风险代理后续15%"

agent 必须把口语 → 正式条款数组，每个阶段一段，遵循模板原有句式；渲染前必须跑一遍 2.5 风险审查——口述常常隐含风险敞口，agent 不能默默套默认，必须主动追问、使用者拍板后再写进 fee_clauses。

2.1 提取结构

把口语拆成 {阶段, 触发条件, 金额} 三元组：

2.2 套句式

优先沿用初始化时那份样本合同里的收费句式；样本没有的用下面通用句式：

模板 A —— 签约时一次性支付（最常见）：

"{阶段}阶段：在签订本合同之日，甲方向乙方支付律师代理费人民币{大写}元（¥{数字}）。"

模板 B —— 触发条件后支付：

"{阶段}阶段：在{触发条件}一次性支付律师服务费{大写}元（¥{数字}）。"

模板 C —— 风险代理（前期固定 + 后期风险）：

"{阶段}阶段：在签订本合同之日起三日内，甲方向乙方支付前期固定律师服务费人民币{大写}元（¥{数字}）。在实现委托事项目标/效果后支付后期风险代理律师服务费，计算方式为：{风险比例和上限}。"

2.3 数字大写转换

from num2cn import int_to_cn     # ${SKILL_ROOT}/scripts/num2cn.py
int_to_cn(30000)   # → "叁万"
int_to_cn(15000)   # → "壹万伍仟"
int_to_cn(100000)  # → "壹拾万"

2.4 输出 fee_clauses 数组（先过 2.5 风险审查，再落盘）

"fee_clauses": [
  "一审阶段：在签订本合同之日，甲方向乙方支付律师代理费人民币叁万元（¥30000）。",
  "二审阶段：在收到对方上诉状或甲方确定上诉之日一次性支付律师服务费壹万伍仟元（¥15000）。"
]

2.5 风险审查清单（强制，渲染前必跑）

Why：早期版本把"润色"窄化为格式润色（口语 → 正式句式 + 数字大写），结果口述里隐含的风险敞口没补，第一版 .docx 要靠律师自己看出问题再回头补——典型反模式（2026-05 一次真实签约：口述"签合同付 8000 / 受理通知书当日付 7000"被原样套模板，事后才补出"仅一审调解阶段" + "15 日内未取得受理通知书第二笔免付" + "调解失败诉讼费用另算"3 条关键条款）。

agent 必须在 fee_clauses 准备好后、写 contract.json 之前，对照以下 5 项逐条自检；A～D 任何一项答不出来就追问使用者、不要默默套默认，E 项命中即按红线改写：

代码级兜底：render.py 渲染前会对多段字段逐段跑红线词扫描（模式表 FEE_REDLINE_PATTERNS 在 scripts/render.py 顶部，可直接增删），命中打 stderr ⚠ WARN [fee-redline]、不拦截渲染。它兜的是「本清单被跳过」的场景——看到 WARN 而 E 项没审过，回到本节补齐；它不替代 A–D 的追问。

审查产出：

• 正常情况：5 项全过（使用者都给了明确答案 / 不适用），fee_clauses 直接落盘。
• 存在风险敞口但使用者已确认补全：每条补出来的兜底 / 限定条款单独成段写进 fee_clauses 末尾，不要塞进原段——让条款层级清楚。
• 使用者来不及补 / 在赶时间：先按原意渲染 V1，但在交付时显式标红："⚠ 风险审查发现 N 项未确认（A/B/C/D/E），建议 Word 打开后补 / 在 V2 一起谈：[逐条列出问题]。" 不要假装审查通过了。（E 项命中属合规红线，不适用"赶时间先渲染"——必须当场改写，不能留到 V2。）

反模式（不要做的）：

• ❌ 默默套"一审阶段"不问代理范围
• ❌ 把"XX 之日"写进条款却不问 deadline 兜底
• ❌ 把"调解阶段"渲染出来但不问后续诉讼如何衔接
• ❌ 风险代理写比例不问上限和保底
• ❌ 婚姻 / 继承 / 刑事案把对客户的"对方反悔不收 / 判不离不收"温情承诺原样搬进收费条款（＝疑似风险代理、违法；须翻译成"程序节点付款 + 判不利递延再收"）

2.6 按模板类别取舍

manifest 的 category：litigation（民商事诉讼 / 仲裁）A–E 全套；criminal 刑事——E 项直接命中（刑事案件禁止风险代理），A/C 按阶段（侦查 / 审查起诉 / 审判）问；advisory 常年顾问——问服务期限、付款节点、超出范围事项如何计费，A–D 不适用；other 由 agent 酌情。

第 3 步：写 contract.json

字段名 = manifest 每个 field 的 json（模板包自带 contract.skeleton.json 可直接复制填写）。以一份民商事诉讼代理模板为例：

{
  "template": "<slug>",
  "year": 2026,
  "contract_num": "",
  "cover_date_cn": "",
  "client_name": "...",
  "client_id": "...",
  "client_address": "...",
  "client_phone": "...",
  "opponent": "...",
  "case_matter": "...",
  "lawyer": "",
  "proc_codes": "1、2",
  "invoice_type": "1",
  "fee_clauses": ["...", "..."],
  "output_path": "<落盘路径>/民商事委托代理合同_{客户}_V1.docx"
}

• 空字符串 = 用 manifest 默认值（日期 → 今天；律师 → 默认承办律师；编号 → 留空）。
• template 只有多包时必填；单包自动选用。
• output_path 可选：不给则按 manifest output_name 落在当前目录；命名习惯 <合同名>_{client_name}_V1.docx，改稿递增 V2 / V3。

成套出件用 suite.json 的 shared 共用数据＋documents 各自数据与文件名；不同字段名用 manifest 字段 shared 绑定同一语义。关系描述、代理权限等不能按相似名称盲目共用。完整示例见 references/signing-suite.md。

第 4 步：渲染 .docx

python3 ${SKILL_ROOT}/scripts/render.py contract.json output.docx            # 单包
python3 ${SKILL_ROOT}/scripts/render.py contract.json output.docx --template <slug>   # 多包
python3 ${SKILL_ROOT}/scripts/render_suite.py suite.json --outdir <本次输出目录>        # 合同＋授权

套件脚本先校验全部文件再落盘；缺模板、必填为空、共享值冲突或输出重名均停止，已有文件不覆盖。

stderr 可能出现：

• ⚠ WARN [fee-redline]：收费条款命中红线词（2.5-E 的代码级兜底）——婚姻 / 继承 / 刑事必须回 2.5-E 改写后重渲；一般民商事核对 D 项上限 / 保底后可继续交付。
• ⚠ WARN [template-drift]：template.docx 与 manifest 指纹不符——使用者自己在 Word 改过模板就 init_template.py relock；否则查模板是否被换。
• ✗ 必填字段为空（exit 4）：回第 1 步补问。
• ✗ … 没有任何模板包（exit 3）：回第 0 步。

第 4.5 步：格式自检

逐份核对：字段全部替换、原“标签：”仍在、下划线与手填槽保留；单律师没有悬空顿号或误填第二律师。模板原有的第二律师手填栏是否保留按用户确认处理，不擅自删版式。套件比对委托人、当事人、律师、阶段和权限范围，逐份确认适用的角色与业务类型；附页已内置的风险告知书不重复出。发现差异回到模板映射或字段确认，不直接改制式授权条款。

全角标点检查（合同正文中文语境）：

• 所有标点必须全角："" '' ， 。 ： ； ！ ？ 《》 、
• 例外（保留半角）：身份证号 / 电话 / URL / 金额数字 / 英文专有名词

python3 -c "
from docx import Document
import re
d = Document('output.docx')
for i, p in enumerate(d.paragraphs):
    m = re.search(r'[一-龥][,.:;?!\"'()]', p.text)
    if m:
        print(f'[{i}] {m.group()!r} in: {p.text[:80]}')
"

第 5 步：交付

• 列出本次全部 .docx 路径及待手填位置；缺模板的配套文件明确标待补。风险审查有未确认项的按 2.5「审查产出」列出。

模板包与 manifest

templates/<slug>/
├── template.docx            占位符版模板（{{KEY}}）
├── manifest.json            字段清单 / 提问话术 / 默认值 / 渲染方式 / 模板指纹
└── contract.skeleton.json   contract.json 骨架

manifest 字段说明见 scripts/render.py 顶部注释；目录约定与隐私说明见 templates/README.md。渲染规则：

• kind: text：{{KEY}} 所在 run 就地替换，继承字体 / 字号 / 下划线；
• 空白下划线行：由结构判定（占位符独占带下划线的 run 且前一个 run 是制表符），整行重建为单 run [tab][值][tab] 连续下划线，短值居中、长值左对齐自动缩字号；首行缩进 / 右侧 tab / 字号从该段自身读取；
• kind: paragraphs：整段锚点，按数组逐段克隆插入；underline: amounts 给中文大写金额与 ¥ 数字加下划线。

不要手改 template.docx 里的占位符文字；改版式去 Word 改后 relock；改字段 / 话术 / 默认值直接改 manifest.json。

隐私与发布边界

• 初始化只把样本里的当事人信息替换成占位符；样本原件不复制进模板包；manifest 不保存样本值；init 隐私清扫拦截残留。
• 模板包含本所固定信息（所名 / 地址 / 账号），属律所资料——不要把模板包提交到公开仓库；示例数据一律脱敏（张三 / 李四 / 110101… / 13800138000 / 示例路 1 号）。
• 共创者提供的合同、授权书、配置包与固定默认值均不入公开仓；只吸收通用代码和流程。测试用代码即时生成虚构样本，不携带模板副本。ask / hint / notes / default 也要检查个案残留。
• 脚本在本机处理 Word；所用 AI 助手可能把读取的内容发送给其模型服务，不能承诺整条链路“不上传”。初始化清扫辅助检查已映射样本值与疑似号码，不是全文件隐私审计；旧稿还应核对批注、修订和文档属性。

不在范围

• 不读案件资料、不调研、不校验事实
• 不自动生成合同编号（律所系统回填）
• 不在页眉页脚里放变量（init 暂只处理正文与表格）
• 不做合同条款的实体审查（只审收费条款的风险敞口与红线）

依赖

• Python 3.10+，python-docx >= 1.2（pip install python-docx）

版本管理

• 改 SKILL.md 或 scripts/* → bump version + 写 CHANGELOG.md
• SemVer：MAJOR = manifest / contract.json schema 变、工作流 step 重排；MINOR = 新字段类型、新审查项、新脚本能力；PATCH = 措辞、bug 修