Quiz Site Builder — Habilidad Portable para Agentes
Co-crea un concepto de cuestionario con el usuario, luego convierte el diseño acordado en un sitio web pulido, probado y listo para Cloudflare Pages. Esta habilidad sigue el formato de carpeta de Habilidades para Agentes neutro respecto al proveedor; nunca requiere un producto de agente específico ni una herramienta propia del proveedor. Siempre distingue el alojamiento del código fuente en GitHub del despliegue del sitio web en Cloudflare; el repositorio de la propia habilidad y el de cada sitio de cuestionario generado son distintos.
Lee esto primero
- Inspecciona el directorio de trabajo del usuario antes de tocar archivos. No sobrescribas proyectos, archivos, configuraciones o despliegues existentes.
- Durante la co-creación, propón en lugar de arreglar el mecanismo en silencio; confirma o acepta la delegación antes de la implementación completa:
- emparejamiento de personalidad / personaje: dimensiones → emparejamiento determinista de tipo/personaje; explica el manejo de empates.
- supervivencia / historia interactiva: decisiones ordenadas → variables de estado rastreadas y puntos de control → finales alcanzables.
- diagnóstico / fortalezas: facilidad natural + desgastes + experiencias cumbre → fortalezas y acciones interpretables.
- Lee
references/quiz-design.mdpara preguntas, resultados y equilibrio de puntuaciones. Leereferences/visual-and-copy.mdpara redacción temática y diseño. Leereferences/mainland-readiness.mdantes de elegir fuentes, imágenes o dependencias. Leereferences/qa.mdantes de declarar la finalización. Leereferences/publishing.mdpara Cloudflare Pages vía GitHub cuando se te pida desplegar. - En la etapa de desarrollo aprobada, empezando desde cero: copia el contenido completo de
assets/starter/en un directorio nuevo del sitio web; nunca modifiques el starter reutilizable directamente. El starter incluye 3 cuestionarios de ejemplo, un motor de puntuación tipificado, vistas responsivas y compartición de resultados. Personalizasrc/data/*.jsonantes de editar los componentes. - Sin muro de pago por defecto. Nunca introduzcas pagos, códigos de tarjeta, Cloudflare Workers, autenticación, D1 o KV a menos que el usuario lo solicite. Si se solicitan códigos de acceso, lee
references/access-codes-optional.mdy guía al usuario a través de una arquitectura segura; no lo implementes en silencio ni despliegues servicios facturables.
Modo predeterminado: 用户参与共创 (Co-creación con el usuario)
Por defecto, usa la co-creación, incluso cuando la solicitud inicial diga "制作网站" o enumere tareas de desarrollo. Primero aclara la dirección creativa; no generes inmediatamente un banco de preguntas completo, copies el starter ni construyas el sitio completo. Reutiliza las elecciones ya proporcionadas por el usuario en lugar de volver a preguntarlas. Está permitido inspeccionar archivos existentes y preparar propuestas acotadas.
Avanza a través de estas tres etapas en orden, normalmente una etapa por respuesta. Cada etapa ofrece recomendaciones concretas y hace como máximo 1–2 preguntas clave en total; no repitas una pregunta ya respondida. Usa chat ordinario en cualquier Agente; nunca se deben requerir formularios opcionales.
- 探索创意 (Exploración creativa) — Ofrece 2–3 enfoques significativamente diferentes sobre el tema del usuario, cada uno con un gancho, una audiencia y una experiencia distintiva. Favorece una tensión de jugador distintiva y un resultado memorable y honestamente compartible, no afirmaciones sin fundamento de viralidad. Si el usuario solicita explícitamente un número diferente (por ejemplo, cinco ideas), respétalo en lugar de forzar 2–3. Recomienda uno y explica por qué. Pregunta qué enfoque desarrollar, con como máximo una pregunta adicional que modifique materialmente el concepto.
- 设计测试 (Diseño del test) — Presenta el algoritmo propuesto en lenguaje sencillo (estado/dimensiones, cómo las elecciones los afectan, puntos de control/empates y cómo se seleccionan los finales), tipos de resultados y diferencias, más 2–3 preguntas de muestra completas con opciones y compensaciones explicadas. Recomienda un mecanismo que se ajuste al enfoque confirmado; pregunta si adoptarlo o cambiar la compensación clave. Las muestras son propuestas, no el banco completo.
- 确定风格 (Definición del estilo) — Ofrece 2–3 direcciones visuales concretas con paleta, tipografía, flujo en teléfono y tratamiento de la tarjeta para compartir en 3:4; recomienda una. Muestra un borrador de informe de resultados representativo que incluya título, interpretación, fortaleza, coste y consejo. Pide la elección visual y la aprobación final del diseño consolidado, como máximo dos preguntas. No comiences el desarrollo completo hasta que el usuario confirme el diseño o delegue explícitamente las decisiones restantes.
Al final de cada etapa, muestra un 决策记录 (registro de decisiones) conciso: elecciones confirmadas, recomendaciones de IA aún pendientes de confirmación y decisiones restantes. Registra las elecciones delegadas/saltadas como "AI决定" (Decisión de IA) o "跳过,采用建议" (Saltado, se adopta la sugerencia), nunca como una preferencia seleccionada por el usuario. Mantén este registro en el chat; después de la aprobación, guárdalo en docs/DESIGN.md del sitio generado. Cuando un usuario revise una decisión, actualiza el registro y reconsidera solo las propuestas afectadas materialmente, no todas las etapas.
En cada etapa, el usuario puede revisar, saltarla o pedir a la IA que decida. "跳过这一步" (Saltar este paso) delega solo esa etapa: registra la opción predeterminada recomendada y procede a la siguiente etapa. "你决定剩下的" (Tú decides el resto) delega todas las elecciones restantes: registra brevemente el diseño seleccionado y continúa con la implementación. El silencio o el tiempo transcurrido no es aprobación. Cuando se requiera entrada, detente en la etapa correspondiente; no trates una respuesta faltante como permiso para construir.
Modo de un clic / 一键生成
Cuando el usuario diga "直接做" (Hazlo directamente), "一键生成" (Generar con un clic), "你来决定" (Tú decides), o pida explícitamente saltar toda la discusión de diseño y construir inmediatamente, cambia al modo de un clic para la solicitud actual. Indica las opciones predeterminadas elegidas y procede de forma autónoma a través del contenido, la lógica, la UI, la validación y la vista previa local sin las tres puertas conversacionales. Las restricciones existentes del usuario siguen aplicándose. El usuario puede volver al modo de co-creación en cualquier momento. Una aprobación de diseño previa y clara también autoriza el desarrollo autónomo sin repetir las etapas.
La aprobación del diseño o el modo de un clic autoriza el desarrollo y la depuración solicitados, no acciones externas no relacionadas. Mantén el límite local solicitado; la publicación en GitHub y el despliegue en Cloudflare aún requieren la intención del usuario y la autorización disponible.
Flujo de trabajo de extremo a extremo
1. Convierte la idea del usuario en una especificación de producto utilizable
En modo de co-creación, completa las tres etapas anteriores y consolida su registro de decisiones antes de la implementación. En modo de un clic, elige e indica brevemente estas opciones predeterminadas sin esperar. Incluye gancho de una oración, audiencia, número de preguntas (por defecto ~10–16), clases de resultados, mecanismo, compensaciones, dirección temática/de color, flujo móvil e idea de tarjeta para compartir. Si no se especifica, por defecto usa un sitio estático, gratuito, anónimo, con progreso guardado localmente. No vuelvas a preguntar sobre elecciones confirmadas; en modo de co-creación, etiqueta las opciones predeterminadas propuestas hasta que sean aceptadas o delegadas. Nunca describas los tests de personalidad de entretenimiento como diagnósticos científicos.
2. Después de la aprobación del diseño o la delegación, escribe el contenido y la lógica del cuestionario antes que la UI
Proporciona de forma autónoma el banco completo, no muestras de marcador de posición, e implementa/depura el sitio aprobado sin preguntar por decisiones técnicas rutinarias. Usa preguntas narrativas con opciones plausibles no obvias. Mantén src/data/*.json como los datos canónicos del cuestionario. Para cada opción de personalidad/diagnóstico, referencia solo los ejes declarados. Para supervivencia, danger (peligro) e influence (influencia) deben ser efectos de estado de enteros finitos, los episodios ordenados y los múltiples finales alcanzables de manera realista. Prueba caminos hacia el fracaso y el éxito; evita un exploit de 'elegir siempre la respuesta más segura'. Para medios con licencia / obras con nombre, separa los hechos verificables de la trama de las situaciones inventadas. Consulta fuentes confiables o referencias proporcionadas por el usuario antes de afirmar una cronología real; si no están disponibles, indica la brecha y propón una alternativa original para que el usuario elija. No trates una solicitud de una obra con nombre como permiso para copiar sus imágenes, diálogos o activos promocionales. Verifica los derechos de uso y no fabriques la cronología exacta de la trama.
3. Construye una UI estática atractiva y consciente de China
Por defecto, usa Vite + React + TypeScript desde el starter, con base: '/' para Cloudflare Pages. Conserva: vista de una pregunta a la vez, progreso, retroceder, reanudar, reiniciar, soporte de teclado, teléfonos 320px+, vista previa del enlace para compartir y exportación de tarjeta para compartir en 3:4. Evita dependencias de tiempo de ejecución de Google Fonts, CDN de imágenes remotas, scripts/SDKs de terceros, APIs en el extranjero y análisis del lado del cliente. Agrupa los activos estáticos; usa un fallback seguro de fuentes del sistema. Nunca comprometas claves ni pongas secretos de API en el código del frontend. Haz que los resultados sean deterministas. Sin pagos/códigos por defecto.
4. Valida la funcionalidad y la preparación para China continental
Ejecuta, ajustando las rutas:
python3 <skill-root>/scripts/validate_quizzes.py <website>/src/data
python3 <skill-root>/scripts/audit_mainland_assets.py <website>
cd <website>
npm install
npm test
npm run build
Luego verifica manualmente la introducción, retroceder y avanzar, actualizar/reanudar, múltiples caminos de resultados, compartir PNG/URL, diseño móvil y contraste. Consulta references/qa.md. No afirmes ninguna comprobación que no hayas ejecutado. No afirmes accesibilidad en China continental sin pruebas en redes reales de China continental.
5. 引导上线 (Guía para publicación) — Publica el código en GitHub, despliega el sitio web con Cloudflare Pages
Después de la vista previa local, explica en lenguaje sencillo que GitHub almacena el código y Cloudflare Pages hace que el sitio sea accesible en línea; guía los pasos de la cuenta o del panel de control cuando las herramientas no puedan hacerlos. Respeta las solicitudes de solo localidad y no preguntes por autorización repetida donde ya se haya concedido. Sigue references/publishing.md. Ruta predeterminada: repositorio separado en GitHub para el sitio generado → Cloudflare Pages Connect to Git → Vite/React npm run build / dist / producción main → desplegar → configurar un dominio personalizado para promoción → probar HTTPS / carga desde redes de China continental antes de afirmar la preparación. La GitHub Action en el starter es solo comprobaciones; la integración de Git de Cloudflare maneja el despliegue.
Si el usuario quiere publicar la habilidad en sí misma en GitHub, publica este repositorio de habilidad entre Agentes por separado. Nunca crees cuentas, compres dominios, conectes repositorios, hagas push o despliegues sin la intención del usuario y la autenticación disponible. Si no está disponible, proporciona comandos ejecutables y pasos del panel de control, no una afirmación falsa de 'publicado'. El plan global estándar de Cloudflare Pages no puede garantizar la accesibilidad en China continental; si el requisito estricto falla las pruebas, recomienda opciones de alojamiento y presentación ICP compatibles con China continental según corresponda. No confundas la Red Empresarial China de Cloudflare con las Pages gratuitas.
Principio del producto
AI 负责拓展创意的可能性,用户负责决定作品的独特性,AI 负责把决定变成现实。 (La IA es responsable de expandir las posibilidades creativas, el usuario es responsable de decidir la singularidad de la obra, y la IA es responsable de convertir esa decisión en realidad). Las elecciones creativas pertenecen al usuario a menos que sean delegadas; la ejecución técnica rutinaria pertenece al Agente. Una delegación estrecha como "配色你来决定" (Tú decides la combinación de colores) se aplica solo a esa decisión, no a todas las etapas restantes.
Invariantes principales
- Algoritmo preciso con resultados alcanzables y distinguibles; ningún resultado aleatorio a menos que se solicite.
- Sin validez clínica falsa; sin promesa general de 'accesible en China'.
- Sin backend, inicio de sesión, seguimiento, pago, compuerta de código o recolección sensible no solicitados.
- Compartir código no es despliegue. Cada nuevo sitio web de cuestionario debe tener su propio repositorio y dominio.
- Los bloqueos de código solo en el frontend no son seguros. Si se solicita una compuerta de código de acceso, aconseja verificación del lado del servidor y manejo de resultados secretos; mantenlo opcional.
- Sigue la marca, las imágenes, los hechos y las elecciones existentes del usuario.
Ejemplos de invocación
- "Usa quiz-site-builder para co-crear conmigo un test de supervivencia en la corte imperial, primero dame algunos enfoques creativos."
- "Haz directamente un test de supervivencia en la corte imperial original de 10 preguntas, vista previa local, sin desplegar." (Modo de un clic)
- "Usa $quiz-site-builder para ayudarme a crear un test de personalidad de estilo chino, análisis de seis ejes, personalidad de objeto, versión móvil, y desplegar en Cloudflare Pages."
- "Haz un test de supervivencia en la corte imperial original de 10 preguntas, finales ramificados, tarjeta de resultados 3:4, publica en GitHub y que Cloudflare lo despliegue automáticamente."
- "Ayúdame a preparar el sitio de prueba para usuarios en China, sin depender de fuentes o CDN extranjeros, enséñame a vincular un dominio personalizado y verificar el acceso."
- "Por ahora no necesito cobros ni códigos de tarjeta, solo dime cómo expandir con códigos de tarjeta más adelante."
Reglas de ejecución entre agentes
- Todas las rutas de instrucción como
references/quiz-design.mdyassets/starter/son relativas a la carpeta que contiene esteSKILL.md(<skill-root>), nunca a un directorio fijo de Codex. - Usa las operaciones de archivo, capacidades de shell y navegador realmente ofrecidas por el agente anfitrión actual; no asumas que
apply_patch, herramientas de Codex o un servidor MCP particular existen. Cuando una herramienta esté ausente, proporciona comandos portables o pasos manuales y marca claramente los pasos incompletos. - La fuente de verdad del proyecto es
skills/quiz-site-builder/. Nunca dupliques ni bifurques la lógica de la habilidad en copias específicas de proveedores. La instalación del adaptador solo copia la misma carpeta. - La invocación de Codex puede usar
$quiz-site-builder; WorkBuddy, Claude Code, CodeBuddy Code y otros agentes pueden usar un selector de habilidades o lenguaje ordinario. No requieras la sintaxis$fuera de Codex. - Nunca afirmes que un agente soporta una característica solo porque importa la habilidad. Confirma el acceso a archivos local, Python, Node/npm, Git y la capacidad de autenticarse antes de ejecutar pasos de despliegue.
- La importación de WorkBuddy usa un zip con una raíz de carpeta
quiz-site-builder/SKILL.md. WorkBuddy debe cargarreferences/,scripts/yassets/desde esa carpeta. Si el sandbox del anfitrión impide ejecutar scripts, explica las limitaciones y aún así genera el código del sitio estático.
Restricciones de despliegue por anfitrión
Independientemente del agente: GitHub almacena el código fuente, Cloudflare Pages es el destino de despliegue predeterminado; usa la integración de Git de Cloudflare donde el usuario pueda autorizarla. La arquitectura opcional de códigos de tarjeta es solo una guía; nunca añadas silenciosamente muros de pago, pagos o comprobaciones en el frontend que contengan secretos. El acceso a China continental requiere pruebas del mundo real y no puede ser garantizado por Cloudflare Pages estándar o dominios personalizados.