Skill Writer

Utilise ceci comme le workflow canonique unique pour la création et l'amélioration de skills. Condition de succès primaire : maximiser la couverture des entrées de haute valeur avant la rédaction afin que le skill résultant ait des points aveugles minimaux.

Charge uniquement le(s) chemin(s) requis pour la tâche :

Step 1: Résoudre la cible et le chemin

1. Résous la racine du skill cible et l'opération prévue (create, update, synthesize, iterate).
2. Inspecte le travail antérieur de l'espace de travail avant de choisir où le skill appartient :
   • répertoires de skills existants et skills voisins
   • documentation du repository telle que AGENTS.md, README.md, et CONTRIBUTING.md
   • manifestes de plugins ou d'autres fichiers définissant la disposition quand présents
3. Choisir la racine du skill cible d'après les conventions observées :
   • défaut .agents/skills/<name>/
   • si l'espace de travail utilise clairement une autre disposition établie, suis cette disposition à la place
   • les alternatives établies courantes incluent skills/<name>/ quand l'espace de travail utilise un arbre de skills racine canonique, .claude/skills/<name>/, plugins/<plugin>/skills/<name>/, ou une autre racine de skill gérée par le repo avec un travail antérieur clair
4. Si plusieurs emplacements plausibles existent et le canonique reste encore peu clair après inspection, demande à l'utilisateur où le skill devrait aller avant d'éditer les fichiers.
5. Distingue les chemins internes au skill des chemins d'enregistrement du repository :
   • à l'intérieur d'un skill, référence les fichiers regroupés relatives à cette racine de skill (par exemple references/foo.md, scripts/check.py)
   • pour les éditions d'enregistrement du repository, utilise les fichiers/emplacements canoniques réels du repository après inspection de l'espace de travail
6. Lis references/mode-selection.md et sélectionne le(s) chemin(s) requis.
7. Classe le skill (workflow-process, integration-documentation, security-review, skill-authoring, generic).
8. Pose une seule question directe si la classe, l'emplacement cible, ou les exigences de profondeur sont ambigus ; sinon énonce les hypothèses explicites.

Step 2: Exécuter la synthèse quand nécessaire

Lis references/synthesis-path.md.

1. Collecte et évalue les sources pertinentes avec provenance.
2. Lis references/source-discovery.md quand le matériel source est fin, obsolète, ou ambigu.
3. Applique les règles de confiance et de sécurité lors de l'ingestion de contenu externe.
4. Produis des décisions appuyées par les sources et l'état de couverture/écart.
5. Charge un ou plusieurs profils de references/examples/*.md quand le skill est hybride.
6. Applique le pack de sources de baseline pour les workflows de skill-authoring.
7. Applique les portes de profondeur avant de passer à la rédaction.

Step 3: Exécuter l'itération en premier lors de l'amélioration à partir de résultats/exemples

Lis references/iteration-path.md en premier quand le chemin sélectionné inclut iteration (par exemple opération iterate).

1. Capture et anonymise les exemples avec provenance.
2. Lis references/iteration-evidence.md quand les exemples devraient persister au-delà du tour actuel.
3. Réévalue le comportement du skill face aux tranches de travail et de rétention.
4. Propose des améliorations à partir des preuves positives/négatives/correctives.
5. Porte les deltas de comportement concrets dans la rédaction.

Saute cette étape quand le chemin sélectionné n'inclut pas iteration.

Step 4: Rédiger ou mettre à jour les artefacts de skill

Lis references/authoring-path.md.

1. Rédige ou mets à jour SKILL.md en voix impérative avec description riche en déclenchements.
2. Lis references/reference-architecture.md avant d'ajouter des instructions en masse ou de nouveaux fichiers de référence.
3. Crée ou mets à jour SPEC.md en utilisant references/spec-template.md lors de la création d'un nouveau skill ou de la modification matérielle de l'intention, des sources, de l'évaluation, ou du modèle de maintenance d'un skill existant.
4. Crée des fichiers de référence et des scripts ciblés uniquement quand justifiés.
5. Suis references/skill-patterns.md, references/workflow-patterns.md, et references/output-patterns.md pour la structure et le déterminisme de la sortie.
6. Pour les skills de rédaction/générateur, inclus les exemples transformés dans les références :
   • chemin heureux
   • variante sécurisée/robuste
   • anti-motif + version corrigée

Step 5: Optimiser la qualité de la description

Lis references/description-optimization.md.

1. Valide les ensembles de requêtes should-trigger et should-not-trigger.
2. Réduis les faux positifs et faux négatifs avec des éditions ciblées de description.
3. Conserve le langage de déclenchement générique entre les fournisseurs sauf si le skill est intentionnellement spécifique au fournisseur.

Step 6: Évaluer les résultats

Lis references/evaluation-path.md.

1. Exécute une vérification qualitative légère par défaut (recommandé).
2. Pour les skills d'intégration/documentation et de skill-authoring, inclus la rubrique de profondeur concise de references/evaluation-path.md.
3. Exécute un playbook d'évaluation plus approfondie et une baseline quantitative vs avec skill uniquement quand demandé ou si le risque le justifie.
4. Enregistre les résultats et les risques non résolus.

Step 7: Enregistrer et valider

Lis references/registration-validation.md.

1. Applique les étapes d'enregistrement du repository pour la disposition active que tu as vérifiée dans l'espace de travail.
2. Exécute une validation rapide avec des portes de profondeur strictes.
3. Rejette les sorties peu profondes qui échouent les portes de profondeur ou les vérifications d'artefacts requis.

Format de sortie

Retourne :

1. Résumé
2. Changements effectués
3. Résultats de validation
4. Écarts ouverts