Superpouvoirs
Superpowers est un pack de compétences pour le flux de travail de développement destiné aux outils de codage IA. Il amène l'IA à clarifier les exigences et à élaborer des plans avant d'écrire du code, ce qui réduit le nombre de révisions répétées.
Difficultés courantes du codage avec l'IA
Après avoir décrit les exigences, l'IA commence immédiatement à écrire du code. Ce n'est qu'après avoir écrit des centaines de lignes que vous réalisez que la direction est mauvaise -- les cas limites ne sont pas gérés, le style de l'interface ne correspond pas, et la logique clé est mal comprise.
Ensuite, vous faites des allers-retours pour apporter des modifications, en passant parfois plus de temps à corriger la trajectoire qu'à écrire le code au départ.
Ce qui est pire, ce sont les exigences complexes impliquant plusieurs modules et une mise en œuvre par phases. L'IA s'écarte progressivement du cap pendant qu'elle écrit, et au moment où vous le remarquez, de nombreux fichiers ont déjà été modifiés, ce qui rend le retour en arrière pénible.
Cause racine
Le comportement par défaut des outils de codage IA après réception des exigences estd'écrire directement du code。
Cela convient pour les tâches simples, mais pour des exigences légèrement plus complexes, « écrire directement » saute une étape critique :comprendre pleinement les exigences。
Chaque ambiguïté dans les exigences finit par devenir un problème dans le code. L'IA ne pose pas de questions de manière proactive et n'a pas non plus de plan de mise en œuvre systématique. Elle avance simplement selon sa compréhension actuelle, et si elle s'écarte du cap, elle doit revenir corriger les choses.
Si l'IA pouvait d'abord clarifier les exigences, lister un plan de mise en œuvre et confirmer les limites avant d'écrire du code, puis enfin commencer à coder, tout le processus serait bien plus stable.
Qu'est-ce que Superpowers ?
Superpowers est un ensemble depacks de compétences pour le workflow de développement destinés aux outils de codage IA.。
Superpowers organise les étapes clés du développement logiciel -- clarification des exigences, planification de la mise en œuvre, développement piloté par les tests, revue de code et gestion des branches -- dans des fichiers de compétences. Une fois chargés dans les outils de codage IA, l'IA déclenche automatiquement le workflow correspondant au bon moment, sans avoir besoin de prompts manuels à chaque fois.
En une phrase :Installez une méthodologie de développement dans l'IA, faites-la travailler selon le processus, plutôt que de commencer à coder dès qu'elle reçoit des exigences.。
| Projet | Information |
|---|---|
| Dépôt GitHub | https://github.com/obra/superpowers |
| Licence | MIT |
| Outils pris en charge | Claude Code, Cursor, Codex CLI, Codex App, Gemini CLI, GitHub Copilot CLI |
Vue d'ensemble du workflow
Le processus principal de Superpowers est divisé en quatre phases. Chaque phase a des objectifs et des résultats clairs, et l'IA ne sautera aucune étape.
| Phase | Name | Ce qu’il fait | Sortie |
|---|---|---|---|
| 1 | Clarification des exigences | L'IA pose des questions en retour, clarifie les ambiguïtés et présente des plans de conception par sections pour confirmation. | Document d'exigences confirmées |
| 2 | Planification de l'implémentation | Décomposer le travail en tâches concrètes de 2-5 minutes chacune. Chaque tâche inclut les fichiers, le code et les méthodes de vérification. | Liste de tâches exécutables |
| 3 | Exécuter des tâches | Exécuter les tâches une par une. Après chaque tâche, effectuer une vérification en deux tours (spec + qualité). | Code vérifié |
| 4 | Livrer le code | Confirmer que toutes les tâches sont terminées et que le code respecte les spécifications de conception et les normes de qualité. | Code livrable |
Installation
Les différents outils de codage IA ont différentes méthodes d'installation. Choisissez la méthode correspondant à l'outil que vous utilisez.
Claude Code (recommandé)
Claude Code peut être installé directement depuis la place de marché officielle des plugins.
# 从官方插件市场安装(推荐) /plugin install superpowers@claude-plugins-official
Il peut également être installé via la place de marché propre à Superpowers.
# 添加 Superpowers 市场 /plugin marketplace add obra/superpowers-marketplace # 从 Superpowers 市场安装 /plugin install superpowers@superpowers-marketplace
Cursor
Installez-le en saisissant une commande dans la boîte de dialogue Agent de Cursor.
# 在 Agent 对话框里输入 /add-plugin superpowers
Vous pouvez également rechercher dans la place de marché des pluginssuperpowerset installer.
Codex CLI
# 打开插件管理界面 /plugins # 搜索 superpowers,选择 Install Plugin
Gemini CLI
# 通过扩展安装 gemini extensions install https://github.com/obra/superpowers
Chaque outil doit être installé séparément. L'installer dans Claude Code ne signifie pas qu'il est également disponible dans Cursor.
| Outil | Méthode d'installation | Si une place de marché supplémentaire est nécessaire |
|---|---|---|
| Claude Code | /plugin install | Seule la marketplace officielle est nécessaire, ou vous pouvez utiliser la marketplace Superpowers |
| Cursor | /add-pluginou recherchez dans la marketplace des plugins | Non nécessaire |
| Codex CLI | /pluginsRecherchez et installez dans l'interface | Non nécessaire |
| Gemini CLI | gemini extensions install | Non nécessaire |
Expérience après installation
Après l'installation, vous n'avez pas besoin d'apprendre de nouvelles commandes ni de changer vos habitudes de travail. Décrivez simplement les exigences comme d'habitude ; Superpowers interviendra automatiquement en arrière-plan.
Lors du démarrage d'une nouvelle fonctionnalité
Après que vous avez décrit les exigences, l'IAne commencera pasimmédiatement à écrire du code.
Il vous posera d'abord quelques questions en retour, clarifiera les ambiguïtés et présentera le plan de conception par sections pour votre confirmation.
Cette phase s'appellebrainstorming, l'objectif est d'aligner les exigences avant de commencer le travail. Après votre confirmation, l'IA passe à l'étape suivante.
Passage à la phase de mise en œuvre
Une fois les exigences confirmées, l'IA génère un plan de mise en œuvre, en décomposant le travail en tâches spécifiques de 2-5 minutes chacune.
Chaque tâche inclut : quels fichiers sont concernés, quel code écrire et comment vérifier.
La granularité du plan sera suffisamment détaillée pour qu'« un ingénieur junior puisse l'exécuter à partir de la description » -- cette conception vise à permettre aux sous-agents d'exécuter chaque étape de manière fiable et à réduire les écarts de compréhension pendant l'exécution.
Phase d'exécution
Une fois le plan confirmé, l'IA exécute les tâches une par une.
Après l'achèvement de chaque tâche, il effectuedeux séries de vérifications: d'abord vérifier si elle respecte les spécifications de conception, puis vérifier la qualité du code.
Si des problèmes sont détectés, ils sont résolus dans la tâche en cours et ne sont pas reportés.
Vous n'avez pas besoin de surveiller tout le processus d'exécution. Laissez simplement l'IA fonctionner. Si elle se bloque, elle s'arrêtera et viendra vous voir.
Vérification de l'installation
Par exemple, nous saisissons dans Claude Code :
Design an attractive mobile phone product promotional page.
Vous verrez superpowers:brainstorming, ce qui signifie que l'installation a réussi :

Un scénario typique de débutant : développer une application Todo à partir de zéro
Supposons que nous voulions implémenter une application Todo prenant en charge le CRUD (React + stockage local).
Approche traditionnelle avec prompt direct :
用 React 帮我写一个 Todo App。
L'IA génère généralement une grande quantité de code d'un seul coup. En apparence, il semble complet en termes de fonctionnalités, mais en réalité les problèmes suivants peuvent exister :
- Gestion d'état incorrecte
- Tests unitaires manquants
- Cas limites (par ex., listes vides, opérations concurrentes) non traités
- Modifier un seul endroit peut facilement introduire d'autres bugs
- Le résultat est souvent un code difficile à maintenir, avec des coûts d'itération élevés par la suite.
L'approche structurée de Superpowers est complètement différente. Elle ne laisse pas l'IA entrer immédiatement dans la phase de codage, mais procède selon les étapes suivantes :

Explication détaillée des flux de travail principaux
Superpowers fournit trois flux de travail principaux, chacun couvrant une partie différente du développement.
Développement piloté par les tests (TDD)
test-driven-developmentLa compétence force l'IA à suivre la séquence RED-GREEN-REFACTOR.
Écrivez d'abord un test qui échoue, observez-le échouer, puis écrivez le code minimal pour le faire passer, et enfin refactorisez.
Si l'IA écrit du code avant d'écrire les tests, cette compétence lui imposera de supprimer le code et de recommencer.
| Étape | Name | Ce qu’il fait |
|---|---|---|
| RED | Écrire un test qui échoue | Écrivez d'abord un cas de test qui échoue actuellement, en clarifiant le comportement attendu. |
| GREEN | Écrire le code minimal pour réussir | N'écrivez que le code minimal pour faire passer le test, rien de plus. |
| REFACTORISER | Refactoriser | Optimisez la structure du code sous la protection des tests, en vous assurant que les tests passent toujours. |
Pour les projets qui n'ont pas l'habitude du TDD, ce processus peut sembler un peu inconfortable, mais il réduit effectivement les situations où des bugs sont découverts plus tard et où vous devez revenir en arrière pour les corriger.
Isolation Git Worktree
using-git-worktreesAprès confirmation de la conception, créez automatiquement une branche de travail isolée.
De cette façon, les modifications de code de l'IA ne polluent pas directement la branche principale. C'est utile pour le multitâche parallèle ou lorsqu'une restauration est nécessaire.
Git Worktree est une fonctionnalité native de Git qui vous permet d'extraire plusieurs branches dans différents répertoires simultanément dans le même dépôt, par rapport àgit stash + git checkoutplus propre.
Débogage systématique
systematic-debuggingLa compétence amène l'IA à suivre un processus de dépannage en 4 étapes lorsqu'elle rencontre des problèmes, plutôt que de deviner.
Lorsque vous rencontrez une erreur, identifiez d'abord la cause racine, puis corrigez-la, plutôt que de commencer directement à modifier le code et à voir ce qui se passe.
| Étapes | Quoi faire | Pourquoi |
|---|---|---|
| 1. Reproduire le problème | Confirmer qu'il peut être reproduit de manière fiable et consigner les conditions de déclenchement | Un bug qui ne peut pas être reproduit ne peut pas être vérifié comme corrigé |
| 2. Identifier la cause racine | Réduire le périmètre étape par étape pour trouver la ligne de code spécifique causant le problème | Les correctifs qui ne traitent que les symptômes introduiront de nouveaux problèmes |
| 3. Implémenter la correction | Modifier le code en fonction de la cause racine | Minimiser l'étendue des modifications |
| 4. Vérifier la correction | Confirmer que le problème est résolu et qu'aucun nouveau problème n'est introduit | S'assurer que la correction est efficace |
Quelques éléments à connaître avant d'utiliser
Le processus devient plus long
Après avoir installé Superpowers, même des exigences simples passeront par une analyse des exigences et une planification avant l'écriture du code.
Si vous ne faites que corriger un petit bug ou ajouter une ligne de configuration, ce processus peut sembler excessif.
Superpowers convient au développement de fonctionnalités d'un certain niveau de complexité. Pour les tâches simples, laissez simplement l'IA écrire le code directement—pas besoin d'appliquer tout ce flux de travail.
Nécessite votre participation aux discussions initiales
remue-méningesLa phase vous oblige à répondre à des questions et à confirmer les plans.
Si vous pensez « il suffit de le confier à l'IA et de le laisser tourner entièrement automatiquement », cette conception vous mettra mal à l'aise.
Superpowers se positionne commeun développement collaboratif entre humains et IA, et non une génération de code entièrement automatisée.
L'expérience varie selon les différents outils
Le README mentionne que Claude peut fonctionner pendant deux heures sans dévier du plan, mais cette performance varie selon l'outil, le projet et la complexité de la tâche, donc l'expérience réelle peut différer.
| Points à noter | Description | Scénarios applicables |
|---|---|---|
| Processus plus long | Même les exigences simples passent par une analyse avant l'implémentation | Développement de fonctionnalités de complexité moyenne ou supérieure |
| Nécessite une participation aux discussions | La phase de remue-méninges vous demande de confirmer le plan | Développeurs prêts à consacrer du temps à un alignement en amont |
| Différences d'expérience | Les performances varient selon les outils et les projets | Tous les utilisateurs doivent en être conscients |