Partager via

Étendre le code Genie avec des compétences d'agents

Créez des compétences pour étendre le code Genie en mode Agent avec des fonctionnalités spécialisées pour vos tâches spécifiques au domaine. Cette page explique comment créer et optimiser les compétences.

Qu’est-ce que les compétences ?

Créez des compétences pour étendre Genie Code avec des fonctionnalités spécialisées. Les compétences suivent la norme ouverte des compétences de l’agent. Connaissances et flux de travail spécifiques au domaine du package de compétences que Genie Code peut charger lorsqu’il est pertinent d’effectuer des tâches spécifiques. Les compétences peuvent inclure des conseils, des bonnes pratiques, du code réutilisable et des scripts exécutables.

Les compétences doivent être adaptées aux tâches spécifiques au domaine. Avec des compétences, vous pouvez fournir un contexte plus riche (comme des scripts, des exemples et d'autres ressources) pour une tâche que vous ne pouvez le faire avec des instructions. Contrairement aux instructions personnalisées, qui sont appliquées globalement, les compétences sont chargées automatiquement et uniquement dans le contexte approprié. En mode Agent, Genie Code charge automatiquement les compétences en cas de pertinence, en fonction de votre demande et de la description de la compétence. Vous pouvez également appeler manuellement des compétences @ en les mentionnant. Cela gère une fenêtre de contexte efficace et réduit la nécessité de fournir le même contexte dans plusieurs conversations.

Note

Les compétences sont uniquement prises en charge en mode Agent de code Genie.

Créer une compétence

Les compétences résident dans le /Users/{username}/.assistant/skills/ répertoire. Chaque compétence doit avoir son propre dossier et un SKILL.md fichier dans ce dossier.

Pour créer une compétence :

  1. Dans votre dossier d’espace de travail utilisateur, créez un dossier de compétences. Le chemin d’accès au dossier doit être : /Users/{username}/.assistant/skills/.

    Après la création, vous pouvez accéder rapidement à ce dossier dans le panneau Génie Code. Cliquez sur l'icône Engrenage. Paramètres, puis cliquez sur Flèche dans l'icône. Ouvrir le dossier des compétences.

  2. Créez un dossier dédié pour votre compétence dans le dossier compétences. Chaque compétence doit avoir son propre dossier. Par exemple, si vous créez une compétence pour les flux de travail personnels, votre structure de dossiers peut être :

    /Users/{username}/.assistant/skills/
└── personal-workflows/
    └── SKILL.md

  3. Dans votre dossier de compétences, créez un SKILL.md fichier. Ce fichier est requis et définit la compétence. Les compétences suivent les spécifications des compétences de l’agent.

  4. Ajoutez l'en-tête requis pour votre compétence :

    ---
name: skill-name
description: A description of what this skill does and when to use it.
---

  5. Ajoutez les instructions relatives aux compétences au format Markdown après l'en-tête. Il est recommandé d’inclure les sections suivantes :

    • Instructions pas à pas : instructions procédurales claires
    • Exemples : Exemples d’entrées et sorties attendues
    • Cas de périphérie : variantes et exceptions courantes

  6. (Facultatif) Pour des compétences plus complexes, vous pouvez fournir et référencer des ressources supplémentaires :

    • Scripts contenant du code exécutable que l’agent peut exécuter.
    • Fichiers contenant une documentation supplémentaire à référencer, comme les meilleures pratiques et les modèles.

    Lorsque vous référencez d’autres fichiers, utilisez des chemins relatifs à partir de la compétence racine.

    Par exemple, vous pouvez avoir une compétence de flux de travail personnel qui référence les meilleures pratiques ETL, les modèles de tableau de bord et les scripts pour la configuration et le déploiement du pipeline. Le dossier de votre compétence peut inclure les fichiers suivants :

    /Users/{username}/.assistant/skills/
├── personal-workflows/
   ├── SKILL.md                # Workflow overview and best practices
   ├── etl-patterns.md         # Personal ETL best practices
   ├── dashboard-templates.md   # Reusable dashboard patterns
   └── scripts/
         ├── pipeline-setup.sh   # Environment setup scripts
         └── model-deploy.py     # Model deployment automation

Genie Code récupère automatiquement vos compétences la prochaine fois que vous l’utilisez en mode Agent. Vous pouvez également @ mentionner des compétences pour vous assurer que Genie Code les utilise.

Bonnes pratiques

Suivez ces instructions pour écrire des compétences efficaces :

  • Concentrez-vous sur les compétences. Les compétences fonctionnent mieux lorsqu’elles se concentrent sur une tâche ou un flux de travail unique. L’étendue étroite facilite la reconnaissance par Genie Code lorsqu'une compétence est applicable.
  • Utilisez des noms et des descriptions clairs. Un nom concis et descriptif ainsi qu'un résumé aident Genie Code à associer la bonne compétence à la bonne demande.
  • Soyez explicite et basé sur des exemples. Décrivez les flux de travail pas à pas et incluez des exemples concrets ou des modèles que Génie Code peut réutiliser.
  • Évitez le contexte inutile. Incluez uniquement les informations requises pour la tâche. Des détails supplémentaires peuvent rendre les compétences plus difficiles à appliquer de manière fiable.
  • Répéter dans le temps. Traitez les compétences comme des flux de travail vivants. Les petites mises à jour basées sur l’utilisation réelle peuvent améliorer considérablement les résultats.
  • Séparez les instructions de l’automatisation. Utilisez Markdown pour expliquer les intentions et les meilleures pratiques et les scripts pour les actions reproductibles. La conservation de ces préoccupations distinctes facilite la maintenance et la réutilisation des compétences.

Voir également

  • Last updated on