Plugins

Notes d'étude : Plugins et Partage de Configurations

1. Concepts de base des Plugins

• Définition : Un plugin est une unité installable qui permet de packager et de partager une configuration (ex: un répertoire . cloud).
• Fonctionnement : Un plugin exécute du code sur votre machine avec vos privilèges et s'accroche (hooks) à chaque appel d'outil correspondant.
• Composants : Un plugin peut inclure des compétences (skills), des agents, des hooks (pré-outil, post-outil) et des configurations de serveur MCP.
• Isolation : Les composants (skills, agents, commandes) sont nommés (namespaced) sous le nom du plugin pour éviter les conflits.

2. Gestion et Installation

• Installation locale : Dans une session, utilisez /plugin install [nom_organisation] [nom_plugin].
• Marketplace privé : Créez un marché privé pour votre équipe via /plugin marketplace add [organisation] [nom_marché].
• Avantages du Marketplace : Centralise la découverte, le suivi des versions et les mises à jour des plugins.
• Configuration : Un plugin ne surcharge pas votre configuration ; ses composants s'exécutent en parallèle.

3. Sécurité et Confiance

• Vérification : Lisez toujours les détails d'un plugin avant de l'installer.
• Sources : N'installez des plugins et n'ajoutez des marketplaces que depuis des sources fiables.
• Processus de révision : Les soumissions passent par une revue automatisée (Anthropix) avant d'atteindre le marketplace communautaire.
• Avertissement : Une révision ne garantit pas la confiance ; vérifiez toujours ce que le plugin fait.

4. Création et Packaging de Plugins

• Objectif : Au lieu de copier/coller des configurations, packagez votre répertoire . cloud une fois qu'il fonctionne.
• Structure du Plugin :
• Le manifeste est situé à . cloudplugin. json (contient nom, version, description, auteur).
• La structure de répertoire est similaire à celle des skills (un dossier par skill, un fichier markdown par sous-agent, etc. ).
• Le champ name est le seul obligatoire.
• **Fonctionnalité settings. json :** Un plugin peut inclure un settings. json restreint. L'activation d'un plugin peut promouvoir un sous-agent en agent principal, modifiant ainsi le comportement par défaut de Cloud Code.

Takeaways

• Un plugin est une unité installable qui permet de packager et de partager une configuration, exécutant du code avec vos privilèges.
• Les composants d'un plugin sont nommés (namespaced) pour éviter les conflits avec d'autres outils.
• Les plugins peuvent être gérés localement ou via un Marketplace privé pour centraliser les versions et mises à jour.
• Il est essentiel de vérifier les détails et les sources des plugins, car la révision automatisée ne garantit pas la confiance.