法律服务文档生成技能
概述
从案件材料或沟通记录生成专业法律服务文档。支持多种文档类型，采用模块化架构自动匹配场景。
对外服务方案的主交付形态为逐案 Markdown 源稿 + 可编辑设计版 Word。需要不再修改、直接发送的 HTML/PDF 时，另用 legal-proposal-designer 渲染同一份内容；该 Skill 的其他设计化能力继续独立演进。
核心原则：
- 只做信息提取、归纳、结构化与专业表述转化
- 不新增事实，不虚构法条或裁判观点
- 仅基于提供的材料进行分析和建议
文档类型
诉讼服务方案
适用场景：客户已明确委托诉讼，需要展示完整的服务思路和工作计划
核心特点：
- 突出法律分析和策略
- 明确服务阶段和内容
- 段落式完整叙述
- 包含服务团队介绍，引用 config/team-config.md
模板文件：templates/litigation-proposal.md
咨询报告
适用场景：初次法律咨询后，客户需要问题梳理和行动指引
核心特点：
- 包含证据收集清单（表格+checkbox）
- 实用工具导向
- 可操作性强
模板文件：templates/consultation-report.md
非诉服务方案
适用场景：非诉项目（如合规、交易、尽职调查等），需要分阶段、模块化服务
核心特点：
- 强调项目背景和需求分析
- 分阶段服务规划
- 团队配置展示（引用 config/team-config.md）
模板文件：templates/non-litigation-proposal.md
法律服务建议书
适用场景：与客户线下沟通后，需要正式提交方案建议
核心特点：
- 说服性较强
- 展示专业能力和方案价值
- 分阶段展示服务内容
- 包含服务团队与保障章节，引用 config/team-config.md
模板文件：templates/service-proposal.md
客户沟通报告
适用场景：复杂案件的全面记录，需要完整的分析框架
核心特点：
- 12部分完整结构
- 包含成本效益分析
- 详细的行动计划
模板文件：templates/communication-report.md
结案汇报
适用场景：案件以判决、调解、和解、撤诉等方式收口后，需要向客户系统汇报结案结果、实际履行情况、客户授权条件与最终结果差异
核心特点：
- 聚焦结案后的结果汇总与客户沟通
- 强调“客户授权条件 vs 历史方案 vs 最终实际”对比
- 明确结案方式、执行情况、客户实际支出和后续提醒
模板文件：templates/case-closing-report.md
内部沟通报告
适用场景：需要团队其他律师协助核实问题、讨论策略或跨部门协作
核心特点：
- 保密等级固定为"内部机密"
- 包含"团队内部讨论事项"专节
- 明确列出需要同事协助核实的事项和负责人
模板文件：templates/internal-communication-report.md
案件分析摘要
适用场景：收到案件原始材料（聊天记录、录音转写、证据材料等），需要快速提取关键信息、梳理案情
核心特点：
- 6 层分析框架（案件信息 → 事实脉络 → 法律关系 → 争议焦点 → 证据材料 → 法律问题）
- 时间线 Mermaid 可视化
- 证据证明力评估表格
- 内部工作文档，用于团队快速了解案情
模板文件：templates/case-analysis-summary.md
工作流程
步骤 1: 分析输入并确定文档类型
文档类型的选择应综合考虑案件性质（诉讼 vs 非诉）、客户阶段和文档目的。
优先级规则（必须严格遵守）：
- 用户明确指定文档类型时，按用户指定的类型生成
- 用户未明确指定时，按以下逻辑判断：
- 涉及诉讼/争议解决案件 + 用户要求生成"方案"或"服务方案" → 诉讼服务方案
- 涉及非诉项目（合规、交易、尽调等）+ 用户要求生成"方案"或"服务方案" → 非诉服务方案
- 只有当用户**明确说"建议书"**时，才生成 法律服务建议书
- 禁止在用户说"方案"时自动降级为"建议书"——"方案"和"建议书"是不同的文档类型
常见场景：
| 输入内容 | 客户阶段 | 文档目的 | 推荐类型 |
|---|---|---|---|
| 诉讼/争议案件材料 | 任何阶段 | 展示服务思路和工作计划 | 诉讼服务方案 |
| 非诉项目背景材料 | 任何阶段 | 分阶段服务规划、团队配置 | 非诉服务方案 |
| 用户明确要求"建议书" | 沟通后争取签约 | 说服客户、展示专业能力 | 法律服务建议书 |
| 初次咨询沟通记录 | 初次咨询 | 问题梳理、证据收集指引 | 咨询报告 |
| 多次沟通记录 | 复杂案件、全面分析 | 完整分析框架、成本效益评估 | 客户沟通报告 |
| 已结案材料 | 结案收口 | 向客户汇报结案结果 | 结案汇报 |
| 需要团队协作/协助核实 | 团队协作 | 内部分析、请求协助、讨论策略 | 内部沟通报告 |
| 原始案件材料（聊天记录、录音转写等） | 案件初期 | 快速提取关键信息、梳理案情 | 案件分析摘要 |
关键判断因素：
- 案件性质（首要）：诉讼/争议 → 诉讼方案；非诉项目 → 非诉方案
- 用户措辞："方案" ≠ "建议书"，除非用户明确说"建议书"
- 客户阶段：初次咨询 vs. 多次沟通 vs. 已委托
- 呈现目的：内部工作计划 vs. 对外说服材料
步骤 2: 选择对应模板
根据文档类型选择 templates/ 中的对应模板。
步骤 2.5: 读取团队配置
对于诉讼服务方案、非诉服务方案、法律服务建议书三类对外方案文档，读取 config/team-config.md 获取主办律师介绍、律所简介和合作伙伴信息，填入模板的团队相关章节。
- 用户会指定主办律师（如"主办律师是律师 A 和律师 B"）。Markdown 方案需要展示团队章节时，从 team-config 的 HTML 表格中提取对应律师内容；走设计版 Word 完整版时，不把 HTML 表格插入源稿，由 Word 渲染器按选定姓名直接读取团队配置并生成可编辑卡片。
- 图片路径必须转为绝对路径：team-config.md 中的图片引用（如
images/avatar-xxx.png）是相对于 skill config 目录的相对路径，在输出文档中无法解析。生成文档时，须将所有images/开头的图片 src 替换为本 skill 的绝对路径前缀，即SKILL_DIR/config/images/（其中 SKILL_DIR 为本 skill 所在目录的绝对路径）。例如images/avatar-example.png应替换为/path/to/your/skills/legal-proposal-generator/config/images/avatar-example.png - 律所简介可直接引用，也可根据项目特点做适当裁剪
- 其他文档类型（咨询报告、沟通报告、结案汇报、内部沟通报告、案件分析摘要）无需团队章节
步骤 3: 生成文档
按模板结构生成内容，遵循以下写作要求：
通用写作要求：
- 段落式写作：使用段落描述，避免过多使用小点和横杠
- 客观陈述：事实部分客观陈述，避免主观评价
- 缺失信息标注：用「[待确认]」标注缺失或不确定的信息
- 专业表述：使用准确的法律术语，逻辑清晰
- 避免预承诺可量化交付物（自缚手脚防护）：方案中不要把后续"可能但非必经"的工作写成具体的、可被客户量化追踪的交付物清单（如各类评估报告、应对预案、答复意见框架等具名文件）。这类清单一旦写入，易被客户当作律师承诺与交付节点追踪，律师自缚手脚、徒增不必要工作量；且这些工作是否实际发生取决于对方行为或程序进展，本身具有不确定性。
- 正确写法：只提示风险（"对方可能以提起 XX 作为反制手段"）+ 律师作初步评估；并明确"如实际发生，作为独立项目另行接受委托、专项应对，相关费用届时协商"。
- 适用场景：专利无效宣告应对、反诉、二审/再审、执行异议、追加当事人等一切"取决于对方行为或程序进展"的后续工作——均按"提示风险 + 初步评估 + 另行协商"处理，不在本方案里预列具体交付文件。
可视化扩展（可选）：
可根据需要使用 Mermaid 图表辅助说明，详见 可视化指南。
外部可视化 skill 配图（推荐）：
对于案件时间轴、主体关系、程序流程、证据链、服务阶段、风险矩阵等需要正式图表的段落，优先扫描当前可用的可视化类 skill（如 legal-visualization、canvas-design 等），按 可视化指南 · 外部可视化 skill 路由 的规则选用最合适的一个产出 PNG/SVG/PDF 等高保真图件，再以  形式插入正文。不要硬编码到某个具体 skill；如果当前环境没有合适的可视化 skill，退回 Mermaid 内联方案。
结案汇报补充要求：
- 必须准确区分结案方式，不得混淆判决、调解、和解、撤诉
- 如存在客户授权条件与实际结果差异，应如实说明原因，不得淡化
- 金额、数量、履行状态等结果性信息应优先回到结案文书或沟通记录核对
步骤 4: 保存并生成交付文件
先保存 Markdown 源稿，文件名格式为文档类型+案件/项目名称。诉讼服务方案、非诉服务方案和法律服务建议书如需向客户交付，默认再生成设计版 Word；用户只要 Markdown 时仅交付源稿。其他文档类型按用户指定格式处理。
Word 源稿须在顶部提供 law_firm、client、lawyer、date，首个 # 为封面标题；也可在命令行补充这些字段。正文可用章/节标题、段落、简单列表、表格、引文和加粗。不要在 Word 源稿中重复插入 team-config 的 HTML 团队页。先核实内容和团队选择，再渲染；排版器不负责补全事实、法条或报价。运行方式、JSON 内容契约、模板 token 快速通道及跨引擎验收见 Word 管线说明。
生成设计版 Word 的依赖：Node.js ≥ 22、docx 包。首次使用执行 npm install -g docx；在本 Skill 根目录运行：
NODE_PATH=$(npm root -g) node word/render.js \
--input /绝对路径/方案.md --output /绝对路径/方案.docx --cover C用户要包含承办团队、相关裁判文书、律所简介和荣誉的完整版时，增加 --full --lawyers 姓名1,姓名2；渲染器默认从本地 config/team-config.md 读取，经 --team-config 可覆盖。未选主办律师时先根据已提供材料确定，不能随意把配置中所有人列为承办团队。交付前检查所有引用图片已脱敏；逐页检查 DOCX 及导出的 PDF，并在实际 WPS、Microsoft Word 中核对封面和分页。页数随内容变化，不把既有案例的 6/10 页当作固定规范。
Word 的正文页码从 1 起算，后部附页用页名作页脚；HTML/PDF 的“当前页 / 正文总页数”在 Word 中只保留可更新的当前页。具体版式对应关系和限制见 Word 管线说明。
少量变量填充的 word/fill.py 需 python-docx，首次使用执行 python3 -m pip install python-docx；它只用于固定模板，不代替逐案正文生成。