Was macht DOCX-Skill?
Wann verwenden
- Lesen oder Überprüfen von DOCX-Inhalten, bei denen das Layout wichtig ist (Tabellen, Diagramme, Seitenumbrüche).
- Erstellen oder Bearbeiten von DOCX-Dateien mit professioneller Formatierung.
- Validierung des visuellen Layouts vor der Auslieferung.
Arbeitsablauf
- Bevorzugt visuelle Überprüfung (Layout, Tabellen, Diagramme).
- Falls
sofficeundpdftoppmverfügbar sind, DOCX -> PDF -> PNGs konvertieren. - Oder
scripts/render_docx.pyverwenden (benötigtpdf2imageund Poppler). - Wenn diese Tools fehlen, installieren oder den Benutzer bitten, die gerenderten Seiten lokal zu überprüfen.
- Falls
python-docxfür Bearbeitungen und strukturierte Erstellung verwenden (Überschriften, Stile, Tabellen, Listen).- Nach jeder sinnvollen Änderung die Seiten neu rendern und inspizieren.
- Falls visuelle Überprüfung nicht möglich ist, Text mit
python-docxals Fallback extrahieren und auf Layout-Risiko hinweisen. - Zwischenergebnisse organisiert halten und nach der endgültigen Genehmigung aufräumen.
Temporäre- und Ausgabekonventionen
- Verwende
tmp/docs/für Zwischendateien; lösche sie nach Abschluss. - Schreibe finale Artefakte unter
output/doc/, wenn in diesem Repository gearbeitet wird. - Behalte stabile und beschreibende Dateinamen bei.
Abhängigkeiten (bei Bedarf installieren)
Bevorzuge uv für die Abhängigkeitsverwaltung.
Python-Pakete:
uv pip install python-docx pdf2image
Falls uv nicht verfügbar ist:
python3 -m pip install python-docx pdf2image
Systemwerkzeuge (für das Rendern):
# macOS (Homebrew)
brew install libreoffice poppler
# Ubuntu/Debian
sudo apt-get install -y libreoffice poppler-utils
Wenn eine Installation in dieser Umgebung nicht möglich ist, teile dem Benutzer mit, welche Abhängigkeit fehlt und wie sie lokal installiert werden kann.
Umgebung
Keine erforderlichen Umgebungsvariablen.
Rendern-Befehle
DOCX -> PDF:
soffice -env:UserInstallation=file:///tmp/lo_profile_$$ --headless --convert-to pdf --outdir $OUTDIR $INPUT_DOCX
PDF -> PNGs:
pdftoppm -png $OUTDIR/$BASENAME.pdf $OUTDIR/$BASENAME
Gebündelter Helfer:
python3 scripts/render_docx.py /path/to/file.docx --output_dir /tmp/docx_pages
Qualitätserwartungen
- Ein kundenfertiges Dokument liefern: konsistente Typografie, Abstände, Ränder und klare Hierarchie.
- Formatierungsfehler vermeiden: abgeschnittener/überlappender Text, kaputte Tabellen, unleserliche Zeichen oder Standardvorlagenstyling.
- Diagramme, Tabellen und Visualisierungen müssen in den gerenderten Seiten lesbar sein und korrekt ausgerichtet sein.
- Nur ASCII-Bindestriche verwenden. U+2011 (geschützter Bindestrich) und andere Unicode-Striche vermeiden.
- Zitate und Referenzen müssen für Menschen lesbar sein; niemals Werkzeug-Token oder Platzhalter-Strings hinterlassen.
Abschließende Prüfungen
- Vor der endgültigen Auslieferung jede Seite bei 100 % Zoom neu rendern und inspizieren.
- Probleme mit Abständen, Ausrichtung oder Seitenumbrüchen beheben und den Rendern-Durchlauf wiederholen.
- Sicherstellen, dass keine Überbleibsel (temporäre Dateien, doppelte Renderings) vorhanden sind, es sei denn, der Benutzer bittet darum, sie zu behalten.