skill
ZUFE-Thesis-Skill
面向浙江财经大学学生的毕业论文 & 专业实践报告自动排版 Skill。用户只需与 AI 交流,就能将 Word 初稿转化为规范格式的 PDF 和 LaTeX 工程,简单易用,无需再浪费时间排版。
Set up
Skills are installed by placing their folder where your agent loads skills.
The download comes from github.com/SeraphinaGlacia/ZUFE-Thesis-Skill itself, not from our server, so what you get is exactly what its author published.
Install instructions come from the README
README
synced Oct 27, 2026[!CAUTION] 本项目目前与上游模板间存在兼容性问题。在本项目发布解决与上游模板兼容性问题的更新之前,不建议再使用本项目。
本 Skill 依赖于原模板工作,如果没有它,本 Skill 也无从立足。本项目所做的,只是为它补充了更适合普通学生使用的 Agent Skill,让不会 LaTeX 的人,也能先享受到 LaTeX 规范排版带来的便利。
[!IMPORTANT] 本项目不代表浙江财经大学官方工具,也不是原始模板项目的官方组成部分。最终格式仍以学校要求、导师要求和原始模板为准。
一、这个 Skill 能解决什么问题?
它主要解决的是:已经有 Word 初稿,不会 LaTeX,但想得到排版专业的文档 的问题。本 Skill 会协助检查和准备环境,并将你的 Word 初稿转换为 LaTeX 工程与格式正确的 PDF,显著减少手动调整格式的时间,让你专注于文章内容本身。
二、我适合用这个 Skill 吗?
如果你符合以下要求,那么恭喜你,这个 Skill 会非常适合你:
- 你正在写浙江财经大学本科毕业论文、专业实践报告或类似格式的课程论文。
- 你已经有 Word 初稿,但不想把时间花在反复调格式上。
- 你不熟悉 LaTeX,但希望得到可提交、可继续维护的 LaTeX 工程或 PDF。
- 你对于 Agent Skill 有基本的认知。
- 你具备基本的操作 Agent 及其衍生工具(例如 Kimi Work、Codex)的能力。
- 你愿意在 AI 对话中确认少量关键信息,并配合 Agent 执行工作。
三、使用这个 Skill,我需要准备什么?
你需要准备:
- 一份已经写好的 Word 初稿(需要使用
.docx格式) - 一份完整的 ZUFE-Thesis 模板项目
- 一个可以运行 Agent Skill 的工具环境(例如:Kimi Work、Codex 等)
四、我能得到什么?
一次完整转换后,你应该能得到:
main.pdf:按 ZUFE-Thesis 模板编译出的 PDF。- 可继续修改的 LaTeX 工程:包括章节、图片、参考文献和基础信息文件。
当然,你也会同时得到 report.md,qa_report.md 等用来记录转换过程、确认事项和相关说明的记录文档。如果你需要对工作过程进行检查,这些文档可以帮助你。
五、那该如何使用呢?(快速开始)
[!CAUTION] 使用前请务必先备份原始 Word 等重要文件;任何因使用本 Skill 导致的文档损坏、内容丢失或数据丢失,均不由本项目承担责任。
5.1 非技术用户:复制这段 Prompt 开始
本 Skill 需要在能够直接读写本地工作区、执行本地命令并安装 Skill 的桌面 Agent 中运行。普通网页对话或只能上传附件的模式不适合。可以使用 Codex Desktop、Kimi 桌面客户端的 Work 模式、WorkBuddy Desktop,或豆包电脑版的“办公任务模式”等;不同版本的功能和权限可能变化,最终以客户端实际能否访问本地文件和运行命令为准。
非技术用户可以把下面整段 Prompt 直接发送给桌面 Agent:
我想使用 ZUFE-Thesis-Skill,把已经写好的 Word 论文转换为 ZUFE-Thesis LaTeX 工程和 PDF。请把这件事作为本地工作流处理,并一步一步引导我完成。
开始前,请先确认你当前具备以下能力:
1. 可以读写我授权的本地文件夹。
2. 可以执行本地终端命令。
3. 可以安装并调用第三方 Agent Skill。
如果任一能力不可用,请不要假装已经安装或继续转换;请直接告诉我当前缺少什么能力。
确认能力满足后,请按下面的顺序进行:
1. 全局安装当前 Agent Skill https://github.com/SeraphinaGlacia/ZUFE-Thesis-Skill。优先尝试运行:`npx skills add SeraphinaGlacia/ZUFE-Thesis-Skill -g`
2. 如果当前客户端不支持 npx 安装,改为从 https://zufe-thesis-skill.glacia.fun/zufe-thesis-typesetter-latest.zip 获取最新 ZIP,并使用客户端支持的本地 Skill 导入方式进行全局安装。如果这些方式都不可用,请说明具体阻碍并让我提供 ZIP,不要自行编造或重写这个 Skill。
3. 安装后,确认客户端能够识别 zufe-thesis-typesetter,并实际读取其 SKILL.md,确认可以正常调用。
4. 调用目标 Skill,为我介绍其工作流程,并先按流程 A 准备或定位完整的 ZUFE-Thesis 模板根目录、确认工作区和输入,再继续转换作业。
现在请开始任务!
5.2 手动安装
专业用户可以继续按照下面的步骤手动安装:
-
先准备一个完整的 ZUFE-Thesis 模板项目。
- 模板优先使用 GitHub 仓库:ZUFE-Thesis。
- 如果 GitHub 因网络环境不可用,可以改用国内备用链接:Gitee 镜像。
-
在 Kimi Work / Codex Desktop 等工具中打开这个完整的 ZUFE-Thesis 模板项目。
-
然后,根据客户端支持情况全局或项目级安装本 Skill。推荐全局安装,方便以后在不同模板工作区中复用:
# 推荐使用 npx skills add 全局安装 npx skills add SeraphinaGlacia/ZUFE-Thesis-Skill -g -
将 Word 同样存放于工作区中,准备好后,直接在对话中说明你的目标,例如:
请帮我把 XXX.docx 转换为 LaTeX 工程和 PDF。
通常而言,你不需要有任何 LaTeX 基础和环境配置基础,只要把 Word 文档交给 Agent 处理就可以了。你不需要过分担心会出现你无法处理的问题,Agent 会尽力帮你自动解决。
Agent 会按流程检查模板、环境、输入文件和元数据,并开始写入、编译。当遇到不确定内容时,它也会先向你确认,而不是猜测。
[!WARNING] 虽然 Agent 会尽量自动推进完整流程,但最终输出的 PDF 依旧可能存在一些错误,例如:缺失部分标点符号、标题重复编号、章节识别错误等,请务必对输出的 PDF 进行检查,并与 AI 进一步交流修改。不要未经检查直接提交。
六、经典案例 & 结果展示
面向非技术用户的一段式启动 Prompt 已放在“快速开始”中;完整案例与结果展示将在获得合适素材后补充。
七、如何保证可靠?
这个 Skill 会把容易出错的地方显式暴露出来,尽力确保最终产物是符合规范的:
- 转换前会先做门禁检查,确认当前目录确实是 ZUFE-Thesis 模板项目,且环境配置正确。
- 遇到 Word 中无法确认的内容(章节、摘要、关键词、参考文献、图表标题等),会进入确认流程,等待用户确认。
- 不静默丢弃无法可靠转换的内容,例如批注、修订痕迹、文本框以及超出当前转换范围的脚注或公式。
- 编译后会生成质检报告,说明 PDF 质量校验结果、是否还有模板残留或占位符。
[!TIP] 转换前建议尽量保持 Word 文档中的章节标题、正文、图表标题和参考文献结构清晰,这能减少 Agent 二次确认和后续修改的次数。
八、Skill 文件结构
zufe-thesis-typesetter/
├── SKILL.md # Skill 入口
├── agents/
│ └── openai.yaml # Agent 配置
├── assets/
│ └── metadata.example.yaml # 元数据示例
├── references/
│ ├── environment-setup-and-repair.md # 环境修复
│ ├── environment-sop.md # 环境检测 SOP
│ ├── flow-a-gatekeeping.md # 流程 A Workflow
│ ├── flow-b-conversion.md # 流程 B Workflow
│ ├── flow-c-export-and-qa.md # 流程 C Workflow
│ └── thesis-json-schema.md # JSON Schema
├── scripts/
│ ├── build.py # 编译脚本
│ ├── check_env.py # 环境检查脚本
│ ├── check_flow_b_gate.py # B 流程门禁脚本
│ ├── check_template.py # 模板检查脚本
│ ├── common.py # 共享工具脚本
│ ├── diagnose_build.py # 编译诊断
│ ├── export_assets.py # 资源导出脚本
│ ├── import_docx.py # DOCX 抽取脚本
│ ├── ledger.py # 内容账本查询脚本
│ ├── omml_to_latex.py # Word 原生公式转换模块
│ ├── prepare_workspace.py # 工作区准备脚本
│ ├── prescan_docx.py # DOCX 预扫描脚本
│ ├── qa.py # 质量检查脚本
│ ├── render_basicinfo.py # 基础信息渲染脚本
│ ├── render_bib.py # 参考文献渲染脚本
│ └── render_chapters.py # 章节渲染脚本
仓库中的 Skill 源目录位于 skills/zufe-thesis-typesetter/;维护用测试位于仓库根目录 tests/,不会进入安装包。
九、许可证与声明
原始 ZUFE-Thesis 模板项目有其自身的作者和许可证;本仓库只维护与其相关的 Skill。本仓库代码以 GNU AGPL-3.0 发布,详见 LICENSE。