docx-Skill: Word-Dokumente lesen, schreiben und ändern

Für wen

Für alle, die in einem Agenten Word-Dokumente (.docx / .dotx) erstellen, lesen, bearbeiten oder verarbeiten wollen: Berichte, Memos, Briefe, Vorlagen oder aus vorhandenen Word-Dateien extrahieren, umordnen, Bilder ersetzen, Suchen/Ersetzen, Änderungen und Kommentare. Die Evidenz sagt: Skill nutzen, wenn jemand ein Word-Dokument, .docx, .dotx nennt oder ein formelles Dokument mit Inhaltsverzeichnis, Überschriften, Seitenzahlen oder Briefkopf will.

Nicht für PDF, Tabellen, Google Docs oder allgemeines Programmieren ohne Dokumenterzeugung. Do NOT use legt diese Grenze fest; nicht auf andere Formate ausweiten.

Abhängigkeiten zuerst anerkennen: docx (npm, vorinstalliert), pandoc, LibreOffice (soffice), pdftoppm (Poppler). Fehlt pandoc auf dem Lesepfad, kommt der erste Lesevorgang nicht weiter. Ein Pflicht-Marktplatz steht nicht da; keinen Store und keine Ein-Klick-Installation ableiten.

Erster Versuch in 3 Minuten

Voraussetzung: Der aktuelle Agent hat das Skill namens docx geladen, und pandoc ist auf der Maschine oder aus diesem Skill-Verzeichnis aufrufbar. Laut offizieller Angabe ist docx vorinstalliert; zuerst kein npm install. Nur wenn require('docx') scheitert: npm install docx.

Empfohlener Hauptweg ist nur lesen, nicht sofort schreiben. In einem Gespräch mit geladenem Skill die offizielle Lesebefehlskette auf einer eigenen .docx ausführen:

pandoc -t markdown file.docx

file.docx durch den echten Namen ersetzen. Das liest die Datei und erzeugt Markdown. Es ist ein Lesevorgang, keine Verlustfrei-Garantie. Zuerst den Pfad prüfen, damit kein Dokument gewandelt wird, das privat bleiben soll. Undo steht nicht in der Evidenz. Erfolg: Befehl endet mit Markdown-Text. Wie man das Skill in der Agent-UI wählt, steht nicht da; nur, es bei Word-Arbeit zu nutzen.

Wenn Sie danach eine vorhandene Datei ändern, zuerst stoppen: Offizieller Weg ist unzip → word/document.xml bearbeiten → zip, und docx-js öffnet vorhandene Dateien nicht. Das ist Schreiben und ändert das Archiv; Kopie bereithalten. Den ersten Versuch nicht auf dem Schreibpfad starten.

Anwendungsfälle

Fall 1: Lesen. Mit pandoc -t markdown file.docx eine vorhandene Word-Datei nach Markdown bringen und prüfen, ob Überschriften und Text erscheinen. Die Evidenz deckt nur diesen Lesebefehl, keine anderen Konverter.

Fall 2: Vorhandenes Dokument bearbeiten. Die drei offiziellen Schritte am Archiv, word/document.xml ändern, wieder zippen. docx-js öffnet vorhandene Dateien nicht; also nicht „alte Datei direkt mit docx-js öffnen“. Expliziter Nebenwirkungspfad; zuerst sichern. Kein vollständiges Skript in der Evidenz; fehlende Parameter unbekannt lassen.

Grenzen

Lesen hängt an pandoc. Schreiben hängt an Entpacken / XML ändern / wieder packen und kann später LibreOffice und pdftoppm zur Prüfung nutzen; diese Prüfbefehle gehören nicht zum ersten Versuch. Nicht für PDF, Tabellen oder Google Docs. Vorinstalliertes docx überspringt npm install docx nicht, wenn require('docx') scheitert. Unterstützte Agent-UIs, Undo und Rechte modelliert die Evidenz nicht; Lücken unbekannt lassen, nicht „kein Risiko“ schreiben.