Use this skill for the BUPT thesis workflow in this repository: run structured Markdown checks, review heading trees against project conventions, and export any specified Markdown thesis file to DOCX with the bundled cover and integrity pages.
用于当前工作区的北邮论文 Markdown 检查与 DOCX 导出。
适用场景:
当前工具链为 JS-only:检查、正文导出、封面组装均使用 Node.js 脚本完成。
check_markdown.js。headings 输出由 LLM 继续复核。运行该 Skill 下的工具链需要配置 Node.js 并在当前上下文环境安装必要的 npm 包。作为 Agent,你应该自主判断或提示用户是否已安装这些包;如果环境缺失依赖,直接通过系统命令在恰当目录自行安装:
npm install docx jszip @xmldom/xmldom
依赖用途:
docx:正文 DOCX 生成jszip:DOCX 包读写@xmldom/xmldom:封面注入与 XML 后处理node bupt-thesis-helper/scripts/check_markdown.js <markdown-path>
需要结构化标题树与问题清单时:
node bupt-thesis-helper/scripts/check_markdown.js <markdown-path> --json
node bupt-thesis-helper/scripts/generate_thesis.js --workspace <workspace> --input <markdown-path> --output <body-docx-path>
node bupt-thesis-helper/scripts/compose_docx.js --cover <cover-docx-path> --body <body-docx-path> --output <final-docx-path> --cover-data <cover-json-path>
node bupt-thesis-helper/scripts/md2doc.js --workspace <workspace> --input <markdown-path> --output <final-docx-path>
可选参数:
--cover <cover-docx-path>--cover-data <cover-json-path>--skip-check--force说明:
--output,默认输出为“输入 Markdown 同名 .docx”check_markdown.js 会做这些事情:
<br> + 关键词 规则重要: 标题“结构正确”不等于“层级语义正确”。拿到 headings 输出后,LLM 仍需结合当前项目约定判断:这些多级标题是否真的该放在这一层。
本技能的一切检查、导出逻辑与特定的论文模板排版,都强依赖于深度的“命名约定与格式约定”(如:特定的专用标题名、固定的图表题注格式等)。 作为 Agent,在执行涉及论文修改、查错、调整排版和结构生成的操作前,你必须前往研读 `bupt-thesis-helper/references/markdown-writing-spec.md`,这是所有约定逻辑的唯一真理源。
check_markdown.js <markdown-path> --jsonissues 和 headings--forcemd2doc.js --workspace <workspace> --input <markdown-path> --output <final-docx-path>check_markdown.js <markdown-path> --jsonheadingsscripts/check_markdown.js:结构化检查与标题树提取scripts/generate_thesis.js:正文 DOCX 生成scripts/compose_docx.js:封面/声明与正文组装scripts/md2doc.js:总入口,串联检查、正文生成、最终组装references/markdown-writing-spec.md:写作与导出规则说明references/add-references.md:参考文献补充 SOPassets/论文封面+诚信声明.docx:封面模板assets/thesis.cover.example.json:封面信息模板--forcescripts/generate_thesis.js