cf-x/project-handoff-skill

Passation de projet

Créez un instantané actuel permettant à un nouvel agent de poursuivre le travail sans la conversation. N'effacez pas la conversation vous-même.

1. Résoudre la destination

Déterminez la cible de la passation avant d'écrire :

1. Privilégiez un répertoire explicite fourni avec l'invocation. Normalisez-le et vérifiez qu'il existe.
2. Sinon, déduisez les candidats à partir des répertoires et fichiers effectivement discutés, lus, créés ou modifiés dans cette session.
3. Traitez le répertoire de travail courant, la racine de l'espace de travail Codex, la racine du contrôle de version et les marqueurs de projet tels que README.md, AGENTS.md, package.json ou pyproject.toml uniquement comme des signaux. Aucun n'est autoritaire en soi, et un projet n'a pas besoin d'utiliser Git.
4. Ne procédez pas sans demander, sauf lorsqu'un seul candidat est clairement soutenu par les preuves de la session.
5. Si la destination est manquante ou ambiguë, montrez les candidats probables et posez une question concise : HANDOFF.md 要写到哪个目录？ Ne devinez pas.

Si plusieurs projets indépendants ont été modifiés, préférez un HANDOFF.md distinct pour chacun et confirmez leurs destinations avant d'écrire.

2. Inspecter l'état réel

Après avoir résolu chaque répertoire cible :

• Examinez le travail pertinent de la session et inspectez la structure de la cible, les instructions, la documentation clé, les fichiers d'implémentation et les sorties.
• Si un contrôle de version existe, inspectez son état et les modifications pertinentes. S'il n'existe pas, continuez sans traiter cela comme une erreur.
• Utilisez les preuves de test ou de validation existantes. N'exécutez que des vérifications légères et sûres lorsque c'est utile ; n'installez pas de dépendances et ne faites pas de modifications non liées au projet.
• Lisez un HANDOFF.md existant avant de le mettre à jour. Conservez les informations toujours valides, remplacez le statut obsolète et déplacez le travail nouvellement terminé hors de la section du travail restant.

Ne vous fiez pas uniquement à la mémoire de la conversation lorsque des preuves du système de fichiers sont disponibles.

3. Écrire HANDOFF.md

Créez ou mettez à jour <cible-confirmée>/HANDOFF.md en tant que document concis décrivant l'état actuel avec les sections suivantes :

# Passation de projet

> Mis à jour : AAAA-MM-JJ
> Cible : /chemin/absolu/confirmé

## État actuel et structure

## Cas terminés

## Décisions et conventions

## Travail restant et prochaine étape exacte

## Pièges et impasses

## Validation, risques et questions ouvertes

Appliquez ces règles :

• Donnez aux cas terminés des résultats concrets et des chemins de fichiers ou de répertoires relatifs au projet.
• Enregistrez les décisions, les choix techniques, les conventions de style ou de nommage, ainsi que leurs raisons. Incluez les emplacements des preuves lorsque c'est utile.
• Rendez le travail restant actionnable : priorité, fichier ou commande de départ exact, blocages et condition d'achèvement.
• Enregistrez les approches qui ont échoué et pourquoi elles ont échoué afin que le prochain agent ne les répète pas.
• Indiquez les tests ou vérifications effectués et leurs résultats. Dites explicitement ce qui n'a pas été vérifié.
• Distinguez les faits observés des affirmations et inférences de session. Marquez l'incertitude comme 待确认 ; ne fabriquez jamais de complétion, de décisions ou de résultats de test.
• Utilisez des dates absolues, une prose concise et des chemins au lieu d'une narration de type transcription.
• N'incluez jamais d'identifiants, de jetons, d'informations personnelles privées, de contenu de fichiers d'environnement ou de gros journaux bruts.
• Conservez le fichier comme le dernier instantané de passation plutôt qu'un historique à ajout uniquement.

Ne modifiez que le HANDOFF.md prévu, sauf si l'utilisateur demande explicitement d'autres modifications.

4. Vérifier et rapporter

Relisez le fichier terminé et confirmez que :

• il se trouve dans le répertoire confirmé ;
• chaque section requise est présente ;
• l'action suivante est suffisamment spécifique pour qu'un nouvel agent puisse commencer immédiatement ;
• les affirmations, chemins, dates et statut de validation concordent avec les preuves disponibles ;
• aucune information sensible n'a été copiée dans le document.

Rapportez le chemin écrit, un bref résumé et toute incertitude non résolue. Arrêtez-vous là pour que l'utilisateur puisse examiner la passation avant d'exécuter manuellement /clear.