Communitygithub.com

leeryong/rhwp-Agent-Skills_by_BLUESKY

Eine Sammlung von Agent-Skills zur GUI-gesteuerten Bedienung und Prüfung des Rust/WASM-basierten HWP-Editors rhwp-studio für koreanische Dokumente.

Was ist rhwp-Agent-Skills_by_BLUESKY?

Dieser Skill ermöglicht es KI-Agenten, `rhwp-studio`, einen Rust/WASM-basierten HWP/HWPX-Editor, über die grafische Benutzeroberfläche zu steuern und zu testen. Er eignet sich besonders für die Erstellung und Bearbeitung koreanischer Dokumente. Der Skill unterstützt die Ausführung über Browser-Automatisierung und bietet eine Agent-Bridge (`?agent=1`) zur Zustandsabfrage, zum Laden von Testdokumenten und zur Exportverifikation. Kernfunktionen umfassen die Interaktion mit Menüs, Toolbar-Schaltflächen und Stil-Steuerelementen sowie die Nutzung der Agent-Bridge für Aktionen wie `ready()`, `context()` oder `exportHwp()`. Der Skill legt Wert auf echte GUI-Aktionen für Features und empfiehlt eine mehrschichtige Teststrategie aus Build-Validierung, GUI-Smoke-Tests und vertieften Prüfungen. Häufige Fehlerquellen wie fehlende WASM-Pakete oder Browser-Berechtigungen werden dokumentiert.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add leeryong/rhwp-Agent-Skills_by_BLUESKY

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

rhwp GUI Agent

Nutzen Sie diesen Skill, um rhwp-studio sowohl als menschliches Web-Editor als auch als agentengesteuerte GUI zu bedienen. Bevorzugen Sie echte GUI-Aktionen für Feature-Prüfungen; verwenden Sie die ?agent=1-Brücke nur für Bereitschaftsprüfung, Zustandsinspektion, Laden von Beispielen und Exportverifikation.

Schnellstart

Vom rhwp-Repository-Root aus:

cp .env.docker.example .env.docker
docker compose --env-file .env.docker run --rm wasm
cd rhwp-studio
npm ci
npm run build
python3 -m http.server 8765 --bind 0.0.0.0 -d dist

Öffnen Sie http://127.0.0.1:8765/?agent=1. Ohne ?agent=1 funktioniert der Editor nur für Benutzer, legt aber die Automatisierungsbrücke nicht offen.

Kernablauf

  1. Erstellen Sie pkg/rhwp.js und pkg/rhwp_bg.wasm vor dem Start von Studio. Wenn npm run build „Cannot find module '@wasm/rhwp.js'“ meldet, wurde das WASM-Paket nicht erstellt.
  2. Stellen Sie die erstellte App bereit oder starten Sie Vite. Verwenden Sie python3 -m http.server ... -d dist, wenn Vite in einer Sandbox keine Ports binden kann.
  3. Starten Sie eine Browser-Automatisierungssitzung für /?agent=1.
  4. Verwenden Sie GUI-Selektoren für Aktionen:
    • Menüs: #menu-bar .menu-item[data-menu="<menu>"] .menu-title
    • Menübefehle: [data-cmd="<command-id>"]
    • Toolbar-Schaltflächen: .tb-btn[data-cmd="<command-id>"]
    • Stil-Steuerelemente: #style-name, #font-lang, #font-name, #font-size, #btn-bold, #btn-italic, #btn-underline, #btn-strike, #btn-text-color, #btn-highlight, Ausrichtungsschaltflächen und #linespacing-select
    • Dateieingabe: #file-input
    • Canvas-Editor: #scroll-container canvas
  5. Verwenden Sie window.__rhwpAgent zur Beobachtung:
    • ready()
    • context()
    • commands()
    • pageCount()
    • fileName()
    • loadSample(path)
    • loadBytes(bytes, fileName)
    • createNewDocument()
    • exportHwp(), exportHwpx()
  6. Machen Sie Screenshots und exportierte Dateien nach jedem Feature-Cluster. Behandeln Sie fehlgeschlagene Klicks, deaktivierte Befehle, Konsolenfehler und leere Canvase als Testfehler.

Feature-Abdeckung

Lesen Sie references/feature-map.md beim Aufzählen oder Testen aller GUI-Features. Es bildet die Menüs der obersten Ebene, Befehls-IDs, Dialoge, Toolbar-Steuerelemente und hwpctl-Aktionen ab.

Für einen automatisierten Smoke-Test verwenden Sie:

cd rhwp-studio
node e2e/agent-gui-full-smoke.mjs

Wenn der Browserstart durch die Umgebung blockiert wird, führen Sie trotzdem aus:

npm run build

Dann überprüfen Sie e2e/agent-gui-full-smoke.mjs und führen es in einer browserfähigen Umgebung aus.

Teststrategie

Verwenden Sie drei Ebenen:

  1. Build-Validierung: docker compose --env-file .env.docker run --rm wasm, dann npm run build.
  2. GUI-Smoke: Erstellen Sie ein neues Dokument, geben Sie Text ein, schalten Sie Zeichen-/Absatzformatierung um, erstellen Sie eine Tabelle, öffnen Sie den Formauswähler, öffnen Sie den Symboldialog, laden Sie .hwp- und .hwpx-Beispiele, speichern/laden Sie .hwp herunter und machen Sie Screenshots.
  3. Tiefgehende Prüfungen: Führen Sie vorhandene rhwp-studio/e2e/*.mjs-Tests und hwpctl-Szenarien aus, wenn ein echter Browser verfügbar ist.

Bevorzugen Sie zuerst integrierte Beispiele:

public/samples/basic/KTX.hwp
public/samples/form-002.hwpx
public/samples/BlogForm_BookReview.hwp
public/samples/biz_plan.hwp
public/samples/field-01.hwp
public/samples/footnote-01.hwp
public/samples/number-bullet.hwp

Beim Herunterladen öffentlicher HWP/HWPX-Beispiele speichern Sie diese unter rhwp-studio/public/samples/external/, überprüfen Sie die Dateisignatur vor dem Laden und dokumentieren Sie Quell-URL, Dateiname, Byte-Größe und Ladeergebnis.

Agent-Brückenregeln

Verwenden Sie die Brücke zur Zustandsbeobachtung und zum Laden wiederholbarer Test-Fixtures, nicht zur Umgehung der GUI-Abdeckung. Für eine Feature-Behauptung wie „Tabellenerstellung funktioniert“ klicken Sie auf die Toolbar, das Menü und den Dialog. Für eine Behauptung wie „Das Dokument wurde geladen“ ist window.__rhwpAgent.pageCount() angemessen.

Gehen Sie nicht davon aus, dass ein Befehl implementiert ist, nur weil er in HTML auftaucht. Überprüfen Sie mit src/command/commands/*.ts; einige Menüpunkte sind Platzhalter oder je nach Kontext deaktiviert.

Häufige Fehler

  • listen EPERM: Verwenden Sie einen statischen Server auf einem genehmigten Port oder führen Sie ihn außerhalb der Sandbox aus.
  • Browserstart fehlgeschlagen: Führen Sie das Skript aus, wo die Ausführung von Chrome/Chromium erlaubt ist; setzen Sie ggf. CHROME_PATH.
  • HWPX-Speichern deaktiviert: Erwartet für HWPX-Quelldokumente im aktuellen Beta-Pfad.
  • @wasm/rhwp.js fehlt: Erstellen Sie WASM mit Docker neu.
  • File System Access API im Headless-Chrome nicht verfügbar: Erwarten Sie den Fallback-Download-Ablauf.

Verwandte Skills