thesis-md-to-docx

name	thesis-md-to-docx
description	将本科毕业论文 Markdown 严格转换为 Word .docx 的专用 skill。用户要求把 .md、论文 Markdown、毕业论文草稿、thesis.md 转成 docx/Word/毕业论文模板格式时必须使用，尤其是提到“毕业论文模板.docx”“格式规范.docx”“广东工业大学”“按模板排版”“论文 docx”“Markdown 转 Word”等场景。使用时必须调用 markdown-to-docx skill 的 pandoc/template 转换流程，并以项目中的 模板/毕业论文模板.docx 作为 Word 参考模板、模板/格式规范.docx 作为格式规范依据；转换后必须运行校验并修复明显格式问题。

毕业论文 Markdown 转 DOCX

把已经写好的 .md 毕业论文转换为符合本科毕业论文模板与格式规范的 .docx 文件。该 skill 不负责重新写论文正文，重点是转换、套模板、格式校验和必要的 Markdown 预处理。

固定模板与规范

默认使用当前项目中的：

• Word 模板：模板/毕业论文模板.docx
• 格式规范：模板/格式规范.docx
• 转换能力：调用 markdown-to-docx skill

除非用户明确指定其他模板，不要换用其他 Word 模板。若模板文件缺失，先提示用户补充，不要用普通空白 Word 文档冒充毕业论文模板。

启动流程

1. 确认输入 Markdown 文件路径。
   • 如果用户提供单个 .md 文件，转换该文件。
   • 如果用户提供目录，询问是转换目录下所有顶层 .md，还是只转换某一个文件。
2. 检查模板文件是否存在：
   • 模板/毕业论文模板.docx
   • 模板/格式规范.docx
3. 询问用户是否需要重新扫描 模板/格式规范.docx。
   • 如果用户选择重新扫描：提取规范重点后再转换。
   • 如果用户选择不扫描：使用本 skill 的规范摘要。
4. 调用 markdown-to-docx skill 的模板转换流程，使用 毕业论文模板.docx 作为 reference/template。
5. 转换后运行 markdown-to-docx 的 post-check 校验。
6. 如果校验发现明显问题，优先修复 Markdown 或转换参数后重新生成；不要直接交付未检查的 docx。
7. 输出最终 .docx 路径，并简要说明使用了哪个 Markdown、哪个模板和校验结果。

与 markdown-to-docx skill 的协作

转换时必须遵循 markdown-to-docx skill 的流程：

1. 确认 pandoc 可用。
2. 使用其脚本进行模板化转换，而不是手写临时转换流程。
3. 对有 Word 模板的任务，优先使用：

SKILL_DIR="<markdown-to-docx skill 路径>"
"$SKILL_DIR/scripts/render_markdown_with_dotx.sh" \
  "<source-md>" \
  "<output-docx>" \
  "模板/毕业论文模板.docx" \
  "<论文题目或文档标题>" \
  "<resource-root>"

4. 转换后运行：

python3 "$SKILL_DIR/scripts/validate_captions.py" post "<output-docx>"

5. 如果 render_markdown_with_dotx.sh 无法处理 .docx 模板或环境缺依赖，再退回到 pandoc reference-doc 工作流：

pandoc "<source-md>" \
  -o "<output-docx>" \
  --reference-doc="模板/毕业论文模板.docx" \
  --resource-path="<resource-root>"

退回方案也必须说明原因，并尽可能运行可用的后置检查。

格式规范摘要

转换输出应尽量满足 毕业论文排版要求汇总.md 汇总的广东工业大学本科毕业设计（论文）排版要求：

• 整体版面：A4；页边距上 30mm、下 25mm、左 30mm、右 20mm；正文 1.5 倍行距；使用国家公布的规范汉字。
• 页码：从绪论开始使用阿拉伯数字连续编排，置于页脚右侧；封面、中英文摘要、目录不编入页码。
• 论文结构：封面 → 诚信承诺书 → 中英文设计说明书（摘要） → 目录 → 绪论 → 正文 → 结论 → 参考文献 → 致谢 → 附录 → 外文参考文献译文及原文。
• 封面：论文题目为二号黑体加粗；学院、专业、年级班别、学号、学生姓名、指导教师等信息为三号黑体加粗并居中；日期置于底部，三号黑体加粗。
• 标题：章标题、摘要标题、目录标题、参考文献标题、致谢标题、附录标题为三号黑体加粗；节标题为小四号黑体加粗；条标题为小四号黑体。
• 正文：中文正文、摘要正文、致谢正文、附录正文为小四号宋体；英文、变量名和英文摘要使用 Times New Roman；段落首行缩进 2 个字符。
• 摘要与目录：摘要 / Abstract 标题按三号黑体加粗处理；目录标题三号黑体加粗；目录层级保持清晰，理工、社科类一般按 1、1.1、1.1.1 三级标题组织。
• 参考文献：标题“参考文献”居中，三号黑体加粗；按 GB/T 7714—2015 编排；序号左顶格并使用方括号；每条末尾以句点结束；外文文献姓在前、名缩写在后。
• 公式：公式另起一行居中，编号置于右侧行末，用圆括号并按章编号，如 (1.1)；文中引用写作“见式(1.1)”或“由公式(1.1)”。
• 表格：表号和表题置于表上居中，按章编号，如 表1.1 表名；表名不使用标点；表题五号黑体加粗，数字/字母为五号 Times New Roman 加粗；表内文字五号宋体，附注小五号宋体。
• 插图：图号和图题置于图下，按章编号，如 图2.1 图名；图题五号宋体；图注置于图题之上，小五号宋体；图与图题、表与表题应尽量作为整体避免跨页拆分。
• 坐标与照片图：坐标图必须标明坐标轴和单位；照片应清晰整洁，金相显微组织照片需注明放大倍数。
• 注释：解释性注释使用页末注或篇末注，不使用行中注；同页多个注释按出现顺序编号。
• 附录：附录按 附录A、附录B 编号；附录中的图、表、公式分别用 图A1、表B2、式(B3) 等形式独立编号；附录正文格式同论文正文。
• 外文参考文献译文：单独成册时格式与正文一致，扉页写“外文参考文献译文及原文”，三号黑体加粗。
• 其他规范：标点按 GB/T 15834—2011；量和单位按 GB 3100～GB 3102—93；首次出现英文缩写应注明英文全文；测量统计数据用阿拉伯数字，叙述性文字中不大的数目可用中文数字，年份写全数。

Markdown 无法表达的精细排版，应尽量通过 Word 模板和后处理完成；不要在 Markdown 中加入大量 Word 专用说明文字。

Markdown 预处理要求

转换前检查并必要时提醒用户修正：

• 标题层级应清晰，建议仅一个文档主标题，章节用 # 1 绪论 或按模板需要映射。
• 摘要、Abstract、目录、正文、参考文献、致谢、附录应结构完整。
• 图表应有规范题注：图X.Y 图名、表X.Y 表名。
• 参考文献条目不要使用虚构信息。
• 图片路径应相对 Markdown 文件或 resource-root 可访问。
• 代码块、目录树、长表格可能影响 Word 排版，必要时提示用户人工检查。

输出文件规则

• 默认输出到源 Markdown 同目录。
• 默认文件名与源 Markdown 同名，例如 thesis.md → thesis.docx。
• 如果目标文件已存在，不要无提示覆盖；使用带后缀的新文件名，或询问用户是否覆盖。
• 转换成功后只报告必要信息：输出路径、模板路径、校验是否通过、是否存在需要人工复查的项。

常见问题处理

• 缺少 pandoc：提示用户安装 pandoc，或说明无法继续转换。
• 模板缺失：提示缺少 模板/毕业论文模板.docx 或 模板/格式规范.docx。
• 图片丢失：检查 --resource-path，优先把项目根目录、Markdown 所在目录和资源目录都纳入。
• 图表题注缺失：使用 markdown-to-docx 的 caption 修复/校验能力，必要时要求用户补充图题表题。
• 校验失败：说明失败项，修复后重新生成；不能修复时明确列为“需人工复查”。

交互模板

我会把该 Markdown 按 `模板/毕业论文模板.docx` 和 `模板/格式规范.docx` 转为 Word。是否需要我重新扫描格式规范？另外请确认输出目录是否使用 Markdown 同目录。

转换完成：
- 源文件：...
- 输出 DOCX：...
- 使用模板：模板/毕业论文模板.docx
- 格式规范：模板/格式规范.docx
- 校验结果：...