Implementar Design
Visão Geral
Esta habilidade fornece um fluxo de trabalho estruturado para traduzir designs do Figma em código pronto para produção com precisão de pixels. Ela garante a integração consistente com o servidor MCP do Figma, o uso adequado de tokens de design e a paridade visual 1:1 com os designs.
Limites da Habilidade
- Use esta habilidade quando a entrega for código no repositório do usuário.
- Se o usuário pedir para criar/editar/excluir nós dentro do próprio Figma, mude para figma-use.
- Se o usuário pedir para construir ou atualizar uma tela de página inteira no Figma a partir de código ou de uma descrição, mude para figma-generate-design.
- Se o usuário pedir apenas mapeamentos do Code Connect, mude para figma-code-connect-components.
- Se o usuário pedir para criar regras de agente reutilizáveis (
CLAUDE.md/AGENTS.md), mude para figma-create-design-system-rules.
Pré-requisitos
- O servidor MCP do Figma deve estar conectado e acessível
- O usuário deve fornecer uma URL do Figma no formato:
https://figma.com/design/:fileKey/:fileName?node-id=1-2:fileKeyé a chave do arquivo1-2é o ID do nó (o componente ou frame específico a ser implementado)
- OU ao usar
figma-desktopMCP: O usuário pode selecionar um nó diretamente no aplicativo desktop do Figma (nenhuma URL necessária) - O projeto deve ter um sistema de design ou biblioteca de componentes estabelecido (preferencialmente)
Fluxo de Trabalho Obrigatório
Siga estas etapas em ordem. Não pule etapas.
Etapa 1: Obter ID do Nó
Opção A: Analisar a partir da URL do Figma
Quando o usuário fornecer uma URL do Figma, extraia a chave do arquivo e o ID do nó para passar como argumentos para as ferramentas MCP.
Formato da URL: https://figma.com/design/:fileKey/:fileName?node-id=1-2
Extrair:
- Chave do arquivo:
:fileKey(o segmento após/design/) - ID do nó:
1-2(o valor do parâmetro de consultanode-id)
Nota: Ao usar o MCP desktop local (figma-desktop), fileKey não é passado como parâmetro para as chamadas de ferramenta. O servidor usa automaticamente o arquivo atualmente aberto, portanto apenas o nodeId é necessário.
Exemplo:
- URL:
https://figma.com/design/kL9xQn2VwM8pYrTb4ZcHjF/DesignSystem?node-id=42-15 - Chave do arquivo:
kL9xQn2VwM8pYrTb4ZcHjF - ID do nó:
42-15
Opção B: Usar a Seleção Atual do Aplicativo Desktop Figma (apenas figma-desktop MCP)
Ao usar o MCP figma-desktop e o usuário NÃO forneceu uma URL, as ferramentas usam automaticamente o nó atualmente selecionado no arquivo Figma aberto no aplicativo desktop.
Nota: A solicitação baseada em seleção só funciona com o servidor MCP figma-desktop. O servidor remoto requer um link para um frame ou camada para extrair o contexto. O usuário deve ter o aplicativo desktop do Figma aberto com um nó selecionado.
Etapa 2: Buscar Contexto do Design
Execute get_design_context com a chave do arquivo e ID do nó extraídos.
get_design_context(fileKey=":fileKey", nodeId="1-2")
Isso fornece os dados estruturados, incluindo:
- Propriedades de layout (Auto Layout, restrições, dimensionamento)
- Especificações tipográficas
- Valores de cores e tokens de design
- Estrutura e variantes de componentes
- Valores de espaçamento e preenchimento
Se a resposta for muito grande ou truncada:
- Execute
get_metadata(fileKey=":fileKey", nodeId="1-2")para obter o mapa de nós de alto nível - Identifique os nós filhos específicos necessários a partir dos metadados
- Busque nós filhos individuais com
get_design_context(fileKey=":fileKey", nodeId=":childNodeId")
Etapa 3: Capturar Referência Visual
Execute get_screenshot com a mesma chave do arquivo e ID do nó para uma referência visual.
get_screenshot(fileKey=":fileKey", nodeId="1-2")
Este screenshot serve como fonte da verdade para a validação visual. Mantenha-o acessível durante toda a implementação.
Etapa 4: Baixar Assets Necessários
Baixe todos os assets (imagens, ícones, SVGs) retornados pelo servidor MCP do Figma.
IMPORTANTE: Siga estas regras de assets:
- Se o servidor MCP do Figma retornar uma fonte
localhostpara uma imagem ou SVG, use essa fonte diretamente - NÃO importe ou adicione novos pacotes de ícones - todos os assets devem vir do payload do Figma
- NÃO use ou crie placeholders se uma fonte
localhostfor fornecida - Os assets são servidos através do endpoint de assets integrado do servidor MCP do Figma
Etapa 5: Traduzir para as Convenções do Projeto
Traduza a saída do Figma para a estrutura, estilos e convenções deste projeto.
Princípios-chave:
- Trate a saída do MCP Figma (tipicamente React + Tailwind) como uma representação do design e comportamento, não como estilo de código final
- Substitua classes utilitárias do Tailwind pelas utilitárias preferidas do projeto ou tokens do sistema de design
- Reutilize componentes existentes (botões, entradas, tipografia, wrappers de ícones) em vez de duplicar funcionalidades
- Use o sistema de cores, escala tipográfica e tokens de espaçamento do projeto de forma consistente
- Respeite os padrões existentes de roteamento, gerenciamento de estado e busca de dados
Etapa 6: Alcançar Paridade Visual 1:1
Esforce-se para obter paridade visual de pixel perfeito com o design do Figma.
Diretrizes:
- Priorize a fidelidade ao Figma para corresponder exatamente aos designs
- Evite valores codificados - use tokens de design do Figma quando disponíveis
- Quando surgirem conflitos entre os tokens do sistema de design e as especificações do Figma, prefira os tokens do sistema de design, mas ajuste espaçamentos ou tamanhos minimamente para corresponder aos visuais
- Siga os requisitos WCAG para acessibilidade
- Adicione documentação de componentes conforme necessário
Etapa 7: Validar Contra o Figma
Antes de marcar como concluído, valide a UI final contra o screenshot do Figma.
Lista de verificação de validação:
- Layout corresponde (espaçamento, alinhamento, dimensionamento)
- Tipografia corresponde (fonte, tamanho, peso, altura da linha)
- Cores correspondem exatamente
- Estados interativos funcionam como projetado (hover, ativo, desabilitado)
- Comportamento responsivo segue as restrições do Figma
- Assets renderizam corretamente
- Padrões de acessibilidade atendidos
Regras de Implementação
Organização de Componentes
- Coloque os componentes de UI no diretório designado do sistema de design do projeto
- Siga as convenções de nomenclatura de componentes do projeto
- Evite estilos inline, a menos que sejam realmente necessários para valores dinâmicos
Integração com o Sistema de Design
- Use SEMPRE componentes do sistema de design do projeto quando possível
- Mapeie tokens de design do Figma para tokens de design do projeto
- Quando um componente correspondente existir, estenda-o em vez de criar um novo
- Documente quaisquer novos componentes adicionados ao sistema de design
Qualidade do Código
- Evite valores codificados - extraia para constantes ou tokens de design
- Mantenha componentes componíveis e reutilizáveis
- Adicione tipos TypeScript para props de componentes
- Inclua comentários JSDoc para componentes exportados
Exemplos
Exemplo 1: Implementando um Componente de Botão
Usuário diz: "Implemente este componente de botão do Figma: https://figma.com/design/kL9xQn2VwM8pYrTb4ZcHjF/DesignSystem?node-id=42-15"
Ações:
- Analisar URL para extrair fileKey=
kL9xQn2VwM8pYrTb4ZcHjFe nodeId=42-15 - Executar
get_design_context(fileKey="kL9xQn2VwM8pYrTb4ZcHjF", nodeId="42-15") - Executar
get_screenshot(fileKey="kL9xQn2VwM8pYrTb4ZcHjF", nodeId="42-15")para referência visual - Baixar quaisquer ícones de botão do endpoint de assets
- Verificar se o projeto tem um componente de botão existente
- Se sim, estendê-lo com uma nova variante; se não, criar novo componente usando as convenções do projeto
- Mapear cores do Figma para tokens de design do projeto (por exemplo,
primary-500,primary-hover) - Validar contra o screenshot para preenchimento, raio de borda, tipografia
Resultado: Componente de botão correspondendo ao design do Figma, integrado ao sistema de design do projeto.
Exemplo 2: Construindo um Layout de Dashboard
Usuário diz: "Construa este dashboard: https://figma.com/design/pR8mNv5KqXzGwY2JtCfL4D/Dashboard?node-id=10-5"
Ações:
- Analisar URL para extrair fileKey=
pR8mNv5KqXzGwY2JtCfL4De nodeId=10-5 - Executar
get_metadata(fileKey="pR8mNv5KqXzGwY2JtCfL4D", nodeId="10-5")para entender a estrutura da página - Identificar seções principais a partir dos metadados (cabeçalho, barra lateral, área de conteúdo, cartões) e seus IDs de nós filhos
- Executar
get_design_context(fileKey="pR8mNv5KqXzGwY2JtCfL4D", nodeId=":childNodeId")para cada seção principal - Executar
get_screenshot(fileKey="pR8mNv5KqXzGwY2JtCfL4D", nodeId="10-5")para a página inteira - Baixar todos os assets (logotipos, ícones, gráficos)
- Construir layout usando primitivas de layout do projeto
- Implementar cada seção usando componentes existentes quando possível
- Validar comportamento responsivo contra as restrições do Figma
Resultado: Dashboard completo correspondendo ao design do Figma com layout responsivo.
Melhores Práticas
Sempre Comece com Contexto
Nunca implemente com base em suposições. Sempre busque get_design_context e get_screenshot primeiro.
Validação Incremental
Valide frequentemente durante a implementação, não apenas no final. Isso detecta problemas precocemente.
Documente Desvios
Se você precisar desviar do design do Figma (por exemplo, por questões de acessibilidade ou restrições técnicas), documente o motivo em comentários de código.
Reutilização sobre Recriação
Sempre verifique se há componentes existentes antes de criar novos. A consistência em todo o código é mais importante do que a replicação exata do Figma.
Sistema de Design Primeiro
Em caso de dúvida, prefira os padrões do sistema de design do projeto em vez da tradução literal do Figma.
Problemas Comuns e Soluções
Problema: Saída do Figma está truncada
Causa: O design é muito complexo ou tem muitas camadas aninhadas para retornar em uma única resposta.
Solução: Use get_metadata para obter a estrutura do nó e, em seguida, busque nós específicos individualmente com get_design_context.
Problema: Design não corresponde após a implementação
Causa: Discrepâncias visuais entre o código implementado e o design original do Figma. Solução: Compare lado a lado com o screenshot da Etapa 3. Verifique espaçamento, cores e valores de tipografia nos dados de contexto do design.
Problema: Assets não carregam
Causa: O endpoint de assets do servidor MCP do Figma não está acessível ou as URLs estão sendo modificadas.
Solução: Verifique se o endpoint de assets do servidor MCP do Figma está acessível. O servidor serve assets em URLs localhost. Use estas diretamente sem modificação.
Problema: Valores de token de design diferem do Figma
Causa: Os tokens do sistema de design do projeto têm valores diferentes daqueles especificados no design do Figma. Solução: Quando os tokens do projeto diferirem dos valores do Figma, prefira os tokens do projeto para consistência, mas ajuste espaçamento/dimensionamento para manter a fidelidade visual.
Entendendo a Implementação de Design
O fluxo de trabalho de implementação do Figma estabelece um processo confiável para traduzir designs em código:
Para designers: Confiança de que as implementações corresponderão aos seus designs com precisão de pixels. Para desenvolvedores: Uma abordagem estruturada que elimina suposições e reduz revisões de ida e volta. Para equipes: Implementações consistentes e de alta qualidade que mantêm a integridade do sistema de design.
Ao seguir este fluxo de trabalho, você garante que cada design do Figma seja implementado com o mesmo nível de cuidado e atenção aos detalhes.