Skill docx : lire, écrire et modifier des documents Word

Pour qui

Pour qui doit, dans un agent, créer, lire, modifier ou traiter des documents Word (.docx / .dotx) : rapports, notes, lettres, modèles, ou extraire, réordonner, remplacer des images, rechercher-remplacer, suivre les révisions et commentaires d’un fichier Word existant. L’évidence dit d’utiliser ce skill quand on parle d’un document Word, .docx, .dotx, ou d’un document formel avec sommaire, titres, numéros de page ou en-tête.

Pas pour les PDF, tableurs, Google Docs, ni le code général sans génération de document. Do NOT use fige cette limite ; ne pas l’étendre à d’autres formats.

Reconnaître d’abord les dépendances : docx (npm, préinstallé), pandoc, LibreOffice (soffice), pdftoppm (Poppler). Sans pandoc sur le chemin de lecture, le premier lecture échoue. Aucun marché d’agent n’est imposé ; ne pas déduire une boutique ou une install en un clic.

Premier essai en 3 minutes

Prérequis : l’agent courant a chargé le skill nommé docx, et pandoc est appelable sur la machine ou depuis ce répertoire de skill. Officiellement docx est préinstallé ; ne pas lancer npm install d’abord. Seulement si require('docx') échoue : npm install docx.

Le chemin principal recommandé est une lecture seule, pas une édition immédiate. Dans une conversation où le skill est chargé, lancer la commande de lecture officielle sur un .docx que vous possédez :

pandoc -t markdown file.docx

Remplacer file.docx par le vrai nom. Cela lit le fichier et produit du Markdown. C’est une lecture, pas une garantie sans perte. Confirmer le chemin pour ne pas convertir un document qui doit rester privé. Pas d’annulation dans l’évidence. Succès : la commande se termine avec du texte Markdown. L’UI de choix du skill n’est pas décrite ; seulement l’utiliser quand il faut du Word.

Si vous éditez ensuite un document existant, arrêtez-vous : le chemin officiel est unzip → éditer word/document.xml → zip, et docx-js ne peut pas ouvrir les fichiers existants. C’est une écriture qui change l’archive ; avoir une copie. Ne pas commencer le premier essai par l’écriture.

Cas d’usage

Cas 1 : lecture. pandoc -t markdown file.docx convertit un Word existant en Markdown ; vérifier titres et corps. L’évidence ne couvre que cette commande de lecture, pas d’autres convertisseurs.

Cas 2 : éditer un document existant. Les trois étapes officielles sur l’archive, modifier word/document.xml, puis zipper. docx-js n’ouvre pas les fichiers existants ; ne pas « ouvrir l’ancien fichier avec docx-js ». Chemin à effet de bord explicite ; sauvegarder d’abord. Pas de script complet ; paramètres manquants inconnus.

Limites

La lecture dépend de pandoc. L’écriture dépend de décompresser / XML / recompresser, et peut ensuite utiliser LibreOffice et pdftoppm pour des contrôles hors de ce premier essai. Pas pour PDF, tableaux ou Google Docs. Un docx préinstallé n’évite pas npm install docx si require('docx') échoue. UI d’agent, annulation et modèle de droits absents de l’évidence ; garder l’inconnu, ne pas écrire « aucun risque ».