Guide de lecture localisé
writing-plansObjectif, utilisation et source
Utilisez cette fonction lorsque vous avez des spécifications ou des exigences pour une tâche en plusieurs étapes, avant de toucher au code.
Source récupérée:
- Dépôt source
- obra/superpowers
- SKILL.md
skills/writing-plans/SKILL.md- Étoiles du dépôt
- 309,479
- Mise à jour du dépôt
- 2026-10-30
- Catégories de capacités
- Flux de travail de l'agent
- Dernière collecte
Licence : MIT
Les extraits de flux de travail sont des outils de lecture et non des instructions exécutables de Codez. Aucune compétence tierce n'a été utilisée pour générer cette page.
Les passages relatifs à l'objectif et au flux de travail ci-dessous constituent le contenu original, organisé et traduit pour la lecture. Ils sont distincts de l'analyse éditoriale de Codez, qui est étiquetée séparément.
À quoi sert cette compétence ?
Utilisez cette fonction lorsque vous avez des spécifications ou des exigences pour une tâche en plusieurs étapes, avant de toucher au code.
Comment fonctionne le flux de travail en amont
Aperçu
Rédigez des plans d'implémentation pour un ingénieur qui n'a pas vu ce code source ni ces spécifications. Partez du principe qu'il écrira du code idiomatique dans le langage du projet une fois qu'il connaîtra l'interface et les tests exacts, et qu'il fera un choix judicieux lorsque le plan laisse une option ouverte. Ce qu'il ne doit pas savoir, ce sont vos décisions : quels fichiers, quels noms et signatures, quelles valeurs des spécifications, quels tests prouvent chaque tâche. Documentez-les. Présentez-lui le plan complet sous forme de tâches gérables. DRY. YAGNI. TDD. Commits fréquents. Annoncez au début : « J'utilise la compétence writing-plans pour créer le plan d'implémentation. » Contexte : Si vous travaillez dans un espace de travail isolé, il aurait dû être créé via…superpowers:using-git-worktreesMaîtrise de l'exécution. Enregistrez vos plans sur :docs/superpowers/plans/YYYY-MM-DD-.md
Granularité par étape
Chaque étape correspond à une action dont le résultat est vérifiable : « Écrire le test défaillant » – étape ; « L’exécuter pour s’assurer de son échec » – étape ; « Implémenter le code minimal pour que le test réussisse » – étape.
passage en amont · L43 ↗Ce que contient une étape
Une étape est considérée comme terminée lorsque l'implémenteur peut en écrire une seule et unique information pertinente. C'est là toute l'exigence : non ambiguë, et non exhaustive. Chaque type d'étape contient ce qui la rend non ambiguë, et rien de plus : une étape de test : le nom du test et ses assertions, sous forme de code, avec les valeurs exactes de la spécification ; une étape de code : la signature exacte (nom, paramètres, type de retour), le fichier dans lequel elle se trouve et les valeurs spécifiques définies par la spécification. L'implémenteur écrit le corps du code. Un corps apparaît uniquement pour un algorithme que la signature et les tests ne déterminent pas, ou pour une copie exacte fixée par la spécification ; une étape de vérification : la commande à exécuter et le résultat indiquant sa réussite.
passage en amont · L140 ↗Configuration requise
Aucun extrait de configuration n'a été sélectionné dans ce fichier. Cela ne signifie pas que la compétence est sans dépendances. Consultez les instructions de configuration du dépôt et les fichiers référencés.
Limites et contrôles de qualité
Aucun passage de limite distinct n'a été sélectionné dans ce fichier. Cela ne signifie pas que la compétence est sûre pour toutes les entrées ou tous les environnements. Consultez le code source complet et validez vos résultats.
Commencez par un essai sans danger
- Vérifiez l'hôte pris en charge et les instructions d'installation du dépôt. Conservez le répertoire Skill ainsi que ses scripts, ressources et documentation référencés ;SKILL.mdSeul, il peut omettre les dépendances.
- Indiquez à l'agent vos paramètres d'entrée réels, le résultat souhaité et les critères d'acceptation. La syntaxe d'appel et les outils disponibles dépendent du système hôte ; ce site ne propose pas de commande d'installation universelle.
- Testez le flux de travail source dans un projet temporaire ou sur une copie. Avant d'autoriser les opérations qui modifient des fichiers, des services distants ou des ressources facturables, examinez-les attentivement.
- Vérifiez la conformité du résultat avec les contrôles qualité sources et vos propres exigences. Un déclenchement réussi ou un nombre élevé d'étoiles dans le dépôt ne garantissent pas un résultat correct.
Pour en savoir plus, consultez la source.
Compétences connexes
Traduction et étendue
Ce guide de lecture sélectionne des passages de l'amont épingléSKILL.mdCette traduction est assistée. Elle ne constitue pas un manuel complet et ne garantit pas une compatibilité testée. Veuillez lire le document original et les fichiers auxquels il fait référence avant utilisation.
Cette introduction fait référence à la version épinglée ci-dessous ; l’activité actuelle du dépôt et la durée de la collecte sont indiquées séparément.
- Source épinglée
- Lire l'original ↗
- Source récupérée
- Commit source
2ce8aa15d05bd57213e6f746f953aafb7ded7a8b- Source SHA-256
a6c67c1900064347c2a329990dd3c555657c51c3ec53b259a08aa01a2c26139a