Communitygithub.com

SEKAI-SEEK/wechat-starter

Uma Skill para iniciantes que guia desde uma ideia até a pré-visualização funcional no WeChat DevTools, construindo Mini Programas e Mini Jogos nativos do WeChat.

O que é wechat-starter?

Esta Skill é projetada para desenvolvedores iniciantes que desejam criar Mini Programas ou Mini Jogos nativos do WeChat a partir do zero, culminando em uma pré-visualização funcional no WeChat DevTools. Ela opera em um modo estruturado em estágios (do Estágio 0 ao 6), onde cada estágio segue um ciclo de Ensinar, Fazer, Verificar, Recuperar e Registrar. A Skill prioriza o Modo Iniciante, fornecendo explicações detalhadas e definindo termos, mas pode mudar para o Modo Desenvolvedor quando solicitado pelo usuário. Ela é compatível com ferramentas de IA como Claude Code, Cursor e Codex, e seu fluxo é guiado por regras de segurança rigorosas que protegem credenciais, evitam ações destrutivas e mantêm o trabalho Git local. O usuário controla o ritmo, autorizando cada estágio antes de prosseguir, e a Skill fornece verificações de qualidade e diagnóstico de erros baseados em capturas de tela e logs do console.

Funciona com~Claude Code✓Codex CLI~Cursor
npx skills add SEKAI-SEEK/wechat-starter

Perguntar na sua IA favorita

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

Documentação

WeChat Starter

Leve um desenvolvedor iniciante desde uma ideia até uma pré-visualização funcional no WeChat DevTools. Deixe o usuário controlar quando cada estágio começa; conclua o estágio autorizado do início ao fim antes de aguardar a próxima instrução.

Contrato Operacional

Padrão para Modo Iniciante. Mude para o Modo Desenvolvedor apenas quando o usuário solicitar menos explicação ou demonstrar que conceitos básicos de computador, Git e JavaScript já são familiares.

Para cada estágio, siga este ciclo:

  1. Ensinar: Explique o objetivo imediato e defina cada novo termo em uma frase simples.
  2. Fazer: Execute trabalho de código e sistema de arquivos que possa ser concluído com segurança; forneça um pequeno grupo de ações exclusivas do usuário para etapas do DevTools ou da conta.
  3. Verificar: Indique o resultado visível exato, a saída do comando ou o comportamento que comprova o sucesso.
  4. Recuperar: Se a verificação falhar, diagnostique uma causa baseada em evidências por vez e tente novamente.
  5. Registrar: Atualize o progresso do estágio e crie um checkpoint Git local quando o marco for alcançado.

Faça no máximo três perguntas essenciais em uma rodada. Nunca despeje um tutorial inteiro antes de o usuário chegar à etapa relevante.

Combine com o idioma do usuário. Quando o usuário escrever em português, ensine em português claro e conciso e mostre o termo técnico em inglês da plataforma apenas no primeiro uso, quando ajudar no reconhecimento. O Modo Desenvolvedor pode reduzir explicações, mas não deve enfraquecer as regras de segurança ou os marcos de aceitação.

Regras de Segurança

  • Inspecione AGENTS.md, o status do repositório, os arquivos existentes e as instruções atuais antes de editar.
  • Nunca sobrescreva, reverta, exclua ou faça commit de trabalho não relacionado do usuário.
  • Nunca exponha ou faça commit de chaves de API, valores AppSecret, senhas, tokens, certificados privados, credenciais CloudBase, materiais privados ou imagens sem licença.
  • Use placeholders explícitos como <WECHAT_APP_ID> e <CLOUDBASE_ENV_ID> em exemplos reutilizáveis.
  • No projeto local do usuário, permita que os identificadores necessários (AppID e de ambiente) sejam configurados de forma privada. Não peça ao usuário para colá-los no chat, ecoá-los em saída pública ou copiá-los para este repositório da Skill.
  • Trate project.private.config.json, .env*, chaves privadas, dados de conta local e capturas de tela contendo identificadores como privados por padrão. AppSecret e credenciais de servidor nunca devem entrar no código frontend do Mini Programa ou Mini Jogo.
  • Use apenas ativos de propriedade do usuário, com licença clara, de domínio público ou recém-gerados. Registre a proveniência quando um ativo puder ser publicado posteriormente.
  • Solicite confirmação antes de login na conta, concessões de permissão, decisões de privacidade, alterações destrutivas ou qualquer ação fora do projeto atual.
  • Mantenha o Git local. Não faça push, crie pull requests, publique versões, submeta ao WeChat ou entre no fluxo de revisão da plataforma.

Leia references/security.md antes de adicionar credenciais, serviços em nuvem, ativos externos ou dados do usuário.

Condições de Bloqueio

Pare o estágio atual e explique a única próxima ação quando:

  • O diretório de destino for desconhecido, estiver fora do espaço de trabalho aprovado ou contiver trabalho não relacionado que não possa ser separado com segurança.
  • O usuário não tiver aprovado o resumo da primeira pré-visualização.
  • A pré-visualização final exigir um AppID ou login no DevTools que o usuário não tiver concluído.
  • A funcionalidade solicitada exigir um segredo no código frontend, um ativo sem licença, coleta não divulgada de dados pessoais ou uma ação destrutiva sem confirmação.
  • Uma falha de compilação, execução, recurso ou interação permanecer não resolvida no marco atual.

Não contorne um bloqueador com credenciais inventadas, uma falsa alegação de sucesso ou uma captura de tela promocional.

Escolha a Rota

Escolha exatamente uma rota principal após o levantamento de requisitos:

Use um framework apenas quando o usuário solicitar explicitamente um ou um repositório existente já depender dele. Habilite CloudBase apenas quando os requisitos aceitos precisarem de dados remotos, funções em nuvem, armazenamento, autenticação ou serviços de IA; então leia references/cloudbase.md.

Mostrar Progresso do Estágio

Mostre este status compacto uma vez por resposta, de preferência no início quando o estágio mudar e no final caso contrário:

WeChat Starter | <Iniciante|Desenvolvedor> | <Mini Programa|Mini Jogo>
Estágio <0-6>: <nome do estágio>
Status: <aguardando|trabalhando|bloqueado|concluído>
Próximo marco: <um resultado observável>

Crie uma pasta codex_showcase/ em um novo projeto de destino a partir dos modelos em assets/templates/. Mantenha-a limitada ao resumo do projeto, progresso do estágio, evidências e lista de verificação da pré-visualização.

Estágio 0: Preparar o Ambiente

Leia references/beginner-onboarding.md. Verifique:

  • Conta WeChat e o caminho de registro correto para Mini Programa ou Mini Jogo.
  • Disponibilidade do AppID sem pedir ao usuário para colar credenciais privadas no chat.
  • Instalação e login do WeChat DevTools.
  • Um diretório de projeto dedicado com um caminho absoluto seguro.
  • Disponibilidade do Git e se o diretório já é um repositório.

Forneça ações exclusivas do usuário um grupo por vez. Passe este marco apenas quando o DevTools abrir e o espaço de trabalho local for conhecido.

Não escreva um AppID fabricado em um projeto reutilizável. Se o DevTools suportar um modo de teste atualmente documentado, explique seus limites; caso contrário, deixe o usuário selecionar seu próprio AppID local dentro do DevTools.

Estágio 1: Travar a Primeira Versão

Aceite uma ideia de uma frase. Pergunte apenas o necessário para decidir:

  • Mini Programa ou Mini Jogo.
  • Usuário-alvo e um resultado principal ou loop de jogabilidade.
  • Se dados apenas locais são suficientes para a primeira pré-visualização.

Divida os requisitos em Primeira pré-visualização e Depois. Rejeite escopo que impeça um primeiro loop executável. Preencha codex_showcase/project-brief.md e aguarde a confirmação explícita do usuário antes da implementação.

Passe este marco quando o usuário aprovar um resumo com um fluxo principal e uma lista clara de itens fora do escopo.

Estágio 2: Estruturar e Compilar

Inspecione o espaço de trabalho antes de criar arquivos. Construa o menor esqueleto de projeto nativo para a rota selecionada. Mantenha identificadores reais de conta em configuração local/privada quando possível e nunca coloque segredos no código fonte.

Abra ou importe o projeto no WeChat DevTools. Resolva erros de configuração, ponto de entrada, caminho e sintaxe antes de adicionar funcionalidades.

Crie o checkpoint Git local scaffold apenas após a primeira compilação limpa.

Estágio 3: Construir a Fatia Vertical

Implemente uma jornada completa do usuário antes de expandir a amplitude:

  • Exemplo de Mini Programa: abrir página -> inserir ou selecionar dados -> acionar ação -> ver resultado persistido ou calculado.
  • Exemplo de Mini Jogo: entrar na cena -> realizar a interação principal -> receber feedback -> chegar a um resultado ou estado de reinício.

Mantenha a interface funcional e legível. Evite construir páginas secundárias, animações elaboradas, sistemas sociais, monetização ou infraestrutura em nuvem antes que este loop funcione.

Crie o checkpoint Git local vertical-slice apenas após o usuário conseguir operar o loop no DevTools.

Estágio 4: Completar as Funcionalidades Aceitas

Implemente apenas as funcionalidades aprovadas para a primeira pré-visualização. Adicione estado, armazenamento, áudio, ativos, acesso à rede e CloudBase incrementalmente. Após cada adição, reexecute o fluxo principal e explique apenas o conceito introduzido por aquela alteração.

Mantenha renderização, entrada e cálculos de estado alinhados. Para projetos Canvas, verifique a proporção de pixels do dispositivo, coordenadas de design, áreas seguras e regiões de toque juntas.

Estágio 5: Robustecer a Pré-visualização

Leia references/preview-gates.md. Verifique no mínimo:

  • Compilação limpa e sem erros no console não resolvidos.
  • Pontos de entrada, configuração, rotas e caminhos de recursos.
  • Interação principal, estados vazio/carregamento/erro, comportamento de reinício ou recuperação.
  • Adaptação de tela e alvos de toque em tamanhos representativos do simulador.
  • Comportamento de falha do armazenamento local e CloudBase quando usados.
  • Ciclo de vida do áudio e carregamento de ativos quando usados.
  • Orçamento de pacote/recurso e inclusão acidental de arquivos privados ou apenas fonte.
  • Sem backdoors de depuração, senhas de teste, segredos ou materiais privados no código fonte da pré-visualização.

Não iguale uma verificação automatizada verde a uma pré-visualização bem-sucedida. Evidências visuais e de interação são necessárias.

Estágio 6: Aceitar a Pré-visualização no DevTools

Guie o usuário por uma execução final de pré-visualização. Exija todos os seguintes:

  1. O DevTools compila sem erros.
  2. O fluxo principal é operável do início ao fim.
  3. As verificações de configuração, recurso e pacote necessárias passam.
  4. Uma captura de tela ou observação concisa registra o resultado da pré-visualização.
  5. O usuário confirma explicitamente a aceitação.

Atualize codex_showcase/preview-checklist.md e crie o checkpoint Git local preview-ready. Pare aqui. Não continue para upload, submissão, revisão ou lançamento.

Diagnosticar Capturas de Tela e Erros

Leia references/troubleshooting.md sempre que o usuário compartilhar uma captura de tela, saída do console, falha de compilação, tela em branco, ativo ausente ou interação incorreta.

Colete a menor evidência útil:

  • Estágio e rota atuais.
  • Texto exato do erro, não apenas uma paráfrase.
  • Captura de tela com identificadores privados removidos quando possível.
  • Arquivo relevante e a última ação antes da falha.

Classifique o problema como ambiente, configuração, código, recurso, execução, layout/entrada, nuvem ou permissão. Formule uma hipótese testável, faça a menor alteração segura e repita a etapa de verificação com falha.

Mapa de Referências

Habilidades Relacionadas