Skill de Formatação Automática de Teses
qikaikailiang/thesis-auto-formatting-skill
Formatação automática de teses em Word com mapeamento de estrutura
Ver no GitHubSkill Python que automatiza a formatação de teses em Word (.docx) com suporte a estrutura de documento, mapeamento de estilos e modelos customizados. Integra-se com Codex e Claude para identificar estrutura de teses e aplicar formatação segura sem modificar conteúdo original, com backup automático.
Instalação
npx convez-ai qikaikailiang/thesis-auto-formatting-skill1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Formatar teses académicas segundo normas institucionais (JNU, etc)
- Corrigir formatação de PDFs convertidos para Word
- Aplicar estilos consistentes em múltiplos documentos
- Mapear estrutura de teses para aplicar formatos customizados
Veredito

Solução robusta e bem pensada para automatizar formatação de teses acadêmicas. Implementa boas práticas de segurança (backup automático, sem sobrescrita) e flexibilidade (modo padrão + modo customizado com mapeamento JSON). Recomendado para instituições e alunos que precisam padronizar documentos Word complexos.
README
A tradução para o português deste README ainda está na fila.
论文排版 Skills
用于 Codex 和 Claude 的论文自动排版 skills。它帮助 AI 先理解论文结构,再用脚本把题名、摘要、标题层级、正文、图题、表题、参考文献等映射到 Word .docx 样式。
核心原则:AI 负责判断论文结构,脚本负责安全排版。
能做什么
- 按默认论文格式排版 Word
.docx。 - 按用户指定的学校、期刊、模板、样例论文或格式 PDF 排版。
- 处理 OCR/PDF 转 Word 后样式缺失、标题不规范、段落结构混乱的论文。
- 自动备份原文件,只生成新的排版文件。
- 保留正文内容、表格数据和图片本体。
- 允许新增图题、表题等排版元数据。
- 支持 AI 生成
structure-map.json,由脚本按结构映射精确套样式。
安装到 Codex
git clone https://github.com/qikaikailiang/thesis-auto-formatting-skill "$env:USERPROFILE\.codex\skills\thesis-auto-formatting"
在 Codex 中调用:
Use $jnu-thesis-docx-formatting to format this thesis.
安装到 Claude
macOS/Linux:
git clone https://github.com/qikaikailiang/thesis-auto-formatting-skill ~/.claude/skills/thesis-auto-formatting
Windows PowerShell:
git clone https://github.com/qikaikailiang/thesis-auto-formatting-skill "$env:USERPROFILE\.claude\skills\thesis-auto-formatting"
在 Claude 中调用:
Use the thesis auto formatting skill to format this thesis.
1. 默认模式
默认模式适合没有额外格式文件时使用。AI 会先识别论文实际结构,脚本再按默认论文格式套样式。
python .\scripts\format_jnu_thesis.py --input ".\论文正文.docx"
默认输出:
论文正文_暨南大学排版.docx
也可以指定输出文件:
python .\scripts\format_jnu_thesis.py --input ".\论文正文.docx" --output ".\论文正文_排版后.docx"
默认排版包括:
- A4 页面。
- 上/左边距 25 mm,下/右边距 20 mm。
- 中文宋体,英文 Times New Roman。
- 正文小四号,1.5 倍行距。
- 正文页眉:
暨南大学硕士学位论文。 - 标题层级:
Title、Heading 1、Heading 2、Heading 3。 - 图题/表题:
JNU Caption。 - 参考文献:
JNU Reference。 - 普通数据表尽量使用三线表。
2. 指定格式模式
指定格式模式适合用户提供了格式来源时使用,例如:
- 学校论文格式 PDF。
- 期刊格式要求。
.docx模板。- 已通过审核的样例论文。
- 用户直接粘贴的格式要求。
工作流程:
- AI 阅读指定格式来源。
- AI 阅读论文实际结构。
- AI 生成结构映射 JSON。
- 脚本按 JSON 中的段落角色套用 Word 样式。
结构映射示例:
{
"paragraphs": [
{"index": 0, "role": "title"},
{"index": 2, "role": "heading1"},
{"index": 6, "role": "heading1"},
{"index": 7, "role": "heading2"},
{"index": 13, "role": "heading1"},
{"index": 14, "role": "reference"}
]
}
支持的 role:
titleheading1heading2heading3bodycaptionreference
命令:
python .\scripts\format_jnu_thesis.py --input ".\论文正文.docx" --output ".\论文正文_指定格式排版.docx" --structure-map ".\structure-map.json"
示例文件:
examples/structure-map.example.json
安全规则
- 不覆盖原
.docx。 - 排版前自动备份原文件。
- 只生成新的排版文件。
- 不修改、润色、翻译、删除或重写正文内容。
- 不改表格数据,不裁剪、压缩、替换或重绘图片。
- 图题、表题属于排版元数据,可以按格式要求补齐。
验证建议
排版后建议检查:
- 原文是否完整保留。
- 标题层级是否符合论文实际结构。
- 图题、表题是否存在且样式一致。
- 表格数据是否未被改动。
- 页眉、页码、字体、字号和行距是否符合目标格式。
脚本会拒绝覆盖输入文件,并在发现原始文字丢失时停止保存。