ios-design-guidelines

Visão geral do skill ios-design-guidelines

O skill ios-design-guidelines ajuda você a revisar, ajustar e reescrever interfaces de iPhone com base no Apple Human Interface Guidelines sem precisar ler toda a fonte antes. Ele é especialmente útil em tarefas com SwiftUI e UIKit em que layout, navegação, acessibilidade, Dynamic Type, Dark Mode ou a escolha de componentes do sistema podem definir o sucesso ou o fracasso da interface.

Use o skill ios-design-guidelines quando precisar de orientação prática para uma decisão real de interface, e não de teoria abstrata de design. Ele é uma boa opção para designers, engenheiros iOS e agentes de revisão que precisam identificar rápido erros evitáveis de HIG: áreas de toque pequenas demais, layouts inseguros, navegação fora do padrão, tamanhos de texto fixos ou suporte de acessibilidade ausente.

Para que esse skill é melhor

A principal tarefa que ele resolve é transformar uma ideia de UI ainda crua em uma implementação ou checklist de revisão adequado para iPhone. O ponto forte do skill é quando você quer padrões alinhados à Apple, exemplos em SwiftUI/UIKit e checagens concretas de regras, em vez de conselhos genéricos do tipo “deixe mais intuitivo”.

Onde ele gera valor real

Ele é especialmente útil quando você está decidindo entre padrões comuns de iOS: tab bar versus navegação customizada, comportamento de safe area, ações fixadas na parte inferior, escala de texto, cores semânticas e gestos do sistema. Isso faz do guia ios-design-guidelines uma ferramenta mais orientada a decisão do que uma leitura rápida do repositório.

Quando não é a melhor opção

Se você precisa de estratégia de produto ampla, orientação de design multiplataforma ou padrões de Android/web, esse skill não é a fonte certa. Ele também tende a ser menos útil para trabalhos puramente visuais de branding que não dependem de convenções de iOS.

Como usar o skill ios-design-guidelines

Instale e inspecione os arquivos certos

Instale com npx skills add ehmo/platform-design-skills --skill ios-design-guidelines. Para que a instalação do ios-design-guidelines realmente valha a pena, leia primeiro SKILL.md, depois AGENTS.md, metadata.json e rules/_sections.md. Esses arquivos mostram o escopo do skill, as prioridades das regras e os poucos grupos de regras que você tem maior chance de aplicar.

Transforme um objetivo vago em um prompt útil

O melhor uso do ios-design-guidelines começa com um contexto específico de interface. Inclua plataforma, tipo de tela, tarefa do usuário e risco atual. Por exemplo: “Revise esta tela de checkout em SwiftUI para iPhone, com foco em posicionamento na thumb zone, safe areas, touch targets e Dynamic Type. Sugira apenas mudanças que preservem o fluxo atual.” Isso dá ao skill algo acionável, em vez de um genérico “melhore meu app”.

Que tipo de entrada melhora a qualidade da saída

Forneça o trecho relevante da UI, a lista de componentes e as restrições: só iPhone ou universal, SwiftUI ou UIKit, versão de iOS suportada e quaisquer comportamentos que precisam ser mantidos. Se estiver pedindo uma reescrita, inclua o código atual ou a estrutura da tela para que o skill consiga mapear as regras para controles reais, sem adivinhação.

Fluxo prático a seguir

Comece com uma passada de revisão focada e, depois, peça uma segunda passada mais restrita sobre qualquer área de risco: navegação, acessibilidade ou layout. Por exemplo: primeiro peça os erros de HIG de maior prioridade e, em seguida, uma implementação corrigida apenas para os três principais problemas. Isso mantém o uso do ios-design-guidelines eficiente e facilita aplicar as correções.

Perguntas frequentes sobre o skill ios-design-guidelines

Isso serve só para SwiftUI?

Não. O skill ios-design-guidelines cobre tanto SwiftUI quanto UIKit, então funciona para projetos novos e também para refatorações de legado. Use-o para comparar escolhas de implementação com as convenções de iPhone, não apenas para gerar código.

Em que ele é diferente de um prompt comum?

Um prompt comum muitas vezes gera conselhos superficiais de UI. Este skill foi construído em torno de regras específicas da Apple e de modos de falha frequentes, então o guia ios-design-guidelines é melhor quando você precisa de recomendações revisáveis, nativas de iPhone e com menos suposição.

Preciso ser especialista em iOS para usar?

Não. Iniciantes conseguem usar bem o skill se descreverem a tela com clareza e fornecerem o código ou o layout que já têm. A principal limitação é a qualidade da entrada: se o prompt for vago, a saída também será vaga.

Quando devo evitar usar?

Evite para interfaces que não sejam de iPhone, mockups apenas de marca ou casos em que você queira explicitamente quebrar o comportamento padrão do iOS. Se seu objetivo for um padrão de interação novo, o skill ios-design-guidelines pode, com razão, puxar você de volta para as convenções do sistema.

Como melhorar o skill ios-design-guidelines

Dê ao skill o contexto de regra de que ele precisa

Os melhores resultados aparecem quando você identifica quais partes da interface têm mais chance de falhar numa revisão de HIG. Diga se a prioridade é layout, navegação, tipografia, cor ou acessibilidade, para que o skill ios-design-guidelines possa ponderar o feedback em vez de espalhar a atenção demais.

Peça mudanças, não só comentários

Se você quer ajuda de implementação, peça uma estrutura de tela revisada, código corrigido em SwiftUI/UIKit ou uma lista de correções priorizadas. O skill fica mais útil quando consegue transformar um problema em ação explícita, como aumentar touch targets, mover ações principais para a thumb zone ou restaurar a conformidade com safe areas.

Fique atento aos erros mais comuns

As falhas mais frequentes costumam ser navegação customizada que briga com o iOS, texto que não escala e sinais de estado só visuais que falham em acessibilidade. Se a primeira resposta parecer genérica demais, adicione restrições concretas como “deve preservar a navegação atual” ou “deve suportar Dynamic Type extra large” para forçar um uso melhor do ios-design-guidelines.

Itere com um segundo prompt mais estreito

Depois da primeira resposta, rode o skill novamente na área de risco mais importante, em vez de pedir outra revisão completa. Por exemplo: “Agora verifique apenas acessibilidade para VoiceOver, Reduce Motion e contraste.” Isso gera feedback mais preciso e torna a instalação do ios-design-guidelines mais valiosa em projetos reais.