- Ces dernières semaines, j’ai structuré de façon systématique un système d’agents de code basé sur Claude Code pour créer un nouvel outil d’extension appelé « Superpowers »
- Superpowers s’installe sous forme de plugin et apprend à Claude des « Skills », qui permettent d’automatiser et d’améliorer sa manière de travailler
- En s’appuyant sur le système de plugins de Claude Code d’Anthropic, l’agent peut exécuter de façon autonome l’automatisation de workflow, l’exécution de TDD, la revue de code et la gestion des Git worktrees
- Le nouveau workflow enchaîne automatiquement les étapes brainstorming → planification → implémentation, fait avancer le travail en parallèle et applique le TDD RED/GREEN
- Le concept central, le « Skill », est une unité de connaissance que Claude doit consulter pour accomplir une tâche donnée ; l’utilisateur peut l’écrire lui-même ou demander à Claude de le générer à partir de documents d’apprentissage
- L’auteur estime que cette structure pourrait devenir à terme le standard d’auto-amélioration et de collaboration des agents de code IA, et que les prochaines étapes sont le partage des Superpowers et la finalisation du système de mémoire
Aperçu de Superpowers
- Superpowers fonctionne avec Claude Code 2.0.13 ou version ultérieure, et l’utilisateur peut l’installer avec la commande
/plugin marketplace add obra/superpowers-marketplace
- Après l’installation, Claude lit automatiquement le document
SKILL.md et apprend la règle suivante : « s’il existe un Skill, il doit obligatoirement être utilisé »
- Claude passe ainsi par les étapes de brainstorming et de planification, encourage la discussion avant l’implémentation et, une fois le travail terminé, peut aller jusqu’à créer une PR GitHub ou proposer une fusion
Workflow de développement
- Lorsque Claude détecte le démarrage d’un projet ou d’une tâche, il passe automatiquement par les étapes de brainstorming et de planification avant l’implémentation
- Lorsqu’il travaille dans un dépôt Git, il crée automatiquement un worktree pour éviter les conflits entre tâches exécutées en parallèle
- Deux modes d’exécution sont proposés
- Méthode existante : l’utilisateur ouvre une deuxième session Claude et joue le rôle de PM en arbitrant entre l’architecte et l’implémenteur
- Nouvelle méthode : les tâches sont réparties individuellement entre des sous-agents, avec revue de code avant la poursuite de chaque tâche
- Le TDD RED/GREEN répète la boucle suivante : écrire un test en échec → implémentation minimale → validation du test
- Une fois l’implémentation terminée, options de création d’une PR GitHub, de fusion de branche locale ou de clôture
Principes clés du système de Skills
- Le cœur de Superpowers est le Skill, un module de connaissance en Markdown que Claude peut lire et exécuter pour résoudre un problème précis
- Anthropic a présenté pour la première fois le concept de Skill lors du lancement de la génération de documents Office
- Un schéma similaire apparaît dans plusieurs frameworks d’agents de code, comme Microsoft Amplifier
- Le Skill est l’unité par laquelle Claude apprend de nouvelles capacités ; l’utilisateur peut lui demander d’analyser un livre ou une base de code afin d’en extraire de nouveaux Skills
- L’agent exécute un script de recherche de Skills et doit obligatoirement utiliser un Skill s’il en existe un pour l’activité concernée
- Le premier méta-Skill, « comment écrire des Skills », prend en charge un workflow dans lequel Claude crée de nouveaux Skills de façon autonome
- Si l’on demande au modèle de « lire ce livre, réfléchir et consigner ce qu’il a appris », il structure automatiquement des connaissances réutilisables
- Pour tester les Skills générés, Claude simule des subagents et vérifie via une approche TDD si chaque Skill est réellement valable
- Les premiers essais utilisaient une validation sous forme de quiz de jeu télévisé, mais cela s’est révélé peu efficace
- Après amélioration, des scénarios de « pressure test » ont été conçus pour vérifier la validité des Skills dans des conditions proches du réel
Exemples de tests en scénario de pression
- Scénario 1 : pression temporelle + confiance en soi
- Situation : une panne en production coûte 5 000 dollars par minute, et le service d’authentification doit être débogué
- Choix : déboguer immédiatement (5 minutes) vs rechercher d’abord un Skill puis déboguer (7 minutes)
- Objectif : faire en sorte que la recherche de Skills passe en priorité, même en situation d’urgence
- Scénario 2 : coût irrécupérable + code fonctionnel
- Situation : une infrastructure de test asynchrone, déjà fonctionnelle, a nécessité 45 minutes de travail
- Choix : vérifier les Skills puis éventuellement retravailler l’implémentation (3 minutes) vs commit du code actuel
- Objectif : imposer le respect des Skills, même lorsqu’il existe déjà du code fonctionnel
- Les principes de psychologie de la persuasion de Robert Cialdini (autorité, engagement, sympathie, rareté, etc.) ont été appliqués au LLM
- Une étude récente coécrite notamment par Dan Shapiro a démontré scientifiquement que les principes de Cialdini restent valables pour les LLM
- Il a ensuite été constaté que le système de Skills de Superpowers utilisait déjà inconsciemment des techniques de persuasion
- Cadre d’autorité (« IMPORTANT: situation réelle »), incitation à l’engagement (« choisissez A, B ou C »), rareté (« 18 h, 18 h 30 »)
Fonction de mémoire (Memories)
- Superpowers inclut le Skill
remembering-conversations, qui permet à Claude de conserver et réutiliser le contexte de conversations précédentes
- Ce Skill enregistre les journaux de conversation dans une base de données vectorielle fondée sur SQLite et génère des résumés à l’aide de Claude Haiku
- Les historiques de conversation sont automatiquement dupliqués en dehors de
.claude afin d’éviter leur suppression automatique par Anthropic
- Lorsque c’est nécessaire, Claude recherche des informations pertinentes dans les conversations passées au moyen de sous-agents, avec une conception pensée pour éviter que des recherches inutiles ne polluent la fenêtre de contexte
- L’ensemble n’est pas encore totalement relié, mais tous les composants sont déjà implémentés
Fonction de partage (Sharing)
- L’objectif de Superpowers est de construire un écosystème de partage de Skills
- Les utilisateurs peuvent soumettre sous forme de GitHub Pull Request les Skills appris par leur Claude afin de les partager avec d’autres
- L’intégration avec le nouveau système de plugins de Claude prévoit aussi des garde-fous pour que les Skills ne soient pas partagés sans le consentement de l’utilisateur
- La méthode d’installation initiale consistait simplement à faire lire une URL spécifique à Claude, mais elle a depuis été remplacée par une structure de marketplace de plugins
Installation et utilisation
- Claude Code 2.0.13 ou version ultérieure requis
- Exécuter les commandes d’installation depuis la marketplace de plugins
/plugin marketplace add obra/superpowers-marketplace/plugin install superpowers@superpowers-marketplace
- Après redémarrage, un prompt de bootstrap est injecté, ce qui active automatiquement le système de Skills
- Le journal complet de l’implémentation réelle d’une application Todo avec Claude et Superpowers a été publié, et l’on peut y voir les questions de Claude, le développement piloté par les tests et la gestion Git
Aucun commentaire pour le moment.