desk-journal

Par github · awesome-copilot

Rédiger, ajouter ou lire des entrées dans un journal de bord. Le journal est une mémoire persistante — ce qui survit aux limites de session. Une bonne entrée contient : ce qui a été fait, l'état actuel, la prochaine étape.

npx skills add https://github.com/github/awesome-copilot --skill desk-journal

Journal de Bureau

Gérer le journal d'un bureau — la mémoire persistante qui survit aux changements de session.

Quand l'utiliser

  • Fin de session : Noter ce qui a été fait, l'état actuel, l'étape suivante
  • Début de session : Lire le journal pour reprendre où vous aviez laissé
  • Point de contrôle en cours de session : Noter les progrès ou décisions importants
  • Clôture du bureau : Rédiger un résumé final quand un bureau est fermé

Comment rédiger une entrée de journal

Ajouter à desks/<desk-name>/journal.md. Chaque entrée est une section :

## <date> — <résumé court>
- **Travaux réalisés :** <ce qui a été fait cette session>
- **État actuel :** <où en sont les choses maintenant>
- **Étape suivante :** <ce que la prochaine session devrait poursuivre>

Directives

  • Être spécifique. « Travaux sur le scan de sécurité » est inutile pour la prochaine session. « Scan des repos A, B, C pour CWE-502 ; 3 findings trouvés dans A, 0 dans B et C ; findings triés au bench » — voilà une piste.
  • Inclure ce qui n'a pas fonctionné. Les impasses sont précieuses — elles empêchent la prochaine session de suivre le même chemin.
  • Rester concis. Le journal est un marqueur de piste, pas un journal intime. 3-5 lignes par entrée. Si vous avez besoin de plus, le contexte important devrait aller sur le bench comme artifact distinct.
  • Toujours inclure l'étape suivante. La prochaine session part de zéro. Sans étape suivante, elle doit tout redériver.

Entrée de fin de bureau

Quand un bureau est en cours de fermeture (pas juste une session qui se termine, mais le bureau lui-même qui ferme) :

## <date> — Bureau fermé
- **Résumé :** <ce que ce bureau a accompli globalement>
- **Artifacts :** <ce qui est sur le bench de ce bureau>
- **Passation :** <tout ce qu'un autre bureau ou l'opérateur doit savoir>

Lire le journal

Au début d'une session, lire le journal du bureau pour reprendre le contexte. L'entrée la plus récente est la plus importante — elle contient l'état actuel et l'étape suivante. Les entrées antérieures fournissent l'historique si nécessaire.

Principes

  • Le journal est un cairn — des pierres laissées pour que le prochain voyageur trouve le chemin. Chaque entrée est une pierre.
  • L'honnêteté plutôt que l'exhaustivité. « Je suis resté bloqué sur X et je ne sais pas pourquoi » est plus utile que le silence.
  • Le journal est pour la prochaine session, pas pour celle-ci. Écrivez pour quelqu'un qui ne sait rien de ce que vous venez de faire.

Skills similaires