Handoff
Rédigez un document de passation qui permet à un nouvel agent de continuer ce travail sans avoir à relire toute la conversation. Capturez l'état et l'intention, pas une transcription.
Où sauvegarder
Sauvegardez le document de passation dans le dépôt du projet actuel — jamais dans le répertoire temporaire du système d'exploitation, jamais en ligne dans le chat.
- Résolvez la racine du dépôt : exécutez
git rev-parse --show-toplevel. Si cela échoue (pas un dépôt Git), revenez au répertoire de travail actuel. - Assurez-vous qu'un répertoire
handoffs/existe à cette racine ; créez-le s'il manque. - Écrivez dans
handoffs/<slug>-handoff-<horodatage-UTC>.md, où :<slug>est un court sujet en kebab-case dérivé de la tâche (ou des arguments, s'il y en a eu), par exemplenotebook-proxy-review.<horodatage-UTC>estYYYYMMDDTHHMMSSZ, par exemple20260527T144059Z. L'horodatage garantit que chaque document de passation est distinct — n'écrasez jamais un document existant.
- Après avoir écrit, affichez le chemin absolu du fichier que vous avez créé.
Que écrire
Si des arguments ont été passés à cette compétence, traitez-les comme le centre d'intérêt de la session suivante et orientez chaque section en conséquence.
Utilisez ces sections. Gardez chacune dans sa limite ; un document de passation est un document indicateur, pas un enregistrement de tout. Omettez toute section qui est vraiment vide plutôt que de la remplir artificiellement.
- En-tête — titre, date (UTC) et une ligne sur l'objectif de la prochaine session. (≤5 lignes)
- Objectif — le but et son critère de succès. (≤3 phrases)
- État actuel — ce qui est fait, ce qui fonctionne, ce qui est vérifié par opposition à supposé. (≤10 puces)
- Prochaines étapes — actions concrètes et ordonnées pour le prochain agent. (≤8 puces)
- Décisions clés et justifications — choix verrouillés et pourquoi, afin que l'agent suivant ne les remette pas en question. (≤8 puces)
- Pièges / chausse-trapes — obstacles déjà rencontrés, surprises, choses qui semblent faites mais ne le sont pas. (≤8 puces)
- Fichiers et références pertinents — chemins et URL vers le code, les PRD, les plans, les diffs, les tickets. Référencez-les ; n'incorporez pas leur contenu. (≤12 entrées)
- Questions ouvertes — décisions non résolues qui nécessitent l'utilisateur ou un travail supplémentaire. (≤6 puces)
- Compétences suggérées — compétences que le prochain agent devrait invoquer, chacune avec une ligne expliquant pourquoi. (≤6 entrées)
Règles
- Ne dupliquez pas le contenu déjà capturé dans d'autres artefacts (PRD, plans, ADR, tickets, commits, diffs). Référencez-les par chemin ou URL à la place.
- Ne collez pas de gros contenus de fichiers ou de sorties de commandes complètes dans le document de passation. Pointez vers la source.
- Masquez les secrets et les données personnelles — tout ce qui correspond à API_KEY / SECRET / TOKEN / PASSWORD / PRIVATE_KEY ou des données personnelles. Les chemins de fichiers locaux sont acceptables.