grill-me
par alirezarezvanigrill-me est un skill de Decision Support qui met plans et conceptions à l’épreuve au moyen d’un questionnement étape par étape, avec réponses recommandées, exploration du codebase et scripts d’aide pour extraire les branches de décision et suivre les sessions.
Ce skill obtient 78/100, ce qui en fait un bon candidat pour les utilisateurs d’un annuaire qui veulent qu’un agent interroge des plans ou des conceptions de façon plus systématique qu’un prompt générique. Il offre un schéma d’activation clair, une discipline d’interaction facile à retenir et des fichiers d’appui pratiques, même s’il faut s’attendre à une certaine ambiguïté de configuration et à des outils heuristiques plutôt qu’à un package de bout en bout parfaitement fini.
- Déclenchement très clair : le frontmatter indique explicitement de l’utiliser lorsque l’utilisateur veut éprouver un plan, se faire challenger sur une conception ou dit « grill me ».
- Les règles d’exécution sont concrètes : une question par tour, une réponse recommandée, exploration du codebase avant de poser une question, et parcours de l’arbre de décision en profondeur d’abord.
- Les ressources d’appui sont utiles : modèles de forcing questions, conditions d’arrêt et scripts Python pour extraire des branches de décision, générer des questions et suivre des sessions multi-tours.
- Aucune commande d’installation ni README n’est présent dans le chemin du skill ; les utilisateurs devront donc déduire l’installation à partir du dépôt global ou de leur configuration Claude Skills.
- Les outils associés reposent sur des heuristiques et des regex, et mentionnent un agent de persona ainsi qu’une slash command situés hors du répertoire du skill présenté ; leur adoption peut donc nécessiter davantage de contexte sur le dépôt.
Présentation de grill-me skill
Ce que fait grill-me
grill-me est une skill d’interrogation décisionnelle pour les workflows d’agents de type Claude. Au lieu de fournir un retour général sur un plan, elle vous interroge une question à la fois jusqu’à clarifier les embranchements, dépendances, arbitrages et hypothèses encore flous. Son fonctionnement est simple, mais très utile : poser une question qui oblige à trancher, proposer une réponse recommandée, attendre votre retour, puis poursuivre dans l’arbre de décision.
Cas d’usage idéal pour l’aide à la décision
Utilisez grill-me pour l’aide à la décision lorsque vous avez un plan produit, une conception technique, une proposition d’architecture, une stratégie de migration, une checklist de lancement ou un document de type « nous devrions faire X » à éprouver avant exécution. La skill est particulièrement utile lorsqu’un plan contient des TBD, des arbitrages vagues, des dépendances cachées ou des décisions prises par défaut plutôt que délibérément.
Ce qui distingue cette skill
Sa différence tient à sa discipline. Le grill-me skill ne regroupe pas dix questions, ne dérive pas vers une critique générique et ne laisse pas l’utilisateur répondre de façon floue. Il privilégie l’exploration du codebase plutôt que les questions inutiles, parcourt les branches en profondeur et pose des questions qui forcent à choisir, comme « Pourquoi X plutôt que Y ? » ou « Qu’est-ce qui vous convaincrait que cette approche est mauvaise ? ». Le dépôt inclut aussi des helpers Python sans dépendances externes, fondés uniquement sur la stdlib, pour extraire les branches de décision, générer des questions et suivre les sessions multi-tours.
Quand ce n’est pas le bon outil
N’installez pas grill-me si vous cherchez un plan finalisé rédigé de zéro, un partenaire léger de brainstorming ou une revue rapide de type “LGTM”. L’expérience est volontairement inconfortable : la skill est conçue pour ralentir la discussion, exposer les raisonnements fragiles et forcer les engagements. C’est puissant avant des décisions coûteuses, mais disproportionné pour des choix mineurs.
Comment utiliser grill-me skill
Installation de grill-me et chemin du dépôt
Installez avec :
npx skills add alirezarezvani/claude-skills --skill grill-me
La skill se trouve dans engineering/grill-me/skills/grill-me dans le dépôt. Commencez par lire SKILL.md, puis consultez les fichiers d’appui qui expliquent comment mener une meilleure session de grill : references/forcing_question_patterns.md, references/when_to_stop_grilling.md et references/companion_tooling.md. Les scripts sont dans scripts/ et ne nécessitent que la stdlib Python.
Entrées nécessaires pour utiliser grill-me
Pour un meilleur grill-me usage, fournissez un plan ou un artefact de conception, pas seulement un objectif vague. Une bonne entrée inclut :
- la décision que vous essayez de prendre
- l’approche actuellement proposée
- les alternatives envisagées
- les contraintes, échéances et risques connus
- les parties encore TBD ou politiquement sensibles
- des liens ou chemins vers le code, les docs, tickets ou notes d’architecture pertinents
Un prompt faible serait : « Grill me on this idea. »
Un prompt plus solide serait : « Use grill-me on docs/auth-migration.md. We plan to move sessions from Redis to Postgres before Q3. Focus on rollback, performance risk, and whether our dependency on the billing service is actually locked. »
Workflow pratique avec grill-me
Un workflow grill-me guide à bon signal ressemble à ceci :
- Placez le plan dans un fichier markdown.
- Demandez à l’agent d’utiliser
grill-meet de lire d’abord le plan. - Si la réponse se trouve dans le dépôt ou le codebase, laissez l’agent inspecter les fichiers au lieu de vous poser la question.
- Répondez à une seule question à la fois.
- Consignez les décisions lorsqu’elles sont verrouillées.
- Arrêtez-vous uniquement lorsque toutes les branches non résolues ont été épuisées.
Pour les plans plus importants, exécutez les scripts d’aide localement :
python scripts/decision_tree_extractor.py path/to/plan.md
python scripts/question_generator.py path/to/plan.md --output json
python scripts/grill_session_tracker.py --action start --session auth-migration --plan path/to/plan.md
Ces outils n’appellent pas de LLM. Ils aident à faire apparaître les branches de décision et à conserver l’état entre de longues sessions de revue.
Modèle de prompt efficace
Utilisez un prompt qui précise l’autorité, le périmètre et les règles d’arrêt :
“Use the grill-me skill for Decision Support on this plan: <path>. Ask one question per turn. Provide your recommended answer with each question. Explore the codebase before asking anything answerable from files. Walk dependencies depth-first. Track resolved decisions and tell me when every branch is answered or when no new questions arise.”
C’est important parce que la valeur de la skill vient de l’enchaînement. Si vous demandez « tous les retours d’un coup », vous contournez son principal avantage.
FAQ sur grill-me skill
grill-me sert-il uniquement aux plans d’ingénierie ?
Non. Le chemin du dépôt est orienté ingénierie, et la règle d’exploration du codebase est utile pour les projets logiciels, mais la méthode fonctionne aussi pour les décisions produit, opérations, recrutement, GTM et stratégie. Le meilleur cas d’usage est tout plan où des hypothèses cachées sont plus dangereuses qu’un manque de finition rédactionnelle.
En quoi est-ce mieux qu’un prompt ordinaire ?
Un prompt classique comme « critique ce plan » produit généralement une liste d’observations. grill-me crée une boucle d’interrogation. Chaque question est reliée à une branche de décision, inclut une réponse recommandée et attend votre réponse avant de continuer. C’est donc plus adapté pour résoudre l’ambiguïté, pas seulement pour la repérer.
Les débutants peuvent-ils utiliser grill-me ?
Oui, mais les débutants devraient commencer avec un plan court. La skill peut sembler intense, car elle demande des arbitrages, des critères d’abandon et des alternatives. Si vous ne maîtrisez pas encore le domaine, répondez honnêtement avec ce qui est inconnu ; la session pourra alors distinguer ce qui est simplement « non décidé » de ce qui est « bloqué par manque d’information ».
Que vérifier avant l’installation ?
Vérifiez que votre runtime d’agent prend en charge les skills depuis GitHub et que vous êtes à l’aise avec un workflow multi-tours. Prévisualisez aussi SKILL.md et les trois fichiers de référence. Si vous voulez utiliser les scripts d’aide, confirmez que vous pouvez exécuter des commandes Python localement et que l’écriture de JSON de session dans ~/.grill_sessions/ est acceptable dans votre environnement.
Comment améliorer grill-me skill
Fournir à grill-me des sources plus exploitables
Le moyen le plus rapide d’améliorer les sorties de grill-me est de rendre le plan plus inspectable. Ajoutez des sections pour les objectifs, non-objectifs, contraintes, alternatives, dépendances, déploiement progressif, rollback, métriques et questions ouvertes. L’extracteur de décisions cherche des signaux comme “we will”, “TBD”, “vs”, “depends on” et “trade-off” ; une formulation explicite aide donc le workflow à trouver les branches.
Éviter les modes d’échec fréquents
Les échecs courants consistent à poser trop de questions à la fois, accepter des réponses vagues, ignorer l’exploration du codebase ou s’arrêter après la première branche inconfortable. Si l’agent regroupe les questions, corrigez-le : “Return to grill-me: one question only, with a recommended answer.” S’il demande quelque chose déjà documenté, indiquez-lui le fichier et exigez qu’il l’inspecte avant de continuer.
Itérer après la première session
Après le premier grill, révisez le plan avec les décisions verrouillées et les risques nouvellement découverts. Puis exécutez à nouveau decision_tree_extractor.py. Cette deuxième passe met souvent en évidence de nouvelles branches introduites par vos réponses. Une bonne session se termine avec moins de TBD, des raisons de rejet plus claires pour les alternatives et des critères d’arrêt explicites pour les choix risqués.
Adapter la skill à votre équipe
Les équipes peuvent faciliter l’adoption en ajoutant des exemples locaux : un bon architecture decision record, un mauvais plan trop vague, les catégories de risques préférées et les critères de lancement standards. Gardez intacte la discipline centrale de grill-me, mais adaptez le style des réponses recommandées aux contraintes de votre organisation. L’objectif n’est pas de poser des questions plus dures ; c’est de construire plus vite une compréhension partagée avant d’engager un travail coûteux.