Communitygithub.com

leeryong/rhwp-Agent-Skills_by_BLUESKY

Ensemble de compétences pour agent permettant de piloter et valider l'éditeur HWP/HWPX rhwp-studio au niveau de l'interface graphique (GUI). Compétences d'agent pour piloter l'éditeur HWP en Rust/WASM dédié aux documents coréens générés par IA.

Qu'est-ce que rhwp-Agent-Skills_by_BLUESKY ?

Cette compétence d'agent fournit un pont d'automatisation complet pour l'éditeur de documents HWP/HWPX `rhwp-studio`, basé sur Rust/WASM et destiné à l'édition de documents coréens par des agents IA. Elle permet de contrôler l'interface graphique via des sélecteurs CSS (menus, barre d'outils, zone de style, canvas) et expose une interface JavaScript `window.__rhwpAgent` pour observer l'état du document, charger des échantillons et exporter des fichiers. La compétence inclut un flux de travail de build (Docker pour WASM, npm pour le frontend), un plan de test en trois couches (validation du build, smoke test GUI, tests approfondis avec navigateur réel) et une stratégie de couverture des fonctionnalités basée sur un fichier de référence. Elle prend en charge les plateformes d'automatisation de navigateur (Playwright, Puppeteer, Selenium) et recommande de privilégier les actions GUI réelles pour les vérifications fonctionnelles, en réservant le pont agent pour les inspections d'état, le chargement d'échantillons et la vérification d'exportation.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add leeryong/rhwp-Agent-Skills_by_BLUESKY

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

rhwp GUI Agent

Utilisez cette compétence pour piloter rhwp-studio à la fois comme un éditeur web destiné aux humains et comme une interface graphique contrôlable par un agent. Privilégiez les actions GUI réelles pour les vérifications de fonctionnalités ; utilisez le pont ?agent=1 uniquement pour la disponibilité, l'inspection d'état, le chargement d'échantillons et la vérification d'exportation.

Démarrage rapide

Depuis la racine du dépôt rhwp :

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

Ouvrez http://127.0.0.1:8765/?agent=1. Sans ?agent=1, l'éditeur fonctionne pour les utilisateurs mais n'expose pas le pont d'automatisation.

Flux de travail principal

  1. Construisez pkg/rhwp.js et pkg/rhwp_bg.wasm avant d'exécuter Studio. Si npm run build signale Cannot find module '@wasm/rhwp.js', le package WASM n'a pas été construit.
  2. Servez l'application construite ou exécutez Vite. Utilisez python3 -m http.server ... -d dist lorsque Vite ne peut pas lier les ports dans un environnement cloisonné.
  3. Lancez une session d'automatisation de navigateur vers /?agent=1.
  4. Utilisez les sélecteurs GUI pour les actions :
    • Menus : #menu-bar .menu-item[data-menu="<menu>"] .menu-title
    • Commandes de menu : [data-cmd="<command-id>"]
    • Boutons de la barre d'outils : .tb-btn[data-cmd="<command-id>"]
    • Contrôles de la barre de style : #style-name, #font-lang, #font-name, #font-size, #btn-bold, #btn-italic, #btn-underline, #btn-strike, #btn-text-color, #btn-highlight, boutons d'alignement et #linespacing-select
    • Entrée de fichier : #file-input
    • Éditeur canvas : #scroll-container canvas
  5. Utilisez window.__rhwpAgent pour l'observation :
    • ready()
    • context()
    • commands()
    • pageCount()
    • fileName()
    • loadSample(path)
    • loadBytes(bytes, fileName)
    • createNewDocument()
    • exportHwp(), exportHwpx()
  6. Capturez des captures d'écran et les fichiers exportés après chaque groupe de fonctionnalités. Considérez les clics échoués, les commandes désactivées, les erreurs dans la console et les canvass vierges comme des échecs de test.

Couverture des fonctionnalités

Consultez references/feature-map.md lorsque vous énumérez ou testez toutes les fonctionnalités de l'interface graphique. Ce fichier répertorie les menus de haut niveau, les identifiants de commande, les boîtes de dialogue, les contrôles de la barre d'outils et les actions hwpctl.

Pour un test automatisé de base, utilisez :

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

Si le lancement du navigateur est bloqué par l'environnement, exécutez tout de même :

npm run build

Ensuite, examinez e2e/agent-gui-full-smoke.mjs et exécutez-le dans un environnement avec navigateur.

Stratégie de test

Utilisez trois niveaux :

  1. Validation de construction : docker compose --env-file .env.docker run --rm wasm, puis npm run build.
  2. Test de base GUI : créez un nouveau document, tapez du texte, basculez le formatage des caractères/paragraphes, créez un tableau, ouvrez le sélecteur de formes, ouvrez la boîte de dialogue des symboles, chargez des échantillons .hwp et .hwpx, sauvegardez/téléchargez .hwp, et capturez des captures d'écran.
  3. Vérifications approfondies : exécutez les tests existants dans rhwp-studio/e2e/*.mjs et les scénarios hwpctl lorsqu'un véritable navigateur est disponible.

Privilégiez d'abord les échantillons intégrés :

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

Lors du téléchargement d'échantillons HWP/HWPX publics, sauvegardez-les sous rhwp-studio/public/samples/external/, vérifiez la signature du fichier avant de le charger, et enregistrez l'URL source, le nom du fichier, la taille en octets et le résultat du chargement.

Règles du pont agent

Utilisez le pont pour observer l'état et charger des jeux de test reproductibles, et non pour contourner la couverture de l'interface graphique. Pour une affirmation de fonctionnalité comme « la création de tableaux fonctionne », cliquez sur la barre d'outils/le menu et la boîte de dialogue. Pour une affirmation comme « le document est chargé », window.__rhwpAgent.pageCount() est approprié.

Ne supposez pas qu'une commande est implémentée simplement parce qu'elle apparaît dans le HTML. Vérifiez avec src/command/commands/*.ts ; certains éléments de menu sont des espaces réservés ou désactivés selon le contexte.

Échecs courants

  • listen EPERM : utilisez un serveur statique sur un port approuvé ou exécutez en dehors de l'environnement cloisonné.
  • Échec du lancement du navigateur : exécutez le script là où l'exécution de Chrome/Chromium est autorisée ; définissez CHROME_PATH si nécessaire.
  • Sauvegarde HWPX désactivée : attendue pour les documents source HWPX dans le chemin bêta actuel.
  • @wasm/rhwp.js manquant : reconstruisez WASM avec Docker.
  • API File System Access indisponible dans Chrome headless : attendez-vous à un flux de téléchargement de secours.

Skills associés