Communitygithub.com

leeryong/rhwp-Agent-Skills_by_BLUESKY

Conjunto de habilidades para que agentes de IA controlen y verifiquen el editor HWP/HWPX rhwp-studio a nivel de GUI.

¿Qué es rhwp-Agent-Skills_by_BLUESKY?

Este skill permite que agentes de IA (como Claude Code, Cursor, Codex) operen el editor de documentos coreanos HWP/HWPX `rhwp-studio` tanto como un editor web orientado a humanos como una GUI controlable por el agente. Su objetivo es automatizar la verificación de características del editor utilizando acciones reales de GUI en lugar de depender únicamente de un puente de automatización. El skill es compatible con cualquier plataforma que pueda ejecutar un navegador y Node.js, y proporciona selectores CSS para interactuar con menús, barras de herramientas, controles de estilo y el lienzo del editor. Además, expone una API de agente (`window.__rhwpAgent`) para inspeccionar el estado del documento, cargar muestras y exportar archivos. La estrategia de pruebas incluye validación de compilación, pruebas de humo de GUI y verificaciones profundas con casos de prueba existentes. Se recomienda usar las muestras integradas y, al descargar archivos HWP/HWPX externos, verificar la firma y registrar los metadatos. El skill también documenta fallos comunes como problemas de permisos, falta de Chrome o archivos WASM no compilados.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

rhwp GUI Agent

Usa este skill para operar rhwp-studio tanto como un editor web orientado a humanos como una GUI controlable por el agente. Prefiere acciones reales de GUI para verificar características; usa el puente ?agent=1 solo para verificar disponibilidad, inspeccionar estado, cargar muestras y verificar exportaciones.

Inicio Rápido

Desde la raíz del repositorio 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

Abre http://127.0.0.1:8765/?agent=1. Sin ?agent=1, el editor funciona para los usuarios pero no expone el puente de automatización.

Flujo de Trabajo Principal

  1. Compila pkg/rhwp.js y pkg/rhwp_bg.wasm antes de ejecutar Studio. Si npm run build informa Cannot find module '@wasm/rhwp.js', el paquete WASM no se ha compilado.
  2. Sirve la aplicación compilada o ejecuta Vite. Usa python3 -m http.server ... -d dist cuando Vite no pueda enlazar puertos en un entorno aislado.
  3. Inicia una sesión de automatización del navegador contra /?agent=1.
  4. Usa selectores de GUI para las acciones:
    • Menús: #menu-bar .menu-item[data-menu="<menu>"] .menu-title
    • Comandos de menú: [data-cmd="<command-id>"]
    • Botones de barra de herramientas: .tb-btn[data-cmd="<command-id>"]
    • Controles de barra de estilo: #style-name, #font-lang, #font-name, #font-size, #btn-bold, #btn-italic, #btn-underline, #btn-strike, #btn-text-color, #btn-highlight, botones de alineación y #linespacing-select
    • Entrada de archivo: #file-input
    • Editor de lienzo: #scroll-container canvas
  5. Usa window.__rhwpAgent para observación:
    • ready()
    • context()
    • commands()
    • pageCount()
    • fileName()
    • loadSample(path)
    • loadBytes(bytes, fileName)
    • createNewDocument()
    • exportHwp(), exportHwpx()
  6. Captura capturas de pantalla y archivos exportados después de cada grupo de características. Trata los clics fallidos, comandos deshabilitados, errores de consola y lienzos vacíos como fallos de prueba.

Cobertura de Características

Lee references/feature-map.md al enumerar o probar todas las características de la GUI. Allí se mapean los menús de nivel superior, IDs de comandos, diálogos, controles de barra de herramientas y acciones de hwpctl.

Para una ejecución de humo automatizada, usa:

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

Si el inicio del navegador está bloqueado por el entorno, ejecuta:

npm run build

Luego revisa e2e/agent-gui-full-smoke.mjs y ejecútalo en un entorno con navegador habilitado.

Estrategia de Pruebas

Usa tres capas:

  1. Validación de compilación: docker compose --env-file .env.docker run --rm wasm, luego npm run build.
  2. Prueba de humo de GUI: crea un nuevo documento, escribe texto, alterna formato de carácter/párrafo, crea una tabla, abre el selector de formas, abre el diálogo de símbolos, carga muestras .hwp y .hwpx, guarda/descarga .hwp y captura capturas de pantalla.
  3. Verificaciones profundas: ejecuta las pruebas existentes de rhwp-studio/e2e/*.mjs y escenarios de hwpctl cuando haya un navegador real disponible.

Primero prefiere las muestras integradas:

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

Al descargar muestras HWP/HWPX públicas, guárdalas en rhwp-studio/public/samples/external/, verifica la firma del archivo antes de cargarlo, y registra la URL de origen, el nombre del archivo, el tamaño en bytes y el resultado de la carga.

Reglas del Puente del Agente

Usa el puente para observar el estado y cargar accesorios de prueba repetibles, no para evitar la cobertura de la GUI. Para una afirmación de característica como "la creación de tablas funciona", haz clic en la barra de herramientas/menú y el diálogo. Para una afirmación como "el documento se ha cargado", window.__rhwpAgent.pageCount() es apropiado.

No asumas que un comando está implementado solo porque aparece en HTML. Verifica con src/command/commands/*.ts; algunos elementos del menú son marcadores de posición o están deshabilitados según el contexto.

Fallos Comunes

  • listen EPERM: usa un servidor estático en un puerto permitido o ejecuta fuera del entorno aislado.
  • Fallo al iniciar el navegador: ejecuta el script donde la ejecución de Chrome/Chromium esté permitida; establece CHROME_PATH si es necesario.
  • Guardado de HWPX deshabilitado: esperado para documentos de origen HWPX en la ruta beta actual.
  • Falta @wasm/rhwp.js: reconstruye WASM con Docker.
  • API de acceso al sistema de archivos no disponible en Chrome sin interfaz gráfica: espera el flujo de descarga alternativo.

Skills relacionados