Quiz Site Builder — Compétence d'Agent Portable
Co-créez un concept de quiz avec l'utilisateur, puis transformez le design convenu en un site web soigné, testé et prêt pour Cloudflare Pages. Cette compétence suit le format de dossier Agent Skills indépendant du fournisseur ; n'exigez jamais de produit ou d'outil spécifique à un fournisseur. Distinguez toujours l'hébergement du code sur GitHub du déploiement du site Cloudflare ; le référentiel de la compétence elle-même et chaque référentiel de site de quiz généré sont distincts.
Lisez ceci en premier
- Inspectez le répertoire de travail de l'utilisateur avant de toucher aux fichiers. N'écrasez pas les projets, fichiers, paramètres ou déploiements existants.
- Pendant la co-création, proposez plutôt que de corriger silencieusement le mécanisme ; confirmez ou acceptez la délégation avant l'implémentation complète :
- correspondance personnalité / caractère : dimensions → correspondance déterministe type/caractère ; expliquez la gestion des égalités.
- survie / histoire interactive : décisions ordonnées → variables d'état suivies et points de contrôle → fins atteignables.
- diagnostic / forces : aisance naturelle + épuisements + expériences marquantes → forces et actions interprétables.
- Lisez
references/quiz-design.mdpour les questions, les résultats et l'équilibrage des scores. Lisezreferences/visual-and-copy.mdpour l'écriture thématique et le design. Lisezreferences/mainland-readiness.mdavant de choisir les polices, images ou dépendances. Lisezreferences/qa.mdavant de déclarer la tâche terminée. Lisezreferences/publishing.mdpour Cloudflare Pages via GitHub lorsque l'on vous demande de déployer. - Au stade de développement approuvé, en partant de zéro : copiez le contenu complet de
assets/starter/dans un nouveau répertoire de site ; ne modifiez jamais le starter réutilisable directement. Le starter comprend 3 exemples de quiz, un moteur de notation typé, des vues responsives et le partage des résultats. Personnalisezsrc/data/*.jsonavant de modifier les composants. - Pas de paywall par défaut. N'introduisez jamais de paiement, de codes, de Cloudflare Workers, d'authentification, de D1 ou de KV sauf si l'utilisateur le demande. Si des codes d'accès sont demandés, lisez
references/access-codes-optional.mdet guidez l'utilisateur vers une architecture sécurisée ; ne l'implémentez pas silencieusement et ne déployez pas de services facturables.
Mode par défaut : 用户参与共创
Par défaut, optez pour la co-création, même lorsque la demande initiale dit "制作网站" ou énumère des tâches de développement. Clarifiez d'abord l'orientation créative ; ne générez pas immédiatement une banque de questions complète, ne copiez pas le starter et ne construisez pas le site complet. Réutilisez les choix déjà donnés par l'utilisateur au lieu de les redemander. L'inspection des fichiers existants et la préparation de propositions limitées sont autorisées.
Suivez ces trois étapes dans l'ordre, normalement une étape par réponse. Chaque étape offre des recommandations concrètes et pose au maximum 1 à 2 questions clés au total ; ne répétez pas une question déjà répondue. Utilisez le chat ordinaire sur chaque Agent ; les formulaires optionnels ne doivent jamais être obligatoires.
- 探索创意 — Proposez 2 à 3 angles significativement différents sur le sujet de l'utilisateur, chacun avec un accroche, un public et une expérience distinctive. Favorisez une tension de jeu distinctive et un résultat mémorable et honnêtement partageable, pas des affirmations non fondées de viralité. Si l'utilisateur demande explicitement un nombre différent (par exemple cinq idées), respectez-le plutôt que d'imposer 2-3. Recommandez-en un et expliquez pourquoi. Demandez quel angle développer, avec au plus une question supplémentaire qui modifie matériellement le concept.
- 设计测试 — Présentez l'algorithme proposé en langage clair (état/dimensions, comment les choix les affectent, points de contrôle/égalités et comment les fins sont sélectionnées), les types de résultats et leurs différences, ainsi que 2 à 3 exemples complets de questions avec options et compromis expliqués. Recommandez un mécanisme qui correspond à l'angle confirmé ; demandez s'il faut l'adopter ou modifier le compromis clé. Les exemples sont des propositions, pas la banque complète.
- 确定风格 — Proposez 2 à 3 directions visuelles concrètes avec palette, typographie, flux téléphone et traitement de carte de partage 3:4 ; recommandez-en une. Montrez un brouillon de rapport de résultat représentatif incluant titre, interprétation, force, coût et conseil. Demandez le choix visuel et l'approbation finale du design consolidé, au plus deux questions. Ne commencez pas le développement complet avant que l'utilisateur confirme le design ou délègue explicitement les décisions restantes.
À la fin de chaque étape, affichez un enregistrement de décision concis : choix confirmés, recommandations de l'IA encore en attente de confirmation, et décisions restantes. Enregistrez les choix délégués/sautés comme "AI决定" ou "跳过,采用建议", jamais comme une préférence utilisateur. Transportez cet enregistrement dans le chat ; après approbation, sauvegardez-le dans docs/DESIGN.md du site généré. Lorsqu'un utilisateur révise une décision, mettez à jour l'enregistrement et ne revisitez que les propositions matériellement affectées, pas toutes les étapes.
À chaque étape, l'utilisateur peut réviser, la sauter ou demander à l'IA de décider. "跳过这一步" délègue uniquement cette étape : enregistrez la valeur par défaut recommandée et passez à l'étape suivante. "你决定剩下的" délègue tous les choix restants : enregistrez brièvement le design sélectionné et continuez vers l'implémentation. Le silence ou le temps écoulé n'est pas une approbation. Lorsqu'une entrée est requise, arrêtez-vous à l'étape pertinente ; ne traitez pas une réponse manquante comme une autorisation de construire.
Mode one-click / 一键生成
Lorsque l'utilisateur dit "直接做", "一键生成", "你来决定", ou demande explicitement de sauter toute discussion de design et de construire immédiatement, passez en mode one-click pour la demande en cours. Énoncez les valeurs par défaut choisies et procédez de manière autonome à travers le contenu, la logique, l'interface utilisateur, la validation et l'aperçu local sans les trois étapes conversationnelles. Les contraintes existantes de l'utilisateur s'appliquent toujours. L'utilisateur peut revenir à la co-création à tout moment. Une approbation claire du design antérieur autorise également le développement autonome sans répéter les étapes.
L'approbation du design ou le mode one-click autorise le développement et le débogage demandés, pas des actions externes non liées. Préservez la limite locale demandée ; la publication sur GitHub et le déploiement Cloudflare nécessitent toujours l'intention de l'utilisateur et une autorisation disponible.
Flux de travail de bout en bout
1. Convertissez l'idée de l'utilisateur en un cahier des charges produit utilisable
En mode co-création, terminez les trois étapes ci-dessus et consolidez leur enregistrement de décision avant l'implémentation. En mode one-click, choisissez et énoncez brièvement ces valeurs par défaut sans attendre. Incluez une phrase d'accroche, le public, le nombre de questions (par défaut ~10-16), les classes de résultats, le mécanisme, les compromis, la direction thème/couleur, le flux mobile et l'idée de carte de partage. Si non spécifié, par défaut un site statique, anonyme et gratuit avec progression sauvegardée localement. Ne redemandez pas les choix confirmés ; en mode co-création, étiquetez les valeurs par défaut proposées jusqu'à ce qu'elles soient acceptées ou déléguées. Ne décrivez jamais les tests de personnalité de divertissement comme des diagnostics scientifiques.
2. Après l'approbation du design ou la délégation, écrivez le contenu et la logique du quiz avant l'interface utilisateur
Fournissez de manière autonome la banque complète, pas des exemples d'espace réservé, et implémentez/déboguez le site approuvé sans demander de décisions techniques de routine. Utilisez des questions narratives avec des options plausibles non évidentes. Gardez src/data/*.json comme donnée canonique du quiz. Pour chaque option de personnalité/diagnostic, référencez uniquement les axes déclarés. Pour la survie, danger et influence doivent être des effets d'état entier finis, les épisodes ordonnés, et plusieurs fins atteignables de manière réaliste. Testez les chemins vers l'échec et le succès ; empêchez une exploitation 'toujours choisir la réponse la plus sûre'. Pour les œuvres sous licence / nommées, séparez les faits d'intrigue vérifiables des situations inventées. Consultez des sources fiables ou des références fournies par l'utilisateur avant de revendiquer une chronologie réelle ; si indisponible, indiquez l'écart et proposez une alternative originale à choisir par l'utilisateur. Ne traitez pas une demande d'œuvre nommée comme une autorisation de copier ses images, dialogues ou actifs promotionnels. Vérifiez les droits d'utilisation et ne fabriquez pas de chronologie d'intrigue exacte.
3. Construisez une interface utilisateur statique attrayante et adaptée à la Chine
Par défaut, utilisez Vite + React + TypeScript à partir du starter, avec base: '/' pour Cloudflare Pages. Préservez : vue une question à la fois, progression, retour, reprise, redémarrage, support clavier, téléphones 320px+, aperçu du lien de partage et export de carte de partage 3:4. Évitez les dépendances runtime sur Google Fonts, les CDN d'images distants, les scripts/SDKs tiers, les API outre-mer et les analyses côté client. Regroupez les actifs statiques ; utilisez une police de secours système sûre. Ne commettez jamais de clés et ne mettez pas de secrets d'API dans le code frontend. Rendez les résultats déterministes. Pas de paiement/codes par défaut.
4. Validez le fonctionnement et la conformité pour la Chine continentale
Exécutez, en ajustant les chemins :
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
Vérifiez ensuite manuellement l'introduction, le retour et l'avancement, l'actualisation/reprise, les multiples chemins de résultats, le partage PNG/URL, la disposition mobile et le contraste. Voir references/qa.md. Ne revendiquez aucun contrôle que vous n'avez pas exécuté. Ne revendiquez pas l'accessibilité en Chine continentale sans tests sur les réseaux réels de la Chine continentale.
5. 引导上线 — Publiez le code sur GitHub, déployez le site avec Cloudflare Pages
Après l'aperçu local, expliquez en langage clair que GitHub stocke le code et Cloudflare Pages rend le site accessible en ligne ; guidez les étapes du compte ou du tableau de bord lorsque les outils ne peuvent pas les effectuer. Respectez les demandes locales uniquement et ne demandez pas d'autorisation répétée là où elle a déjà été accordée. Suivez references/publishing.md. Route par défaut : référentiel GitHub séparé pour le site généré → Cloudflare Pages Connect to Git → Vite/React npm run build / dist / main de production → déployer → configurer un domaine personnalisé pour la promotion → tester HTTPS / le chargement depuis les réseaux de la Chine continentale avant de revendiquer la disponibilité. L'Action GitHub dans le starter ne fait que des vérifications ; l'intégration Git de Cloudflare gère le déploiement.
Si l'utilisateur souhaite publier la compétence elle-même sur GitHub, publiez ce référentiel de compétence multi-agent séparément. Ne créez jamais de comptes, n'achetez pas de domaines, ne connectez pas de référentiels, ne pushez pas ou ne déployez pas sans l'intention de l'utilisateur et une autorisation disponible. Si indisponible, donnez des commandes actionnables et des étapes de tableau de bord, pas une fausse revendication 'publiée'. Le plan standard global de Cloudflare Pages ne peut pas garantir l'accessibilité en Chine continentale ; si les tests échouent en raison d'une exigence stricte, recommandez des options d'hébergement conformes en Chine continentale / ICP selon le cas. Ne confondez pas le China Network Enterprise de Cloudflare avec les Pages gratuites.
Principe produit
AI 负责拓展创意的可能性,用户负责决定作品的独特性,AI 负责把决定变成现实。 Les choix créatifs appartiennent à l'utilisateur sauf délégation ; l'exécution technique de routine appartient à l'Agent. Une délégation étroite telle que "配色你来决定" ne s'applique qu'à cette décision, pas à toutes les étapes restantes.
Invariants principaux
- Algorithme précis avec des résultats atteignables et distinguables ; pas de résultat aléatoire sauf demande.
- Pas de fausse validité clinique ; pas de promesse générale d'accessibilité en Chine.
- Pas de backend, connexion, suivi, paiement, porte de code ou collecte sensible non sollicités.
- Le partage de code n'est pas un déploiement. Un nouveau site web de quiz doit avoir son propre référentiel et domaine.
- Les verrous de code frontend uniquement ne sont pas sécurisés. Si une porte de code d'accès est demandée, conseillez une vérification côté serveur et la gestion des résultats secrets ; gardez-la optionnelle.
- Suivez la marque, les visuels, les faits et les choix existants de l'utilisateur.
Exemples d'invocation
-
"Utilise quiz-site-builder et co-crée un test de survie de cour impériale avec moi, donne-moi d'abord quelques angles créatifs."
-
"Crée directement un test de survie de cour impériale original de 10 questions, aperçu local, pas de déploiement." (mode one-click)
-
"Utilise $quiz-site-builder pour m'aider à créer un test de personnalité de style chinois, analyse à six dimensions, personnalité d'objet, mobile, et déploiement sur Cloudflare Pages."
-
"Crée un test de survie de cour impériale original de 10 questions, fins alternatives, carte de résultat 3:4, publie sur GitHub puis déploiement automatique via Cloudflare."
-
"Aide-moi à préparer le site de test pour les utilisateurs en Chine continentale, sans dépendre de polices ou CDN étrangers, apprends-moi à lier un domaine personnalisé et à vérifier l'accès."
-
"Je n'ai pas besoin de paiement ou de code d'accès pour l'instant, dis-moi seulement comment étendre avec un code d'accès plus tard."
Règles d'exécution inter-agent
- Tous les chemins d'instruction comme
references/quiz-design.mdetassets/starter/sont relatifs au dossier contenant ceSKILL.md(<skill-root>), jamais à un répertoire Codex codé en dur. - Utilisez les opérations sur fichiers, les capacités shell et navigateur réellement offertes par l'agent hôte actuel ; ne supposez pas que
apply_patch, les outils Codex ou un serveur MCP particulier existent. Lorsqu'un outil est absent, fournissez des commandes portables ou des étapes manuelles et marquez clairement les étapes non terminées. - La source de vérité du projet est
skills/quiz-site-builder/. Ne dupliquez et ne forkez jamais la logique de la compétence dans des copies spécifiques au fournisseur. L'installation de l'adaptateur copie uniquement le même dossier. - L'invocation Codex peut utiliser
$quiz-site-builder; WorkBuddy, Claude Code, CodeBuddy Code et d'autres agents peuvent utiliser un sélecteur de compétence ou un langage ordinaire. N'exigez pas la syntaxe$en dehors de Codex. - Ne prétendez jamais qu'un agent prend en charge une fonctionnalité simplement parce qu'il importe la compétence. Confirmez l'accès local aux fichiers, Python, Node/npm, Git et la capacité de s'authentifier avant d'exécuter les étapes de déploiement.
- L'importation WorkBuddy utilise un zip avec une racine de dossier
quiz-site-builder/SKILL.md. WorkBuddy doit chargerreferences/,scripts/etassets/depuis ce dossier. Si le bac à sable hôte empêche d'exécuter des scripts, expliquez les limitations et générez quand même le code du site statique.
Contraintes de déploiement par hôte
Quel que soit l'agent : GitHub stocke le code source, Cloudflare Pages est la destination de déploiement par défaut ; utilisez l'intégration Git de Cloudflare là où l'utilisateur peut l'autoriser. L'architecture de code d'accès optionnelle est un guide uniquement ; n'ajoutez jamais silencieusement des paywalls, des paiements ou des vérifications frontend contenant des secrets. L'accès en Chine continentale nécessite des tests réels et ne peut pas être garanti par Cloudflare Pages standard ou des domaines personnalisés.