Thesis DOCX 论文排版技能
面向毕业论文 Word 文档的创建、修订与格式控制技能，强调先审计再修改、严格执行学校规范、逐页 PDF 复核。
SKILL.md 提出先审计后修改、只按学校规定修改、防止过度美化、无 PDF 复核不声称完成等原则，且要求图与代码均基于用户真实材料、禁止编造数据，数据流透明度较好；未发现隐蔽外传或恶意行为。扣分点：脚本实际内容未提供，无从确认最小权限与回滚机制；PowerShell 使用 -ExecutionPolicy Bypass 降低用户确认门槛；样式批量归一化属较大外部副作用，回滚说明缺失。
工作流自洽，环境检查前置、dry-run 优先、失败时明确告知用户而非隐性降级，设计上考虑了失败反馈。扣分点：被引用的 scripts/ 与 references/ 文件均未在证据中出现，无法验证脚本可运行性与错误处理；无测试证据，边界输入行为不明。
目标场景（中文学位论文 Word 排版）明确，触发描述具体（样式、题注、页码、交叉引用、Mermaid 图、LaTeX 代码），并声明了不适用边界（不虚构学校标准、材料不足拒绝作图）；中文文档齐全，依赖本机 Word 与本地 Node，无海外服务依赖。扣分点：硬性依赖 Windows 桌面版 Word，跨平台与无 Word 环境的适用范围仅口头提示，未量化触发精度证据。
文档分层合理（SKILL.md 主流程 + references 深入规则 + scripts 工具），MIT 许可明确，双语 README、安装与快速开始齐备。扣分点：无版本号与变更日志，维护者身份与更新路径不明，仓库含 examples/ 目录但内容未验证，部分关键假设（如 agents/openai.yaml）仅在 README 提及。
核心主张（审计先行、样式驱动、PDF 逐页复核、防止 AI 元话语泄漏进论文）对真实痛点有针对性，边际价值明显高于手工处理。扣分点：静态评审无法验证输出可直接使用，脚本质量未知，效果声明仅属作者主张，缺乏代表性产出验证。
有可审计的一手材料：完整的 SKILL.md、双语 README、许可文件、明确的脚本清单与仓库结构。扣分点：脚本与参考文档源码未提供，无 CI 或测试证据，所有效果声明无法独立复现，事实与推断未分离标注。
- 所有 scripts/ 与 references/ 文件未随证据提供，脚本行为、错误处理与回滚均未经审计，使用前请人工审阅源码。
- PowerShell 命令使用 -ExecutionPolicy Bypass，运行批量样式归一化前务必备份原 docx；该操作对文档有不可逆风险。
- 技能强依赖 Windows 桌面版 Microsoft Word，非 Windows 或无 Word 环境下核心功能不可用。
- 仓库无版本号与变更日志，发布者身份未经核实，长期维护状况不明。
- Mermaid 渲染依赖本地 Node.js/mmdc，请确认本地安装情况。
这个 Skill 能做什么，适合哪些场景？
thesis-docx 是一个处理毕业论文 / 学位论文 .docx 文件的技能。它通过 Windows 上的 Word COM/DOM 自动化批量统一样式、修复目录与页码，并先用 Python 脚本审计 OOXML 隐藏问题再做修改。核心原则是避免过早的大范围格式改动：只修学校明确规定的内容，未规定的部分保留现状，最后导出 PDF 逐页复核后才算完成。它还能基于用户提供的真实材料生成 Mermaid 图和 LaTeX 风格代码排版，并控制论文口吻、避免把 AI 工作过程的痕迹写进正文。
检查 Word COM/DOM 自动化环境是否可用；读取用户的学校模板和格式规范并区分为"必须执行"与"保留现状"两类；用 audit_docx_ooxml.py 审计 styleId、firstLineChars、titlePg、REF 域等隐藏问题；通过 normalize_word_styles.ps1 批量归一化正文、标题、图表题注样式；修复目录、页码、分节、交叉引用；基于真实材料生成 Mermaid 架构图、E-R 图、流程图；以 LaTeX 约定排版代码清单；用 export_word_pdf.ps1 导出 PDF 供逐页审查。
- 研究生在提交前需要按学校模板统一论文的正文、标题、图题注、表题注和参考文献样式
- 论文目录、页码或交叉引用显示过期域文本，需要修复但担心改动引入新问题
- 需要根据真实的代码、SQL 表结构或 API 文档生成系统架构图、E-R 图或流程图
- 论文正文中混入了"根据现有代码"之类的 AI 工作痕迹语言，需要改写为正常学术叙述
- 格式修改完成后需要导出 PDF 逐页检查排版是否符合学校规范
这个 Skill 有哪些优点和局限？
- 审计优先的工作流降低大范围格式改动引入新问题的风险
- 严格区分学校硬性要求与可保留现状，避免不必要的全局美化
- 审计 OOXML 隐藏状态（styleId、firstLineChars、REF 域等），处理纯样式手段难以解决的问题
- 明确禁止编造实验数据和图表，所有图与代码必须基于真实材料
- 要求 PDF 逐页复核后才可宣布完成，包含布局保真度的验证
- 强依赖 Windows 桌面版 Microsoft Word 的 COM/DOM 自动化，macOS 和 Linux 无法运行核心脚本
- 明确建议避免 WPS，对 WPS 用户不友好
- 仓库没有提供测试套件或第三方验证，效果依赖脚本的可靠性
- 未提供明确的触发提示词或与具体 Agent 平台集成的安装说明
如何安装这个 Skill？
克隆仓库并保持目录完整：git clone https://github.com/the-shy123456/thesis-docx.git。运行前提：Windows 下安装桌面版 Microsoft Word；Python 环境需 python-docx 和 lxml；Mermaid 渲染需 Node.js 及 mmdc 或 npx。源材料未说明特定 Agent Skills 客户端（如 Claude Code）的安装目录位置。
如何使用这个 Skill？
先运行 scripts/check_word_com.ps1 确认 Word 自动化可用；再用 python scripts/audit_docx_ooxml.py 对论文做 OOXML 审计；可用 scripts/normalize_word_styles.ps1 -AuditOnly 做样式归一化的 dry-run；修改完成后用 scripts/export_word_pdf.ps1 导出 PDF 逐页复核。阅读 SKILL.md 与 references/ 目录下的工作流和规则文件以了解完整用法。
这个 Skill 与同类方案有什么区别？
README 明确建议优先使用 Microsoft Word 桌面自动化而非 WPS 类工具，因为 WPS 在表格行高、垂直对齐、代码框标题裁剪等方面与 Word 存在差异，可能降低论文排版的保真度。