hig-components-menus
par raintree-technologyhig-components-menus est un skill de recommandations Apple HIG pour les menus et les surfaces de commande pilotées par des boutons. Utilisez le skill hig-components-menus pour les décisions de conception d’interface concernant les menus, les menus contextuels, les barres d’outils, les barres de menus et les contrôles associés, lorsque vous avez besoin de conseils propres à Apple sur le placement des commandes, leur regroupement et leur comportement.
Ce skill obtient 82/100, ce qui en fait une fiche solide pour les utilisateurs qui ont besoin de recommandations Apple HIG sur les menus et les boutons. Il offre aux agents un périmètre d’activation clair, des repères de décision concrets et suffisamment de contenu de référence structuré pour agir avec moins d’hésitation qu’avec un prompt générique, même s’il s’agit davantage d’un index de recommandations que d’un workflow d’automatisation pas à pas.
- Déclenchement très clair : la description nomme de nombreux besoins utilisateurs explicites et plusieurs types de composants, ce qui facilite une invocation pertinente par un agent.
- Couverture solide adossée à des sources : le contenu relie menus, menus contextuels, menus d’édition, barre de menus, barres d’outils, boutons d’action, boutons popup/pull-down, contrôles de divulgation et boutons standards.
- Références croisées utiles et attribution des sources : 11 fichiers de référence pointent vers des pages Apple HIG canoniques, ce qui améliore la confiance et la navigation.
- Légère sur le plan opérationnel : le dépôt est surtout composé de contenu de référence organisé, sans scripts ni commande d’installation pour soutenir une exécution procédurale.
- Largeur parfois au détriment de la profondeur : la description est étendue, mais les extraits visibles du contenu suggèrent des recommandations plutôt générales, et l’agent peut devoir synthétiser les sources.
Aperçu de la skill hig-components-menus
hig-components-menus est une skill de recommandations Apple HIG pour concevoir des menus et des surfaces de commande pilotées par boutons sur les plateformes Apple. Utilisez la skill hig-components-menus lorsque vous avez besoin d’orientations concrètes sur les menus, les menus contextuels, les menus du Dock, les menus d’édition, la barre de menus, les barres d’outils, les boutons d’action, les boutons contextuels, les boutons déroulants, les contrôles de dévoilement ou les boutons standards.
Cette skill est particulièrement adaptée aux UI designers, product designers, frontend engineers et agents IA qui génèrent des recommandations d’interface au style Apple. Le vrai besoin n’est pas seulement « qu’est-ce qu’un menu ? », mais plutôt « quel contrôle doit aller ici, que doit-il contenir et comment doit-il se comporter pour rester conforme aux conventions Apple et prévisible ? »
Ce qu’elle aide à décider
Le guide hig-components-menus est utile lorsque la question de conception porte sur le placement des commandes, et pas uniquement sur le rendu visuel. Il aide à choisir entre des actions dans une barre d’outils, des commandes de barre de menus, des menus contextuels et des contrôles intégrés ; à éviter de surcharger les menus avec des éléments peu utiles ; et à garder les libellés, l’ordre et le regroupement alignés sur les attentes de la plateforme.
Pourquoi l’installer
Par rapport à un prompt générique, hig-components-menus apporte une couverture HIG structurée, ainsi que des renvois vers des sujets voisins comme les boutons, les menus contextuels, les menus d’édition et les barres d’outils. C’est donc plus solide pour les décisions qui dépendent des frontières entre composants et du comportement attendu, surtout quand vous avez besoin d’une cohérence propre à Apple plutôt que de conseils UI trop larges.
Cas d’usage adaptés et cas où ce n’est pas pertinent
Installez hig-components-menus si vous concevez pour les plateformes Apple ou si vous transformez une intention produit en interface alignée sur l’Apple HIG. Évitez-le si vous avez besoin de code de framework, de détails d’implémentation de composants ou de systèmes de design non Apple ; cette skill concerne les recommandations de conception et les choix d’interaction, pas les API SDK.
Comment utiliser la skill hig-components-menus
Installez-la et ouvrez le bon fichier d’entrée
Utilisez le chemin d’installation de hig-components-menus fourni par le répertoire, puis commencez par SKILL.md. Les fichiers d’accompagnement les plus utiles sont les pages de references/, car elles découpent les grandes familles de composants en sections lisibles. Pour un premier tri rapide, consultez d’abord references/menus.md, references/buttons.md, references/context-menus.md et references/toolbars.md.
Donnez-lui un problème UI concret
L’usage de hig-components-menus fonctionne mieux si vous décrivez l’écran, la plateforme et l’objectif utilisateur plutôt que de demander un conseil de design abstrait. Une bonne demande nomme la source de commande, le contexte et la contrainte :
- « Concevoir la surface de commande pour un éditeur de documents macOS avec 8 actions fréquentes et 12 actions occasionnelles. »
- « Faut-il placer supprimer, dupliquer et partager dans la barre d’outils, le menu contextuel ou la barre de menus sur iPadOS ? »
- « En quoi un menu contextuel à la manière d’Apple devrait-il différer entre du texte sélectionné et un élément de fichier ? »
Si vous dites seulement « concevez mon menu », la skill devra deviner le modèle d’interaction et sera moins utile.
Lisez les références dans l’ordre de la décision
Un guide pratique hig-components-menus commence généralement par le composant principal, puis se resserre sur les cas particuliers. Lisez references/menus.md pour les règles de libellé et d’organisation, references/context-menus.md pour la pertinence et le nombre d’éléments, et references/toolbars.md lorsque vous décidez ce qui doit rester toujours visible. Utilisez references/the-menu-bar.md pour l’architecture des commandes sur macOS et references/edit-menus.md quand la modification de texte intervient.
Adoptez un flux de travail orienté décision
Demandez d’abord à la skill de trancher sur le choix du contrôle, puis sur le contenu, puis sur l’ordre. Un bon format de prompt est :
- Plateforme : macOS, iPadOS, iOS ou visionOS
- Objet : sélection, document, message, fichier ou commande à l’échelle de l’app
- Ensemble d’actions : actions principales, secondaires, destructives et indisponibles
- Contrainte : espace, découvrabilité, prise en charge clavier ou cohérence
Cette structure aide la skill hig-components-menus à fournir une réponse plus précise sur l’emplacement des commandes et sur ce qui doit être masqué, regroupé ou mis en avant.
FAQ de la skill hig-components-menus
hig-components-menus concerne-t-elle seulement les menus ?
Non. La skill hig-components-menus couvre les menus et les patterns de boutons adjacents qui donnent accès aux commandes, notamment les boutons d’action, les boutons contextuels, les boutons déroulants, les contrôles de dévoilement, les barres d’outils et les boutons standards. Cette portée plus large est utile, car de nombreuses décisions UI Apple dépendent du fait qu’une action soit exposée comme bouton, comme élément de menu ou comme les deux.
Quand ne faut-il pas utiliser cette skill ?
N’utilisez pas hig-components-menus si votre question porte surtout sur l’identité visuelle, les animations personnalisées ou le code des composants. Elle n’est pas non plus adaptée si vous concevez pour un écosystème non Apple et n’avez pas besoin du comportement HIG d’Apple. Pour les détails d’implémentation, associez-la plutôt à la documentation du framework.
En quoi est-elle différente d’un prompt classique ?
Un prompt classique peut proposer une structure de menu, mais la skill hig-components-menus est calibrée sur les arbitrages propres à Apple : hiérarchie des commandes, conventions de plateforme, densité des menus et choix entre actions visibles ou actions masquées. En pratique, cela réduit les approximations quand il faut une interface qui paraît native sur les appareils Apple.
Est-elle adaptée aux débutants ?
Oui, si vous savez décrire l’écran et les actions concernées. Vous n’avez pas besoin d’une connaissance approfondie de l’HIG pour commencer à utiliser hig-components-menus, mais vous devez fournir assez de contexte pour indiquer ce que fait l’utilisateur et quelles commandes sont disponibles. Plus votre scénario est précis, meilleure sera la recommandation.
Comment améliorer la skill hig-components-menus
Fournissez des inventaires d’actions, pas seulement des objectifs
Le plus gros gain de qualité vient du fait de lister les actions réelles. Au lieu de dire « rendez cela plus simple », donnez à la skill l’ensemble des commandes et indiquez lesquelles sont fréquentes, rares, destructives ou contextuelles. Cela permet à hig-components-menus d’évaluer si une barre d’outils, un menu ou un menu contextuel est approprié, et si un élément doit être masqué ou rendu visible.
Indiquez explicitement la plateforme et le déclencheur
Un pattern de menu adapté à macOS peut être inadapté sur iOS ou iPadOS. Précisez si l’utilisateur invoque la commande par clic, clic secondaire, appui prolongé, clavier ou navigation dans la barre de menus. C’est important, car le guide hig-components-menus est sensible aux parcours d’interaction propres à chaque plateforme, en particulier pour les menus contextuels et les menus d’édition.
Demandez les arbitrages, pas seulement la réponse finale
Si la première réponse vous paraît générique, poursuivez en demandant pourquoi une commande doit être placée ici plutôt que là. Par exemple : « Quels éléments devraient passer du menu contextuel à la barre d’outils, et quel est le coût en découvrabilité ? » Cela rend l’usage de hig-components-menus plus utile, car la sortie devient un support à la décision, et pas seulement une liste.
Surveillez les modes d’échec courants
Les erreurs les plus fréquentes sont les menus surchargés, les commandes dupliquées sans priorité claire et les actions essentielles cachées derrière des gestes secondaires. Utilisez la skill pour détecter ces problèmes tôt. Si la première sortie vous paraît trop dense, demandez un ensemble réduit d’éléments à forte valeur et une séparation plus stricte entre actions principales et secondaires.