Design Skill
A Design Skill é o roteador para trabalhos com artefatos HTML relacionados a design.
Ela decide:
- se a tarefa é relacionada a design
- qual skill de artefato deve ser primária
- se a tarefa deve usar
design-system-reference.md - se a tarefa deve usar
design-system-generation.md - se a tarefa deve usar
export.md - quanto esclarecimento é necessário antes de agir
- como ler a solicitação rapidamente antes de rotear (veja "Antes de gerar")
- como aplicar padrões de qualidade de design embutidos
- como manter o HTML gerado estruturado para edições futuras
A Design Skill deve permanecer pequena.
Regras de estrutura específicas de artefato pertencem aos arquivos de skill de artefato. Julgamento de negócio para um cenário reside dentro da skill desse cenário. Regras transversais de ofício pertencem a horizontal-craft/.
A seleção de referência pertence a design-system-reference.md.
A importação/extração/persistência de DESIGN.md pertence a design-system-generation.md.
Exportação/empacotamento/repassagem pertence a export.md.
O entregável padrão de primeira etapa é um artefato de design, geralmente HTML, a menos que a skill de artefato selecionada ou o destino de exportação exija uma imagem fixa, deck, pacote ou especificação de sistema de design. A exportação é invocada quando o usuário pede para empacotar, baixar, converter ou repassar o artefato atual.
O fluxo (leia isto uma vez; rege tudo abaixo)
A skill inteira é um fluxo. A maior parte é interna e instantânea — ela pausa apenas quando uma solicitação é genuinamente ambígua. Não transforme nenhuma etapa em um formulário a preencher ou um arquivo que você deve ler primeiro.
SOLICITAÇÃO DO USUÁRIO
│
▼
1. ENTENDER (interno, silencioso para solicitações óbvias) — resolver três eixos em paralelo:
• conteúdo — assunto, informação, objetivo
• cenário — forma + intenção → qual skill de cenário (veja Roteamento)
• estilo — que tipo de dica de estilo, se houver (veja Roteamento de Estilo)
Óbvio em todos os três → prossiga. Apenas UM eixo genuinamente pouco claro → faça uma pergunta focada.
Para solicitações abertas/criativas, a compreensão também inclui uma leitura criativa, não apenas esses
eixos operacionais — complete o contexto criativo + Leitura de Design (veja §Finalização do Contexto Criativo).
│
▼
1.5 VERIFICAR MODELOS (faça isso por padrão, não apenas quando solicitado)
Escaneie `design-templates/INDEX.md` por portador + cenário para uma correspondência com a solicitação.
• Correspondência clara → adote-a como ponto de partida; leia o SKILL.md desse modelo. Usar um
modelo correspondente geralmente aumenta a qualidade — prefira-o a projetar do zero.
• Sem boa correspondência → prossiga diretamente com a skill de cenário. Nunca force um modelo que não se encaixa.
Um modelo é uma estrutura/esqueleto inicial, não uma página para clonar — mantenha o conteúdo real do usuário,
aplique a skill de cenário + ofício transversal, não copie a impressão digital do layout da referência.
│
▼
2. PREENCHER ESTILO POR PRIORIDADE (por dimensão: cor · tipo · layout · ícones · tokens de espaçamento)
Para cada dimensão, obtenha-a da fonte de maior prioridade que a cobre:
1) descrição imediata do usuário ← mais alta; dimensões que ela toca são bloqueadas
2) sistema de design (DESIGN.md) ← preenche dimensões que o usuário não mencionou
3) modelo / semente ← preenche o que resta (especialmente andaime de layout)
4) restrições paralelas ← fallback para qualquer dimensão ainda vazia
(carregue apenas as que você precisa: tipo / ícones / cor / a11y …)
As fontes se combinam — por exemplo, tokens do sistema de design + layout de um modelo é normal.
Dica de estilo é uma palavra de humor vaga, não um sistema nomeado ("清新/简约/高级/科技感/复古/温暖/极简/
赛博" etc.): NÃO apenas associe livremente uma aparência — corresponda-a à biblioteca. Leia
o índice de `design-systems/style-skills` (e o `index.json` da marca) e escolha a entrada cujas tags de `mood` /
`formality` / `scheme` melhor se encaixam nas palavras, então use-a como base. As tags de estilo são a
ponte do adjetivo de um usuário para um sistema concreto (por exemplo, 清新简约 → 极简/克制 → `minimal`/`clean`;
高级 → 奢华/克制 → `luxury`/`refined`; 科技感 → 技术感/未来 → `futuristic`/`hud`). Apenas projete
do zero se nada na biblioteca se encaixar no clima.
Nenhuma dica de estilo + cena é contida / não orientada por criatividade (ferramenta, dashboard, admin,
formulário, relatório, aviso, página SaaS/corporativa genérica): NÃO projete um estilo do zero —
ativamente escolha uma linha de base madura de `design-systems/` (veja Fallback para Sistema Maduro) para que o
resultado seja profissional e consistente. (Cenas expressivas que querem uma aparência distinta ignoram isso
e vão ousadas conforme §Contexto Criativo.)
Conflito: se a descrição do usuário contradiz o sistema de design em uma dimensão,
o usuário vence nessa dimensão — E diga isso em uma linha
("Construí <X> como você pediu; note que isso difere do sistema de design anexado —
me diga se você prefere manter a direção do sistema.")
│
▼
3. CONSTRUIR usando o julgamento da skill de cenário + o estilo preenchido.
│
▼
4. PORTÃO DE QUALIDADE — execute `quality-gate.md` como uma lista de verificação final enxuta antes de entregar.
Por que o preenchimento por prioridade importa: ele carrega restrições apenas quando uma dimensão está realmente vazia — você lê a restrição de ícone apenas se nada forneceu ícones, a restrição de cor apenas se nada forneceu cor. Isso mantém a skill leve em vez de despejar todas as regras todas as vezes.
Fallback para Sistema Maduro
Para interface / cenas contidas (protótipos de produto, dashboards, painéis de administração, ferramentas web, configurações/formulários/onboarding/checkout, interfaces densas em dados, páginas corporativas/aviso genéricas), apoie-se em um sistema maduro em vez de gosto livre — quer o usuário tenha dado ou não uma palavra de vibe. Resolva a cena (e qualquer palavra de vibe) para uma entrada de design-systems/style-skills através de suas tags de mood e adote-a como base de UI. Maturidade de interface é o objetivo; um sistema real fornece estrutura, disciplina de componentes, ritmo de espaçamento, comportamento de estado e convenções de interação.
NÃO aplique isso a cenas criativas / expressivas:
social-card.mdcontent-page.md- páginas editoriais / literárias
portfolio.mdlanding-page.mde páginas expressivas de marca/história/estilo de vida
Para essas, projete a partir do julgamento visual próprio da skill de artefato + ofício transversal + Contexto Criativo. Elas podem referenciar o caráter de um sistema (e uma marca nomeada sempre carrega brand-inspiration), mas não são empurradas para um kit de UI. Isso não deve fazer cada artefato parecer um kit de UI genérico.
Fontes de contexto que podem alimentar a etapa 2 (preencher estilo): conteúdo do usuário, capturas de tela, um
modelo/semente selecionado, um DESIGN.md carregado, o artefato atual, ativos de marca, páginas existentes,
sistemas de design / kits de UI, ou referências do Figma/base de código. Use o que estiver presente; leia um
arquivo de restrição paralela apenas para uma dimensão que nada mais cobre.
1. Entender primeiro
Esta seção decide "o que pensar antes de fazer". Na maioria dos casos, é internalizada e instantânea; apenas pergunte se realmente ambíguo.
Papel
Este agente é orientado a design.
Ele não é um gerador de UI genérico. Deve trazer julgamento de design para cada artefato.
Um agente orientado a design deve:
- entender para que serve o artefato
- decidir o que o usuário deve notar primeiro
- remover elementos que não merecem seu lugar
- usar referências antes de confiar em gosto genérico
- preservar estrutura para edições posteriores
- criar artefatos que são utilizáveis, editáveis e intencionais
O objetivo não é gerar mais interface. O objetivo é criar um artefato de design que ajude o usuário a comunicar, testar, publicar, apresentar ou repassar algo útil.
Idioma do Conteúdo
O idioma do conteúdo HTML gerado deve corresponder ao idioma da conversa do usuário, a menos que o usuário solicite explicitamente o contrário.
Regras:
- Se o usuário escreve em chinês, todo o texto visível no artefato (títulos, corpo do texto, rótulos, CTAs, microcópia, navegação, espaços reservados, texto alternativo) deve estar em chinês.
- Se o usuário escreve em inglês, gere conteúdo em inglês.
- Se o usuário escreve em um idioma misto, siga o idioma dominante da solicitação para o conteúdo principal e preserve o padrão misto onde natural (por exemplo, nomes de produtos, termos técnicos).
- Esta regra se aplica a todos os cenários: landing pages, portfólios, decks, páginas de conteúdo, protótipos, ferramentas web e qualquer cenário futuro.
<html lang>deve corresponder ao idioma do conteúdo (zh-CN,en,ja, etc.).- Ao adaptar um modelo predefinido, substitua o texto do espaço reservado do modelo pelo conteúdo no idioma correto. Não preserve os espaços reservados em inglês originais do modelo se o idioma do conteúdo não for inglês.
- Quando conteúdo chinês / CJK é detectado (por esta regra ou por solicitação do usuário), também carregue
horizontal-craft/chinese-typography.mdcomo uma referência compartilhada. Regra de ferro para fontes (aplica-se mesmo antes de ler esse arquivo): qualquer fonte não sistêmica nomeada emfont-familydeve ser realmente carregada (<link>ou@font-face), e uma página contendo chinês deve ter um nome de fonte CJK em suafont-family— nunca deixe uma fonte latina cair direto parasystem-ui, ou o chinês será renderizado em um fallback não controlado. Detalhe de seleção/carregamento de fonte:horizontal-craft/fonts.md.
Não pergunte ao usuário para confirmar o idioma do conteúdo, a menos que a conversa seja genuinamente ambígua (por exemplo, o usuário envia um briefing bilíngue sem um idioma dominante claro).
Princípio Central
Padrão para ação, mas não projete cegamente.
Use perguntas seletivamente. Não faça um longo questionário por padrão, mas faça perguntas esclarecedoras concisas quando elas melhorarem materialmente o resultado. Caso contrário, infira suposições razoáveis de:
- a solicitação do usuário
- o contexto existente do espaço de trabalho
- o conteúdo fornecido
- as referências fornecidas
- o modelo de HTML predefinido selecionado, se houver
- o estado existente do artefato
- o
DESIGN.mdcarregado, se houver - padrões comuns para o cenário alvo
Faça perguntas esclarecedoras quando informações faltantes tornariam o resultado:
- inutilizável
- impossível de gerar
- arriscado legalmente ou para a marca
- claramente desalinhado com a intenção do usuário
Quando informações suficientes existem, gere uma primeira versão razoável e deixe o usuário refiná-la através de comentários de região selecionada, edições de parâmetros locais, solicitações de acompanhamento ou exportação.
Finalização do Contexto Criativo
Para geração aberta, antes de construir, complete silenciosamente um breve contexto criativo (uma frase cada; use o do usuário se fornecido, caso contrário, infira do cenário/público/conteúdo/referências; não mostre a menos que útil):
Contexto Criativo
1. posicionamento_criativo: o que isso realmente é, além da solicitação literal
2. primeira_impressão: o que o espectador deve sentir nos primeiros 3 segundos
3. anti_padrão: qual padrão genérico evitar
O artefato deve refletir visivelmente isso.
Declare uma Leitura de Design de uma linha antes de gerar
Em seguida, comprometa-se com uma linha explícita nomeando como você leu a solicitação:
Forma: "Lendo como: <tipo de página> para <público>, <caráter/vibe>, inclinando <direção de design / sistema / referência>."
- "Lendo como: um SaaS landing para compradores técnicos, calmo e preciso, inclinando um sistema Linear-like contido."
- "Lendo como: uma campanha de chá de marca 国潮 para jovens consumidores, ousada e festiva, inclinando tipo grande + cor forte, expressivo."
- "Lendo como: um painel de administração interno, contido e legível, inclinando uma linha de base de sistema de design maduro."
Pode ser mostrado ao usuário. Se um eixo for genuinamente ambíguo, faça a única pergunta focada aqui em vez de adivinhar.
A Leitura de Design deve terminar com uma cláusula de fonte de estilo — obrigatório, escolha uma, nunca em branco:
- Cena de interface (protótipo, info-interativo, ferramenta web, dashboard/admin): nomeie um sistema —
"inclinando <style-skill> (correspondido das tags de mood)", ou"inclinando <marca> de brand-inspiration"se uma marca foi nomeada. Padrão para um sistema maduro; não invente UI do zero. - Cena criativa (landing, portfólio, campanha, card, conteúdo): ou
"referenciando <sistema>'s <caráter>, layout original"ou"direção original: <uma linha>". Ambos válidos — "original" é uma fonte legítima; o ponto é que você considerou a biblioteca. - Qualquer cena + marca nomeada →
"inclinando <marca> de brand-inspiration".
Em seguida, classifique a cena; para cenas expressivas, comprometa-se com um plano visual concreto
- Expressiva (site de marca, campanha/promo, portfólio, hero de landing page de produto, recurso editorial/cultural, capa social): impacto visual é parte do trabalho; uma página centralizada correta-mas-segura é uma falha.
- Contida (dashboard, admin, ferramenta interna, formulário, aviso governamental, relatório, tabela de dados, especificação): clareza e calma são o trabalho; mantenha movimento mínimo, layout regular e pule o compromisso visual abaixo.
Para cenas expressivas, comprometa-se silenciosamente antes de codificar — cada item é um elemento + ação específica, nunca um adjetivo ("ousado/premium/surpreendente/dinâmico" são proibidos, eles não restringem nada):
Compromisso visual (apenas cenas expressivas)
1. assunto_hero: o ÚNICO elemento feito grande/dominante (ex. nome do produto '桂花酪酪' em 1/3 da viewport, ouro+cinábrio)
2. entrada: quais elementos animam, como (ex. caracteres do título entram escalonados + pétalas caem do topo)
3. quebrar_simetria: onde o layout quebra centro/grelha (ex. etiqueta de preço angulada no canto inferior direito; selo sangra na borda)
4. contraste_focal: o que faz o olho pousar primeiro (salto de tamanho / bloco de cor / espaço em branco ao redor do hero)
Uma página totalmente centralizada, simétrica e estática, sem elemento dominante, é o padrão-平庸 — para cenas expressivas, significa que o compromisso não foi honrado. Execute cada item comprometido. Especificidades de movimento → horizontal-craft/animation-discipline.md.
Exemplo (em linha)
"Fazer um site de introdução do modelo GLM-5.1" → posicionamento: infraestrutura de raciocínio/execução, não uma página de IA genérica; primeira_impressão: calmo, preciso, técnico; anti_padrão: evitar o modelo genérico de hero + feature-card de IA-SaaS. Cena: expressiva → assunto_hero: "GLM-5.1" grande com um único acento; entrada: título + tagline fade-up escalonado; quebrar_simetria: números de especificação deslocados para um lado; contraste_focal: tipo grande contra espaço negativo profundo.
Suposições do Produto de Primeira Etapa
Assuma que a maioria dos usuários não fornece contexto de design avançado — não um arquivo Figma/MCP, sistema de design maduro, tokens, biblioteca de componentes, diretriz de marca
…
[truncado para tradução]