Aller au contenu

Utiliser des plugins / Créer des plugins ​

Installez un paquet pour vos agents ou créez un paquet portable Agent Plugins 1.0 avec des instructions et une configuration d’outils.

Utiliser des plugins ​

Avec Node.js 22 ou une version ultérieure :

bash
npx universal-agent-plugins add context7

Le CLI vous demande quels agents compatibles utiliser et indique les étapes d’activation restantes. Pour examiner et prévisualiser d’abord :

bash
npx universal-agent-plugins info context7
npx universal-agent-plugins add context7 --target codex,cursor --dry-run

Le guide d’installation native fournit des exécutables pour macOS, Linux et Windows. Le gestionnaire natif ne nécessite pas Node.js, même si certains plugins ont besoin de leur propre environnement d’exécution.

CLI conserve la portée projet explicite et la sélection automatique pour install introduite dans 0.1.94. Il ajoute aussi une API de gestion locale et des extensions Pi, Skills et MCP. Pour prévisualiser l’ajout d’un paquet à un projet :

Pour une entrée de catalogue vérifiée et compatible, la CLI publiée accepte le nom court du Directory signé en portée Project explicite lorsque le client prend en charge tous les composants obligatoires (par exemple, agentplugins add context7 --target codex --scope project --dry-run). Vous pouvez aussi utiliser une source Git vérifiée épinglée à un SHA complet et un client compatible. Remplacez OWNER/REPOSITORY, FULL_COMMIT_SHA et PACKAGE_PATH ; si le paquet est à la racine du dépôt, omettez //PACKAGE_PATH.

Modèle : github:OWNER/REPOSITORY@FULL_COMMIT_SHA//PACKAGE_PATH. La commande ci-dessous utilise un commit GitLab historique réel ; cela ne prouve pas que cette révision est actuellement vérifiée dans le catalogue. Pour une nouvelle installation, copiez la source vérifiée actuelle depuis le catalogue.

bash
npx universal-agent-plugins add github:777genius/universal-agent-plugins@2ddbb99dd190c1792b79904f9875e6322bccd243//plugins/gitlab --target codex --scope project \
  --project-root /path/to/project --dry-run

Choisissez un dossier de projet existant. add utilise par défaut la portée utilisateur : sélectionnez projet explicitement pour cette opération. Depuis CLI natif 0.1.94, install sans argument de source détecte le projet uniquement si un fichier uap.toml ordinaire existe dans le dossier courant exact, sans recherche dans les parents. Une portée explicite reste prioritaire. Cette sélection automatique nécessite 0.1.94 ou une version ultérieure : vérifiez agentplugins version et utilisez l’installateur natif si votre canal est antérieur. Les canaux peuvent être mis à jour à des moments différents ; l’exemple Git avec SHA complet et portée Project fonctionne dès 0.1.93 ; les noms courts Directory en Project exigent la CLI stable actuelle. Examinez le plan avant d’omettre --dry-run. La découverte native, la confiance, l’authentification et les appels MCP réussis restent distincts de l’écriture des fichiers du paquet.

Parcours complet d’installation · Compatibilité des clients et portée des tests

Restaurez des dépendances enregistrées ​

Vérifiez ce que l’environnement utilisateur sélectionné enregistre :

bash
npx universal-agent-plugins deps status

Pour un couple uap.toml/uap.lock enregistré, exportez depuis un dossier d’échange :

bash
npx universal-agent-plugins deps export

Copiez le dossier sur une autre machine, installez les clients cibles, puis exécutez :

bash
npx universal-agent-plugins deps import
npx universal-agent-plugins install --locked --scope user

Seuls l’accord et le verrouillage validés sont transférés. Profils, réglages, identifiants, reçus et données du plugin restent séparés. L’installation nécessite toujours les sources exactes ou des paquets vérifiés en cache. Pour un projet, versionnez les deux fichiers et restaurez avec install --locked --scope project explicite. Consultez la maintenance et la restauration pour la récupération et le transfert.

Créer des plugins ​

Un paquet standard commence avec plugin.json à sa racine et peut inclure skills/<name>/SKILL.md, mcp.json ou les deux. Vous pouvez écrire ces fichiers à la main et valider le paquet avec l’installateur publié :

bash
npx universal-agent-plugins validate ./my-plugin
npx universal-agent-plugins add ./my-plugin --target codex --dry-run

Ces exemples supposent que ./my-plugin contient déjà un paquet complet. Le guide de création décrit un paquet Skill manuel et les outils source de génération d’une structure initiale.

Disponibilité de la création : l’installateur actuel npm ou natif n’inclut pas agentplugins author. Le code source actuel implémente la génération initiale, les vérifications statiques, les tests MCP explicites, les cycles de développement, l’installation des dépendances et la maintenance JSON. Utilisez la préparation depuis le code source pour ces commandes. Les preuves d’anciennes publications restent liées à leurs versions ; elles ne promettent pas les mêmes fonctions dans l’installateur actuel.

La validation statique ne prouve ni l’exécution, ni OAuth, ni l’activation. Les transports MCP pris en charge varient aussi par client : par exemple, Codex ne prend pas en charge MCP SSE déclaré. Indiquez les prérequis du paquet et les vérifications restantes dans son README.

Spécification Agent Plugins 1.0

Documentation publique pour les auteurs de plugins et les intégrateurs.