ecm-draft-format-adjust

name	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 的视觉 / 结构调整（标题层级、编号、目录、页眉页脚、交叉引用）也应触发。
version	0.1.0
license	MIT
module	ecm-draft
user_role	项目组律师
phase	["全阶段"]
category	["格式处理"]
depends_on	{"external_skills":["docx"]}

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。

资深律师执行标准

执行本 skill 时，必须同时遵循 senior-lawyer-execution-standards.md。本 skill 的任何输出不得突破四条底线：事实可追溯、法源可核验、风险可分级、建议可落地；无法核验时必须显式标注。

本 skill 的实务加固点

• 格式不改实体：格式调整不得改变法律结论、事实描述、金额、日期、主体名称和风险等级。
• 修订痕迹保护：含 tracked changes / comments 的 Word 文件不得扁平化；无法保留时必须先提示用户。
• 目录与交叉引用：自动目录、编号、表格编号、附件编号和交叉引用应优先修复，避免申报文件结构错误。
• 失败回退：无法转换或样式冲突时，应输出问题清单和可手工处理步骤，不得生成看似完成的错误版本。

前置依赖

• 外部 docx skill（必需）：本 skill 的 Word 操作都委托给 docx skill 执行
• shared/templates/ 下的格式规范文件（本 skill 的"套版源"）：
  • work-report-format.md（律师工作报告 / 尽职调查报告）
  • legal-opinion-format.md（法律意见书）
  • legal-memo-format.md（法律备忘录）
  • 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 —— Markdown 元素 → Word 样式的完整映射表（所有格式规范共用）
• references/format-check-checklist.md —— 格式检查清单的具体条目（每类文档独立 checklist）
• 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