skill-writer

Créer, synthétiser et améliorer itérativement les compétences des agents en suivant la spécification Agent Skills. À utiliser lorsque vous êtes invité à « créer une compétence », « écrire une compétence », « synthétiser des sources dans une compétence », « améliorer une compétence à partir d'exemples positifs/négatifs », « mettre à jour une compétence » ou « maintenir la documentation et l'enregistrement des compétences ». Gère la capture de sources, les portails de profondeur, la création, l'enregistrement et la validation.

npx skills add https://github.com/getsentry/skills --skill skill-writer

Rédacteur de Compétence

Utilisez ceci comme flux de travail canonique unique pour la création et l'amélioration de compétences. Condition de succès principale : maximiser la couverture des entrées de haute valeur avant la rédaction afin que la compétence résultante ait des points aveugles minimaux.

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

Tâche Lire
Définir la classe de compétence et les dimensions requises references/mode-selection.md
Appliquer les contraintes de rédaction pour la profondeur par rapport à la concision references/design-principles.md
Décider ce qui appartient à SKILL.md par rapport aux fichiers de référence references/reference-architecture.md
Créer ou mettre à jour une spécification de maintenance de compétence references/spec-template.md
Sélectionner le modèle de structure pour cette compétence references/skill-patterns.md
Sélectionner le modèle d'orchestration de flux de travail pour les compétences lourdes en processus references/workflow-patterns.md
Sélectionner le modèle de format de sortie pour la qualité déterministe references/output-patterns.md
Choisir le chemin du flux de travail et les sorties requises references/mode-selection.md
Trouver du matériel source de haut signal, y compris l'historique references/source-discovery.md
Charger des exemples de synthèse représentatifs par type de compétence references/examples/*.md
Synthétiser les sources externes/locales avec des portes de profondeur references/synthesis-path.md
Rédiger ou mettre à jour SKILL.md et les fichiers de support references/authoring-path.md
Optimiser la précision de la description et du déclencheur de compétence references/description-optimization.md
Itérer en utilisant des exemples positifs/négatifs/correctifs references/iteration-path.md
Stocker les preuves d'amélioration pour les itérations futures references/iteration-evidence.md
Évaluer le comportement et comparer la ligne de base par rapport à avec la compétence (quantitatif optionnel) references/evaluation-path.md
Enregistrer et valider les modifications de compétence references/registration-validation.md

Étape 1 : Résoudre la cible et le chemin

  1. Résolvez la racine de la compétence cible et l'opération prévue (create, update, synthesize, iterate).
  2. Inspectez les travaux antérieurs de l'espace de travail avant de choisir où la compétence appartient :
    • répertoires de compétences existants et compétences voisines
    • documents du référentiel tels que AGENTS.md, README.md et CONTRIBUTING.md
    • manifestes de plugins ou autres fichiers définissant la disposition si présents
  3. Choisissez la racine de compétence cible parmi les conventions observées :
    • par défaut .agents/skills/<name>/
    • si l'espace de travail utilise clairement une autre disposition établie, suivez plutôt cette disposition
    • les alternatives établies courantes incluent skills/<name>/ lorsque l'espace de travail utilise un arbre de compétences de racine canonique, .claude/skills/<name>/, plugins/<plugin>/skills/<name>/, ou une autre racine de compétence gérée par le référentiel avec des travaux antérieurs clairs
  4. S'il existe plusieurs emplacements plausibles et que le canonique est toujours flou après inspection, demandez à l'utilisateur où la compétence doit aller avant de modifier les fichiers.
  5. Distinguez les chemins internes à la compétence des chemins d'enregistrement du référentiel :
    • à l'intérieur d'une compétence, référencez les fichiers fournis par rapport à cette racine de compétence (par exemple references/foo.md, scripts/check.py)
    • pour les modifications d'enregistrement du référentiel, utilisez les fichiers/emplacements canoniques réels du référentiel après inspection de l'espace de travail
  6. Lisez references/mode-selection.md et sélectionnez le(s) chemin(s) requis.
  7. Classifiez la compétence (workflow-process, integration-documentation, security-review, skill-authoring, generic).
  8. Posez une question directe si la classe, l'emplacement cible ou les exigences de profondeur sont ambigus ; sinon, énoncez des hypothèses explicites.

Étape 2 : Exécuter la synthèse si nécessaire

Lisez references/synthesis-path.md.

  1. Collectez et notez les sources pertinentes avec provenance.
  2. Lisez references/source-discovery.md lorsque le matériel source est mince, obsolète ou ambigu.
  3. Appliquez les règles de confiance et de sécurité lors de l'ingestion de contenu externe.
  4. Produisez des décisions soutenues par les sources et l'état de la couverture/lacunes.
  5. Chargez un ou plusieurs profils de references/examples/*.md lorsque la compétence est hybride.
  6. Appliquez le pack de sources de base pour les flux de travail de création de compétences.
  7. Appliquez les portes de profondeur avant de passer à la rédaction.

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

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

  1. Capturez et anonymisez les exemples avec provenance.
  2. Lisez references/iteration-evidence.md lorsque les exemples doivent persister au-delà du tour actuel.
  3. Réévaluez le comportement de la compétence par rapport aux tranches de travail et de retenue.
  4. Proposez des améliorations à partir de preuves positives/négatives/correctrices.
  5. Portez les deltas de comportement concrets dans la rédaction.

Ignorez cette étape lorsque le chemin sélectionné n'inclut pas iteration.

Étape 4 : Créer ou mettre à jour les artefacts de compétence

Lisez references/authoring-path.md.

  1. Écrivez ou mettez à jour SKILL.md à la voix impérative avec une description riche en déclencheurs.
  2. Lisez references/reference-architecture.md avant d'ajouter des instructions en masse ou de nouveaux fichiers de référence.
  3. Créez ou mettez à jour SPEC.md en utilisant references/spec-template.md lors de la création d'une nouvelle compétence ou de la modification matérielle de l'intention, des sources, de l'évaluation ou du modèle de maintenance d'une compétence existante.
  4. Créez des fichiers de référence et des scripts ciblés uniquement lorsque justifiés.
  5. Suivez references/skill-patterns.md, references/workflow-patterns.md et references/output-patterns.md pour la structure et le déterminisme de sortie.
  6. Pour les compétences de création/générateur, incluez des exemples transformés dans les références :
    • chemin heureux
    • variante sécurisée/robuste
    • anti-modèle + version corrigée

Étape 5 : Optimiser la qualité de la description

Lisez references/description-optimization.md.

  1. Validez les ensembles de requêtes devrait-déclencher et ne-devrait-pas-déclencher.
  2. Réduisez les faux positifs et les faux négatifs avec des modifications de description ciblées.
  3. Maintenez un langage de déclenchement générique entre les fournisseurs sauf si la compétence est intentionnellement spécifique au fournisseur.

Étape 6 : Évaluer les résultats

Lisez references/evaluation-path.md.

  1. Exécutez une vérification qualitative légère par défaut (recommandé).
  2. Pour les compétences d'intégration/documentation et de création de compétences, incluez la rubrique de profondeur concise de references/evaluation-path.md.
  3. Exécutez un manuel d'évaluation plus approfondi et une quantitatif ligne de base par rapport à avec-compétence uniquement si demandé ou si le risque le justifie.
  4. Enregistrez les résultats et les risques non résolus.

Étape 7 : Enregistrer et valider

Lisez references/registration-validation.md.

  1. Appliquez les étapes d'enregistrement du référentiel pour la disposition active que vous avez vérifiée dans l'espace de travail.
  2. Exécutez une validation rapide avec des portes de profondeur strictes.
  3. Rejetez les sorties peu profondes qui échouent aux portes de profondeur ou aux vérifications d'artefacts requis.

Format de sortie

Retournez :

  1. Résumé
  2. Modifications apportées
  3. Résultats de validation
  4. Lacunes ouvertes