Skip to content
Conduit

skill

ZUFE-Thesis-Skill

面向浙江财经大学学生的毕业论文 & 专业实践报告自动排版 Skill。用户只需与 AI 交流,就能将 Word 初稿转化为规范格式的 PDF 和 LaTeX 工程,简单易用,无需再浪费时间排版。

SeraphinaGlacia/ZUFE-Thesis-Skillcommunitylistedunreviewed

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

Skills do not use an MCP config. Follow the steps in the README below.

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 手动安装

专业用户可以继续按照下面的步骤手动安装:

  1. 先准备一个完整的 ZUFE-Thesis 模板项目。

    • 模板优先使用 GitHub 仓库:ZUFE-Thesis。
    • 如果 GitHub 因网络环境不可用,可以改用国内备用链接:Gitee 镜像。
  2. 在 Kimi Work / Codex Desktop 等工具中打开这个完整的 ZUFE-Thesis 模板项目。

  3. 然后,根据客户端支持情况全局或项目级安装本 Skill。推荐全局安装,方便以后在不同模板工作区中复用:

    # 推荐使用 npx skills add 全局安装
    npx skills add SeraphinaGlacia/ZUFE-Thesis-Skill -g
    
  4. 将 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。


↑↓ navigate openesc close