Kit do produto
Cada vídeo de um produto extrai do mesmo kit, então o kit é extraído uma vez, aprovado uma vez e reutilizado. Na produção de onde vêm essas habilidades, fazer isso de forma fragmentada era caro: uma fonte de ícones foi baixada sem permissão, depois com aprovação, depois alargada três vezes, e no meio disso um subagente pegou dois glifos de uma fonte dentro de uma pasta de extensão do navegador; o mesmo cliente demo acabou com dois sobrenomes diferentes em dois vídeos porque uma lista de nomes para vetar nunca foi respondida; e um produto renomeado manteve seu nome antigo na tela até que um revisor o detectou.
Antes de começar
- As fontes estão fixadas (
sources.lock,sources/<role>/). Se não, execute source-recon primeiro: todo arquivo do kit cita o commit fixado. - Pergunte uma vez por cada download que o kit precisa (pacotes de fontes, pacotes de ícones que não estão no repositório), em uma única lista com o quê, de onde e aproximadamente o tamanho. Nada é baixado sem esse sim, e nada jamais vem de um perfil do navegador ou pasta de extensão.
PVS_HOME="$(cd "$(cd "${CLAUDE_SKILL_DIR}" && pwd -P)/../.." && pwd)"
K="$PVS_HOME/skills/product-kit/scripts"
1. Tokens
Execute o resolvedor do ui-spec-from-code para o tema do produto e escreva os fatos de renderização que ele
descreve (rem de execução, seletor de tema, fontes realmente carregadas) em kit/render-facts.md:
"$PVS_HOME/bin/pvs-py" "$PVS_HOME/skills/ui-spec-from-code/scripts/resolve_tokens.py" <diretório_do_produto> \
[--theme-selector "<seletor escuro>"]
Defina brand.accent em product.yaml a partir do token que o produto usa para sua cor primária, citando-o.
2. Fontes
Encontre quais fontes o aplicativo realmente carrega (tags link, @font-face, pacotes de fontes no lockfile),
não apenas aquelas nomeadas em CSS. Pegue os arquivos do repositório ou do pacote instalado (por
exemplo um pacote @fontsource/<family> em node_modules); uma fonte que só existe em um serviço de fontes web
precisa da aprovação do usuário para baixar. Depois, faça o subconjunto:
"$PVS_HOME/bin/pvs-py" "$K/subset_fonts.py" <diretório_do_produto> <arquivos de fonte...> \
[--text-file videos/*/audio/lines.tsv] [--license OFL-1.1] [--source <citação>]
Ele escreve kit/fonts/<family>-<weight>.woff2, reconstrói kit/fonts/fonts.css (font-display
block, para que uma renderização nunca exiba primeiro uma fonte substituta), copia o texto da licença que encontrar ao lado da
fonte ou em seu pacote (a OFL exige que o texto acompanhe a fonte) e registra a fonte,
licença e arquivo de licença em kit/fonts/fonts.md. Uma fonte com licença "desconhecida" ou um
arquivo de licença "ausente" não está pronta: encontre-os ou pergunte. Defina
brand.font em product.yaml. Para uma fonte de ícones que funciona por ligaduras, passe --all-features e
os nomes das ligaduras como --text, e verifique se cada nome é renderizado como um glifo, não como letras.
3. Ícones
Obtenha a lista de ícones da extração de ícones do ui-spec-from-code (ou das especificações), agrupados por pacote. Copie-os dos próprios pacotes do produto:
"$PVS_HOME/bin/pvs-py" "$K/collect_icons.py" <diretório_do_produto> --package <diretório com arquivos svg> \
--names calendar,check,plus [--variant outline/24] [--prefix bx-] [--clean]
Ele copia cada SVG para kit/icons/<conjunto>-<nome>.svg e adiciona uma linha em kit/icons/icons.md
(arquivo, nome, conjunto, citação da fonte, licença). Falha em um nome ausente ou ambíguo em vez de
escolher um similar, porque um ícone próximo foi o que fez um revisor rejeitar um primeiro corte inteiro.
Ícones que só existem como fonte de ícones: faça o subconjunto da fonte (seção 2) e pegue os codepoints do
CSS da própria biblioteca; a construção deve falhar em um nome desconhecido.
4. Logotipos
Apenas a partir dos ativos do repositório (ou de um pacote de marca fornecido pelo usuário): nunca redesenhados, traçados ou retirados de um site. Liste os candidatos, observe-os e depois copie as três variantes:
"$PVS_HOME/bin/pvs-py" "$K/collect_logos.py" <diretório_do_produto> # candidatos em sources/
"$PVS_HOME/bin/pvs-py" "$K/collect_logos.py" <diretório_do_produto> --light frontend/assets/logo.svg \
--dark frontend/assets/logo-white.svg --tile frontend/public/icon-512.png [--root <pasta da marca>]
Ele escreve kit/logos/logo-light.* (para fundos claros), logo-dark.* (para fundos escuros) e app-tile.* (o ícone quadrado), SVG quando o produto possui um, com uma linha citada cada em kit/logos/logos.md; recusa URLs. Em seguida, defina brand.logo_light, brand.logo_dark e brand.app_tile em product.yaml para os caminhos que ele exibe. Escolha a variante pelo fundo em cada vídeo: uma marca clara em uma página branca desaparece, o que aconteceu na produção de origem.
5. Elenco
Os dados de demonstração são fictícios desde o primeiro quadro e são os mesmos em todos os vídeos. Leia
references/cast-and-names.md para as faixas de números e domínios reservados. Proponha um elenco completo
em uma única pergunta fechada, com sua proposta como padrão recomendado:
Elenco demo para todos os vídeos do Acme Tasks (recomendado: use como está): Northwind Bakery, Portland OR (northwind.example); proprietária Maya Lindqvist, [email protected]; cliente Omar Haddad, +1 503 555 0172. Use, ou altere quais nomes?
Nomes completos, um sobrenome por pessoa, mantidos para sempre; números em 555-0100 a 555-0199; e-mails e
sites em domínios reservados. Revisores vetam nomes por gosto (um nome sem graça foi rejeitado na produção
de origem), então pergunte antes de qualquer animação. Se o revisor não responder, diga que está
congelando a proposta e congele-a: o silêncio não deve deixar duas versões de uma mesma pessoa. Escreva em
cast: em product.yaml e verifique:
"$PVS_HOME/bin/pvs-py" "$K/check_cast.py" <diretório_do_produto>
Ele falha em um sobrenome ausente, um primeiro nome com dois sobrenomes, um telefone não-555 ou não fictício, e um e-mail ou site em um domínio de aparência real.
6. Nomes, pronúncias, termos proibidos
Pergunte ao usuário e depois escreva em product.yaml:
names: nome canônico para as strings legadas que nunca devem aparecer (nomes antigos de produtos que a IU ativa ou o código ainda podem mostrar). Cada vídeo usa o nome canônico mesmo onde a IU real está desatualizada, e o grep encontra os legados antes de uma renderização.pronounce: palavras de marca para a grafia que o motor de voz diz corretamente (um nome de produto inventado lido como uma palavra diferente foi detectado pelo ouvido na produção de origem).banned_terms: concorrentes, fornecedores terceiros que a equipe mantém fora da tela, clientes reais, nomes de código internos.never_sayepositioning: a identidade em uma linha e as frases que ela nunca deve assumir.
7. Ferramentas somente leitura
Preencha a seção 10 de kit/RULES.md, "Ferramentas somente leitura" (o modelo vem com um
placeholder), com as ferramentas de API ou MCP do produto que os agentes podem chamar
(documentos, catálogos, modelos) e diga que todo o resto é proibido. Uma conexão com acesso de escrita
permanece somente leitura por esta regra; recomende uma credencial com escopo somente leitura, porque na
produção de origem o somente leitura era imposto apenas por instrução.
8. Relatório
Mostre ao usuário o inventário do kit (contagem de tokens e sinalizadores, fontes com licenças, ícones por conjunto, logotipos, elenco), o que ainda precisa de aprovação e as chaves de product.yaml que você alterou.