thesis-format-hfut

name	thesis-format-hfut
description	把按 schema 写好的论文 Markdown 转换成符合《合肥工业大学本科毕业设计（论文）写作规范》的 .docx。当用户要"按毕设格式输出 word"、"生成毕业论文 docx"、"按学校格式排版论文"时调用。

合肥工业大学本科毕业设计（论文）格式化

这个 skill 干嘛的

把一个按特定 schema 写好的 Markdown 源文件，转换成符合《合肥工业大学本科毕业设计（论文）写作规范》的 Word 文档（.docx）。

输入：一个带 YAML frontmatter 的 .md 文件（封面信息、摘要、关键词、参考文献都在 frontmatter 里；正文、图、表用 markdown 写）。 输出：一个排版好的 .docx，字体/字号/行距/缩进/对齐都按规范走。

什么时候用

用户说类似的话就调：

• "按毕设格式生成 word"
• "把这篇论文按学校规范排版"
• "输出符合 HFUT 毕业论文格式的 docx"
• 给了一段论文内容，让你"整理成毕业论文格式"

怎么用

1. 帮用户准备源文件

如果用户给的是散乱的内容（比如一段段落、一个大纲），先把它整理成本 skill 期望的 Markdown 格式。参考 example.md。

关键约定（必读，否则生成的文档会缺字段）：

---
# 封面信息（全部必填，缺的留空字符串）
type: 论文                    # "论文" 或 "设计"
title_zh: 中文题目
title_en: English Title
author: 张三
student_id: 2020XXXXXXX
advisor_name: 李四
advisor_title: 教授
major: 软件工程
admission_year: 2020
school: 计算机与信息学院
complete_time: 2024年5月       # 中文写法
complete_month_en: May        # 英文月份，封面英文页用
complete_year_en: 2024
author_en: Zhang San          # 姓前名后，首字母大写

# 摘要 / Abstract
abstract_zh: |
  这里写中文摘要全文，可以多段，用空行分段。
keywords_zh: [关键词1, 关键词2, 关键词3]
abstract_en: |
  English abstract goes here, multiple paragraphs separated by blank lines.
keywords_en: [keyword1, keyword2, keyword3]

# 参考文献（按规范的 [J] [M] [C] [D] 等格式自己写好）
references:
  - "马建勋，梅占馨．筒仓在地震作用下的计算理论[J]．土木工程学报，1997，30（1）：25-30．"
  - "Skolink M I. Radar handbook[M]. New York: McGraw-Hill, 1990."

# 致谢
acknowledgments: |
  本论文是在指导老师×××的悉心指导下完成的……
  作者：张三
  2024年5月20日

# 附录（没有就删掉这一段）
appendix: |
  附录1 主要符号表
  ……
---

# 1 绪论

## 1.1 研究背景

正文段落，会自动套用宋体小四 + 22磅固定行距 + 首行缩进 2 字符。

### 1.1.1 子节标题

正文段落。

# 2 第二章标题

## 2.1 节标题

下面这种写法会被识别成图：

![图2.1 酶解时间对DH的影响](path/to/figure.png)

下面这种写法会被识别成表（表号+标题写在表格上一行，以 `表X.X` 开头）：

表2.1 三种肌球蛋白/多糖混合凝胶的红外光谱数据

| Treatment | PK1 | PK2 |
|---|---|---|
| Myosin gel | 3439 | — |
| Myosin+1% KCG | 3358 | 3006 |

格式约定要点：

• 一级标题 # 1 绪论 → 章（自动分页 + 黑体三号居中）
• 二级标题 ## 1.1 ... → 节（黑体小四左对齐）
• 三级标题 ### 1.1.1 ... → 小节（宋体小四加粗左对齐）
• 普通段落 → 宋体小四 + 22磅固定行距 + 首行缩进 2 字符
• 图：![图X.X 图题](图片路径)，图题会自动放在图下面居中
• 表：在表格 markdown 上一行写一个以 表X.X 开头的标题行
• 章与章之间会自动插分页符

2. 调用生成脚本

确保已经装了 python-docx：

python3 -m pip install --user python-docx pyyaml 2>&1 | tail -1

然后跑：

python3 ${SKILL_DIR}/scripts/build_thesis.py <input.md> <output.docx>

${SKILL_DIR} 是这个 skill 所在目录（通常是 ~/.claude/skills/thesis-format-hfut/）。

3. 验证

生成完后告诉用户 .docx 的路径，提醒：

• 封面页和英文标题页的占位下划线长度可能要在 Word 里手动微调
• 目录是空的（只放了"目 录"标题），需要在 Word 里点 "引用 → 目录 → 自动目录" 生成；脚本已经为各级标题打了样式标记
• 图片如果路径找不到会被标黄"[图片缺失：xxx]"，用户改完路径重跑即可

输入不全怎么办

如果用户只给了正文没给 frontmatter，先问清楚封面元信息（题目、姓名、学号、专业、指导教师、学院、完成时间），不要瞎填。摘要/关键词如果没给可以问用户要，或者基于正文提议一版让用户改。

参考文献用户没给的话就留空数组 references: []，不要编造文献。

不要做的事

• 不要修改用户正文的措辞或观点，只做排版
• 不要替用户编造参考文献
• 不要把字体/字号"优化"成你觉得更好看的——规范说什么就是什么