用途
Markdown to MS Word Converter 是一个专门用于将 Markdown 纯文本文件（.md）转换为 MS Word 二进制文档（.docx）的转换代理技能。它面向需要将 Markdown 内容批量或单个导出为 Word 格式的场景，例如文档交付、报告生成或格式归档。
主要能力
- 单文件转换：将单个 .md 文件转换为对应的 .docx 文件。
- 批量转换：在项目范围内批量将多个 .md 文件各自转换为一个 .docx 文档。
- 约束验证：转换后通过验证引擎检查生成的 .docx 二进制文件是否有效，返回 success 或 errors_found 状态及 JSON 日志。
- 错误排查：当验证发现 ArchiveCorrupt、NoParagraphs 等问题时，可参考 references/fallback-tree.md 进行诊断。
使用方式
依赖要求：Python 3.8+，仅使用标准库，无需外部包。安装依赖的命令为：
pip-compile ./requirements.in
pip install -r ./requirements.txt
requirements.txt 为依赖锁定文件（当前为空，仅标准库）。
核心工作流分为两个阶段：
阶段一：引擎执行
- 批量转换：
python run_bulk_md_to_docx.py --overwrite - 单文件转换：
python md_to_docx.py input.md --output output.docx
阶段二：委托约束验证（L5 模式） 生成 .docx 文件后（批量生成时至少抽样），立即执行验证引擎：
python3 ./scripts/verify_docx.py "output.docx"
若返回 "status": "success"，则生成的二进制文件有效。若返回 "status": "errors_found"，需查看 JSON 日志（如 ArchiveCorrupt、NoParagraphs），常见原因是源 Markdown 中嵌入了不支持的 HTML 标签，此时应查阅 references/fallback-tree.md。
适用场景
- 需要将 Markdown 文档转换为 Word 格式进行交付或存档。
- 项目内存在大量 .md 文件，需要批量生成对应的 .docx 文件。
- 对生成的 .docx 二进制文件有验证需求，确保文件未损坏且包含段落内容。
限制与约束
- 禁止手动二进制操作：不得尝试从上下文窗口直接写入原始 XML 或 .docx 字节流，LLM 无法安全生成二进制归档。
- 禁止污染上下文读取：不得使用 cat 或读取生成的 .docx 文件回聊天上下文来“检查”工作，因为它是包含 XML 的 ZIP 归档，会立即破坏上下文窗口。必须使用 verify_docx.py 脚本检查文件。
- 所有二进制生成与验证必须通过插件提供的加固 .py 脚本完成。
- 若转换脚本崩溃或验证循环失败，应停止并查阅 references/fallback-tree.md 进行分诊和替代转换策略。
- 源 Markdown 中不支持的 HTML 标签可能导致验证错误。
工具脚本
- 单文件引擎：scripts/md_to_docx.py
- 批量引擎：scripts/run_bulk_md_to_docx.py
- 验证引擎：scripts/verify_docx.py