ajustar-detalhe-prototipo
Constrói uma ferramenta interativa com sliders, arrasto e guias visuais para o usuário escolher ele mesmo valores visuais exatos — posição, espaçamento, tamanho — e exporta os valores mapeados às linhas de código. Use quando o usuário pede ajuste fino que não converge por descrição ("sobe um pouco… demais… menos"), quando cada tentativa exige rebuild lento, ou quando o controle que você mexe quase não move o resultado. NÃO use quando o valor certo é óbvio, quando ninguém precisa julgar visualmente, ou para mudança de design mais ampla (melhorar-prototipo).
- License 许可
- MIT
- 最近更新
- 2026-11-02
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- ajustar-detalhe-prototipo
- description
- Constrói uma ferramenta interativa com sliders, arrasto e guias visuais para o usuário escolher ele mesmo valores visuais exatos — posição, espaçamento, tamanho — e exporta os valores mapeados às linhas de código. Use quando o usuário pede ajuste fino que não converge por descrição ("sobe um pouco… demais… menos"), quando cada tentativa exige rebuild lento, ou quando o controle que você mexe quase não move o resultado. NÃO use quando o valor certo é óbvio, quando ninguém precisa julgar visualmente, ou para mudança de design mais ampla (melhorar-prototipo).
03 SKILL.md 正文
ajustar-detalhe-prototipo
Quando um humano precisa escolher valores visuais exatos e seu loop é
edita → rebuild → olha → "um pouco mais… demais", pare de adivinhar. Construa uma
ferramenta que renderiza o componente fielmente, expõe os valores como controles ao
vivo com guias objetivas, e exporta os números já mapeados às linhas de código.
O humano ajusta; você porta uma vez. Seu papel muda de "adivinhar o número" para "construir o botão e ler o resultado".
Leia primeiro: ~/.claude/skills/prototipo-html/references/convencoes.md.
O gatilho
Depois de 1 ou 2 palpites que não acertaram — não depois de cinco. Reconhecer cedo é metade do valor. Nomeie em voz alta: "isso é problema de ajuste, não de valor — vou construir o controle."
Sinais de que já passou da hora:
- O pedido é vago por natureza ("mais pra baixo", "respirando melhor")
- Cada ciclo custa caro (rebuild nativo, deploy de preview)
- O controle que você mexe quase não move a coisa
Quando não usar: valor único e óbvio, nenhum julgamento humano necessário, ou o loop já é instantâneo e você sabe nomear o alvo exato.
Por que o loop não converge
Duas falhas se somam:
-
Superfície de controle errada. Controles que distribuem sobra (
flex,Spacer,justify-content) só têm o que distribuir se sobrar espaço. Com conteúdo quase preenchendo a tela, mudar a proporção move poucos pixels. O usuário pede "bem mais pra baixo" e o botão não entrega. Caso real: mudar de 2:1 para 3:1 moveu 15px. -
Você é um tradutor com perda. O humano descreve uma sensação → você chuta um inteiro → rebuild lento → ele reage a um número que nunca viu. O viés de recência apaga a versão anterior e ninguém consegue segurar um valor.
A solução ataca os dois: muda o meio (browser, tempo real) e entrega o controle direto à mão de quem julga.
Os 5 detalhes que fazem funcionar
Sem qualquer um deles, o vaivém volta.
| # | Detalhe | Se faltar |
|---|---|---|
| 1 | Reconhecer o gatilho cedo — 1 ou 2 palpites, e troca de abordagem | Cinco ciclos de rebuild e frustração |
| 2 | Inicializar nos valores reais de hoje, com botão "resetar para o atual" | A ferramenta mente: ele ajusta contra uma ficção |
| 3 | Exportar mapeado às linhas de código (gap: 36 → linha 84 de x.dart) + botão de copiar |
Você re-traduz e reintroduz o erro |
| 4 | Guias objetivas e aviso de validade — linha de centro, marcador do alvo, delta ao vivo, aviso de overflow/corte | Ele aprova um layout que estoura no aparelho |
| 5 | Modelar como o código real dispõe, e escolher controle que alcança o alvo | Ajusta em flex (não chega lá) ou em px absoluto que não sobrevive ao porte |
Debaixo dos cinco: renderizar fielmente. Assets e SVG reais, ordem real dos elementos, altura real dos campos, moldura de aparelho com safe area, e seletor de tamanho de tela — "o centro" depende da altura da tela.
Fluxo
- Nomeie o gatilho e diga que vai construir o controle.
- Trave a granularidade com
AskUserQuestion: arrastar o bloco inteiro · ajuste fino leve · controle por gap individual. Granularidade demais também trava a decisão. - Leia os valores atuais no código de produção — a ferramenta abre neles (detalhe 2).
- Construa em
<raiz>/<task-id>/, seguindo o contrato (React 18 + Babel via CDN, tokens em CSS var, light e dark). Cada valor ganha slider e campo numérico: slider para explorar, campo para fechar. - Verifique você mesmo antes de entregar: suba com
/iniciar-prototipo, console limpo, exercite um slider e o arrasto, confira nos dois temas. A ferramenta precisa renderizar fiel antes do humano tocar nela. - Entregue a URL. Ele ajusta até as guias confirmarem e aprova.
- Leia os valores exportados e porte de uma vez só — uma edição, valores 1:1. Sem re-interpretar.
- Verifique o resultado real e abra a imagem. Comparar hash ou tamanho de arquivo não é verificação.
O painel de export
O que separa a ferramenta útil da ferramenta bonita:
topo: 88px → linha 42: SizedBox(height: 88)
logo: 240px → linha 51: BrandLogo(width: 240)
logo→email: 55px → linha 63: SizedBox(height: 55)
[copiar]
Cada valor ao lado do lugar exato que muda. Assim o porte é mecânico, não uma segunda rodada de adivinhação.
Guias que tornam "quase no meio" mensurável
- Linha de centro do espaço útil
- Marcador no elemento que o usuário citou como referência
- Delta ao vivo ("38px acima do centro")
- Aviso de overflow ou corte — o valor mais bonito às vezes empurra conteúdo para fora da tela; sem o aviso ele aprova sem saber
Caso real: o bloco de login (587px) era mais alto que a área útil (711px), então centrar o e-mail jogava o link de cadastro para fora. O aviso tornou o trade-off visível, e o usuário escolheu conscientemente outra composição.
Anti-padrões
| Erro | Correção |
|---|---|
| Continuar mexendo no mesmo controle porque "mais um pouco resolve" | Depois de 2 palpites, construa a ferramenta |
| Ferramenta abre em valores arbitrários | Inicialize nos valores reais + botão de reset |
| Exportar números soltos | Exporte mapeado às linhas, com botão de copiar |
| Buscar o centro perfeito ignorando se cabe | Aviso de overflow; deixe o trade-off explícito |
Ajustar em flex e depois brigar com o porte |
Modele como o código real dispõe |
| Dizer "ficou bom" a partir do tamanho do arquivo de imagem | Abra e olhe a imagem |
04 同仓库更多 Skills
zoom-out
Tell the agent to zoom out and give broader context or a higher-level perspective. Use when you're unfamiliar with a section of code or need to understand how it fits into the bigger picture.
writing-great-skills
Reference for writing and editing skills well — the vocabulary and principles that make a skill predictable.
write-a-skill
Create new agent skills with proper structure, progressive disclosure, and bundled resources. Use when user wants to create, write, or build a new skill.
teach
Teach the user a new skill or concept, within this workspace.
resumo-trabalho
Resumo do trabalho de um período, agrupado pelas partes do produto, para quem não lê código. Use quando o usuário pedir um resumo ou status do que foi feito nos últimos dias, para mandar ao cliente, ao sócio ou ao gestor. NÃO use para o relatório ponto a ponto de uma entrega (relatorio-de-entrega) nem para o corpo de PR (pr).
writing-for-agents
Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.