Communitygithub.com

bushnell

Concevoir une divulgation progressive qui offre une valeur immédiate aux débutants et une profondeur significative aux utilisateurs expérimentés. Utilisez-le pour les explorations hiérarchiques, les visualisations en couches, la navigation, les tableaux de bord et les expériences à usage répété ; évaluez à la fois la première rencontre et la centième utilisation.

Qu'est-ce que bushnell ?

La compétence « Bushnell » applique le principe de conception connu sous le nom de loi de Bushnell : « facile à apprendre, difficile à maîtriser ». Elle guide les concepteurs et développeurs d'agents IA pour créer des interfaces qui offrent une valeur immédiate dès les premières secondes d'interaction, tout en offrant une profondeur durable qui récompense l'utilisateur expérimenté lors de la centième utilisation. Cette approche est particulièrement adaptée aux fonctionnalités répétées comme les tableaux de bord, les visualisations en couches et la navigation complexe. La compétence propose une « échelle de divulgation » structurée (surface initiale, précision à la demande, investigation, preuve/méthode, mécanismes internes) pour organiser le contenu de manière progressive, ainsi que des directives explicites sur la préservation du contexte, la gestion des gestes concurrents et la récupération d'erreur. Elle insiste sur le fait que la profondeur ne vient pas du nombre de panneaux ou de contrôles, mais des relations significatives entre des éléments compréhensibles.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jwexler10/bushnell-skill/tree/HEAD/skills/bushnell

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Bushnell — Valeur immédiate, profondeur durable

Appliquez le principe de conception communément appelé loi de Bushnell : facile à apprendre, difficile à maîtriser. Pour un produit, cela signifie compris en quelques secondes, gratifiant après des utilisations répétées. La maîtrise doit découler d'une compréhension plus riche, pas du déchiffrage de l'interface.

Utilisez cette compétence pour concevoir comment la profondeur se dévoile. Établissez d'abord le but de la fonctionnalité et sa convivialité de base. Aucune compétence associée, bibliothèque de composants ou disposition de référentiel n'est requise.

Définir les deux récompenses

Récompense de première rencontre : ce qu'un nouvel utilisateur comprend ou gagne dans les premières secondes, avant d'apprendre les commandes ou d'explorer les détails. Un graphique peut rendre une tendance immédiatement visible ; un outil de création peut fournir un résultat de départ utile.

Récompense de la centième utilisation : ce qui reste significatif après la familiarité. Les sources utiles incluent une plus grande précision, de nouvelles relations entre des objets familiers, les preuves derrière une affirmation, des combinaisons expressives et les changements dans les propres données ou le travail de l'utilisateur.

N'offrez pas deux fois le même résumé à des tailles différentes. La couche plus profonde doit répondre à une nouvelle question ou soutenir une nouvelle action.

Construire une échelle de divulgation

La surface initiale répond à la question courante. Une action explicite et découvrable ouvre une question moins courante. Choisissez la scission en fonction des besoins de l'utilisateur, pas de la manière dont le backend stocke les données.

CoucheContenu appropriéObligation de conception
Surface initialeRésultat principal, visualisation primaire, statut essentielCommuniquer la valeur sans interaction exploratoire.
Précision à la demandeValeurs exactes, définitions, comparaisonsPrendre en charge l'accès par pointeur, clavier et tactile selon le cas ; éviter les éléments essentiels uniquement au survol.
InvestigationMembres, exemples, objets associés, détails modifiablesRendre le déclencheur et son résultat prévisibles.
Preuve ou méthodeSources, calculs, incertitude, limitesMaintenir la disponibilité et la compréhension sans submerger la tâche principale.
Mécanismes internesScores et identifiants destinés uniquement à l'implémentationExposer uniquement s'ils aident la tâche de l'utilisateur, avec des libellés significatifs.

Ce sont des rôles, pas des widgets obligatoires. Réduire une section ne crée pas en soi de la profondeur ; cela n'aide que lorsque le contenu initial est utile et que le contenu révélé répond à une question de suivi significative.

Appliquer le principe de manière récursive

Une fonctionnalité située à plusieurs couches de profondeur nécessite toujours un point d'entrée compréhensible et une raison d'explorer. Par exemple :

vue d'ensemble -> sélectionner un groupe -> inspecter un membre -> inspecter les preuves à l'appui

Chaque transition doit ajouter de la compréhension tout en préservant l'orientation. Plus de curiosité peut être nécessaire ; plus de littératie de l'interface ne devrait pas l'être.

La profondeur vient de relations significatives entre quelques éléments compréhensibles, pas du nombre de panneaux, de commandes ou de termes inventés. La grammaire visuelle d'un diagramme ne doit pas impliquer une relation, telle qu'une causalité, que les preuves ne peuvent pas soutenir.

Rendre le contrat d'interaction explicite

  • Résoudre les gestes concurrents. Définir ce que font la sélection, le glissement, les clics en arrière-plan, la recherche et la navigation lorsqu'ils coexistent. Éviter l'activation accidentelle.
  • Préserver le contexte. Une couche plus profonde doit conserver le parent ou offrir un moyen évident de revenir avec l'état pertinent intact. Utilisez des panneaux adjacents, un fil d'Ariane, une pile ou un autre motif adapté à l'appareil et à la tâche.
  • Répondre à la question posée. La sélection d'un élément dans un groupe doit expliquer cet élément dans ce contexte. Offrez son historique plus large comme un chemin séparé.
  • Réutiliser les conteneurs établis. Ajoutez un nouveau sujet à un motif de détail existant avant d'introduire un autre système de navigation.
  • Révéler délibérément. Évitez les infobulles permanentes qui dominent la surface pour répondre à une question rare.
  • Plier honnêtement. Indiquez les comptes ou l'étendue omis. Développer une liste ne doit pas modifier silencieusement le sens ou l'échelle des informations déjà affichées.
  • Rendre la récupération visible. Fournissez fermer, retour, réinitialiser ou annuler lorsque cela est pertinent. Préservez les ajustements délibérés de l'utilisateur à moins qu'il ne choisisse de les réinitialiser.

Adaptez la disposition et les gestes exacts aux besoins d'accessibilité et à l'espace disponible. Une disposition de bureau n'est pas une exigence pour un petit écran.

Concevoir le comportement que le système crée

Demandez ce que les gens feront, pas seulement ce que la fonctionnalité permet :

CapacitéComportement à vérifier
Points de données cliquablesInvestigation intentionnelle plutôt qu'ouverture de panneau sans but.
RechercheOrientation plutôt que navigation ou changement d'état indésirable.
Glisser, panoramique et zoomerUne vue plus claire avec un chemin de retour fiable.
Plusieurs couches de détailAccumulation de compréhension tout en conservant le contexte.
PersonnalisationUn contrôle utile sans faire de la configuration un prérequis.
Navigation profondeConfiance que l'utilisateur peut revenir sans perdre son travail.

Lorsque l'utilisation réelle contredit le comportement prévu, révisez la conception. La récupération et la continuité sont des conditions qui rendent l'exploration possible.

Rendre les idées non familières lisibles

Nommez le référent plutôt qu'une unité interne : préférez « 1,4 fois votre total hebdomadaire habituel » à un score inexpliqué. Gardez un adjectif connecté à la quantité et à la comparaison qui le soutiennent. Définissez les termes non familiers là où ils sont nécessaires.

Indiquez quand les preuves sont minces. Ne comblez pas une lacune avec une conclusion non étayée. Une explication générée facultative ne doit pas bloquer un résultat par ailleurs utile ; un travail obligatoire doit toujours communiquer honnêtement le progrès, l'échec et la récupération.

Flux de travail

  1. Localisez la fonctionnalité dans le parcours global de l'utilisateur. Identifiez qui la rencontre et ce qu'il sait déjà. Inspectez le produit existant ou le code lorsqu'il est disponible.
  2. Rédigez sa récompense de première rencontre et sa récompense de centième utilisation, une phrase chacune.
  3. Cartographiez l'action principale, la question qu'elle ouvre et la prochaine étape utile.
  4. Attribuez le contenu à l'échelle de divulgation. Supprimez les résumés et les contrôles en double qui ajoutent de l'apprentissage sans ajouter de valeur.
  5. Spécifiez la préservation du contexte, la priorité des gestes, l'accès accessible et la récupération.
  6. Utilisez les modèles d'implémentation établis lorsque l'implémentation est demandée.
  7. Examinez une fois en tant que nouvel utilisateur et une fois en tant qu'utilisateur revenant. Vérifiez le comportement ainsi que le bon fonctionnement technique des contrôles.

Pour une vue d'ensemble, privilégiez la valeur immédiate et une voie claire vers un matériel plus riche. Pour une fonctionnalité de profondeur moyenne, organisez autour des questions de l'utilisateur. Pour les preuves derrière une affirmation, priorisez la provenance, la portée, l'incertitude et le chemin de retour.

Éviter

  • Une surface qui ne dit rien tant qu'elle n'est pas utilisée.
  • Cacher des fonctionnalités essentielles ou l'accessibilité derrière la découverte.
  • Ajouter des contrôles, des graphiques ou des paramètres et appeler le résultat profondeur.
  • Exiger une terminologie interne pour comprendre des résultats ordinaires.
  • Remplacer le parent si complètement que l'utilisateur perd la question qu'il a posée.
  • Traiter les badges, les séquences ou les déverrouillages artificiels comme des substituts à une valeur significative.
  • Imposer des limites ou des mises en page spécifiques au produit sans vérifier le contexte actuel.

Lors de la remise, nommez les deux récompenses et le chemin de découverte. Adaptez l'explication à la tâche et étayez les affirmations sur le produit actuel par des observations réelles ou des références au code.

Skills associés