Guide de lecture localisé
writing-skillsObjectif, utilisation et source
À utiliser lors de la création de nouvelles compétences, de la modification de compétences existantes ou de la vérification du bon fonctionnement des compétences avant leur déploiement.
Source récupérée:
- Dépôt source
- obra/superpowers
- SKILL.md
skills/writing-skills/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 ?
À utiliser lors de la création de nouvelles compétences, de la modification de compétences existantes ou de la vérification du bon fonctionnement des compétences avant leur déploiement.
Comment fonctionne le flux de travail en amont
Flux de travail de découverte
Comment les futurs agents découvrent votre compétence : Ils rencontrent des problèmes (« les tests sont instables »), recherchent des compétences (analyse des descriptions, navigation par catégories), trouvent la compétence (correspondance avec la description).
passage en amont · L388 ↗Aperçu
Les compétences rédactionnelles correspondent au développement piloté par les tests appliqué à la documentation des processus. Les compétences personnelles se trouvent dans le répertoire des compétences de votre environnement d'exécution (~/.claude/skills/(sur le Code Claude) — voircodex-tools.mdougemini-tools.mdpour le chemin d'accès sur ces environnements d'exécution. Codex, Copilot CLI et Gemini CLI le reconnaissent également.~/.agents/skills/comme un alias inter-environnements d'exécution. Vous rédigez des cas de test (scénarios de charge avec des sous-agents), observez leurs échecs (comportement de base), développez la compétence (documentation), vérifiez la réussite des tests (les agents se conforment) et refactorisez (corrigez les failles). Principe fondamental : si vous n'avez pas observé un agent échouer sans la compétence, vous ne pouvez pas savoir si celle-ci enseigne la bonne chose.
Quand créer une compétence
Cette technique ne vous paraissait pas évidente. Vous y ferez référence à nouveau dans différents projets. Le modèle est largement applicable (non spécifique à un projet). D'autres pourraient en bénéficier.
passage en amont · L47 ↗skills/
skill-name/
SKILL.md # Main reference (required)
supporting-file.* # Only if neededConfiguration requise
Compétences en matière de discipline (rules/requirements)
Exemples : TDD, vérification avant finalisation, conception avant codage. Questions académiques : Comprennent-ils les règles ?
passage en amont · L188 ↗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.
- Aperçu
- Qu'est-ce qu'une compétence ?
- Cartographie TDD des compétences
- Quand créer une compétence
- Technique
- Modèle
- Référence
- Structure du répertoire
- En écrivantSKILL.md
- organigrammes
- Exemples de code
- Compétence autonome
- Maîtrise des outils réutilisables
- Compétence avec de nombreuses références
- La loi de fer (identique à TDD)
- Tester tous les types de compétences
- Compétences en matière de discipline (rules/requirements)
- Compétences techniques (guides pratiques)
- Compétences en matière de schémas (modèles mentaux)
- Compétences de référence (documentation/APIs)
- Justifications courantes pour éviter les tests
- Associez le formulaire à l'échec
- Se prémunir contre la rationalisation
- RÉFACTEUR ROUGE-VERT pour les compétences
- ROUGE : Écrire le test en échec (ligne de base)
- VERT : Écrire des compétences minimales
- REFACTEUR : Combler les lacunes
- Formulation des micro-tests avant les scénarios complets
- ❌ Exemple narratif
- ❌ Dilution multilingue
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
8cb3ac68c6d8c4bb46886b998b09af7989643cab8bd0e46ee86dd62e64546bbe