Communitygithub.com

Quiz Site Builder

Erstelle, verbessere oder betreibe mobile-first interaktive Quiz-Websites aus natürlicher Sprache: chinesische Persönlichkeits-/Charakter-Matches, Survival-/Geschichten, Stärkentests, Fragenkataloge, deterministische Bewertung, teilbare Ergebnisse, Validierung, GitHub-Quellcode-Veröffentlichung und Cloudflare-Pages-Bereitstellung. Nutze dies, wenn der Benutzer einen Online-Test oder ein Quiz erstellen möchte. Keine Zahlungs- oder Kartencodes standardmäßig.

Was ist Quiz Site Builder?

Dieses Skill ermöglicht die ko-kreative oder automatische Erstellung von interaktiven Quiz-Websites, die auf mobilen Geräten optimiert sind und über Cloudflare Pages bereitgestellt werden. Es unterstützt verschiedene Quiz-Typen wie Persönlichkeits-/Charakter-Matching, Survival-/Geschichten und Stärken-/Diagnose-Tests. Der Skill betont einen deterministischen Bewertungsmechanismus, validierte Ergebnisse und die gemeinsame Erstellung mit dem Benutzer in den Bereichen Konzept, Design und Inhalt. Technisch nutzt es die Skripte `assets/starter/`, `scripts/` und `references/`, um einen lokalen oder Cloudflare-basierten Workflow zu unterstützen, wobei die Quellen immer in GitHub gespeichert werden. Es vermeidet standardmäßig Paywalls, Kartencodes, externe APIs oder nicht-chinesisch-konforme Abhängigkeiten und stellt die Bereitschaft für den chinesischen Markt durch Skripte wie `audit_mainland_assets.py` sicher. Der Skill ist plattformunabhängig und arbeitet mit Agenten wie Codex, Claude Code, Cursor oder WorkBuddy zusammen, indem er portable Befehle und manuelle Schritte für die Dateibearbeitung und Bereitstellung verwendet.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/jinceci9-netizen/quiz-site-builder/tree/HEAD/skills/quiz-site-builder

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Quiz Site Builder — Portables Agenten-Skill

Gemeinsam mit dem Benutzer ein Quiz-Konzept entwickeln und dann das vereinbarte Design in eine gepflegte, getestete, Cloudflare-Pages-fertige Website umsetzen. Dieses Skill folgt dem anbieterneutralen Agenten-Skills-Ordnerformat; es erfordert niemals ein bestimmtes Agentenprodukt oder ein anbieterspezifisches Tool. Unterscheide immer die GitHub-Quellcode-Hosting von der Cloudflare-Website-Bereitstellung; das eigene Repository des Skills und jedes generierte Quiz-Website-Repository sind getrennt.

Zuerst lesen

  1. Überprüfe das Arbeitsverzeichnis des Benutzers, bevor du Dateien berührst. Überschreibe keine bestehenden Projekte, Dateien, Einstellungen oder Bereitstellungen.
  2. Schlage während der gemeinsamen Erstellung den Mechanismus vor, anstatt ihn stillschweigend zu reparieren; bestätige oder akzeptiere die Delegierung vor der vollständigen Implementierung:
    • Persönlichkeit / Charakter-Matching: Dimensionen → deterministischer Typ-/Charakter-Match; erkläre die Behandlung von Gleichständen.
    • Survival / interaktive Geschichte: geordnete Entscheidungen → verfolgte Zustandsvariablen und Kontrollpunkte → erreichbare Enden.
    • Diagnose / Stärken: natürliche Leichtigkeit + Belastungen + Spitzenerlebnisse → interpretierbare Stärken und Handlungen.
  3. Lies references/quiz-design.md für Fragen, Ergebnisse und Score-Balancing. Lies references/visual-and-copy.md für thematisches Schreiben und Design. Lies references/mainland-readiness.md, bevor du Schriftarten, Bilder oder Abhängigkeiten wählst. Lies references/qa.md, bevor du den Abschluss erklärst. Lies references/publishing.md für Cloudflare Pages über GitHub, wenn du zur Bereitstellung aufgefordert wirst.
  4. In der genehmigten Entwicklungsphase: Kopiere von Grund auf das vollständige assets/starter/ in ein neues Website-Verzeichnis; modifiziere niemals den wiederverwendbaren Starter direkt. Der Starter enthält 3 Beispiel-Quizze, eine typisierte Bewertungs-Engine, responsive Ansichten und die Möglichkeit, Ergebnisse zu teilen. Passe src/data/*.json an, bevor du Komponenten bearbeitest.
  5. Keine Paywall standardmäßig. Führe niemals Zahlungen, Kartencodes, Cloudflare Workers, Authentifizierung, D1 oder KV ein, es sei denn, der Benutzer fragt danach. Wenn Zugangscodes angefordert werden, lies references/access-codes-optional.md und führe den Benutzer durch eine sichere Architektur; implementiere sie nicht stillschweigend oder stelle abrechenbare Dienste bereit.

Standardmodus: 用户参与共创

Standardmäßig gemeinsame Erstellung, auch wenn die ursprüngliche Anfrage „制作网站“ lautet oder Entwicklungsschritte auflistet. Kläre zuerst die kreative Richtung; generiere nicht sofort einen vollständigen Fragenkatalog, kopiere den Starter oder baue die gesamte Website. Verwende bereits vom Benutzer gegebene Entscheidungen erneut, anstatt sie erneut zu fragen. Das Überprüfen vorhandener Dateien und das Vorbereiten begrenzter Vorschläge ist erlaubt.

Bewege dich in der Reihenfolge durch diese drei Phasen, normalerweise eine Phase pro Antwort. Jede Phase bietet konkrete Empfehlungen und stellt insgesamt höchstens 1–2 Schlüsselfragen; wiederhole keine bereits beantwortete Frage. Verwende auf jedem Agenten gewöhnlichen Chat; optionale Formulare dürfen niemals erforderlich sein.

  1. 探索创意 — Biete 2–3 bedeutungsvoll unterschiedliche Blickwinkel auf das Thema des Benutzers, jeweils mit Aufhänger, Zielgruppe und unterscheidendem Erlebnis. Bevorzuge eine unverwechselbare Spieler-Spannung und ein einprägsames, ehrlich teilbares Ergebnis, keine unbegründeten Behauptungen von Viralität. Wenn der Benutzer explizit eine andere Anzahl anfordert (z. B. fünf Ideen), erfülle dies anstatt 2–3 zu erzwingen. Empfehle einen und erkläre warum. Frage, welcher Blickwinkel entwickelt werden soll, mit höchstens einer zusätzlichen Frage, die das Konzept wesentlich verändert.
  2. 设计测试 — Präsentiere den vorgeschlagenen Algorithmus in einfacher Sprache (Zustände/Dimensionen, wie Entscheidungen sie beeinflussen, Kontrollpunkte/Gleichstände und wie Enden ausgewählt werden), Ergebnistypen und -unterschiede, plus 2–3 vollständige Beispielfragen mit Optionen und erklärten Kompromissen. Empfehle einen Mechanismus, der zum bestätigten Blickwinkel passt; frage, ob er übernommen oder der entscheidende Kompromiss geändert werden soll. Beispiele sind Vorschläge, nicht der vollständige Fragenkatalog.
  3. 确定风格 — Biete 2–3 konkrete visuelle Richtungen mit Palette, Typografie, Telefonablauf und 3:4-Sharing-Karten-Behandlung; empfehle eine. Zeige einen repräsentativen Ergebnisbericht-Entwurf mit Titel, Interpretation, Stärke, Kosten und Rat. Frage nach der visuellen Wahl und der endgültigen Genehmigung des konsolidierten Designs, höchstens zwei Fragen. Beginne nicht mit der vollständigen Entwicklung, bis der Benutzer das Design bestätigt oder die verbleibenden Entscheidungen explizit delegiert.

Am Ende jeder Phase, zeige eine prägnante 决策记录: bestätigte Entscheidungen, noch auf Bestätigung wartende KI-Empfehlungen und verbleibende Entscheidungen. Notiere delegierte/übersprungene Entscheidungen als „AI决定“ oder „跳过,采用建议“, niemals als eine vom Benutzer ausgewählte Präferenz. Führe diese Aufzeichnung im Chat fort; nach der Genehmigung speichere sie in docs/DESIGN.md der generierten Website. Wenn ein Benutzer eine Entscheidung überarbeitet, aktualisiere die Aufzeichnung und überprüfe nur wesentlich betroffene Vorschläge, nicht alle Phasen.

In jeder Phase kann der Benutzer revidieren, überspringen oder die KI entscheiden lassen. „跳过这一步“ delegiert nur diese Phase: notiere die empfohlene Voreinstellung und fahre mit der nächsten Phase fort. „你决定剩下的“ delegiert alle verbleibenden Entscheidungen: notiere kurz das ausgewählte Design und fahre mit der Implementierung fort. Stille oder verstrichene Zeit ist keine Genehmigung. Wenn eine Eingabe erforderlich ist, halte in der relevanten Phase an; behandle eine fehlende Antwort nicht als Erlaubnis zum Bauen.

One-Click-Modus / 一键生成

Wenn der Benutzer „直接做“, „一键生成“, „你来决定“ sagt oder explizit darum bittet, alle Design-Diskussionen zu überspringen und sofort zu bauen, wechsle für die aktuelle Anfrage in den One-Click-Modus. Gib die gewählten Voreinstellungen an und fahre autonom mit Inhalt, Logik, UI, Validierung und lokaler Vorschau fort, ohne die drei Gesprächsgates. Bestehende Benutzereinschränkungen gelten weiterhin. Der Benutzer kann jederzeit zur gemeinsamen Erstellung zurückwechseln. Eine klare vorherige Design-Genehmigung erlaubt ebenfalls eine autonome Entwicklung, ohne die Phasen zu wiederholen.

Die Design-Genehmigung oder der One-Click-Modus autorisiert die angeforderte Entwicklung und Fehlersuche, nicht unabhängige externe Aktionen. Behalte das angeforderte lokal-only-Grenze bei; GitHub-Veröffentlichung und Cloudflare-Bereitstellung erfordern weiterhin die Absicht des Benutzers und verfügbare Autorisierung.

End-to-End-Workflow

1. Die Idee des Benutzers in ein brauchbares Produkt-Lastenheft umwandeln

Im Co-Creation-Modus schließe die drei obigen Phasen ab und konsolidiere ihre Entscheidungsaufzeichnung vor der Implementierung. Im One-Click-Modus wähle und notiere kurz diese Voreinstellungen, ohne zu warten. Enthalte einen Ein-Satz-Aufhänger, Zielgruppe, Anzahl der Fragen (Standard ~10–16), Ergebnisklassen, Mechanismus, Kompromisse, Themen-/Farbrichtung, mobilen Ablauf und Idee für die Sharing-Karte. Wenn nicht anders angegeben, standardmäßig eine kostenlose, anonyme, statische Website mit lokal gespeichertem Fortschritt. Frage nicht erneut nach bestätigten Entscheidungen; im Co-Creation-Modus kennzeichne vorgeschlagene Voreinstellungen als solche, bis sie akzeptiert oder delegiert werden. Beschreibe Unterhaltungs-Persönlichkeitstests niemals als wissenschaftliche Diagnosen.

2. Nach Design-Genehmigung oder -Delegierung, schreibe Quiz-Inhalt und -Logik vor der UI

Stelle den vollständigen Fragenkatalog autonom zur Verfügung, keine Platzhalter-Beispiele, und implementiere/fehlersuche die genehmigte Website, ohne nach routinemäßigen technischen Entscheidungen zu fragen. Verwende narrative Fragen mit plausiblen, nicht offensichtlichen Optionen. Halte src/data/*.json als die kanonischen Quizdaten. Für jede Persönlichkeits-/Diagnoseoption, verweise nur auf deklarierte Achsen. Für Survival müssen danger und influence endliche ganzzahlige Zustandseffekte sein, Episoden geordnet und mehrere Enden realistisch erreichbar. Teste Pfade zu Fehlschlag und Erfolg; verhindere eine „immer sicherste Antwort wählen“-Ausbeutung. Für lizenzierte Medien / genannte Werke, trenne überprüfbare Handlungsfakten von erfundenen Situationen. Konsultiere zuverlässige Quellen oder vom Benutzer bereitgestellte Referenzen, bevor du eine tatsächliche Chronologie behauptest; falls nicht verfügbar, benenne die Lücke und schlage eine originale Alternative zur Auswahl durch den Benutzer vor. Behandle eine Anfrage für ein genanntes Werk nicht als Erlaubnis, dessen Bilder, Dialoge oder Werbemittel zu kopieren. Überprüfe Nutzungsrechte und erfinde keine exakte Handlungschronologie.

3. Attraktive, China-bewusste statische UI erstellen

Standardmäßig Vite + React + TypeScript aus dem Starter, mit base: '/' für Cloudflare Pages. Behalte bei: One-Question-at-a-Time-Ansicht, Fortschritt, Zurück, Fortsetzen, Neustart, Tastaturunterstützung, Telefone 320px+, Vorschau des Sharing-Links und 3:4-Sharing-Karten-Export. Vermeide Laufzeitabhängigkeiten von Google Fonts, Remote-Bild-CDN, Skripten/SDKs von Drittanbietern, Übersee-APIs und clientseitiger Analytik. Bündle statische Assets; verwende sicheres System-Font-Fallback. Committe niemals Schlüssel oder platziere API-Geheimnisse im Frontend-Code. Mache Ergebnisse deterministisch. Keine Zahlung/Codes standardmäßig.

4. Auf Funktion und China-Bereitschaft validieren

Ausführen, Pfade anpassen:

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

Dann manuell Intro, Vor und Zurück, Aktualisieren/Fortsetzen, mehrere Ergebnis-Pfade, Teilen PNG/URL, mobiles Layout und Kontrast überprüfen. Siehe references/qa.md. Behaupte keine Überprüfung, die du nicht durchgeführt hast. Behaupte keine Zugänglichkeit in China ohne Tests auf tatsächlichen chinesischen Netzwerken.

5. 引导上线 — Code auf GitHub veröffentlichen, Website mit Cloudflare Pages bereitstellen

Nach lokaler Vorschau erkläre in einfacher Sprache, dass GitHub Code speichert und Cloudflare Pages die Website online zugänglich macht; leite Konto- oder Dashboard-Schritte an, wenn Tools sie nicht ausführen können. Respektiere lokal-only-Anfragen und frage nicht erneut nach Autorisierung, wo sie bereits erteilt wurde. Folge references/publishing.md. Standard-Route: separates GitHub-Repository für die generierte Website → Cloudflare Pages Mit Git verbinden → Vite/React npm run build / dist / Produktion main → bereitstellen → eine benutzerdefinierte Domain zur Promotion einrichten → HTTPS testen / von chinesischen Netzwerken laden, bevor Bereitschaft behauptet wird. Die GitHub Action im Starter ist nur Checks; Cloudflares Git-Integration übernimmt die Bereitstellung.

Wenn der Benutzer das Skill selbst auf GitHub veröffentlichen möchte, veröffentliche dieses plattformübergreifende Agenten-Skill-Repository separat. Erstelle niemals Konten, kaufe Domains, verbinde Repositories, pushe oder stelle bereit ohne die Absicht des Benutzers und verfügbare Authentifizierung. Wenn nicht verfügbar, gib umsetzbare Befehle und Dashboard-Schritte, keine falsche 'veröffentlicht'-Behauptung. Der Standard-Global-Plan von Cloudflare Pages kann die Erreichbarkeit in China nicht garantieren; wenn das harte Kriterium fehlschlägt, empfehle konforme China-Hosting-Optionen / ICP falls angemessen. Verwechsle Cloudflares Enterprise China Network nicht mit kostenlosen Pages.

Produktprinzip

AI 负责拓展创意的可能性,用户负责决定作品的独特性,AI 负责把决定变成现实. Kreative Entscheidungen gehören dem Benutzer, sofern nicht delegiert; routinemäßige technische Ausführung gehört dem Agenten. Eine enge Delegierung wie „配色你来决定“ gilt nur für diese Entscheidung, nicht für alle verbleibenden Phasen.

Kerninvarianten

  • Genauer Algorithmus mit erreichbaren, unterscheidbaren Ergebnissen; kein zufälliges Ergebnis, sofern nicht angefordert.
  • Keine falsche klinische Validität; kein pauschales „China-zugänglich“-Versprechen.
  • Kein unaufgeforderter Backend, Login, Tracking, Zahlung, Code-Gate oder sensible Erfassung.
  • Code teilen ist nicht Bereitstellung. Neue Quiz-Website sollte eigenes Repository und Domain haben.
  • Frontend-only-Code-Sperren sind nicht sicher. Wenn Zugangscode-Gating angefordert wird, rate zu server-seitiger Verifizierung und Handhabung von geheimen Ergebnissen; halte es optional.
  • Folge dem vorhandenen Branding, den Visuals, Fakten und Entscheidungen des Benutzers.

Aufruffbeispiele

  • „用 quiz-site-builder 和我共创一个宫廷生存测试,先给我几个创意切口。“
  • „直接做一个10题原创宫廷生存测试,本地预览,不部署。“(一键生成)
  • „用 $quiz-site-builder 帮我做国风人格测试,六衡分析、器物人格、手机端,并部署到 Cloudflare Pages。“
  • „做10题原创宫廷生存测试,分支结局、3:4结果卡,发布到 GitHub 后由 Cloudflare 自动上线。“
  • „帮我把测试网站准备给国内用户用,不依赖国外字体或 CDN,教我绑定自定义域名并检查访问。“
  • „我暂时不需要收费或卡密,只告诉我之后怎么扩展卡密。“

Plattformübergreifende Ausführungsregeln

  • Alle Anweisungspfade wie references/quiz-design.md und assets/starter/ sind relativ zum Ordner, der diese SKILL.md enthält (<skill-root>), niemals zu einem fest codierten Codex-Verzeichnis.
  • Verwende die Dateioperationen, Shell- und Browser-Fähigkeiten die tatsächlich vom aktuellen Host-Agenten angeboten werden; gehe nicht davon aus, dass apply_patch, Codex-Tools oder ein bestimmter MCP-Server existieren. Wenn ein Tool fehlt, stelle portable Befehle oder manuelle Schritte bereit und markiere unfertige Schritte deutlich.
  • Die Source-of-Truth des Projekts ist skills/quiz-site-builder/. Verdopple oder forke niemals die Skill-Logik in anbieterspezifische Kopien. Die Adapter-Installation kopiert nur denselben Ordner.
  • Codex-Aufruf kann $quiz-site-builder verwenden; WorkBuddy, Claude Code, CodeBuddy Code und andere Agenten können eine Skill-Auswahl oder gewöhnliche Sprache verwenden. Erfordere die $-Syntax nicht außerhalb von Codex.
  • Behaupte niemals, dass ein Agent eine Funktion unterstützt, nur weil er das Skill importiert. Bestätige lokalen Dateizugriff, Python, Node/npm, Git und die Fähigkeit zur Authentifizierung, bevor du Bereitstellungsschritte ausführst.
  • WorkBuddy-Import verwendet ein Zip mit einem quiz-site-builder/SKILL.md-Ordnerstamm. WorkBuddy sollte references/, scripts/ und assets/ aus diesem Ordner laden. Wenn die Host-Sandbox das Ausführen von Skripten verhindert, erkläre die Einschränkungen und generiere trotzdem den statischen Site-Code.

Bereitstellungsbeschränkungen nach Host

Unabhängig vom Agenten: GitHub speichert Quelle, Cloudflare Pages ist das Standard-Bereitstellungsziel; verwende Cloudflare Git-Integration, wo der Benutzer sie autorisieren kann. Die optionale Karten-Code-Architektur ist nur eine Anleitung; füge niemals stillschweigend Paywalls, Zahlung oder geheimnisenthaltende Frontend-Prüfungen hinzu. Zugang zu Festlandchina erfordert reale Tests und kann nicht durch standardmäßige Cloudflare Pages oder benutzerdefinierte Domains garantiert werden.

Verwandte Skills