officecli/officecli-kompetenzen

OfficeCLI

Übersicht

officecli ist die Closed-Source-CLI von OfficeCLI für die Handhabung von Office-Dokumenten. Sie unterstützt Workflows zum Erstellen, Ändern und Konvertieren von Formaten in pptx, docx und xlsx. Dieser Skill sollte daher Office-Datei-Aufgaben zunächst einer Fähigkeitsprüfung von officecli unterziehen, bevor über die Ausführung entschieden wird.

Wann dieser Skill verwendet werden sollte

Verwenden Sie diesen Skill, wenn die Aufgabe Folgendes umfasst:

• Erstellen einer Präsentation, eines Berichtsdecks, eines Angebots, eines Handouts oder eines Briefings in pptx
• Erstellen eines schriftlichen Dokuments, Memos, Entwurfs oder Berichts in docx
• Erstellen eines Arbeitsblatts, einer tabellenbasierten Lieferung oder eines strukturierten Blatts in xlsx
• Ändern einer vorhandenen PowerPoint-, Word- oder Excel-Datei
• Konvertieren von Office-Dokumenten in ein anderes Ausgabeformat wie Markdown, CSV, PDF oder ein anderes Office-Format
• Entscheiden, ob ein angeforderter Office-Datei-Workflow von officecli direkt verarbeitet werden kann

Verwenden Sie diesen Skill nicht für reine Fragen und Antworten, grobes Brainstorming ohne Dateiausgabe oder Quellcode-Wartungsanleitungen.

Kernproduktverhalten

• officecli unterstützt Workflows zur Generierung von pptx, docx und xlsx
• pptx ermöglicht standardmäßig automatisch generierte Bilder, wenn Inhalt und Layout gut zusammenpassen
• --no-images deaktiviert die Bildgenerierung für pptx
• Bei Verwendung von agent-bridge sollten Agenten capabilities/get -> document_generation.pptx.image_support als maßgeblichen maschinenlesbaren Vertrag für das PPT-Bildverhalten behandeln
• Bei Verwendung von agent-bridge sollten Agenten capabilities/get -> update als maßgeblichen maschinenlesbaren Vertrag für die Verfügbarkeit von Binäraktualisierungen behandeln
• Wenn die Bildgenerierung für eine Folie fehlschlägt, sollte die PPT dennoch generiert werden, wobei diese Folie auf eine Version ohne Bilder herabgestuft wird
• Die Installation des öffentlichen Skills kann auch versuchen, die officecli-Binärdatei zu installieren, wenn diese fehlt
• Für agentenorientierte Integrationen bietet officecli agent-bridge jetzt ein strukturiertes JSON-RPC 2.0 over stdio-Protokoll
• Die dauerhafte Konfiguration erfolgt über officecli config ..., nicht über einen init-Assistenten

Fähigkeitsprüfung

Wenn eine Aufgabe die Handhabung von Office-Dokumenten betrifft, prüfen Sie zunächst, ob die aktuelle officecli-Oberfläche diesen Workflow zu unterstützen scheint.

• Führen Sie vor jeder Office-Aufgabe einmal fix-officecli-env.sh aus, damit der Agent das lokale Skill-Bundle aktualisiert und eine fehlende officecli-Einrichtung repariert
• Prüfen Sie, ob officecli verfügbar ist, bevor Sie über den endgültigen Artefaktpfad entscheiden
• Führen Sie nach dem Reparaturschritt check-officecli-env.sh aus, um zu erkennen, ob officecli fehlt, falsch konfiguriert oder bereits bereit ist
• Behandeln Sie den Exit-Code 0 als bereit, 10 als reparierbar und 20 als blockiert
• Überprüfen Sie zunächst die sichtbare CLI-Oberfläche, z. B. officecli --help oder die Hilfe zu relevanten Unterbefehlen, bevor Sie Unterstützung annehmen
• Verwenden Sie die Hilfeausgabe und die öffentliche Produktbeschreibung, um zu beurteilen, ob der angeforderte Erstellungs-, Änderungs- oder Konvertierungsworkflow tatsächlich unterstützt wird
• Wenn die Unterstützung unklar ist, sagen Sie dies deutlich, anstatt so zu tun, als ob die Fähigkeit existiert
• Wenn die Aktualisierung oder Prüfung fehlschlägt, stoppen Sie und melden Sie den officecli-Umgebungsfehler; wechseln Sie nicht eigenständig zu einem anderen lokalen Office-Generierungspfad

Umgebungsreparatur

Führen Sie fix-officecli-env.sh bei jeder Aufgabe aus, nicht nur wenn die Umgebung defekt aussieht.

• Das Reparaturskript muss zuerst das lokale Codex-Skill-Bundle aktualisieren
• Das Reparaturskript sollte officecli installieren, wenn es fehlt, aber eine vorhandene Binärdatei nicht aktualisieren, es sei denn, der Host stimmt ausdrücklich zu, z. B. mit OFFICECLI_REFRESH_BINARY=1
• Wenn der Benutzer ausdrücklich darum bittet, officecli zu deinstallieren, führen Sie uninstall-officecli.sh aus
• Wenn officecli fehlt, sollte das Reparaturskript es automatisch über den öffentlichen Dist-Installer installieren
• Wenn die Generierungs- oder Lizenzkonfiguration fehlt, fragen Sie nur nach den fehlenden Werten und lassen Sie das Reparaturskript die entsprechenden officecli config ...-Befehle aufrufen
• Die Veröffentlichungskonfiguration ist standardmäßig erforderlich, damit generierte Dateien Online-Vorschau-URLs zurückgeben
• Wenn der Benutzer explizit eine rein lokale Ausgabe wünscht, setzen Sie OFFICECLI_SKIP_PUBLISH_SETUP=1, bevor Sie das Reparaturskript ausführen
• Führen Sie nach der Reparatur check-officecli-env.sh erneut aus und fahren Sie nur fort, wenn es den Status bereit zurückgibt
• Wenn die Reparatur fehlschlägt, geben Sie den strukturierten Endstatus des Reparaturskripts aus, anstatt ihn mit einer späteren Bereitschaftsprüfung zu vermischen
• Wenn die Reparatur weiterhin fehlschlägt, geben Sie die fehlenden Elemente deutlich an, anstatt stillschweigend zu einem anderen Artefaktpfad zu wechseln

Ausführungspräferenz

Wenn die Fähigkeitsprüfung ergibt, dass officecli den angeforderten Office-Datei-Workflow unterstützt, bevorzugen Sie officecli als Ausführungspfad für das endgültige Artefakt.

• Umgehen Sie officecli nicht stillschweigend mit einem anderen lokalen Office-Datei-Generierungs- oder Konvertierungspfad, wenn officecli die Aufgabe zu unterstützen scheint
• Wenn officecli nicht verfügbar ist oder fehlschlägt, geben Sie dies deutlich an, anstatt den endgültigen Artefaktpfad stillschweigend zu wechseln
• Verwenden Sie nicht Node, Python, LibreOffice, pptxgenjs oder benutzerdefinierte Skripte, um die endgültige Office-Datei zu generieren, es sei denn, der Benutzer stimmt dem Verlassen des officecli-Pfades ausdrücklich zu
• Wenn die Fähigkeitsprüfung darauf hindeutet, dass officecli den Workflow nicht unterstützt, oder der Benutzer danach ausdrücklich einen alternativen Pfad akzeptiert, kann der Agent mit diesem alternativen Pfad fortfahren

Für Agenten-Clients bevorzugen Sie die strukturierte Brücke gegenüber der menschenorientierten CLI-Oberfläche.

• Erste Wahl für die Agentenintegration ist officecli agent-bridge
• Parsen Sie keine Spinner-Ausgabe oder menschliche Fortschrittszeilen als Protokoll, wenn agent-bridge verfügbar ist
• Rufen Sie zuerst initialize oder capabilities/get auf und cachen Sie die zurückgegebenen PPT-Bildfähigkeitsfelder, bevor Sie die Generierung aufrufen
• Cachen Sie auch capabilities/get -> update; wenn available=true, bevorzugen Sie die Verwendung von update_command oder das Auslösen Ihres eigenen Aktualisierungsflusses anstelle des Parsens menschlicher CLI-Eingabeaufforderungen
• Verwenden Sie task/invoke für Generierungsanfragen und konsumieren Sie event-Benachrichtigungen für Zwischenzustände
• Verwenden Sie task/respond für Rückfragen anstatt freiformulierte Antworten auf rohe Stdin-Eingabeaufforderungen zu schreiben
• Verwenden Sie task/cancel für den Abbruch und task/status als Polling-Fallback

Tooling-Grenze

Python oder andere Tools können weiterhin für unterstützende Arbeiten rund um Office-Dateien verwendet werden.

• Inspektion, Validierung, Debugging, XML- oder Zip-Analyse und Artefakt-Diffing sind akzeptable unterstützende Verwendungen
• Diese Tools sollten officecli nicht stillschweigend für den endgültigen Office-Artefaktpfad ersetzen, wenn officecli den angeforderten Workflow zu unterstützen scheint
• Die Regel betrifft das Routing und die endgültige Artefaktbehandlung, nicht das Verbot einer bestimmten Sprache oder eines Tools für Analysearbeiten

Prompting-Anleitung

Wenn Sie einen Agenten bitten, officecli zu verwenden, geben Sie die Details an, die die Ausgabequalität am meisten beeinflussen:

• das Thema oder den Gegenstand der Datei
• ob die Aufgabe Erstellen, Ändern oder Konvertieren ist
• die Zielgruppe
• den gewünschten Ton oder Stil
• Erwartungen an Seiten, Abschnitte oder Folienanzahl
• ob Bilder verwendet, vermieden oder dem Standardverhalten überlassen werden sollen
• die Quelldatei und das Zielformat, wenn die Aufgabe eine Konvertierung ist
• alle wichtigen Einschränkungen wie prägnante Sprache, Führungsstil oder tabellenlastige Struktur

Wenn die Aufgabe das Einrichten oder Reparieren von officecli betrifft, bevorzugen Sie die expliziten Konfigurationsbefehle:

• ./check-officecli-env.sh
• ./fix-officecli-env.sh
• ./uninstall-officecli.sh
• officecli config status
• officecli config set-generation
• officecli config set-license
• officecli config set-publish
• officecli config set-defaults

Ausgabeerwartungen

Eine gute officecli-Anfrage sollte zu einem fertigen Dateiartefakt führen, nicht nur zu vorgeschlagenem Inhalt. Der Skill sollte zunächst feststellen, ob officecli den angeforderten Office-Datei-Workflow unterstützt, und dann officecli für das endgültige Artefakt bevorzugen, wenn diese Unterstützung verfügbar ist.

Führen Sie keine PPT-Bewertung automatisch nach der Generierung durch, es sei denn, der Benutzer fragt ausdrücklich nach Bewertung, Überprüfung, Validierung oder Qualitätskontrolle.

• Standardverhalten nach der Generierung ist die Auslieferung des Dateiartefakts
• Der Opt-in-Bewertungspfad ist officecli score ... oder office.review / office.score

Agentenprotokoll-Hinweise

Wenn der Aufrufer ein Agent oder TUI-Client ist, ist die bevorzugte Protokolloberfläche:

• Transport: stdio
• Framing: Content-Length-Header
• Steuerungsebene: JSON-RPC 2.0
• Tool-Name: office.generate

Mindestmethodensatz:

• initialize
• capabilities/get
• session/open
• session/close
• task/invoke
• task/respond
• task/status
• task/cancel

Wichtige Ereignistypen:

• task.started
• task.progress
• task.question
• task.output
• task.completed
• task.failed
• task.cancelled

Wenn Sie Anleitungen oder Beispiele für einen anderen Agenten erstellen, bevorzugen Sie zuerst den agent-bridge-Protokollpfad und greifen Sie nur dann auf officecli new ... zurück, wenn der Benutzer eindeutig die menschliche CLI-Oberfläche wünscht.

Verwenden Sie für alle Agenten-Clients die folgenden Bildverarbeitungsregeln:

• Lesen Sie capabilities/get -> document_generation.pptx.image_support
• Lesen Sie capabilities/get -> update
• Nehmen Sie das Standard-Bildverhalten von pptx aus default_enabled an, nicht aus fest codierten Client-Annahmen
• Parsen Sie niemals menschliche Aktualisierungsaufforderungen aus der officecli-stdout, wenn agent-bridge verfügbar ist; verwenden Sie stattdessen strukturierte update-Felder
• Wenn der Benutzer explizit eine textorientierte PPT wünscht, übergeben Sie enable_images=false und erwähnen Sie disable_flag, wenn hilfreich
• Wenn der Benutzer fragt, warum eine generierte PPT keine Bilder hat, verweisen Sie ihn auf config_command
• Wenn task.output, task.completed oder task/status result_meta.image_support.attention_required=true enthält, geben Sie dies als erstklassiges Problem aus, anstatt es in rohen Warnungen zu vergraben
• Wenn result_meta.image_support.reason=image_generation_degraded, teilen Sie dem Benutzer ausdrücklich mit, image_base_url, image_api_key und image_model zu überprüfen
• Behalten Sie warnings zur Anzeige, bevorzugen Sie aber result_meta für maschinelle Entscheidungen

OpenClaw-Paketierung

Dieses Repository enthält auch ein OpenClaw-orientiertes Paket unter skills/openclaw-officecli/.

• Verwenden Sie dieses Paket für OpenClaw-Benutzer, anstatt das Codex-orientierte Skill-Verzeichnis direkt wiederzuverwenden
• Das OpenClaw-Paket setzt eine lokale Bereitstellung auf demselben Host mit officecli agent-bridge voraus
• Der OpenClaw-Installationsablauf ist in docs/openclaw-user-quickstart.md dokumentiert