convez.ai
SkillAutomaçãoIntermediário
qikaikailiang

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 GitHub
InicialPluginScore · de 0 a 100

Skill 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-skill

1 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

Estrelas
1
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

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 模板。
  • 已通过审核的样例论文。
  • 用户直接粘贴的格式要求。

工作流程:

  1. AI 阅读指定格式来源。
  2. AI 阅读论文实际结构。
  3. AI 生成结构映射 JSON。
  4. 脚本按 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:

  • title
  • heading1
  • heading2
  • heading3
  • body
  • caption
  • reference

命令:

python .\scripts\format_jnu_thesis.py --input ".\论文正文.docx" --output ".\论文正文_指定格式排版.docx" --structure-map ".\structure-map.json"

示例文件:

examples/structure-map.example.json

安全规则

  • 不覆盖原 .docx。
  • 排版前自动备份原文件。
  • 只生成新的排版文件。
  • 不修改、润色、翻译、删除或重写正文内容。
  • 不改表格数据,不裁剪、压缩、替换或重绘图片。
  • 图题、表题属于排版元数据,可以按格式要求补齐。

验证建议

排版后建议检查:

  • 原文是否完整保留。
  • 标题层级是否符合论文实际结构。
  • 图题、表题是否存在且样式一致。
  • 表格数据是否未被改动。
  • 页眉、页码、字体、字号和行距是否符合目标格式。

脚本会拒绝覆盖输入文件,并在发现原始文字丢失时停止保存。

Ver o original no GitHub

Bom para

Relacionados