O que clipes de changelog faz?
Instruções explícitas do usuário têm prioridade sobre este fluxo de trabalho. Trabalhe apenas em produtos autorizados e dados de amostra. Não solicite senhas, chaves de API, dados de pagamento, identificadores governamentais, registros de saúde ou outros dados sensíveis. Explique dependências locais ausentes antes de instalá-las no projeto ativo. O acesso à rede é para o produto autorizado e seus ativos licenciados, além da dependência npm declarada; respeite os controles de acesso. Renderize um trabalho por vez e aguarde a conclusão. Mantenha a publicação, o envio e a implantação fora desta tarefa.
Um painel nativo, uma ação, seu resultado mantido e, em seguida, um Reset de demonstração anunciado. Mantenha a câmera fixa e deixe um padding uniforme ao redor do painel inteiro. Leia style.md antes de construir e critique.md antes de julgar.
Entradas e configuração
Leia as notas de lançamento e inspecione o produto ativo primeiro. Colete apenas o que eles não podem fornecer: as mudanças a anunciar, uma URL de demonstração ou app local, dados de amostra seguros, arquivos de marca/fonte e tamanhos solicitados. A versão um cobre mudanças visíveis em aplicativos web. Segure mudanças somente de API em vez de inventar um painel. Não anuncie um recurso como entregue com base em uma prévia futura.
Verifique Node 20+, ffmpeg e Chrome (scripts/chrome.mjs ou CHROME_PATH). Instale puppeteer-core@^24 no projeto ativo (roda no Node 20; versões principais mais novas podem exigir um Node mais novo). SKILL_DIR abaixo é a pasta que contém este arquivo.
mkdir -p changelog-clips
cp -R "$SKILL_DIR/reference" changelog-clips/film
cp -R "$SKILL_DIR/scripts" changelog-clips/scripts
cp -R "$SKILL_DIR/music" changelog-clips/music
cd changelog-clips
npm init -y
npm install -D 'puppeteer-core@^24'
Crie uma pasta de filme separada para cada mudança; a referência é o controle de aparência, e examples/compare-matching-stays/ mostra uma lista nativa. Remova as capturas copiadas após estudar seu formato e substitua-as pelas deste produto. Remova out/ copiado, se presente. Mantenha cada filme autocontido. Em lançamentos posteriores, reutilize a marca e os clipes não alterados; recapture apenas as ações modificadas.
Produto e história
Escreva PRODUCT.md com o produto real, marca, permissões de dados e fonte de cada afirmação de lançamento. Escreva STORY.md com uma entrada por clipe: ID estável, fonte/data de lançamento, título, estado anterior, rota acessível, controle/ação real, resultado mantido, método de reset, limites de captura e política de reprodução pretendida. Cada clipe independente deve fazer sentido ao lado de seu próprio texto de lançamento. Não combine duas mudanças em uma linha do tempo.
Faça o título concordar com a conclusão demonstrada: escolher um ponto de repetição não é executar uma repetição, e visualizar uma programação analisada não é salvá-la. Diga "Escolher…" ou "Visualizar…" quando esse for o resultado real; não pegue emprestado a afirmação mais ampla do lançamento para uma demonstração mais restrita.
Antes de se comprometer com uma mudança, meça seu componente nativo completo e o texto decisivo do resultado no tamanho de visualização real. Registre as dimensões CSS, o tamanho do texto e o tamanho de 358 px resultante na história. Uma solicitação para dois clipes não significa que existem duas mudanças adequadas. Segure um item incompatível e diga por quê; nunca o entregue como um clipe de telefone/rede social finalizado com uma ressalva em letras miúdas. Selecione outra mudança genuinamente documentada, se couber. Quando várias formas forem solicitadas e o usuário não nomear a mudança, meça todos os candidatos documentados em relação a cada forma solicitada antes de escolher, e prefira um cujo componente completo caiba em todas elas; entregue uma família parcial apenas quando nenhum couber. Se nenhum couber, retorne a limitação do produto sem inventar UI ou diminuir o limite.
Um componente pode caber apenas em algumas formas. Declare cada forma não suportada e sua razão medida em heldShapes do clip.json (por exemplo {"4:3":"Resultado nativo é 10.7 px a 358 px; mínimo 12"}). O pintor, o pré-voo e o exportador omitem essa forma retida, enquanto verificam e entregam as compatíveis. O manifesto marca isso como parcial; relate cada forma solicitada ausente de forma proeminente. Uma família parcial não é uma prova de três formas aprovada. Se todas as formas forem retidas, entregue as medidas/relatório, não um filme.
Mostre esse plano para revisão, a menos que o usuário tenha solicitado trabalho não supervisionado. O padrão é 1200 × 900 web, 1080 × 1080 quadrado e 1080 × 1350 retrato. Estas são composições separadas, não recortes de um filme. Um título de lançamento fixo curto fica fora da UI nas redes sociais; o clipe web usa texto de lançamento adjacente.
Capturar e adaptar
- Encontre um cartão ou painel nativo inteiro que contenha tanto a ação quanto seu resultado. Verifique seu layout nativo estreito antes da captura. A 358 px de largura de visualização, o rótulo, valor ou resultado alterado deve ter cerca de 12 px ou mais. Se o componente completo não conseguir atender a isso, escolha uma visualização compacta que o app realmente tenha ou relate a limitação. Nunca o redesenhe ou reestilize para o filme.
- Copie/adapte
film/plans/capture.jsone seucapture-setup.mjs. Defina sua URL, viewport, seletores, configuração de amostra e evidênciainspect. Registrepieceetargetemrects.before, e novamente após o resultado. Capture toda a superfíciebefore,hover,pressed,changed(ainda hover) eresult(cursor limpo). Use mouse down/up real para que o app forneça seu próprio pressionamento. Executenode scripts/centring.mjs film/plans/capture.json --no-crawlantes da captura. - Execute
node scripts/screens.mjs film/plans/capture.json film/captures. Useanimatepara os quadros CSS/Web Animations próprios do app. Inclua limites suficientes para a maior extensão nativa; a ferramenta de captura mede a região antes da ação. Para uma ação instantânea, umadurationexplícita curta registra evidência comfound: []: mude toda a captura instantaneamente. Para movimento controlado por JS que a ferramenta de captura não pode buscar, forneça uma gravação nativa determinística; nunca a substitua por um fade ou movimento montado a partir de fotos. - Copie a fonte licenciada do produto para
film/fonts/, definafilm/clip.jsone executenode scripts/build-clip.mjs film film/clip.json. As opções são mostradas abaixo. Ele deriva a geometria de toda a superfície, o alvo do cursor e as ligações de quadros nativos decaptures/screens.json, amostra as superfícies nativas, escreveconfig.jse executa as verificações de tamanho nativo de cada forma. Uma falha retém o item: pare antes de exportá-lo. Revise cada captura antes de usá-la. A referência fornecida já tem sua configuração, então reconstruí-la é opcional.
{
"id": "new-view", "title": "Seu título de lançamento", "kind": "panel",
"paper": "#F7F4EE", "ink": "#17191F", "groundSource": "Sua paleta aprovada ou superfície de app amostrada",
"radius": 20, "clearOnExit": true, "primaryTextPx": 24,
"font": {"family": "ProductSans", "file": "fonts/product.woff2", "weight": "300 900"}
}
primaryTextPx é o tamanho CSS nativo medido do texto decisivo do resultado, não um alvo inventado pelo filme. paper vem deste produto, não da amostra acima. radius é o raio nativo do componente em pixels CSS. clearOnExit mantém o hover até que o ponteiro saia do alvo real. Adapte esses campos e o objeto timing opcional em config.js; mantenha o pintor de câmera fixa e superfície inteira em film.js. Os quadros de animação nativos tocam em seus fps capturados. Se a ação for mais longa, mova a saída do cursor e o reset para mais tarde, de modo que ela termine e o resultado estabilizado seja lido por pelo menos um segundo; a referência deixa mais de quatro segundos. Não trunque o processamento real nem retrate uma solicitação na fila como concluída.
Mantenha o ponteiro parado longe do rótulo crítico. Prefira o controle visível em si como rects.target; para uma linha rotulada, clip.json pode definir "targetFraction": [0.72, 0.5] para escolher um ponto claro dentro dessa área de clique real (padrão [0.5, 0.5]). Adapte capture-setup.mjs para mover o mouse real para as mesmas frações da caixa delimitadora desse alvo antes de pressionar/soltar. A captura e o filme devem usar o mesmo ponto; mover apenas o ponteiro desenhado deturparia o pressionamento nativo. Verifique isso em quadros de ação em largura de telefone decodificados.
Revisar e entregar
node scripts/render.mjs film --all --check --check-fresh --stress --phone --times key --sheet --review --out film/out
node scripts/export-clips.mjs film
Estes comandos de entrega terminam. Para trabalho não supervisionado, aguarde ambos, complete a revisão e relate o player film/out/index.html exportado e os caminhos de mídia. A prévia interativa é uma ferramenta de edição assistida:
node scripts/preview.mjs film inicia um servidor persistente até ser interrompido com Ctrl-C. Execute-o separadamente quando alguém estiver presente para usá-lo; nunca o anexe a um comando de entrega/verificação não supervisionado em primeiro plano.
export-clips.mjs verifica cada forma primeiro e recusa novas exportações de vídeo em uma verificação de filme com falha. Em seguida, renderiza MP4s H.264 silenciosos a 30 fps, WebMs VP9 e PNGs de resultado em film/out/. Seu --poster <seconds> opcional seleciona um resultado estabilizado (padrão 3.5). Ele escreve um player local com contexto adjacente, pausa/reprodução e tratamento de movimento reduzido. O reset do filme é rotulado; não é um ciclo de produto contínuo. Mantenha o poster de resultado estático para movimento reduzido. O rótulo aparece antes do reset e permanece visível até o final; inspecione também o último e o primeiro quadro decodificados.
Leia cada tira de mudança de UI em tamanho real, hover/pressionar/soltar e reset em cada forma; inspecione quadros MP4 decodificados nesses eventos. Pontue com critique.md, depois obtenha um revisor diferente, se disponível. Corrija a origem e repita apenas as verificações afetadas. Nenhuma pontuação abaixo de 8; após duas rodadas de correção com falha, relate a falha restante em vez de escondê-la. A verificação de estresse cobre palavras desenhadas, então inspecione o texto nativo capturado separadamente a 358 px.
Entregue filmes editáveis com todas as capturas/fontes e licenças locais, caminhos MP4/WebM/poster, legendas de lançamento, alegações de origem, o comando de regeneração e REVIEW.md com pontuações e limitações. Abra os MP4s finalizados para revisão. Visando um clipe web abaixo de 1 MB, preservando a legibilidade primeiro; relate os bytes reais e o tempo decorrido.
Os loops padrão são silenciosos. music/README.md explica a música opcional incluída feita com IA (take A selecionado). Nunca substitua por uma trilha sonora sintetizada. Uma música fornecida ou selecionada usa o ajustador da casa; mantenha as exportações silenciosas para incorporações.
Invariantes
- Apenas capturas reais do produto e dados próprios/amostra do usuário. Nenhuma UI inventada, retângulos levantados, patches de texto, crossfades entre estados ou processamento falso.
- Invólucro nativo completo, padding oposto uniforme, escala e câmera fixas. Nenhum ripple de clique adicional ou mockups de dispositivo.
seek(t, values)pinta apenas a partir de argumentos;ctx.reset()a cada quadro, canvases principal/auxiliar com suporte de CPU, imagens locais preparadas. Nenhum relógio, chamadas aleatórias, temporizadores ou rede no pintor.- Cada palavra do filme é uma entrada
template.fields. O texto nativo crítico deve ser legível independentemente das verificações de estresse de cópia desenhada. - Um reset nunca finge desfazer uma compra, envio ou ação irreversível. Use um reset de estado de amostra explicitamente rotulado, ou reproduza uma vez e mantenha o resultado real.
Ostlery é uma empresa fictícia criada para os exemplos da omnigami.
Esta skill é de propriedade da omnigami, © 2026 Auberon LLC. Use o que ela produz para qualquer coisa, inclusive trabalho comercial, e modifique a skill para seu próprio uso; não redistribua ou venda a skill. Termos completos: LICENSE.md