Ferramentas DOCX

Visão geral

Ferramentas DOCX profissionais para criar, editar e manipular documentos Word.

Com este skill você pode:

• Criar novos arquivos .docx com controle total sobre estilos, tabelas e layout
• Abrir e editar documentos existentes em nível de OOXML (XML) quando precisa de precisão cirúrgica
• Ler, limpar e aceitar alterações rastreadas e comentários
• Converter entre formatos como .doc, .docx, PDF, HTML e ODT
• Validar e reparar a estrutura OOXML antes de enviar documentos para clientes
• Comparar duas versões de um documento e gerar um redline com alterações rastreadas

Como começar

Adicione seus arquivos-fonte ao espaço de trabalho do projeto e ative o skill Ferramentas DOCX. O agente o guiará passo a passo.

Workflows típicos

• Redigir um documento Word polido: Peça para o agente criar um novo .docx com as seções, títulos, tabelas e estilos de que você precisa. Nos bastidores ele usa docx_build, garantindo que o arquivo abra limpo no Word.
• Revisar alterações rastreadas: Quando um documento tem muito histórico de edição, o agente pode usar docx_extract_text para mostrar uma visão em Markdown mais limpa ou docx_accept_changes para consolidar todas as alterações em uma nova versão final.
• Cirurgias em nível de XML: Para problemas difíceis de formatação ou corrupção, o agente pode executar docx_unpack para extrair o XML, editar diretamente, rodar docx_validate para encontrar problemas estruturais e, em seguida, docx_pack para gerar uma nova .docx limpa.
• Converter formatos com segurança: Use docx_convert quando precisar sair de .doc para .docx, PDF, HTML ou ODT preservando o máximo possível da estrutura.
• Comparar versões com redline: Depois de editar um contrato ou relatório, o agente pode executar docx_compare para gerar uma versão redline que abre no Word com o modo de Controle de Alterações ativado.
• Gerar imagens a partir de PDFs: Use docx_pdf_to_images para produzir imagens página a página de um PDF para inspeção visual ou para embutir em outros documentos.

Referência das ferramentas

O skill Ferramentas DOCX expõe dez ferramentas especializadas. Você não precisa decorar os nomes — o agente escolhe a melhor opção —, mas esta referência mostra o que está disponível.

Criar novos documentos

• docx_build: Constrói arquivos .docx programaticamente usando a biblioteca JavaScript docx. Ideal para documentos estruturados (contratos, relatórios, templates) com controle preciso sobre seções, parágrafos, tabelas e formatação.

Ler e limpar conteúdo

• docx_extract_text: Extrai o texto de um arquivo .docx como Markdown. Você pode escolher se quer:

  • mostrar inserções e deleções,
  • mostrar apenas o texto final (como se todas as alterações tivessem sido aceitas),
  • ou mostrar o texto original (como se todas as alterações tivessem sido rejeitadas).

• docx_accept_changes: Aceita todas as alterações rastreadas em um arquivo .docx e grava o resultado em um novo arquivo. Útil quando você precisa de uma versão final limpa, sem histórico de revisão.

Workflow em nível de XML/OOXML

Estas ferramentas são usadas em conjunto quando o agente precisa trabalhar diretamente com OOXML:

• docx_unpack: Descompacta um arquivo .docx em um diretório editável de arquivos XML, mesclando runs com formatação idêntica e aplicando pretty-printing para facilitar a leitura.
• docx_validate: Verifica um arquivo .docx ou diretório desempacotado em busca de problemas estruturais (arquivos obrigatórios ausentes, XML malformado, relacionamentos quebrados) e pode reparar automaticamente problemas comuns.
• docx_pack: Recompacta um diretório XML desempacotado em um novo arquivo .docx depois que a validação passar.

Comentários de revisão e colaboração

• docx_add_comment: Adiciona um comentário de revisão — ou resposta a um comentário existente — a um documento desempacotado. Os comentários são ancorados em trechos específicos de texto para aparecerem no lugar esperado no Word.

Conversões e comparações

• docx_convert: Usa o LibreOffice em modo headless para converter documentos entre formatos, como:

  • .doc → .docx
  • .docx → pdf
  • .docx → html
  • .odt → .docx

• docx_compare: Compara uma .docx “original” com uma .docx “modificada” e produz um terceiro documento com redline. Ao abrir o resultado no Word, revisores veem inserções, deleções e movimentações como alterações rastreadas.

Páginas de PDF em imagens

• docx_pdf_to_images: Converte páginas de PDF em imagens JPEG ou PNG na resolução que você escolher. Útil para QA visual, apresentações ou para incorporar miniaturas de páginas em outros documentos.

Boas práticas

• Nunca sobrescreva o arquivo original: O agente sempre grava em um novo caminho (por exemplo, com sufixos _clean, _final, _redlined) para que você possa comparar e reverter.
• Valide antes de enviar: Para documentos importantes de clientes, peça para o agente executar docx_validate e capturar qualquer problema de OOXML antes do envio.
• Escolha bem entre build e XML: Prefira docx_build para documentos novos e use o fluxo desempacotar/validar/reempacotar apenas quando precisar de correções em baixo nível ou inspeção direta do XML.