Fichas de Apoio para Expressão Presencial
As fichas de apoio são a interface cognitiva do momento presencial, não um roteiro com letras reduzidas. Este Skill primeiro organiza a tarefa de apresentação e depois gera conjuntos de fichas rastreáveis com ferramentas locais originais; ele não realiza revisão científica nem gera arquivos Word.
Sintaxe das Fichas
Cada ficha define cinco itens, mapeados para campos JSON:
- Ponto de gatilho: quando virar para esta ficha, inserido em
titleou no início do corpo. - Discurso central: conteúdo obrigatório a ser dito ao vivo, inserido em
body. - Âncora de evidência: fontes, dados ou limites que precisam ser verificados, inserido em
source. - Ação de fala: pausa, pergunta, demonstração ou dica de transição, inserido em
notes. - Responsável: um ou mais papéis reais, inserido em
speaker; não adivinhe a divisão com base em nome ou gênero.
As fichas de pergunta podem colocar os pontos esperados da resposta no notes da versão do professor; ao gerar a versão do aluno, remova as respostas da cópia de entrada. notes é impresso e não é uma anotação oculta.
Fluxo de Geração
- Primeiro, confirme o cenário, o(s) falante(s), o tamanho da ficha, a distância de uso e o formato de saída. Conclusões científicas, dados experimentais, aprovações de competições e endossos de pessoas devem ser verificados antes da criação das fichas.
- Crie a estrutura a partir do modelo em branco, preencha conforme o guia de operação; o exemplo de simulação didática serve apenas como referência de formato.
- Execute
scripts/cue_cards.py. O modo HTML usa apenas a biblioteca padrão do Python; o PDF requer ReportLab e uma fonte TrueType fornecida pelo usuário, com permissão de incorporação e que cubra os caracteres chineses necessários. - Verifique o conjunto total, os subconjuntos de cada falante, a atribuição de fichas compartilhadas, os números das fichas, a ordem de continuação, o índice completo das fontes e se os caracteres do corpo estão completos.
- No PDF, verifique a renderização página por página; no HTML, use a visualização de impressão do navegador alvo. Registre o meio já validado; não considere a visualização em tela como equivalente à aceitação de impressão real.
Contrato de Formatação
- Padrão: uma ficha por página, 150×100 mm. Corpo em 13pt; tamanho e fonte podem ser ajustados na linha de comando.
- Conteúdo longo deve ser continuado preferencialmente em finais de frase ou quebras de linha; se não couber completamente, continue dividindo as fichas sem silenciosamente cortar caracteres.
- O conjunto total e os subconjuntos compartilham números de ficha estáveis; fichas compartilhadas por múltiplas pessoas entram no subconjunto de cada responsável.
- Cada página exibe a fonte; fontes muito longas apontam para o
index.htmldo pacote, e o valor completo é mantido tanto no JSON do índice quanto no HTML. - Retorne erro se faltar caracteres na fonte, o título não couber, o JSON for inválido ou o diretório de saída já existir. O programa não exclui nem substitui silenciosamente resultados antigos.
O modelo de entrada não armazena fórmulas, gráficos científicos, imagens ou rich text. Se a tarefa exigir conversão fiel desses itens, use ferramentas de documento ou apresentação. Esta ferramenta lê apenas JSON local, não acessa URLs nele contidas nem executa comandos no corpo.
Para uma primeira leitura, veja a introdução; métodos de ensaio e avaliação estão no guia didático. Ao fazer a transição para uma plataforma de curso ou módulo de vídeo, mantenha números de ficha estáveis e âncoras de fonte para que a expressão presencial possa ser rastreada até o conteúdo original.