AgentSkillsCN

lesson-extractor

从一次工作会议中提炼经验教训，并将其持久保存于 lessons/ 目录中。适用于用户希望分析会议过程、捕捉学习心得，或在关键代理给出 PASS 评价后使用。可通过“提取经验教训”、“我学到了什么”、“经验教训”、“捕捉学习成果”、“分析会议”、“关键代理 PASS”等短语触发。

SKILL.md
--- frontmatter
name: "lesson-extractor"
description: >
  Extraire les leçons apprises d'une session de travail et les persister dans
  le dossier lessons/. Utiliser quand l'utilisateur demande d'analyser une session,
  de capturer des apprentissages, ou après un verdict PASS de l'agent critique.
  Déclenché par : "extraire leçon", "qu'ai-je appris", "lessons learned",
  "capturer apprentissage", "analyser session", "agent critique PASS".

Lesson Extractor — Extraction de leçons apprises

Cette skill fournit le processus et les formats pour extraire des leçons d'une session de travail et les persister dans le système de mémoire du projet.

Format d'une leçon

markdown
## [YYYY-MM-DD] — Titre court et descriptif

- **Contexte** : Ce qui était demandé ou le problème adressé
- **Problème** : Ce qui n'a pas fonctionné (ou ce qui a particulièrement bien fonctionné)
- **Solution** : L'approche corrigée ou validée
- **Règle** : La règle généralisable pour le futur (actionnable et concise)

Fichiers de destination

FichierContenu
lessons/lessons-learned.mdLeçons génériques chronologiques
lessons/development-guide.mdPatterns et conventions du projet
lessons/error-playbook.mdErreurs spécifiques et résolutions
lessons/session-log.mdJournal factuel des sessions

Processus d'extraction

1. Collecter les faits

  • •Lire les changements de la session (diffs, fichiers modifiés)
  • •Identifier les erreurs rencontrées et comment elles ont été résolues
  • •Identifier les décisions de design et leurs justifications
  • •Identifier les patterns réussis

2. Formuler la leçon

  • •Titre : court, descriptif, unique
  • •Contexte : factuel, pas d'opinions
  • •Problème/Solution : précis, avec références aux fichiers si pertinent
  • •Règle : généralisable, actionnable, formulée comme une instruction

3. Classifier

  • •Leçon technique générique → lessons-learned.md
  • •Pattern ou convention du projet → development-guide.md
  • •Erreur avec résolution → error-playbook.md

4. Valider

  • •Vérifier que la leçon n'existe pas déjà dans les fichiers lessons/
  • •Proposer la leçon à l'utilisateur pour validation
  • •Ne jamais écrire sans validation humaine explicite

Critères de qualité d'une leçon

  • •Factuelle : basée sur des observations, pas des suppositions
  • •Actionnable : la règle peut être appliquée par un humain ou un bot
  • •Généralisable : utile au-delà du cas spécifique
  • •Non-dupliquée : pas déjà capturée dans les fichiers existants
  • •Concise : une leçon = un apprentissage (pas de méga-leçons)