yangming-666/Codex-Skill

DOCX Skill

Wann verwenden

• DOCX-Inhalt lesen oder überprüfen, bei dem das Layout wichtig ist (Tabellen, Diagramme, Seitennummerierung).
• DOCX-Dateien mit professioneller Formatierung erstellen oder bearbeiten.
• Visuelles Layout vor der Auslieferung validieren.

Arbeitsablauf

1. Visuelle Überprüfung bevorzugen (Layout, Tabellen, Diagramme).
   • Wenn soffice und pdftoppm verfügbar sind, DOCX -> PDF -> PNGs konvertieren.
   • Oder scripts/render_docx.py verwenden (erfordert pdf2image und Poppler).
   • Wenn diese Tools fehlen, installieren Sie sie oder bitten Sie den Benutzer, gerenderte Seiten lokal zu überprüfen.
2. python-docx für Bearbeitungen und strukturierte Erstellung verwenden (Überschriften, Stile, Tabellen, Listen).
3. Nach jeder sinnvollen Änderung erneut rendern und die Seiten inspizieren.
4. Wenn eine visuelle Überprüfung nicht möglich ist, Text mit python-docx als Fallback extrahieren und auf Layout-Risiken hinweisen.
5. Zwischenergebnisse organisiert halten und nach endgültiger Freigabe aufräumen.

Temporäre und Ausgabekonventionen

• tmp/docs/ für temporäre Dateien verwenden; nach Abschluss löschen.
• Endgültige Artefakte unter output/doc/ ablegen, wenn in diesem Repository gearbeitet wird.
• Dateinamen stabil und beschreibend halten.

Abhängigkeiten (installieren, falls fehlend)

uv für das Abhängigkeitsmanagement bevorzugen.

Python-Pakete:

uv pip install python-docx pdf2image

Wenn uv nicht verfügbar ist:

python3 -m pip install python-docx pdf2image

Systemtools (zum Rendern):

# macOS (Homebrew)
brew install libreoffice poppler

# Ubuntu/Debian
sudo apt-get install -y libreoffice poppler-utils

Wenn die Installation in dieser Umgebung nicht möglich ist, teilen Sie dem Benutzer mit, welche Abhängigkeit fehlt und wie sie lokal installiert werden kann.

Umgebung

Keine erforderlichen Umgebungsvariablen.

Rendering-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 abgabebereites Dokument liefern: konsistente Typografie, Abstände, Ränder und klare Hierarchie.
• Formatierungsfehler vermeiden: abgeschnittenen/überlappenden Text, defekte Tabellen, unleserliche Zeichen oder Standardvorlagen-Stil.
• Diagramme, Tabellen und Grafiken müssen in gerenderten Seiten lesbar und korrekt ausgerichtet sein.
• Nur ASCII-Bindestriche (-) verwenden. U+2011 (geschützter Bindestrich) und andere Unicode-Striche vermeiden.
• Zitate und Verweise müssen für Menschen lesbar sein; niemals Tool-Token oder Platzhalterzeichenfolgen hinterlassen.

Abschließende Prüfungen

• Vor der endgültigen Auslieferung jede Seite bei 100% Zoom erneut rendern und inspizieren.
• Probleme mit Abständen, Ausrichtung oder Seitennummerierung beheben und den Rendervorgang wiederholen.
• Bestätigen, dass keine Überreste (temporäre Dateien, doppelte Renderausgaben) vorhanden sind, es sei denn, der Benutzer bittet darum, sie zu behalten.