Communitygithub.com

Construtor de Sites de Quiz

Crie, melhore ou implante websites interativos de quiz com design mobile-first a partir de linguagem natural: testes de personalidade/combinação de personagens chineses, sobrevivência/história, testes de pontos fortes, bancos de perguntas, pontuação determinística, resultados compartilháveis, validação, publicação no GitHub e implantação no Cloudflare Pages. Use quando o usuário quiser construir um teste ou quiz online. Sem cobrança ou códigos de cartão por padrão.

O que é Construtor de Sites de Quiz?

O Construtor de Sites de Quiz é uma habilidade de agente portátil e neutra em relação a fornecedores, projetada para co-criar, desenvolver e implantar websites de quiz interativos com foco em dispositivos móveis. Ela permite que o usuário descreva a ideia do quiz em linguagem natural e então a guia por um processo estruturado de três etapas: exploração criativa, design do teste e definição visual, ou alterna para um modo de um clique para construção autônoma. A habilidade gera um site estático completo usando Vite + React + TypeScript, com um mecanismo de pontuação determinística, suporte a resultados compartilháveis (cartão 3:4) e validação rigorosa para prontidão para o mercado da China continental (sem fontes ou CDNs estrangeiros). O fluxo de trabalho final inclui a publicação do código-fonte em um repositório GitHub separado e a implantação automática no Cloudflare Pages via integração Git, sem adicionar paywalls, backends ou rastreamento por padrão. A habilidade é adequada para agentes como Codex, Claude Code e WorkBuddy, e enfatiza que as escolhas criativas pertencem ao usuário, a menos que sejam delegadas, enquanto a execução técnica de rotina é responsabilidade do agente.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Construtor de Sites de Quiz — Habilidade de Agente Portátil

Co-crie um conceito de quiz com o usuário e transforme o design acordado em um site polido, testado e pronto para Cloudflare Pages. Esta Habilidade segue o formato de pasta de Habilidades de Agente neutro em relação a fornecedores; nunca exija um produto de Agente específico ou ferramenta específica de fornecedor. Sempre distinga a hospedagem do código-fonte no GitHub da implantação do site no Cloudflare Pages; o repositório da própria Habilidade e o repositório de cada site de quiz gerado são distintos.

Leia isto primeiro

  1. Inspecione o diretório de trabalho do usuário antes de tocar em arquivos. Não sobrescreva projetos, arquivos, configurações ou implantações existentes.
  2. Durante a cocriação, proponha em vez de corrigir silenciosamente o mecanismo; confirme ou aceite a delegação antes da implementação completa:
    • combinação de personalidade / personagem: dimensões → combinação determinística de tipo/personagem; explique o tratamento de empates.
    • sobrevivência / história interativa: decisões ordenadas → variáveis de estado rastreadas e checkpoints → finais alcançáveis.
    • diagnóstico / pontos fortes: facilidade natural + drenos + experiências de pico → pontos fortes e ações interpretáveis.
  3. Leia references/quiz-design.md para perguntas, resultados e balanceamento de pontuação. Leia references/visual-and-copy.md para redação temática e design. Leia references/mainland-readiness.md antes de escolher fontes, imagens ou dependências. Leia references/qa.md antes de declarar a conclusão. Leia references/publishing.md para Cloudflare Pages via GitHub quando solicitado a implantar.
  4. No estágio de desenvolvimento aprovado, começando do zero: copie o assets/starter/ completo para um novo diretório do site; nunca modifique o starter reutilizável diretamente. O starter inclui 3 quizzes de exemplo, um mecanismo de pontuação tipado, visualizações responsivas e compartilhamento de resultados. Personalize src/data/*.json antes de editar componentes.
  5. Sem paywall por padrão. Nunca introduza pagamento, códigos de cartão, Cloudflare Workers, autenticação, D1 ou KV a menos que o usuário peça. Se códigos de acesso forem solicitados, leia references/access-codes-optional.md e guie o usuário por uma arquitetura segura; não implemente silenciosamente ou implante serviços cobráveis.

Modo padrão: 用户参与共创

Padrão para cocriação, mesmo quando a solicitação inicial diz "制作网站" ou lista tarefas de desenvolvimento. Primeiro esclareça a direção criativa; não gere imediatamente um banco de perguntas completo, copie o starter ou construa o site inteiro. Reutilize escolhas já fornecidas pelo usuário em vez de perguntá-las novamente. Inspecionar arquivos existentes e preparar propostas limitadas é permitido.

Percorra estes três estágios em ordem, normalmente um estágio por resposta. Cada estágio oferece recomendações concretas e faz no máximo 1–2 perguntas-chave no total; não repita uma pergunta já respondida. Use chat comum em todos os Agentes; formulários opcionais nunca devem ser obrigatórios.

  1. 探索创意 — Ofereça 2–3 ângulos significativamente diferentes sobre o tópico do usuário, cada um com um gancho, público e experiência diferenciadora. Favoreça uma tensão distintiva para o jogador e um resultado memorável e honestamente compartilhável, não afirmações não fundamentadas de viralidade. Se o usuário solicitar explicitamente um número diferente (por exemplo, cinco ideias), atenda em vez de forçar 2–3. Recomende um e explique o porquê. Pergunte qual ângulo desenvolver, com no máximo uma pergunta adicional que modifique materialmente o conceito.
  2. 设计测试 — Apresente o algoritmo proposto em linguagem simples (estado/dimensões, como as escolhas os afetam, checkpoints/empates e como os finais são selecionados), tipos de resultados e diferenças, além de 2–3 perguntas de amostra completas com opções e tradeoffs explicados. Recomende um mecanismo que se ajuste ao ângulo confirmado; pergunte se deve adotá-lo ou alterar o principal tradeoff. As amostras são propostas, não o banco completo.
  3. 确定风格 — Ofereça 2–3 direções visuais concretas com paleta, tipografia, fluxo no telefone e tratamento do cartão de compartilhamento 3:4; recomende uma. Mostre um rascunho representativo do relatório de resultado incluindo título, interpretação, ponto forte, custo e conselho. Peça a escolha visual e aprovação final do design consolidado, no máximo duas perguntas. Não comece o desenvolvimento completo até que o usuário confirme o design ou delegue explicitamente as decisões restantes.

Ao final de cada estágio, exiba um conciso 决策记录: escolhas confirmadas, recomendações de IA ainda aguardando confirmação e decisões restantes. Registre escolhas delegadas/puladas como "AI决定" ou "跳过,采用建议", nunca como uma preferência selecionada pelo usuário. Carregue este registro adiante no chat; após a aprovação, salve-o em docs/DESIGN.md do site gerado. Quando um usuário revisar uma decisão, atualize o registro e revise apenas as propostas materialmente afetadas, não todos os estágios.

Em cada estágio, o usuário pode revisar, pular ou pedir à IA para decidir. “跳过这一步” delega apenas aquele estágio: registre o padrão recomendado e prossiga para o próximo estágio. “你决定剩下的” delega todas as escolhas restantes: registre brevemente o design selecionado e continue para a implementação. Silêncio ou tempo decorrido não é aprovação. Quando a entrada for necessária, pare no estágio relevante; não trate uma resposta ausente como permissão para construir.

Modo de um clique / 一键生成

Quando o usuário disser “直接做”, “一键生成”, “你来决定”, ou pedir explicitamente para pular toda a discussão de design e construir imediatamente, mude para o modo de um clique para a solicitação atual. Declare os padrões escolhidos e prossiga autonomamente através do conteúdo, lógica, UI, validação e visualização local sem as três etapas de conversação. As restrições existentes do usuário ainda se aplicam. O usuário pode voltar ao modo de cocriação a qualquer momento. Uma aprovação de design anterior clara também autoriza o desenvolvimento autônomo sem repetir as etapas.

A aprovação do design ou o modo de um clique autoriza o desenvolvimento e a depuração solicitados, não ações externas não relacionadas. Preserve o limite local solicitado; a publicação no GitHub e a implantação no Cloudflare ainda exigem intenção do usuário e autorização disponível.

Fluxo de trabalho ponta a ponta

1. Converta a ideia do usuário em uma especificação de produto utilizável

No modo de cocriação, complete as três etapas acima e consolide o registro de decisões antes da implementação. No modo de um clique, escolha e declare brevemente esses padrões sem esperar. Inclua gancho de uma frase, público, número de perguntas (padrão ~10–16), classes de resultado, mecanismo, tradeoffs, direção de tema/cor, fluxo mobile e ideia do cartão de compartilhamento. Se não especificado, o padrão é um site estático, anônimo, gratuito com progresso salvo localmente. Não pergunte novamente sobre escolhas confirmadas; no modo de cocriação, rotule os padrões propostos até serem aceitos ou delegados. Nunca descreva testes de personalidade de entretenimento como diagnósticos científicos.

2. Após a aprovação do design ou delegação, escreva o conteúdo e a lógica do quiz antes da UI

Forneça autonomamente o banco completo, não amostras de espaço reservado, e implemente/depure o site aprovado sem perguntar sobre decisões técnicas rotineiras. Use perguntas narrativas com opções plausíveis não óbvias. Mantenha src/data/*.json como os dados canônicos do quiz. Para cada opção de personalidade/diagnóstico, referencie apenas os eixos declarados. Para sobrevivência, danger e influence devem ser efeitos de estado inteiros finitos, episódios ordenados e múltiplos finais realisticamente alcançáveis. Teste caminhos para falha e sucesso; evite uma exploração de 'sempre escolher a resposta mais segura'. Para mídia licenciada / obras nomeadas, separe fatos verificáveis do enredo de situações inventadas. Consulte fontes confiáveis ou referências fornecidas pelo usuário antes de reivindicar cronologia real; se indisponível, declare a lacuna e proponha uma alternativa original para o usuário escolher. Não trate uma solicitação de uma obra nomeada como permissão para copiar suas imagens, diálogos ou ativos promocionais. Verifique os direitos de uso e não invente cronologia exata do enredo.

3. Construa uma UI estática atrativa e consciente da China

Padrão para Vite + React + TypeScript a partir do starter, com base: '/' para Cloudflare Pages. Preserve: visualização de uma pergunta por vez, progresso, voltar, retomar, reiniciar, suporte a teclado, telefones 320px+, visualização de link de compartilhamento e exportação de cartão de compartilhamento 3:4. Evite dependências de tempo de execução de Google Fonts, CDNs de imagens remotas, scripts/SDKs de terceiros, APIs estrangeiras e análise do lado do cliente. Agrupe ativos estáticos; use fallback seguro de fontes do sistema. Nunca confirme chaves ou coloque segredos de API no código frontend. Torne os resultados determinísticos. Sem pagamento/códigos por padrão.

4. Valide para funcionalidade e prontidão para o continente

Execute, ajustando caminhos:

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

Em seguida, verifique manualmente a introdução, voltar e avançar, atualizar/retomar, múltiplos caminhos de resultado, compartilhar PNG/URL, layout mobile e contraste. Veja references/qa.md. Não reivindique nenhuma verificação que você não executou. Não reivindique acessibilidade no continente sem testes em redes reais do continente.

5. 引导上线 — Publique o código no GitHub, implante o site com Cloudflare Pages

Após a visualização local, explique em linguagem simples que o GitHub armazena código e o Cloudflare Pages torna o site acessível online; guie as etapas de conta ou painel quando as ferramentas não puderem fazê-lo. Respeite solicitações somente locais e não peça autorização repetida onde já foi concedida. Siga references/publishing.md. Rota padrão: repositório GitHub separado para o site gerado → Cloudflare Pages Connect to Git → Vite/React npm run build / dist / produção main → implantar → configurar um domínio personalizado para promoção → testar HTTPS / carregar de redes do continente antes de reivindicar prontidão. A GitHub Action no starter é apenas verificações; a integração Git do Cloudflare lida com a implantação.

Se o usuário quiser publicar a própria Habilidade no GitHub, publique este repositório de Habilidade entre Agentes separadamente. Nunca crie contas, compre domínios, conecte repositórios, faça push ou implante sem intenção do usuário e autenticação disponível. Se indisponível, forneça comandos acionáveis e etapas do painel, não uma reivindicação falsa de 'publicado'. O plano global padrão do Cloudflare Pages não pode garantir acessibilidade na China continental; se o requisito estrito falhar nos testes, recomende opções de hospedagem compatíveis com o continente / ICP conforme apropriado. Não confunda o Cloudflare Enterprise China Network com o Pages gratuito.

Princípio do produto

AI 负责拓展创意的可能性,用户负责决定作品的独特性,AI 负责把决定变成现实。 As escolhas criativas pertencem ao usuário, a menos que sejam delegadas; a execução técnica de rotina pertence ao Agente. Uma delegação restrita como “配色你来决定” aplica-se apenas a essa decisão, não a todas as etapas restantes.

Invariantes centrais

  • Algoritmo preciso com resultados alcançáveis e distinguíveis; nenhum resultado aleatório a menos que solicitado.
  • Nenhuma validade clínica falsa; nenhuma promessa genérica de 'acessível na China'.
  • Sem backend, login, rastreamento, pagamento, bloqueio de código ou coleta sensível não solicitados.
  • Compartilhamento de código não é implantação. O novo site de quiz deve ter seu próprio repositório e domínio.
  • Bloqueios de código apenas no frontend não são seguros. Se o bloqueio por código de acesso for solicitado, aconselhe verificação no lado do servidor e tratamento de resultados secretos; mantenha-o opcional.
  • Siga a marca, visuais, fatos e escolhas existentes do usuário.

Exemplos de invocação

  • “用 quiz-site-builder 和我共创一个宫廷生存测试,先给我几个创意切口。”

  • “直接做一个10题原创宫廷生存测试,本地预览,不部署。”(一键生成)

  • “用 $quiz-site-builder 帮我做国风人格测试,六衡分析、器物人格、手机端,并部署到 Cloudflare Pages。”

  • “做10题原创宫廷生存测试,分支结局、3:4结果卡,发布到 GitHub 后由 Cloudflare 自动上线。”

  • “帮我把测试网站准备给国内用户用,不依赖国外字体或 CDN,教我绑定自定义域名并检查访问。”

  • “我暂时不需要收费或卡密,只告诉我之后怎么扩展卡密。”

Regras de execução entre agentes

  • Todos os caminhos instrucionais como references/quiz-design.md e assets/starter/ são relativos à pasta que contém este SKILL.md (<skill-root>), nunca a um diretório fixo do Codex.
  • Use as operações de arquivo, shell e capacidades do navegador realmente oferecidas pelo agente host atual; não presuma que apply_patch, ferramentas Codex ou um servidor MCP específico existam. Quando uma ferramenta estiver ausente, forneça comandos portáteis ou etapas manuais e marque claramente as etapas não concluídas.
  • A fonte de verdade do projeto é skills/quiz-site-builder/. Nunca duplique ou bifurque a lógica da habilidade em cópias específicas do fornecedor. A instalação do adaptador apenas copia a mesma pasta.
  • A invocação pelo Codex pode usar $quiz-site-builder; WorkBuddy, Claude Code, CodeBuddy Code e outros agentes podem usar um seletor de habilidades ou linguagem comum. Não exija a sintaxe $ fora do Codex.
  • Nunca reivindique que um agente suporta um recurso simplesmente porque importou a Habilidade. Confirme o acesso a arquivos locais, Python, Node/npm, Git e capacidade de autenticar antes de executar etapas de implantação.
  • A importação pelo WorkBuddy usa um zip com uma raiz de pasta quiz-site-builder/SKILL.md. O WorkBuddy deve carregar references/, scripts/, e assets/ dessa pasta. Se o sandbox do host impedir a execução de scripts, explique as limitações e ainda assim gere o código do site estático.

Restrições de implantação por host

Independentemente do agente: o GitHub armazena o código-fonte, o Cloudflare Pages é o destino de implantação padrão; use a integração Git do Cloudflare onde o usuário puder autorizá-la. A arquitetura opcional de código de cartão é apenas orientação; nunca adicione silenciosamente paywalls, pagamento ou verificações de frontend contendo segredos. O acesso na China continental requer testes no mundo real e não pode ser garantido pelo Cloudflare Pages padrão ou domínios personalizados.

Habilidades Relacionadas