| 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: [],不要编造文献。
不要做的事
- 不要修改用户正文的措辞或观点,只做排版
- 不要替用户编造参考文献
- 不要把字体/字号"优化"成你觉得更好看的——规范说什么就是什么