Votre Ingénieur Prompt

Aperçu

Transformez une demande approximative d'un utilisateur en un prompt de délégation précis, sélectionnez le mode d'agent approprié, affichez le prompt préparé à l'utilisateur et transmettez-le après confirmation lorsque l'hôte actuel expose un mécanisme de délégation.

Codex et Claude Code sont des cibles de première classe. Les autres hôtes d'agents compatibles doivent utiliser le même comportement de préparation de prompt, validation de cible, confirmation et barrière de sécurité, puis dispatcher via les outils natifs de l'hôte lorsqu'ils sont disponibles. Si aucun outil de dispatch n'est disponible, fournissez le prompt préparé et des instructions de transfert claires, sans prétendre que la tâche a été envoyée.

Prenez en charge le chinois, l'anglais et le japonais dans la communication avec l'utilisateur. Choisissez la langue du prompt qui convient le mieux à l'exécution : généralement l'anglais pour les tâches techniques/de code, et la langue du projet ou du public pour les tâches d'écriture, de localisation ou spécifiques au domaine. Les réponses destinées au client de l'utilisateur doivent suivre la langue du projet ; en cas d'ambiguïté, suivez la langue actuelle de l'utilisateur.

Invocation

N'obligez pas l'utilisateur à taper $votre-ingénieur-prompt. Traitez l'invocation explicite de la compétence et l'intention en langage naturel comme équivalentes.

Pour un comportement fiable sur tous les hôtes, préférez l'invocation explicite :

Utilisez $votre-ingénieur-prompt <votre demande approximative>

L'invocation en langage naturel peut fonctionner lorsque l'hôte prend en charge la découverte implicite de compétences personnelles, mais l'invocation explicite est recommandée pour un comportement prévisible de préparation, de confirmation et de dispatch du prompt.

Si l'utilisateur combine un langage de préparation de prompt/exigence avec un langage de délégation d'agent, utilisez cette compétence avant tout outil de délégation ou compétence d'agent parallèle. Ne dispatchez pas d'agents en premier et ne résumez pas plus tard, sauf si l'utilisateur a explicitement demandé un envoi direct.

Déclenchez-vous sur des demandes telles que :

"Aide-moi à écrire un prompt"
"Écris un prompt pour que l'agent le fasse"
"Transforme cela en prompt d'agent"
"Optimise ce prompt, puis demande-moi si je veux l'envoyer à l'agent"
"Aide-moi à organiser les exigences, que le sous-agent vérifie d'abord ce projet en lecture seule"
"Transforme cela en prompt de sous-agent"
"envoie ce prompt à un agent"
"transforme cela en un prompt de tâche Claude Code"
"écris un prompt à donner à l'agent"

Ne vous déclenchez pas implicitement lorsque l'utilisateur demande d'exécuter, de lancer, de dispatcher, de déléguer, d'inspecter, de corriger, d'implémenter ou de vérifier quelque chose avec un agent/sous-agent mais ne mentionne pas l'écriture ou la préparation de prompt. Dans ce cas, préférez le comportement de délégation normal de l'hôte, sauf si l'utilisateur invoque explicitement $votre-ingénieur-prompt.

Workflow

Identifiez si l'utilisateur souhaite une préparation de prompt, une délégation d'agent, ou les deux.
Déterminez si la demande est suffisamment claire pour être exécutée ou si elle nécessite une exploration.
Extrayez l'intention de la tâche, l'objet cible, le résultat, les contraintes, le signal d'acceptation, le niveau de risque, la langue et le meilleur adaptateur hôte.
Résolvez la cible de la tâche avant d'écrire le prompt.
Choisissez le mode confirmation d'abord, envoi direct ou exploration d'abord.
Produisez un prompt préparé en utilisant references/prompt-templates.md.
Affichez le prompt à l'utilisateur et demandez s'il faut l'envoyer, sauf si le mode d'envoi direct s'applique. Préférez l'interface native de choix interactif de l'hôte lorsqu'elle est disponible.
Après confirmation ou instruction explicite d'envoi direct, dispatchez avec le meilleur adaptateur hôte disponible.
Signalez le type d'agent/outil utilisé et l'identifiant de l'agent ou le descripteur de tâche lorsqu'il est disponible.

Ne sautez l'étape de confirmation que lorsque l'utilisateur dit explicitement d'envoyer directement, de dispatcher automatiquement ou de ne pas demander de confirmation.

Modes de Dispatch

Utilisez le mode confirmation d'abord par défaut : préparez le prompt, montrez-le à l'utilisateur et demandez s'il faut l'envoyer.
Utilisez le mode envoi direct uniquement lorsque l'utilisateur dit explicitement "envoyer directement", "pas de confirmation", "dispatch automatique" ou une formulation équivalente en japonais.
Utilisez le mode exploration d'abord lorsque la demande est vague mais peut être investiguée à partir du contexte actuel. Préparez un prompt d'exploration pour une tâche d'exploration/lecture seule avant de préparer un prompt d'exécution.

Exigez toujours une confirmation avant de dispatcher si la tâche peut affecter les systèmes de production, les déploiements, les comptes, la facturation, les identifiants, les API externes, les données sensibles, le contenu juridique/conforme, ou les modifications multi-fichiers larges, même si l'utilisateur préfère généralement l'automatisation.

Extraction de l'Intention

Avant d'écrire le prompt final, extrayez :

Objectif : le résultat concret.
Cible : fichiers, dépôt, produit, document, texte, page, problème, jeu de données ou système.
Résultat : implémentation, rapport, plan, document, prompt, résultat de test ou autre livrable.
Contraintes : exigences énoncées par l'utilisateur, exclusions, style, plateforme, outils, temps, budget ou portée.
Acceptation : comment l'agent peut savoir qu'il a terminé.
Risque : production, compte, argent, confidentialité, sécurité, conformité ou impact à grande échelle.
Langue : langue de l'utilisateur, langue du projet, langue du client et meilleure langue d'exécution.
Hôte : Codex, Claude Code, hôte d'agent compatible, ou indisponible/inconnu.
Type d'agent : explorateur, travailleur, par défaut, ou plusieurs agents indépendants.

Si un champ est manquant mais peut être déduit en toute sécurité, ajoutez-le comme hypothèse explicite dans le prompt. Si l'objectif ou la cible est manquant et non déductible, posez une question de suivi concise.

Résolution de Cible

Ne traitez pas "projet", "ce projet", "projet actuel" comme une cible valide à moins que l'espace de travail actuel ne semble contenir un projet réel ou que l'utilisateur n'ait fourni un chemin, un dépôt, un fichier, un problème, un document ou un autre objet concret.

Un espace de travail est probablement un projet valide lorsqu'il contient des indicateurs de projet tels que :

.git/
package.json, pnpm-lock.yaml, pyproject.toml, requirements.txt, go.mod, Cargo.toml, pom.xml, build.gradle, Gemfile, composer.json
des répertoires sources d'application tels que src/, app/, pages/, lib/, server/ ou tests/
des actifs de produit/document clairement nommés par l'utilisateur

Un espace de travail n'est pas suffisant en soi lorsqu'il s'agit d'un répertoire généré, vide ou sans projet, surtout s'il ne contient que des dossiers tels que work/, outputs/, des fichiers temporaires, ou aucun indicateur de projet reconnaissable.

Lorsque la cible est manquante, posez une question concise avant de produire un prompt :

Sur quel projet souhaitez-vous que l'agent travaille ? Veuillez fournir le chemin du projet, le dépôt, le dossier, ou rouvrir la session dans l'espace de travail du projet cible.

Dans des contextes anglais ou japonais, posez la même question dans la langue de l'utilisateur. Ne produisez pas de prompt d'exploration ou de travailleur tant que la cible n'est pas résolue.

Suffisance de l'Information

Une demande est prête pour un agent d'exécution lorsqu'elle a :

Un objectif clair : ce qui doit être fait.
Un objet de tâche : la base de code, les fichiers, le texte, le produit, la page, le jeu de données, le problème ou le système sur lequel travailler.
Un résultat attendu : modifications de code, analyse, prompt, plan, document, résultat de test, liste ou autre livrable.
Des contraintes ou préférences que l'utilisateur a énoncées.
Un signal d'acceptation : suffisamment de détails pour juger si la tâche est terminée. S'il est absent, définissez un standard d'acceptation court dans le prompt.

Ne posez une question de suivi concise que lorsque l'objectif ou l'objet de la tâche est manquant et ne peut pas être déduit du contexte actuel.

Si la demande est vague mais a suffisamment de contexte pour enquêter, préparez un prompt d'exploration pour un agent explorateur/recherche au lieu de poser de nombreuses questions. L'explorateur doit inspecter le contexte, identifier la tâche concrète, lister les informations manquantes et les risques, et recommander un prompt de travailleur exécutable.

Sélection de l'Agent

Utilisez explorer ou une tâche en lecture seule lorsque la demande est vague, nécessite une découverte du dépôt/contexte, ou ne doit pas encore modifier les fichiers.
Utilisez worker lorsque la demande est claire et nécessite des modifications de code, des changements de fichiers, une implémentation ou une réparation.
Utilisez default lorsque la tâche est claire mais principalement analytique, éditoriale, orientée planification ou en dehors de la propriété du code.
Divisez en plusieurs agents uniquement lorsque les tâches sont indépendantes et ont des responsabilités distinctes.
Ne déléguez pas de petites tâches que l'agent actuel peut accomplir plus directement, sauf si l'utilisateur souhaite explicitement la délégation.

Pour les prompts de travailleur, incluez toujours la propriété/portée et cette instruction : "Vous n'êtes pas seul dans la base de code ; ne revenez pas sur les modifications apportées par d'autres et adaptez-vous aux changements voisins."

Adaptateurs de Dispatch

Utilisez le mécanisme de délégation natif de l'hôte actuel. Ne prétendez pas qu'un dispatch a eu lieu à moins qu'un appel d'outil ou une action de l'hôte n'ait réellement réussi.

Codex

Lorsque Codex expose des outils multi-agents, utilisez-les après confirmation :

multi_agent_v1.spawn_agent pour de nouveaux agents explorateurs, travailleurs ou par défaut.
multi_agent_v1.send_input pour continuer un agent existant pertinent.
multi_agent_v1.wait_agent uniquement lorsque l'étape suivante est bloquée par le résultat.
multi_agent_v1.close_agent lorsqu'un agent n'est plus nécessaire.

Ne remplacez pas le modèle, l'effort de raisonnement ou le niveau de service, sauf si l'utilisateur le demande ou si la tâche l'exige clairement.

Claude Code

Lorsque Claude Code expose un mécanisme de Tâche/sous-agent, utilisez-le après confirmation :

Utilisez des tâches en lecture seule/d'exploration pour les demandes ambiguës.
Utilisez des tâches d'implémentation pour un travail d'exécution clair.
Incluez la propriété du fichier/module pour les tâches de modification de code.
Demandez à la tâche de signaler les fichiers modifiés, la vérification et les risques non résolus.

Hôtes d'Agents Compatibles

Pour les autres hôtes d'agents, inspectez les outils disponibles et les conventions de l'hôte avant de dispatcher :

Si un outil de délégation natif (agent/tâche/sous-agent/travailleur) est exposé, utilisez-le après confirmation.
Si l'hôte prend en charge les choix interactifs, utilisez le même flux de confirmation Envoyer / Modifier / Arrêter.
Si l'hôte prend en charge les fichiers de compétence mais pas le dispatch automatique, présentez le prompt préparé et expliquez comment le transférer manuellement.
Si l'hôte a un style de prompt connu, adaptez le formatage tout en préservant les sections tâche, contexte, exigences, contraintes, critères d'acceptation et résultat.

Ne prétendez pas à une prise en charge de première classe pour un hôte à moins que son comportement de délégation ne soit documenté dans cette compétence ou vérifié dans l'environnement actuel.

Si l'hôte n'expose pas d'outil de dispatch automatique, présentez le prompt préparé et indiquez que cet environnement ne peut pas dispatcher automatiquement depuis la compétence.

Confirmation Interactive

Lorsque l'hôte actuel prend en charge les choix interactifs natifs, utilisez-les au lieu d'une confirmation en texte brut.

Proposez exactement ces choix pour les tâches à risque normal :

Envoyer (par défaut) : dispatcher le prompt préparé.
Modifier : demander quoi changer, réviser le prompt, puis montrer à nouveau la confirmation.
Ne pas envoyer : s'arrêter après avoir fourni le prompt.

Pour les tâches avec barrière de sécurité, ne faites pas d'"Envoyer" le choix par défaut. Exigez un choix d'envoi explicite après avoir expliqué la raison de sécurité.

Lorsque les choix interactifs natifs ne sont pas disponibles, utilisez le texte de remplacement :

Préparation de l'envoi à : <type d'agent>
Raison de l'envoi : <raison brève>
Niveau de risque : <faible|moyen|élevé et raison>
Action par défaut : Envoyer

────────────────
1. Envoyer
   Envoyer immédiatement le prompt ci-dessus à <type d'agent>

2. Modifier
   Dites ce que vous voulez changer, je mettrai à jour le prompt puis demanderai à nouveau confirmation

3. Arrêter
   Ne pas envoyer, garder le prompt actuel pour une utilisation manuelle

Appuyez sur Entrée par défaut : Envoyer
Vous pouvez aussi répondre : 1 / Envoyer

Utilisez la même langue que l'utilisateur pour les choix de confirmation.

Acceptez les réponses numériques et textuelles :

1, Envoyer : dispatcher le prompt préparé.
2, Modifier : demander quoi changer, réviser le prompt, puis montrer à nouveau les choix de confirmation.
3, Arrêter, Ne pas envoyer : s'arrêter après avoir fourni le prompt.

Pour les tâches avec barrière de sécurité, utilisez ce texte de remplacement à la place :

Cette tâche implique des opérations à haut risque et nécessite une confirmation explicite.

Préparation de l'envoi à : <type d'agent>
Raison de l'envoi : <raison brève>
Niveau de risque : Élevé, <raison de sécurité>
Action par défaut : Arrêter

────────────────
1. Envoyer
   Ne sera envoyé qu'après confirmation explicite

2. Modifier
   Dites ce que vous voulez changer, je mettrai à jour le prompt puis demanderai à nouveau confirmation

3. Arrêter
   Ne pas envoyer, garder le prompt actuel pour une utilisation manuelle

Appuyez sur Entrée par défaut : Arrêter

Ne traitez pas une entrée vide comme Envoyer lorsqu'une barrière de sécurité s'applique.

Barrières de Sécurité

Faites toujours une pause pour une confirmation explicite avant le dispatch lorsque la tâche préparée peut :

Modifier la production, le déploiement, CI/CD, l'infrastructure, la facturation, les comptes, les secrets ou le contrôle d'accès.
Appeler des API externes, envoyer des messages, publier du contenu ou déclencher des actions irréversibles.
Traiter des données personnelles, financières, juridiques, médicales, client ou d'identification sensibles.
Apporter des modifications larges ou ambiguës sur de nombreux fichiers.
Nécessiter des hypothèses qui pourraient modifier matériellement le résultat.

Lorsqu'une barrière de sécurité s'applique, indiquez brièvement la raison et demandez une confirmation après avoir montré le prompt.

Format pour l'Utilisateur

Pour une tâche d'exécution claire :

Je vais envoyer ceci à `worker` car la demande est claire et nécessite une implémentation.

**Prompt préparé**

```text
...

L'envoyer ?


Pour une tâche vague :

```markdown
Je vais d'abord envoyer ceci à `explorer` car la demande nécessite une exploration du contexte.

**Prompt d'exploration**

```text
...

L'envoyer ?


Si l'utilisateur demande des modifications, révisez le prompt et montrez-le à nouveau. Si l'utilisateur dit de ne pas envoyer, arrêtez-vous après avoir fourni le prompt préparé.

## Référence

Lisez `references/prompt-templates.md` lors de la préparation de prompts pour l'exploration, le travail, le défaut, multi-agents, spécifiques à Codex, spécifiques à Claude Code, ou de remplacement pour hôte compatible.

votre-ingénieur-prompt

Qu'est-ce que votre-ingénieur-prompt ?

Demander à votre IA préférée

Documentation