Communitygithub.com

waitlist-launch — 流程 de lanzamiento de lista de espera

Construye y lanza un sitio de lista de espera (waitlist) desde cero para cualquier sitio/proyecto: Cloudflare Worker + KV para recopilar correos, Resend para sincronización, triple capa antiabuso, tarjetas OG para compartir, bucle de referidos, Web Analytics. Incluye fórmulas de copy, playbook de canales de difusión y lista de verificación de lanzamiento. Se activa cuando el usuario dice 'crea waitlist', 'lista de espera', 'página coming soon para recopilar correos', 'recoge correos antes del lanzamiento', 'haz una página de espera para el proyecto X', incluso si solo dice 'quiero recopilar correos para ver si hay interés'.

¿Qué es waitlist-launch — 流程 de lanzamiento de lista de espera?

Este skill (waitlist-launch) automatiza la creación y lanzamiento de un sitio de lista de espera (waitlist) desde cero para cualquier proyecto o sitio web. Su propósito es que un desarrollador o agente de IA pueda, ante una solicitud del usuario, desplegar una página funcional de 'coming soon' que capture correos electrónicos de interesados, sincronice los datos con Resend para mailing, incluya protección contra abusos (honeypot, rate limiting, Turnstile), genere tarjetas OG para compartir en redes sociales, implemente un sistema de referidos para viralidad y añada Web Analytics para medir el tráfico. Además, proporciona guías completas de copywriting con fórmulas para titulares, descripciones y llamadas a la acción, un playbook de canales de difusión con códigos de atribución, y una lista de verificación de lanzamiento (gate) para asegurar que todo esté listo. Está diseñado para proyectos Cloudflare Workers + KV, con configuración vía variables de entorno, y evita el uso innecesario de escrituras en KV para el antiabuso. El skill se activa con frases como 'crea waitlist', 'lista de espera', 'página coming soon', 'recoge correos antes del lanzamiento', 'haz una página de espera para X', o incluso 'quiero recopilar correos para ver si hay interés'. Incluye un flujo de trabajo paso a paso con 6 fases, roles claros (arquitecto, redactor, gestor de producto), y una sección de 'trampas comunes' para evitar errores típicos.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Heng-xiu/xiuxiu-agent-skills/tree/HEAD/skills/waitlist-launch

Preguntar en tu IA favorita

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

Documentación

waitlist-launch — Proceso de lanzamiento de sitio de lista de espera

Extraído del proyecto real fare-waitlist (2026-07, early-fare.hengshiou.com, referencia: /Users/xiuxiu/Documents/個人事宜/1_Projects/fare-waitlist). Idea central: KV es la única fuente de verdad para la lista, antiabuso sin gastar escrituras KV, toda la configuración pública vía variables de runtime, sin redirigir tráfico hasta tener analytics, y el copy se basa en la venta inversa para generar confianza.

Tres documentos de rol (cargar bajo demanda, no todos a la vez)

ArchivoRolCuándo leerlo
references/architecture.mdArquitecto de informaciónLectura obligatoria al empezar: lista de preguntas previas, proceso de seis fases, contrato API/KV (se puede copiar), límite entre var y secret, tabla de permisos de herramientas, manual de verificación, trampas conocidas
references/copywriting.mdEspecialista en marketingLeer al escribir copy de página, copy para compartir, gráfico OG, planificar canales de difusión: fórmulas de H1 dolor, estructura del lede, fórmula de consentimiento, principios de venta inversa, playbook de canales + código de atribución ref
references/operations.mdProduct managerLeer durante la verificación pre-lanzamiento y operación post-lanzamiento: lista de verificación gate (niveles obligatorio/recomendado), indicadores de éxito vs. vanidad, ritmo de retención, límites de decisión, plantilla de backlog de iteración

Flujo de ejecución (desde la perspectiva del orquestador)

  1. Entrevista previa: Preguntar al usuario las 9 preguntas de la sección 1 del architecture.md. No empezar sin respuestas. Atención: el handle de la comunidad debe verificarse (grep del código fuente del sitio web existente del usuario o confirmación directa del usuario), no adivinar con la memoria del modelo.
  2. Reconocimiento del estado actual: Si es un repositorio existente, verificar con git log; confirmar la cuenta de inicio de sesión de wrangler y los permisos de zona.
  3. Implementación por fases (pasos detallados y definición de 'Done' en la sección 2 del architecture.md):
    • Fase 1: Construcción base del sitio (Worker + assets + KV + custom domain)
    • Fase 2: Sincronización de la lista con Resend (best-effort + relleno idempotente con ops/sync)
    • Fase 3: Triple capa antiabuso (honeypot → rate limiting nativo → Turnstile, sin gastar escrituras KV)
    • Fase 4: Footer de marca personal (discreto, peso visual menor que el CTA)
    • Fase 5: Capa de exposición (og:image → referidos → analytics, en ese orden, todos modifican index.html)
    • Fase 6: Verificación de despliegue (lista smoke + cache-buster)
  4. Copy: Cada espacio de copy (H1/lede/bullets/consent/tarjeta de prueba/frase para compartir) aplica las fórmulas del copywriting.md. La frase de desaliento honesta debe ser verdadera.
  5. Gate de lanzamiento: Marcar cada elemento de la sección 1 del operations.md. No lanzar si algún elemento de nivel "obligatorio" no pasa. No comenzar a redirigir tráfico hasta tener analytics.
  6. Post-lanzamiento: Los canales llevan código ref para atribución (sección 4 del copywriting.md). Una vez que la lista supere los 100, hacer retención. La prueba social de número de personas solo se muestra cuando supera el umbral (sección 3 del operations.md).

Disciplina de asignación de tareas (cuando hay múltiples subagentes)

  • Múltiples tareas que modifican el mismo archivo (típico: las tres subtareas de la capa de exposición modifican index.html) → Asignar en secuencia, no en paralelo.
  • Cada tarea de subagente debe incluir: qué archivos puede modificar, definición de 'Done', solicitar evidencia de prueba real (captura de pantalla/salida de curl), no hacer commit/deploy.
  • El orquestador verifica tarea por tarea (diff + inspección visual de los artefactos clave; las imágenes deben ser revisadas visualmente), hace commit por tarea, y al final despliega todo junto + smoke en línea.
  • El informe de entrega incluye cuatro cosas: branch, hash de commit, si está desplegado, si se limpió el worktree.

Cosas que el usuario debe hacer manualmente (no automatizables, avisar con antelación)

  • Crear un Turnstile site en el dashboard de CF (obtener site key + secret)
  • Crear un Web Analytics site en el dashboard de CF (obtener beacon token; wrangler OAuth no tiene permisos RUM, la API no puede crearlo)
  • Resend: Crear una audiencia, generar una API key dedicada (no reutilizar la de otros sitios), verificar DNS del dominio de envío
  • Al montar un custom domain por primera vez, puede ser necesario confirmar DNS/certificados en el dashboard

Escribir el código primero con el patrón de variables de runtime (/api/health las suministra dinámicamente al frontend). Una vez que los credenciales estén listos, rellenar var/secret y redeploy; sin cambiar código. Esto evita que "esperar credenciales" bloquee el desarrollo.

Las trampas más comunes (lista completa en la sección 5.3 del architecture.md)

  • Captura de OG con headless Chrome: --force-device-scale-factor=1 (retina genera 2x) + --virtual-time-budget=4000 (esperar webfont). Después de capturar, revisar visualmente (tipografía de respaldo, líneas huérfanas en títulos).
  • Después del deploy, el caché de borde devuelve el HTML antiguo → Verificar con ?cb=<timestamp>.
  • Turnstile en línea fuerza que curl no pueda probar /api/join → Las pruebas de contrato (casos normal/duplicado/honeypot) solo pueden hacerse localmente con wrangler dev (sin secret, se salta automáticamente).
  • El honeypot/rate limit devuelve éxito suave pero no devuelve refCode (no dar información al bot); los ya registrados devuelven already + mismo refCode (idempotente).
  • Si una API key en texto plano aparece en el diálogo/archivo → cambiar inmediatamente a secret.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills relacionados