| 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_zh: |
这里写中文摘要全文，可以多段，用空行分段。
keywords_zh: [关键词1, 关键词2, 关键词3]
abstract_en: |
English abstract goes here, multiple paragraphs separated by blank lines.
keywords_en: [keyword1, keyword2, keyword3]
references:
- "马建勋，梅占馨．筒仓在地震作用下的计算理论[J]．土木工程学报，1997，30（1）：25-30．"
- "Skolink M I. Radar handbook[M]. New York: McGraw-Hill, 1990."
acknowledgments: |
本论文是在指导老师×××的悉心指导下完成的……
作者：张三
2024年5月20日
appendix: |
附录1 主要符号表
……
---
正文段落，会自动套用宋体小四 + 22磅固定行距 + 首行缩进 2 字符。
正文段落。
下面这种写法会被识别成图：
下面这种写法会被识别成表（表号+标题写在表格上一行，以 `表X.X` 开头）：
表2.1 三种肌球蛋白/多糖混合凝胶的红外光谱数据
| Treatment | PK1 | PK2 |
|---|---|---|
| Myosin gel | 3439 | — |
| Myosin+1% KCG | 3358 | 3006 |
格式约定要点：
- 一级标题
# 1 绪论 → 章（自动分页 + 黑体三号居中）
- 二级标题
## 1.1 ... → 节（黑体小四左对齐）
- 三级标题
### 1.1.1 ... → 小节（宋体小四加粗左对齐）
- 普通段落 → 宋体小四 + 22磅固定行距 + 首行缩进 2 字符
- 图：
，图题会自动放在图下面居中
- 表：在表格 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: []，不要编造文献。
不要做的事
- 不要修改用户正文的措辞或观点，只做排版
- 不要替用户编造参考文献
- 不要把字体/字号"优化"成你觉得更好看的——规范说什么就是什么
