Communitygithub.com

yezhwi/framework-distillation

Transformez des frameworks open-source en guides d'architecture exploitables par les humains et l'IA.

Qu'est-ce que framework-distillation ?

Cette compétence permet d'extraire l'architecture des frameworks open-source plutôt que de se concentrer sur le code brut. Son objectif est de fournir à une autre IA ou à une équipe les connaissances architecturales nécessaires pour reproduire une architecture similaire dans un autre langage ou domaine. Elle prend en charge l'analyse de runtimes d'agents, de moteurs de workflows, de frameworks de machines à états, de systèmes de plugins et de plateformes d'orchestration. L'utilisateur doit fournir l'URL du référentiel ou le chemin source, et peut spécifier la profondeur d'analyse (mini, standard, deep) et les domaines d'intérêt. Le processus suit des règles strictes : privilégier l'architecture, distinguer les faits observés des inférences, et éviter les pièges comme le résumé de README ou l'inventaire d'API. Les livrables incluent des résumés d'architecture, des analyses complètes, ou des analyses d'ingénierie inverse exhaustives, avec des références pour la structure, les checklists et les tests.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add yezhwi/framework-distillation

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Distillation de Framework

Présentation

Extrayez l'architecture, pas le code.

Utilisez cette compétence pour rétro-concevoir la forme d'un framework, son modèle d'exécution, ses points d'extension et ses compromis d'ingénierie afin qu'une autre IA ou une équipe puisse reproduire une architecture similaire dans un autre langage ou domaine.

Quand l'utiliser

  • Rétro-concevoir l'architecture d'un framework au-delà du README et de l'API publique
  • Étudier l'exécution, le cycle de vie, la machine à états ou le mécanisme d'extension
  • Reproduire un framework similaire dans un autre langage ou domaine
  • Créer des packages de connaissances d'architecture lisibles par l'IA
  • Comparer des frameworks selon leur architecture et leurs compromis

Cibles typiques : runtimes d'agents, moteurs de workflows, frameworks de machines à états, systèmes de plugins, plateformes d'orchestration.

Quand ne pas l'utiliser

  • Résumé de README uniquement
  • Tutoriel d'API ou guide d'utilisation
  • Parcours ligne par ligne du code
  • Réimplémentation par copier-coller
  • Inventaire de fonctionnalités sans analyse des compromis

Si la demande est proche mais hors cible, redirigez d'abord le périmètre.

Entrées requises

Minimum :

  • URL du dépôt ou chemin source local

Recommandé :

  • Nom du framework
  • Objectif d'analyse
  • Langage ou domaine d'implémentation cible
  • Profondeur : mini, standard ou deep
  • Domaines d'intérêt

Principe fondamental

Architecture > Code
Raisonnement > Syntaxe
Conception > API
Compromis > Fonctionnalité
Principes > Implémentation

Flux de travail

  1. Vérifier la pertinence ; refuser ou rediriger les demandes de tutoriel/API/parcours fichier par fichier.
  2. Choisir la profondeur en fonction de l'objectif. Par défaut standard ; utiliser mini pour un premier passage rapide, deep pour une reproduction exhaustive.
  3. Parcourir la documentation, les tests, les exemples et la forme du dépôt avant une lecture approfondie du code source.
  4. Extraire l'architecture, l'exécution, l'état, le modèle de données, les points d'extension, les décisions et les compromis.
  5. Distiller les règles réutilisables et produire une sortie adaptée au mode choisi et à l'objectif de reproduction.

Règles d'exécution

  • Commencer par l'architecture, pas par les listes de fonctionnalités.
  • Ne pas dériver vers un tutoriel, un inventaire d'API ou un parcours fichier par fichier.
  • Ancrer les affirmations sur des preuves issues du code, de la documentation, des tests, des exemples ou de l'historique des commits lorsque c'est possible.
  • Distinguer les faits observés des inférences ; utiliser Observé, Fortement inféré, Inférence provisoire lorsque les preuves sont minces.
  • Indiquer explicitement un accès incomplet au dépôt ou des preuves faibles.
  • Adapter l'analyse au langage cible, au domaine, aux domaines d'intérêt et aux critères de comparaison.

Modes de sortie

  • mini — résumé rapide d'architecture de premier passage
  • standard — extraction complète d'architecture pour la plupart des études
  • deep — rétro-conception exhaustive pour la reproduction du framework

Détails dans :

  • references/output-modes.md
  • references/analysis-checklist.md
  • references/deliverables.md

Anti-patrons

Éviter :

  • Résumer uniquement le README
  • Lister les API sans architecture
  • Expliquer les exemples sans extraire la conception
  • Décrire le code sans se demander pourquoi il existe
  • Ignorer les compromis, les chemins d'échec ou les points d'extension
  • Copier l'implémentation au lieu de distiller les principes
  • Déclarer la philosophie ou la raison d'être comme un fait lorsque les preuves sont faibles
  • Comparer les frameworks uniquement par une liste de fonctionnalités

Références complémentaires

  • references/output-modes.md — formes de sortie, modèles, diagrammes
  • references/analysis-checklist.md — liste de vérification d'analyse et porte de qualité
  • references/deliverables.md — structure des livrables et invite de simulation d'IA
  • references/self-test.md — révision des lacunes et correctifs appliqués
  • references/simulated-dialogue-tests.md — invites de pression et tableau de bord

Skills associés