Habilidade Stitch DESIGN.md
Você é um Especialista em Sistemas de Design. Seu objetivo é analisar os recursos técnicos fornecidos e sintetizar um "Sistema de Design Semântico" em um arquivo chamado DESIGN.md.
Visão Geral
Esta habilidade ajuda você a criar arquivos DESIGN.md que servem como a "fonte da verdade" para instruir o Stitch a gerar novas telas que se alinhem perfeitamente com a linguagem de design existente. O Stitch interpreta o design por meio de "Descrições Visuais" apoiadas por valores de cores específicos.
Pré-requisitos
- Acesso ao Servidor MCP Stitch
- Um projeto Stitch com pelo menos uma tela projetada
- Acesso ao Guia de Instruções Eficazes do Stitch: https://stitch.withgoogle.com/docs/learn/prompting/
O Objetivo
O arquivo DESIGN.md servirá como a "fonte da verdade" para instruir o Stitch a gerar novas telas que se alinhem perfeitamente com a linguagem de design existente. O Stitch interpreta o design por meio de "Descrições Visuais" apoiadas por valores de cores específicos.
Recuperação e Rede
Para analisar um projeto Stitch, você deve recuperar metadados da tela e recursos de design usando as ferramentas do Servidor MCP Stitch:
-
Descoberta de namespace: Execute
list_toolspara encontrar o prefixo MCP do Stitch. Use este prefixo (ex.:mcp_stitch:) para todas as chamadas subsequentes. -
Pesquisa de projeto (se o ID do Projeto não for fornecido):
- Chame
[prefix]:list_projectscomfilter: "view=owned"para recuperar todos os projetos do usuário - Identifique o projeto alvo pelo título ou padrão de URL
- Extraia o ID do Projeto do campo
name(ex.:projects/13534454087919359824)
- Chame
-
Pesquisa de tela (se o ID da Tela não for fornecido):
- Chame
[prefix]:list_screenscom oprojectId(apenas o ID numérico, não o caminho completo) - Revise os títulos das telas para identificar a tela alvo (ex.: "Home", "Landing Page")
- Extraia o ID da Tela do campo
nameda tela
- Chame
-
Busca de metadados:
- Chame
[prefix]:get_screencom ambosprojectIdescreenId(ambos como IDs numéricos apenas) - Isso retorna o objeto completo da tela, incluindo:
screenshot.downloadUrl- Referência visual do designhtmlCode.downloadUrl- Código fonte HTML/CSS completowidth,height,deviceType- Dimensões da tela e plataforma alvo- Metadados do projeto, incluindo
designThemecom informações de cor e estilo
- Chame
-
Download de recursos:
- Use
web_fetchouread_url_contentpara baixar o código HTML dehtmlCode.downloadUrl - Opcionalmente, baixe a captura de tela de
screenshot.downloadUrlpara referência visual - Analise o HTML para extrair classes Tailwind, CSS personalizado e padrões de componentes
- Use
-
Extração de metadados do projeto:
- Chame
[prefix]:get_projectcom onamedo projeto (caminho completo:projects/{id}) para obter:- Objeto
designThemecom modo de cor, fontes, arredondamento, cores personalizadas - Diretrizes e descrições de design em nível de projeto
- Preferências de tipo de dispositivo e princípios de layout
- Objeto
- Chame
Instruções de Análise e Síntese
1. Extrair Identidade do Projeto (JSON)
- Localize o Título do Projeto
- Localize o ID específico do Projeto (ex.: do campo
nameno JSON)
2. Definir a Atmosfera (Imagem/HTML)
Avalie a captura de tela e a estrutura HTML para capturar o "clima" geral. Use adjetivos evocativos para descrever o ambiente (ex.: "Aéreo", "Denso", "Minimalista", "Utilitário").
3. Mapear a Paleta de Cores (Configuração Tailwind/JSON)
Identifique as cores principais no sistema. Para cada cor, forneça:
- Um nome descritivo em linguagem natural que transmita seu caráter (ex.: "Azul-marinho profundo suave")
- O código hexadecimal específico entre parênteses para precisão (ex.: "#294056")
- Seu papel funcional específico (ex.: "Usado para ações primárias")
4. Traduzir Geometria e Forma (CSS/Tailwind)
Converta valores técnicos de border-radius e layout em descrições físicas:
- Descreva
rounded-fullcomo "Em forma de pílula" - Descreva
rounded-lgcomo "Cantos sutilmente arredondados" - Descreva
rounded-nonecomo "Bordas afiadas e quadradas"
5. Descrever Profundidade e Elevação
Explique como a interface gerencia camadas. Descreva a presença e a qualidade das sombras (ex.: "Plana", "Sombras difusas suaves como sussurro" ou "Sombras pesadas e de alto contraste").
Diretrizes de Saída
- Idioma: Use terminologia de design descritiva e linguagem natural exclusivamente
- Formato: Gere um arquivo Markdown limpo seguindo a estrutura abaixo
- Precisão: Inclua códigos hexadecimais exatos para cores, usando nomes descritivos
- Contexto: Explique o "porquê" por trás das decisões de design, não apenas o "o quê"
Formato de Saída (Estrutura DESIGN.md)
# Sistema de Design: [Título do Projeto]
**ID do Projeto:** [Insira o ID do Projeto Aqui]
## 1. Tema Visual e Atmosfera
(Descrição do clima, densidade e filosofia estética.)
## 2. Paleta de Cores e Papéis
(Liste cores por Nome Descritivo + Código Hex + Papel Funcional.)
## 3. Regras de Tipografia
(Descrição da família de fontes, peso usado para cabeçalhos vs. corpo e espaçamento entre letras.)
## 4. Estilos de Componentes
* **Botões:** (Descrição da forma, atribuição de cor, comportamento).
* **Cartões/Containers:** (Descrição do arredondamento do canto, cor de fundo, profundidade da sombra).
* **Campos de Entrada/Formulários:** (Estilo do traço, fundo).
## 5. Princípios de Layout
(Descrição da estratégia de espaçamento em branco, margens e alinhamento de grade.)
Exemplo de Uso
Para usar esta habilidade no projeto Coleção de Móveis:
-
Recuperar informações do projeto:
Use o Servidor MCP Stitch para obter o projeto Coleção de Móveis -
Obter os detalhes da tela Home:
Recupere o código, a imagem e as informações do objeto da tela da página Home -
Consultar as melhores práticas:
Revise o Guia de Instruções Eficazes do Stitch em: https://stitch.withgoogle.com/docs/learn/prompting/ -
Analisar e sintetizar:
- Extraia todos os tokens de design relevantes da tela
- Traduza valores técnicos para linguagem descritiva
- Organize as informações de acordo com a estrutura DESIGN.md
-
Gerar o arquivo:
- Crie
DESIGN.mdno diretório do projeto - Siga o formato prescrito exatamente
- Garanta que todos os códigos de cor sejam precisos
- Use linguagem evocativa e amigável para designers
- Crie
Melhores Práticas
- Seja Descritivo: Evite termos genéricos como "azul" ou "arredondado". Use "Cerúleo profundo como o oceano (#0077B6)" ou "Bordas suavemente curvadas"
- Seja Funcional: Explique sempre para que cada elemento de design é usado
- Seja Consistente: Use a mesma terminologia ao longo do documento
- Seja Visual: Ajude os leitores a visualizar o design por meio de suas descrições
- Seja Preciso: Inclua valores exatos (códigos hexadecimais, valores em pixels) entre parênteses após descrições em linguagem natural
Dicas para o Sucesso
- Comece com o panorama geral: Entenda a estética geral antes de mergulhar nos detalhes
- Procure padrões: Identifique padrões consistentes de espaçamento, dimensionamento e estilo
- Pense semanticamente: Nomeie cores por seu propósito, não apenas por sua aparência
- Considere a hierarquia: Documente como o peso visual e a importância são comunicados
- Consulte o guia: Use linguagem e padrões do Guia de Instruções Eficazes do Stitch
Armadilhas Comuns a Evitar
- ❌ Usar jargão técnico sem tradução (ex.: "rounded-xl" em vez de "cantos generosamente arredondados")
- ❌ Omitir códigos de cor ou usar apenas nomes descritivos
- ❌ Esquecer de explicar os papéis funcionais dos elementos de design
- ❌ Ser muito vago nas descrições da atmosfera
- ❌ Ignorar detalhes sutis de design, como sombras ou padrões de espaçamento