OpenAI Plugins: ejemplos, formatos portables y límites de conexión
Leer el ejemplo Figma: su hook provisional solo imprime un recordatorio
Sigue manifiesto, conexión y script sin confundir instrucciones declaradas con una comprobación visual ejecutada.
Qué aprenderás
- Sigue referencias antes de asumir implementación
- El hook recuerda, no compara capturas
- Prueba el contrato que realmente existe
Antes de empezar
- Conocimientos básicos de JSON y rutas
- Comprender habilidades y permisos de servicios externos
Distinguir ejemplos y guía actual sin confundir metadatos con evidencia de ejecución.
Conclusiones clave
- El mapa identifica una conexión, no implementa herramientas.
- El hook provisional imprime y no compara imágenes.
- Las conclusiones deben corresponder al código ejecutado.
Sigue referencias antes de asumir implementación
El manifiesto Figma fijado declara versión 2.0.20, skills en ./skills y apps en ./.app.json. El mapa contiene un identificador, no una clave API ni implementación de herramientas Figma. El README describe flujos conectados y llama estructuras de ejemplo a comandos, hooks e interfaz.
Read o Write son metadatos de presentación, no controles de acceso implementados ni evidencia de una llamada. Para entender el ejemplo, sigue recursos y distingue configuración, flujo en lenguaje natural y comportamiento ejecutable antes de asignar garantías.
El hook recuerda, no compara capturas
hooks.json declara PostToolUse para Write o Edit y referencia scripts/post_write_figma_parity_check.sh. El script inicia Bash, activa opciones estrictas e imprime un recordatorio para revisar paridad tras cambios de interfaz. Su cabecera lo llama ejemplo provisional para futuros entornos de hooks.
No contiene captura de pantalla, comparación de imágenes ni decisión por umbral. Ejecutarlo correctamente solo demostraría impresión del mensaje, no fidelidad visual. Su presencia tampoco prueba que los anfitriones actuales descubran automáticamente ese archivo de ejemplo heredado.
Prueba el contrato que realmente existe
Nuestro modelo sintético comprueba selección de configuración completa y componentes portables fijos. No prueba Figma, el hook ni el cargador Codex. No ejecutamos el script Shell, instalamos el paquete ni comparamos un diseño real con su implementación.
Para convertir el recordatorio en verificación real, define adquisición de imágenes, viewport, revisión de referencia, tolerancias y salida de revisión. Harían falta fallo con código distinto de cero y artefactos reproducibles. Es una extensión propuesta, no comportamiento del script inspeccionado.
Cómo elegir
| Criterio | Opción A | Opción B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
Pasos de implementación
- 1
Sigue referencias hasta archivos reales.
- 2
Lee declaración y script completos.
- 3
Enumera operaciones presentes y ausentes.
- 4
Diseña evidencia visual antes de afirmar una comprobación de paridad.
Ejemplo para copiar
Comportamiento del hook provisional inspeccionado:
1. Iniciar Bash con opciones estrictas.
2. Imprimir un recordatorio de paridad.
Ausente: captura, comparación de píxeles y umbral de aceptación.Preguntas frecuentes
¿El hook verifica capturas?
No. El script inspeccionado solo imprime un recordatorio.
¿Las pruebas ejecutaron el cargador real?
No. Ejecutaron un modelo de configuración sintético separado.
Fuentes
- OpenAI Plugins / plugins/figma/.codex-plugin/plugin.jsonFuente verificada 2026-09-14
- OpenAI Plugins / plugins/figma/.app.jsonFuente verificada 2026-09-14
- OpenAI Plugins / plugins/figma/README.mdFuente verificada 2026-09-14
- OpenAI Plugins / plugins/figma/hooks.jsonFuente verificada 2026-09-14
- OpenAI Plugins / plugins/figma/scripts/post_write_figma_parity_check.shFuente verificada 2026-09-14
- OpenAI — Package your plugin (checked 2026-09-14)Fuente verificada 2026-09-14