handoff

Vue d’ensemble de handoff

Ce que fait le skill handoff

handoff transforme la conversation en cours en un document de passation concis pour le prochain agent. Il est conçu pour les moments où il faut assurer rapidement la continuité : résumer l’essentiel, ce qui a été décidé, et ce que la prochaine session doit faire ensuite.

À qui il s’adresse

Utilisez le skill handoff si vous transmettez un travail entre deux sessions, si vous passez une tâche à un autre agent, ou si vous préparez un brief exploitable par une IA pour poursuivre l’exécution. Il est particulièrement utile pour le travail sur des repos, les tâches produit en plusieurs étapes, et tout workflow où une perte de contexte entraînerait du rework.

En quoi il se distingue

La valeur clé de handoff n’est pas la simple synthèse. Il demande un document orienté action, qui évite de dupliquer les artefacts existants et renvoie le prochain agent vers la bonne source, par chemin ou par URL. C’est bien plus utile qu’un simple prompt du type « résume cette conversation ».

Comment utiliser le skill handoff

Installer handoff et partir du fichier du skill

Pour un handoff install classique, ajoutez le skill depuis le repo et ouvrez d’abord SKILL.md :

npx skills add mattpocock/skills --skill handoff

Lisez ensuite SKILL.md pour comprendre précisément la forme de sortie et le comportement attendus avant de l’appliquer à votre propre workflow.

Donnez au skill une vraie cible de session

Le schéma handoff usage fonctionne mieux quand vous précisez à quoi servira la prochaine session. L’indication d’argument du repository attend une phrase de cadrage comme :

• “Continue debugging the TypeScript build failure in the payments package.”
• “Pick up the landing page copy review and finalize the CTA variants.”
• “Resume implementation of the auth flow after the API schema changes.”

Une demande vague comme « fais une passation » produit un document plus faible. Un objectif clair pour la prochaine session aide le skill à décider ce qui doit figurer dans le handoff et ce qui peut être omis.

Lisez les bons fichiers avant d’écrire

Le skill est volontairement léger, donc la source principale reste SKILL.md. Vérifiez aussi les artefacts projet proches que le skill mentionne, plutôt que de les recopier dans le handoff :

• README.md
• AGENTS.md
• metadata.json
• les dossiers rules/, resources/, references/ ou scripts/ s’ils existent

Si le travail est déjà consigné dans un PRD, un plan, un ADR, une issue, un diff ou un commit, le handoff doit créer un lien vers cette source plutôt que la répéter. Le document reste ainsi court et le prochain agent avance plus vite.

Écrivez pour le prochain agent, pas pour vous-même

Un bon document handoff inclut généralement :

• l’objectif et l’état actuel
• les décisions déjà prises
• les questions ouvertes ou les blocages
• les chemins de fichiers exacts, les URLs ou les artefacts à examiner ensuite
• tout skill suggéré pour la session de suivi

C’est le principe d’usage principal : rendre l’étape suivante évidente sans réexpliquer tout l’historique du projet.

FAQ sur le skill handoff

handoff est-il réservé aux longues conversations ?

Non. handoff est utile chaque fois que le prochain agent doit démarrer avec moins de préparation, même après un échange court mais complexe. Il apporte surtout de la valeur quand il faut préserver des décisions, des dépendances ou des artefacts source.

En quoi est-ce différent d’un prompt ordinaire ?

Un prompt ordinaire demande souvent un résumé et s’arrête là. Le skill handoff est plus prescriptif : il est conçu pour produire un document de transfert, éviter les doublons et pointer vers les artefacts de référence que la prochaine session doit utiliser.

handoff convient-il aux débutants ?

Oui, à condition de pouvoir nommer clairement la prochaine tâche. Les débutants obtiennent les meilleurs résultats lorsqu’ils fournissent une simple phrase de cadrage et laissent le skill structurer la passation en brief utile.

Quand ne faut-il pas utiliser handoff ?

N’utilisez pas handoff si la prochaine session n’a pas besoin de continuité, ou si le contexte nécessaire est déjà entièrement capturé dans un artefact existant que le prochain agent lira directement.

Comment améliorer le skill handoff

Rendez l’objectif de la prochaine session précis

La qualité de la sortie handoff dépend de la précision avec laquelle vous définissez la prochaine session. De meilleures entrées nomment la phase exacte, le sous-système ou le point de décision, plutôt que le projet dans son ensemble.

Indiquez les artefacts source de vérité

Si le travail en cours vit dans un document, une issue ou un diff, ajoutez ces références pour que le handoff reste compact. C’est important, car le skill est justement conçu pour ne pas dupliquer du contenu déjà stocké ailleurs.

Incluez les contraintes et les questions ouvertes

Les documents handoff les plus utiles capturent ce qui n’est pas encore tranché : blocages d’implémentation, arbitrages, remarques de relecture ou hypothèses qui doivent encore être confirmées. Ces détails aident le prochain agent à éviter de refaire les mêmes impasses.

Suggérez des skills de suivi quand c’est pertinent

Le skill demande explicitement des suggestions de skills pour la prochaine session ; incluez-en donc si la tâche à venir bénéficierait d’un workflow différent. Par exemple, un handoff peut orienter le prochain agent vers des skills de planification, de codage ou de revue selon le travail restant.