--- name: ecm-draft-format-adjust title: ecm-draft-format-adjust description: Word 文档格式调整 skill。当用户要求调整 / 优化 / 修正 / 排版 / 套版 / 套格式 / 按律所模板 格式化 / 按证监会要求格式化 Word 文档（包括律师工作报告、法律意见书、法律备忘录、法律意见、 会议文件、信披文件等），具体调整项包括：字体、字号、行距、段前段后、首行缩进、标题层级、 章节编号、自动编号、交叉引用、脚注、尾注、页眉页脚、页码、目录（自动生成 / 更新）、 表格样式、封面页、签字页、Markdown → Word 转换、套用律所样式 / 样式表、批量统一格式、 按 shared/templates 规范套版，或说"把这份文件格式弄一下""按律所模板排版""格式不统一帮我 改下""加个目录""生成页眉页脚""正文统一小四宋体""一级标题用黑体"等场景时触发。 典型输入：待调整的 Markdown / Word / PDF 文件、目标格式规范名（work-report / legal-opinion / legal-memo / meeting-docs / 律所自定义样式），或具体格式要求（字体 / 字号 / 行距等）。 典型输出：格式调整后的 Word 文档 + 格式检查清单 + 样式调整记录。 非触发边界：本 skill 不起草文书内容（归各起草类 skill）、不做内核审查（归 ecm-qc-*）、 不做 PDF 填表（归外部 pdf skill）。即使用户未明确说"排版 / 格式"，只要涉及 Word 的视觉 / 结构调整（标题层级、编号、目录、页眉页脚、交叉引用）也应触发。 author: zeweihan author_url: https://github.com/zeweihan/A-market-ecm-lawyer-plugin/tree/main/skills/ecm-draft-format-adjust license: MIT version: 0.1.0 execution_mode: open jurisdiction: general practice: general language: zh --- # ecm-draft-format-adjust ## 定位与边界 本 skill **负责**： - **Markdown → Word 套版**：把起草类 skill 输出的 Markdown 初稿按 `shared/templates/` 下的格式规范转为 Word 文档 - **Word 文档的格式统一**：字体 / 字号 / 行距 / 段前段后 / 首行缩进的全文档统一 - **章节编号 / 自动编号**：将硬编码的"第一部分"/"第二部分"转为 Word 自动编号（Heading 样式绑定列表） - **目录生成 / 更新**：自动插入 / 刷新目录（TOC） - **交叉引用处理**：将形如 `{{XREF: 第N部分.小节M}}` 的占位符替换为 Word 域代码 - **页眉页脚 / 页码**：按格式规范添加页眉页脚，支持奇偶页不同 / 章节页码重置 - **封面与正文之间的分页**：插入分页符，保证封面独占一页 - **签字页格式**：按格式规范生成签字盖章页 - **表格样式统一**：应用标准表格样式（外框 / 内框 / 表头底色 / 跨页表头重复） - **律所自定义样式表注入**：若用户提供律所 `.dotx` 模板，按其样式表套版 本 skill **不负责**： - 文书内容的起草（归各起草类 skill） - 内核审查修订痕迹（归 ecm-qc-*） - PDF 的生成（Word → PDF 由用户在 Word 中另存） - 骑缝章、电子签章的添加（由印章系统或后期处理） - 超出 Word 的特殊排版（如需要 LaTeX、Adobe InDesign 等工具的排版需求） ## 免责声明 本 skill 做**格式化**工作，不修改文书的内容实质。格式调整后文件需律师复核确认内容未因格式化而失真。完整免责声明见 [DISCLAIMER.md](../../DISCLAIMER.md)。 ## 资深律师执行标准 执行本 skill 时，必须同时遵循 [senior-lawyer-execution-standards.md](../../shared/templates/senior-lawyer-execution-standards.md)。本 skill 的任何输出不得突破四条底线：事实可追溯、法源可核验、风险可分级、建议可落地；无法核验时必须显式标注。 ## 本 skill 的实务加固点 - **格式不改实体**：格式调整不得改变法律结论、事实描述、金额、日期、主体名称和风险等级。 - **修订痕迹保护**：含 tracked changes / comments 的 Word 文件不得扁平化；无法保留时必须先提示用户。 - **目录与交叉引用**：自动目录、编号、表格编号、附件编号和交叉引用应优先修复，避免申报文件结构错误。 - **失败回退**：无法转换或样式冲突时，应输出问题清单和可手工处理步骤，不得生成看似完成的错误版本。 ## 前置依赖 - 外部 `docx` skill（必需）：本 skill 的 Word 操作都委托给 docx skill 执行 - `shared/templates/` 下的格式规范文件（本 skill 的"套版源"）： - [`work-report-format.md`](../../shared/templates/work-report-format.md)（律师工作报告 / 尽职调查报告） - [`legal-opinion-format.md`](../../shared/templates/legal-opinion-format.md)（法律意见书） - [`legal-memo-format.md`](../../shared/templates/legal-memo-format.md)（法律备忘录） - [`meeting-docs-format.md`](../../shared/templates/meeting-docs-format.md)（会议文件） ## 核心工作流（七步） ### Step 1：识别目标格式规范 用户可能通过以下方式指定目标格式： 1. **显式指定**：指定 `shared/templates/` 下具体文件（如 `work-report-format.md`） 2. **隐式识别**：按输入文件类型推断： - 律师工作报告 / 尽职调查报告 → `work-report-format.md` - 法律意见书 → `legal-opinion-format.md` - 法律备忘录 / 备忘 / 备注录 / legal memo → `legal-memo-format.md` - 会议通知 / 议案 / 决议 / 会议记录 / 签到表 → `meeting-docs-format.md` 3. **律所自定义**：用户提供 `.dotx` / `.docx` 模板 → 本 skill 按该模板样式表套版，但章节结构仍按标准规范 4. **手工指定**：用户直接告诉本 skill 具体参数（字体 / 字号 / 行距等），不使用标准规范 ### Step 2：读取输入文件 - Markdown → 结构化解析（用 pypandoc 或标准 Markdown AST） - Word → 调用 `docx` skill 读取样式、段落、表格、页眉页脚 - PDF → 提示用户提供 Word 源文件（PDF 的格式难以可靠回填） ### Step 3：规范化转换（按格式规范表套版） 对每个 Markdown / Word 元素按格式规范的"Markdown → Word 参数表"查找对应 Word 样式，执行： - 段落属性（字体、字号、加粗、段前段后、行距、首行缩进、对齐） - 标题层级映射（Markdown `# ## ###` → Word Heading 1/2/3 + 绑定自动编号样式） - 表格样式（外框、内框、表头、跨页重复） - 页面设置（纸张 A4 / 页边距 / 奇偶页不同） ### Step 4：自动编号 / 交叉引用 / 目录 - 将 Markdown 中的汉字编号（"第一部分"）转为 Word Heading 1 绑定的自动编号样式 - 扫描文档中的交叉引用占位符（`{{XREF: 第N部分.小节M}}` / 对应 Markdown 章节名）替换为 Word REF 域代码 - 在"封面后、引言前"插入 TOC 域代码，并触发刷新 ### Step 5：页眉页脚 / 页码 - 按格式规范在 Word 中添加页眉页脚 - 奇偶页不同（律师工作报告 / 法律意见书）：奇数页右对齐文件类型、偶数页左对齐律所名 - 页码：封面 / 目录不显示；从引言起算阿拉伯数字；附件部分重新编号（若格式规范如此要求） ### Step 6：特殊段落处理 - **封面页**：按规范的元素顺序和样式生成；封面末尾自动插入分页符 - **签字盖章页**：按规范生成（律所盖章位 + 律所负责人签字行 + 经办律师签字行 + 日期） - **表格**：应用标准表格样式；表格上方加表号表名（如 "表 5-1 股权结构穿透表"） - **脚注 / 尾注**：统一为尾注（律师文书惯例），字号小五号 ### Step 7：输出 + 格式检查清单 - Word 文档落到原始输入文件同目录（若输入为 Markdown，则落到 `04-文件输出/` 对应类别目录） - 文件名：`{原文件名}-{YYYYMMDD}-{格式化版本}.docx` - 生成**格式检查清单**（同目录，`格式检查-{YYYYMMDD}.md`），列明： - 格式规范来源（用了哪份 `shared/templates/*.md`） - Markdown → Word 元素映射清单（每个样式的应用数量） - 自动编号绑定结果（多少个章节、多少级标题使用自动编号） - 交叉引用处理结果（成功替换数 / 未找到目标数） - 目录生成结果（层级深度、条目数） - 页眉页脚 / 页码应用结果 - 异常项清单（格式规范中有要求但输入文件未提供的元素，如"封面签字栏未找到必需字段"） ## 配置项 ### 目标格式规范（Target Format） - `work-report`（律师工作报告 / 尽职调查报告） - `legal-opinion`（法律意见书） - `legal-memo`（法律备忘录） - `meeting-docs`（会议文件） - `auto`（默认；按输入文件类型自动识别） - `custom`（用户提供 `.dotx` 模板或手工指定参数） ### Word 样式绑定方式（Style Binding） - `direct`（默认）：直接设置段落属性（字体 / 字号 / 行距等）—— 简单但不利于后期批量修改 - `style-based`：使用 Word Style 机制（推荐律所内批量出文档时使用）—— 后期修改样式即可批量应用 ### 页面设置（Page Setup） - `a4-standard`（默认）：A4，上 2.5 / 下 2.5 / 左右 2.5 cm - `a4-tight`：上 3.5 / 下 2.5 / 左右 2.5 cm（封面用，右侧留骑缝章位） - `custom`：用户指定 ### 交叉引用处理（XRef Handling） - `auto`（默认）：扫描占位符自动替换为 Word 域代码 - `off`：跳过交叉引用处理（保留占位符） - `manual`：只报告占位符位置，不自动替换 ### 目录（TOC） - `on`（默认）：生成 2 级目录 - `deep`：生成 3 级目录 - `off`：不生成目录 ## 输出格式契约 1. **文件路径**：`{输入目录}/{原文件名}-{YYYYMMDD}.docx`（Word 版本） 2. **格式检查清单**：同目录 Markdown，必出 3. **样式绑定结果**：按配置项 `style-based` 模式时，输出 Word 文件需保留 Style 定义（可通过 Word 文档的"样式"窗格查看） 4. **异常清单**：必出；每条异常有明确位置（章节 / 页码），不含行号（Markdown 的行号与 Word 不对应） ## 与邻近 skill 的边界 - 与 `ecm-draft-report-assembly` / `opinion-letter` / `meeting-docs` / `disclosure-review`：本 skill 是它们的"下游"——起草类 skill 出 Markdown 初稿后，本 skill 做 Word 套版 - 与 `ecm-design-*` 系列：本 skill 对 `ecm-design` 输出的法律备忘录（走 `legal-memo-format.md`）做 Word 套版 - 与 `docx` 外部 skill：本 skill 是"业务层"，`docx` 是"操作层"；本 skill 的 Word 操作都委托给 docx - 与 `ecm-qc-*` 系列（QC 审查）：QC skill 输出的是带 tracked changes 的 Word 修订稿，**不经过本 skill**；QC 的修订痕迹是在**已套版**的 Word 上直接做 ## 参考资料索引 - [references/markdown-to-word-mapping.md](./references/markdown-to-word-mapping.md) —— Markdown 元素 → Word 样式的完整映射表（所有格式规范共用） - [references/format-check-checklist.md](./references/format-check-checklist.md) —— 格式检查清单的具体条目（每类文档独立 checklist） - [references/docx-skill-invocation-patterns.md](./references/docx-skill-invocation-patterns.md) —— 调用 docx 外部 skill 的典型模式（对段落属性、表格、页眉页脚、域代码等） ## 常见误用 / FAQ 1. **"能直接调整 PDF 吗？"**：不能。PDF 的格式难以可靠回填；请提供 Word 源文件。 2. **"律所有自己的 .dotx 模板，能用吗？"**：可以。用 `custom` 模式；本 skill 会优先使用律所模板的样式表 + 本仓库格式规范的章节结构（若冲突以律所模板的字体 / 字号为准，章节结构按规范） 3. **"能只改字体不改其他吗？"**：可以。在 Step 1 指定 `custom` 模式并手工传入"仅字体"参数 4. **"目录更新后字体不统一怎么办？"**：本 skill 生成的 TOC 自动继承目录样式；若仍不统一，可能是 Word 在插入 TOC 时按 Normal 样式；建议运行 `style-based` 模式以确保样式绑定 5. **"交叉引用占位符怎么写？"**：在 Markdown 中使用 `{{XREF: 第N部分.小节M}}`（推荐）或 `详见本报告"第N部分"`（后者本 skill 无法自动替换为域代码，但保留文本） 6. **"表格跨页了怎么办？"**：本 skill 对所有表格应用"跨页时自动重复表头行"样式；若仍出问题，可能是单行高度超过一页（一般是超长单元格）；手工拆分内容 7. **"输入 Markdown 的段落里用了 `**加粗**`，转换到 Word 后还加粗吗？"**：保留。本 skill 保留行内样式（加粗 / 斜体 / 下划线 / 代码） ## 变更规则 - 输出契约变动 → MAJOR - 新增配置项 / 支持新格式规范 → MINOR - Markdown → Word 映射表的样式参数调整（跟随 shared/templates 下格式规范的 PATCH 更新） → PATCH