Stick scene
Um palito no estilo tinta-e-manteiga de Kamran faz um trabalho que mostra o que um produto faz. A cena fica ociosa (respira, olha, coça o queixo) e executa uma ação de 5 a 8 segundos quando acionada, depois retorna ao estado de repouso. É um único <canvas> dentro de um elemento <stick-scene>, sem dependências.
Tudo aqui é comprovado em ~90 cenas em kamranahmed.info/story. Comece a partir desses padrões; não invente um novo estilo de desenho.
Arquivos
runtime/stick.js: todo o runtime. A estrutura (figura, poses, easing, caneta), um kit de adereços, o palco e o elemento<stick-scene>. Copie-o para a pasta estática do projeto sem modificações.templates/scene.js: o ponto de partida para uma nova cena.templates/preview.html+scripts/frames.mjs: renderiza uma cena congelada em momentos escolhidos em uma folha de contato e relata erros.scripts/motion.mjs: percorre uma cena a 60 qps e relata falhas que um quadro congelado pode esconder: articulações que estalam, um braço através do rosto, um adereço desenhado sobre a cabeça, um cotovelo dobrado para o lado errado ou projetado para trás, uma virada esmagada, pés deslizando, uma mão que não alcança, e um salto onde a ação começa ou termina.references/craft.md: folha de dicas da API, livro de receitas de poses, receita de temporização, receitas de adereços, catálogo de metáforas e os erros já cometidos uma vez. Leia-o antes de escrever uma cena.examples/: cenas reais.diffity-review.js(comentário → correção do agente → aprovar, duas figuras, um quadro e uma mesa) é o exemplo completo mais limpo.scenes-p3.jsescenes-p4.jscontêm ~30 mais; o catálogo de metáforas em craft.md diz qual é qual.
Fluxo de trabalho
- Entenda o produto. Uma linha cada: o que o usuário faz, o que ele obtém. Leia a landing page ou README, se houver.
- Sugira 2 a 3 metáforas e deixe o usuário escolher, a menos que ele tenha dito para ir em frente. Uma linha por ideia: o adereço, a ação, o resultado. Uma boa é física (alavanca, carimbo, esteira, quadro de avisos, trilho de quadros, pilha de caixas), lê-se em um relance sem a legenda e termina em um resultado visível (um visto, um carimbo, algo subindo ou acendendo). Veja o catálogo em craft.md.
- Escreva a cena a partir de
templates/scene.js. Primeiro, organize os adereços em coordenadas mundiais fixas, depois a ociosidade, depois a ação como uma linha do tempo ao longo deTsegundos. Dê aolabeluma frase simples para leitores de tela. - Verifique com a folha de contato. Olhe cada folha antes de considerar a cena pronta:
# uma vez, em um diretório temporário: npm i [email protected] NODE_PATH=<temp>/node_modules node <caminho-skill>/scripts/frames.mjs \ --scene <id> --src caminho/para/scene.js \ --frames "idle:0,idle:2.5,s:0.8,s:1.6,s:2.4,s:3.2,s:4.0,s:5.0" --fw 400 --out /tmp/<id>.png<caminho-skill>é a pasta onde este SKILL.md está. Em seguida, leia o PNG.idle:<seg>congela o loop de repouso,s:<seg>um momento na ação,u:<0..1>uma fração dela. Adicione@<n>para renderizar a n-ésima execução (s:2.4@1), para que cenas que variam comS.ntenham todas as variantes verificadas. Corrija e renderize novamente até: nada esteja cortado nas bordas, nenhum adereço cubra o rosto ou a coisa sendo explicada, cada batida se leia sozinha, o texto fique dentro de sua caixa com espaço acima e abaixo, as mãos estejam na frente do que seguram, as coisas seguradas encontrem o corpo onde uma real encontraria (um microfone na boca, uma alça na palma), as setas sejam chevrons desenhados à mão, não triângulos preenchidos, e o último quadro corresponda ao estado ocioso (nenhum salto quando volta ao loop). Duas ou três rodadas é normal. Em seguida, verifique o movimento, que a folha não pode mostrar:Corrija cadaNODE_PATH=<temp>/node_modules node <caminho-skill>/scripts/motion.mjs --scene <id> --src caminho/para/scene.jsjump(misture a pose em vez de alterná-la),arm-through-face(braço através do rosto),head-covered(cabeça coberta por um adereço, nota ou bolha),bent-back-elbow(cotovelo dobrado para trás),elbow-out-back(braço de asa quebrada mantido por mais de um momento),squash(esmagamento),start-pop(salto no início) eend-pop(salto no fim) até que imprima "motion is clean". Umskate(deslize) curto no início ou fim de uma caminhada é aceitável. - Embuta-a. Copie
runtime/stick.jse o arquivo da cena para a pasta estática do site e adicione:No Astro, use<stick-scene scene="<id>" play="view" style="height:230px; max-width:560px"></stick-scene> <script src="/scenes/stick.js" defer></script> <script src="/scenes/<id>.js" defer></script><script is:inline ... defer>.stick.jsdeve vir antes de cada script de cena na ordem do documento (scripts com defer são executados em ordem e as cenas leemwindow.RIGao carregar). Em uma landing page com várias cenas, coloque cada uma em um quadro para que não flutue em uma linha de base nua: um cartão arredondado com borda de 1px, fundo branco, uma grade de pontos fraca (radial-gradient(#e6e6e6 1px, transparent 1.2px)em 14px) e a faixa do chão mantida (semno-floor); a linha do chão então corre de ponta a ponta como um pequeno palco. Dê a cada cena na página o mesmo quadro e largura total do conteúdo. Em seguida, carregue a página real em um navegador sem cabeça, role o elemento para a visualização, aguarde ~3 s e faça uma captura de tela nas larguras de desktop e celular.
O elemento
scene: o id registrado comoSCENES['<id>'].play:view(executa uma vez quando meio visível, depois ao clicar; melhor padrão para landing pages),click,hover(loop enquanto o mouse está sobre ele, clique no toque),loop(sempre executando, use com moderação),idle(nunca executa).no-floor: remove a faixa cinza clara sob a linha do chão. Use em páginas brancas simples.no-ground: remove também a linha.zoom: escala o desenho para cima ou para baixo dentro da caixa (padrão 1).labelouaria-label: o que a cena mostra. O padrão é olabelda cena.no-font: não carrega Balsamiq Sans do Google Fonts (quando o site já a hospeda ou não pode chamar o Google).- Dimensione com CSS. O desenho se ajusta à altura (230px é o tamanho nativo) e à
widthda cena em unidades mundiais, centralizado. - Movimento reduzido mostra um quadro estático e nunca executa. Cenas fora da tela não são desenhadas.
STICK.theme({ butter: '#…', greenInk: '#…' })troca as cores da paleta para toda a página. Prefira constantes de cor locais na cena (como os verdes de adicionar/remover do GitHub emdiffity-review.js) quando apenas uma cena precisar delas.
Regras de estilo
- Tinta
#141414, preenchimentos de papel branco, um destaque manteiga ou acento, muito espaço vazio. Balsamiq Sans em 8,5–11px para quaisquer palavras, e apenas algumas palavras. - A figura é a heroína: nunca esconda sua cabeça ou a mão ativa atrás de um adereço. Desenhe os adereços primeiro, depois as figuras, depois as coisas seguradas ou voando.
- Uma ideia por cena. Se você precisar de uma legenda para explicá-la, a metáfora está errada.
- Mostre o resultado, não o trabalho: termine em algo que mudou de estado e permanece por um momento.
- Objetos físicos em vez de animais desenhados ou personagens detalhados. Uma segunda figura (um ajudante) recebe uma única cor via
ink/far. Um agente de IA é um robô:fig(..., { ink: '#d97757', far: '#e8b7a3', bot: { col: '#d97757', dark: '#a8553a', glow, blink, happy } })desenha uma cabeça arredondada com um visor escuro e olhos brilhantes, parafusos de orelha, uma antena e uma luz no peito. Um segundo agente vai em verde-azulado (#3d7a8c, dark#2a5866, far#a9c9d1). Um agente preto também funciona: umcolescuro recebe um visor branco e olhos de tinta automaticamente. Luzglowenquanto trabalha,happyquando termina, e coloque uma pequena etiqueta (você,agente,claude) sob cada figura emy = 16. - Agentes não devem reagir instantaneamente. Segure um momento após uma solicitação chegar (uma linha
pensando…, uma bolhahmm…, uma mão no queixo, uma piscada lenta da antena) antes de o trabalho começar. - Não use logotipos de outras empresas. Nomes de produtos como texto simples em um adereço são aceitáveis.