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.。

ProjetInformation
Dépôt GitHubhttps://github.com/obra/superpowers
LicenceMIT
Outils pris en chargeClaude 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.

Superpowers 工作流程图

PhaseNameCe qu’il faitSortie
1Clarification des exigencesL'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
2Planification de l'implémentationDé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
3Exécuter des tâchesExécuter les tâches une par une. Après chaque tâche, effectuer une vérification en deux tours (spec + qualité).Code vérifié
4Livrer le codeConfirmer 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.

OutilMéthode d'installationSi une place de marché supplémentaire est nécessaire
Claude Code/plugin installSeule la marketplace officielle est nécessaire, ou vous pouvez utiliser la marketplace Superpowers
Cursor/add-pluginou recherchez dans la marketplace des pluginsNon nécessaire
Codex CLI/pluginsRecherchez et installez dans l'interfaceNon nécessaire
Gemini CLIgemini extensions installNon 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.

ÉtapeNameCe 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éussirN'écrivez que le code minimal pour faire passer le test, rien de plus.
REFACTORISERRefactoriserOptimisez 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.

ÉtapesQuoi fairePourquoi
1. Reproduire le problèmeConfirmer qu'il peut être reproduit de manière fiable et consigner les conditions de déclenchementUn bug qui ne peut pas être reproduit ne peut pas être vérifié comme corrigé
2. Identifier la cause racineRéduire le périmètre étape par étape pour trouver la ligne de code spécifique causant le problèmeLes correctifs qui ne traitent que les symptômes introduiront de nouveaux problèmes
3. Implémenter la correctionModifier le code en fonction de la cause racineMinimiser l'étendue des modifications
4. Vérifier la correctionConfirmer que le problème est résolu et qu'aucun nouveau problème n'est introduitS'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 à noterDescriptionScénarios applicables
Processus plus longMême les exigences simples passent par une analyse avant l'implémentationDéveloppement de fonctionnalités de complexité moyenne ou supérieure
Nécessite une participation aux discussionsLa phase de remue-méninges vous demande de confirmer le planDéveloppeurs prêts à consacrer du temps à un alignement en amont
Différences d'expérienceLes performances varient selon les outils et les projetsTous les utilisateurs doivent en être conscients
Autres extensions