Communitygithub.com

Alessiawondering/ielts-learning-studio-skill

Habilidade reutilizável para Codex que cria um estúdio de aprendizado IELTS personalizado a partir de materiais do Google Drive.

O que é ielts-learning-studio-skill?

Esta skill permite que agentes de IA (como Codex) construam um estúdio de aprendizado IELTS completo e personalizado para um aluno específico, utilizando materiais fornecidos via Google Drive, uploads locais ou texto colado. Ela prioriza a privacidade e a configuração do aluno, nunca copiando dados de outros aprendizes. A skill implementa um pipeline de ingestão inteligente que processa documentos (DOCX, PDF, texto) para extrair pontos de aprendizado (vocabulário, colocações, gramática), padroniza-os linguisticamente e os enriquece com significados em chinês, exemplos, pronúncias e categorias IELTS. Além disso, constrói um ambiente de aprendizado completo com caderno de estudo, flashcards, teste com dicas, bloco de erros, favoritos e arquivamento diário/temático, persistindo o progresso localmente por padrão, mas suportando persistência em servidor quando solicitado. A implementação deve seguir um contrato de produto e guias de personalização e privacidade, validando comportamentos por meio de testes de aceitação.

Funciona com~Claude Code✓Codex CLI~Cursor
npx skills add Alessiawondering/ielts-learning-studio-skill

Perguntar na sua IA favorita

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

Documentação

Construir Estúdio de Aprendizado IELTS

Crie um site de aprendizado completo e utilizável para o aluno atual. Trate qualquer site IELTS existente apenas como uma referência comportamental. Nunca copie a URL do Drive, documentos, datas, tópicos, pontos salvos, favoritos, erros ou identidade de implantação de outro aluno.

Comece com o Aluno

Reúna apenas as decisões faltantes, em um grupo de no máximo três perguntas:

  1. Pergunte pela URL da pasta do Google Drive do aluno ou se prefere começar com uploads locais/colagem manual.
  2. Confirme as categorias de aprendizado e os modos habilitados. Padrão: Listening, Reading, Speaking, Writing, anotações, flashcards, teste Chinês-Inglês, favoritos e um caderno de erros.
  3. Confirme as expectativas de armazenamento: persistência local no dispositivo por padrão, ou persistência autenticada entre dispositivos quando explicitamente solicitada.

Proceda imediatamente quando a solicitação já responder a essas perguntas. Não exija documentos de amostra antes de produzir uma primeira tela funcional.

Leia product-contract.md antes da implementação. Leia customization-and-privacy.md ao configurar Drive, persistência, compartilhamento ou implantação. Use acceptance-tests.md para verificação final.

Fluxo de Trabalho de Construção

  1. Inspecione o espaço de trabalho e preserve suas convenções de framework e design. Quando .openai/hosting.json existir, use o fluxo de trabalho de construção e hospedagem do Sites.
  2. Crie uma configuração de primeira execução que armazene a URL da pasta e as preferências deste aluno. Não codifique os valores de um aluno de referência como padrões.
  3. Implemente o pipeline de ingestão antes de poluir a UI secundária:
    • liste os arquivos suportados da pasta do Drive do aluno;
    • analise realces amarelos e revisões controladas de DOCX sem limite de contagem;
    • extraia vocabulário de planilhas de PDFs;
    • extraia linguagem valiosa de texto comum quando não houver realce ou correção;
    • crie impressões digitais dos arquivos para que adições, edições e exclusões atualizem o site de forma limpa.
  4. Padronize cada ponto extraído antes de chegar a anotações, cartões ou testes:
    • use uma forma de lema ou dicionário reutilizável;
    • use substantivos no singular, a menos que o plural seja gramaticalmente exigido;
    • preserve particípios passivos como be accompanied by;
    • preserve gerúndios exigidos como prevent someone from doing something;
    • mantenha preposições dependentes e colocações completas juntas;
    • divida uma frase contendo várias palavras ou colocações aprendíveis em pontos separados;
    • exclua nomes, detritos de formatação e correções de baixo valor.
  5. Enriqueça cada ponto aceito com um significado chinês preciso, uso, exemplo, pronúncia, colocações, frase de origem, data, tópico e uma ou mais categorias IELTS. Nunca mostre explicações placeholder quando o enriquecimento falhar; tente novamente ou marque o item para revisão.
  6. Mantenha um ponto de conhecimento lógico quando a mesma expressão aparecer em várias categorias, mas exiba-o em todas as categorias aplicáveis.
  7. Construa o ciclo completo de aprendizado: caderno, cartões de estudo, reprodução de fala, favoritos, testes com escopo, dicas, revelação após três erros, caderno de erros persistente e arquivamento diário/temático.
  8. Persista o estado do aluno. O armazenamento local do dispositivo deve sobreviver a recarregamentos e saída do navegador. Use persistência de servidor apenas quando o usuário solicitar comportamento baseado em conta ou entre dispositivos.
  9. Valide os comportamentos em acceptance-tests.md, construa com sucesso e publique de forma privada, a menos que o aluno escolha explicitamente outro modelo de acesso.

Regras de Adaptação

  • Permita que o aluno altere rótulos, categorias habilitadas, convenções de nomenclatura de temas, escopos de teste e direção visual sem enfraquecer a correção da extração.
  • Infira data, tópico e categoria a partir de nomes de arquivos e cabeçalhos de documentos. Forneça alternativas editáveis quando a inferência for ambígua.
  • Prefira uma interface silenciosa e focada no trabalho, adequada para repetição diária. Mantenha controles compactos e responsivos; não transforme o produto em uma página de marketing.
  • Quando o aluno ainda não tiver uma pasta do Drive, mantenha uploads e texto colado totalmente funcionais e torne a conexão com o Drive uma etapa opcional posterior.
  • Explique honestamente a limitação do link público. Um MVP de pasta pública do Drive não é equivalente ao acesso OAuth privado.

Padrão de Conclusão

Termine com a URL do site independente do aluno e um resumo conciso das capacidades habilitadas. Declare claramente qualquer integração indisponível. Não exponha credenciais de origem, IDs de projeto internos, dados de alunos de referência ou detalhes internos de implantação.

Habilidades Relacionadas