Communitygithub.com

Heng-xiu/xiuxiu-agent-skills

Créez et déployez de zéro une page d'attente (waitlist) pour tout site/projet : Cloudflare Worker + KV pour collecter les emails, synchronisation Resend, triple couche anti-abus, cartes de partage OG, boucle de parrainage et Web Analytics. Inclut formules de copywriting, playbook de canaux d'exposition et checklist de validation de mise en ligne.

Qu'est-ce que xiuxiu-agent-skills ?

Cette compétence (skill) permet à un agent IA (comme Claude Code, Cursor, ou Codex) de créer et déployer une page d'attente (waitlist) complète et professionnelle en quelques minutes, directement à partir d'une conversation. Elle est idéale pour tout projet web ou mobile qui souhaite collecter des emails avant un lancement officiel, que ce soit pour un ``coming soon``, une beta privée ou une simple validation d'idée. Le skill s'appuie sur une stack technique moderne et serverless : Cloudflare Workers pour l'API, Workers KV pour le stockage persistant des emails (unique source de vérité), Resend pour l'envoi de confirmations, et Turnstile pour la protection anti-bot. Il intègre également l'analyse web (Web Analytics), un système de parrainage (référencement), et des cartes de partage Open Graph (OG) optimisées. Le flux de travail est entièrement documenté avec trois références détaillées (architecture, copywriting, operations) qui guident l'agent pas à pas, de l'entretien préalable à la mise en ligne, en passant par la rédaction de copywriting honnête et la validation rigoureuse. Le skill gère aussi les pièges courants (cache, Turnstile en local, etc.) et produit un livrable prêt à déployer, avec une séparation claire entre code et configuration (variables d'environnement).

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

Demander à votre IA préférée

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

Documentation

waitlist-launch — Processus de mise en ligne d'une page d'attente

Extrait de l'implémentation réelle de fare-waitlist (juillet 2026, early-fare.hengshiou.com, références pratiques : /Users/xiuxiu/Documents/個人事宜/1_Projects/fare-waitlist). Idée centrale : KV est la seule source de vérité pour la liste, l'anti-abus ne consomme pas d'écritures KV, tous les paramètres publics passent par des variables d'exécution, pas de trafic avant d'avoir des analytics, le copywriting crée la confiance en inversant la vente.

Trois fichiers de référence (charger à la demande, pas tous en même temps)

FichierRôleQuand le lire
references/architecture.mdArchitecte de l'informationÀ lire obligatoirement avant de commencer : checklist d'entretien préalable, processus en six étapes, contrat API/KV (à copier), séparation var vs secret, tableau des permissions des outils, manuel de validation, pièges connus
references/copywriting.mdSpécialiste marketingÀ lire pour écrire les textes de la page, les messages de partage, l'image OG, et planifier les canaux de trafic : formules pour les points de douleur H1, structure de l'accroche, formule de consentement, règles d'anti-vente, playbook des canaux + codes de référence
references/operations.mdChef de produitÀ lire pour la validation pré-lancement et l'exploitation post-lancement : checklist de validation (obligatoire / recommandé), indicateurs de succès et de vanité, rythme de relance, périmètre des décisions, template de backlog d'itération

Processus d'exécution (vue orchestrateur)

  1. Entretien préalable : Poser les 9 questions de la section §1 de architecture.md ; ne pas commencer sans les réponses. Attention particulière : vérifier le handle de la communauté (grep sur le code source du site existant ou confirmer avec la personne), ne pas deviner avec la mémoire du modèle.
  2. Reconnaissance de l'existant : S'il s'agit d'un dépôt existant, exécuter git log pour vérifier ; confirmer le compte de connexion wrangler et les droits sur la zone.
  3. Implémentation par phases (étapes détaillées et définition de "Fait" dans architecture.md §2) :
    • Phase 1 : Construction de base (Worker + assets + KV + domaine personnalisé)
    • Phase 2 : Synchronisation de la liste avec Resend (best-effort + ops/sync idempotent pour re-création)
    • Phase 3 : Anti-abus en trois couches (honeypot → rate-limiting natif → Turnstile, aucun consommateur d'écriture KV)
    • Phase 4 : Pied de page de marque personnelle (discret, poids visuel inférieur au CTA)
    • Phase 5 : Couche d'exposition (og:image → parrainage → analytics, dans cet ordre, tous modifient index.html)
    • Phase 6 : Validation de déploiement (checklist smoke + cache-buster)
  4. Copywriting : Chaque emplacement (H1/accroche/puces/consentement/ carte de preuve /message de partage) utilise la formule de copywriting.md ; la phrase de dissuasion honnête doit être vraie.
  5. Passerelle de mise en ligne : Cocher chaque élément de la §1 de operations.md ; si un élément "obligatoire" n'est pas rempli, ne pas mettre en ligne. Pas de trafic avant d'avoir des analytics.
  6. Post-lancement : Les canaux utilisent un code de référence pour l'attribution (copywriting.md §4) ; relancer quand la liste dépasse 100 ; afficher la preuve sociale uniquement lorsque le seuil de nombre est atteint (operations.md §3).

Discipline d'affectation (quand plusieurs sous-agents)

  • Plusieurs tâches modifiant le même fichier (typique : les trois sous-tâches de la couche d'exposition modifient toutes index.html) → affecter séquentiellement, pas en parallèle.
  • Chaque mission d'un sous-agent doit inclure : quels fichiers sont autorisés à être modifiés, définition de "Fait", demande de preuve concrète (capture d'écran / sortie curl), interdiction de commit/déployer.
  • L'orchestrateur valide chaque tâche (diff + inspection visuelle des artefacts clés ; les images doivent être lues), commit par tâche, puis un seul déploiement + smoke test en ligne à la fin.
  • Le rapport de livraison contient quatre choses : branche, hash du commit, état du déploiement, et nettoyage du worktree.

Actions manuelles nécessaires (non automatisables, à signaler tôt)

  • Créer un Turnstile site dans le tableau de bord CF (obtenir site key + secret)
  • Créer un Web Analytics site dans le tableau de bord CF (obtenir le beacon token ; l'OAuth de wrangler n'a pas les droits RUM, l'API ne peut pas le créer)
  • Resend : Créer une audience, générer une clé API dédiée (ne pas réutiliser celle d'autres sites), valider le DNS du domaine d'envoi
  • Le premier rattachement d'un domaine personnalisé peut nécessiter une vérification DNS/certificats dans le tableau de bord

Le code est d'abord écrit en mode variables d'exécution (/api/health les fournit dynamiquement au front-end). Une fois les credentials réunis, remplir les var/secret et redéployer pour les activer, sans modifier le code — cela permet de ne pas bloquer le développement en attendant les credentials.

Pièges les plus fréquents (liste complète dans architecture.md §5.3)

  • Capture d'écran OG avec headless Chrome : --force-device-scale-factor=1 (le retina donne du 2x) + --virtual-time-budget=4000 (pour attendre les webfonts) ; vérifier visuellement la capture (police de secours, lignes orphelines dans le titre).
  • Cache périphérique renvoyant une ancienne version HTML après déploiement → tester avec ?cb=<timestamp>.
  • Turnstile en ligne bloque curl pour tester /api/join → les tests de contrat (trois cas : normal/ doublon / honeypot) ne peuvent être faits qu'en local avec wrangler dev (sans secret, les étapes sont sautées automatiquement).
  • Honeypot / rate-limiting renvoient un succès soft mais sans refCode (aucune information donnée au bot) ; les inscriptions déjà présentes renvoient already + le même refCode (idempotence).
  • Clé API en texte clair dans la conversation/fichier → passer immédiatement en secret.

Individual skills in this repo

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

Skills associés