Skills pour agents d'IA

Opfield est le plan de contrôle de l’infrastructure pour les agents de code : ils travaillent sans accès SSH direct, et vous n’avez pas à réexpliquer votre processus de déploiement à chaque agent. Les skills publics d’Opfield expliquent le fonctionnement des ressources Opfield, des permissions, des tâches, des builds, de la livraison, du diagnostic, de la vérification et du retour arrière : using-opfield est le point d’entrée, et un skill par zone du produit entre dans les détails. Le serveur MCP distant d’Opfield donne ensuite à l’agent un accès authentifié aux ressources que son utilisateur est autorisé à voir.

Les deux couches ont des rôles différents :

Skill d’agent : des connaissances d’exploitation réutilisables, installées dans Codex, Claude Code, Cursor et les autres agents compatibles.
Opfield MCP : des outils en direct issus de votre installation Opfield, protégés par OAuth, les scopes de ressources, les droits du plan, les confirmations et la journalisation d’audit.

Installer les skills Opfield

Depuis un projet dans lequel l’agent doit utiliser Opfield, installez l’ensemble complet :

npx skills add opfield/opfield-skills --skill '*'

L’installateur vous permet de sélectionner les agents compatibles configurés sur votre machine. Pour rendre les skills disponibles dans tous vos projets, installez-les globalement avec -g. Pour installer un seul skill, nommez-le, par exemple --skill publishing-html-pages ; using-opfield seul oriente l’agent vers les autres skills et lui indique où les lire.

Skill	Couvre
`using-opfield`	Connexion via MCP, découverte des outils, règles de sécurité, tâches et vérification ; oriente vers les skills ci-dessous
`publishing-html-pages`	Publication de rapports HTML générés et de sites statiques sur Pages, et partage du lien
`deploying-workloads`	Containers, Deployments blue/green, projets Compose, builds Git, volumes et migration
`high-availability`	Exécution d’une charge de travail sur plusieurs nœuds Docker avec répliques ou basculement
`ingress-and-domains`	Domaines, DNS, TLS, Routes, Access Lists, Secure Links et mode maintenance
`internal-pki`	Autorités de certification privées et certificats internes
`databases`	PostgreSQL, stockages clé-valeur et ClickHouse managés et externes, liaisons, requêtes et sauvegardes
`storage`	Connexions de stockage, stockage objet managé, tâches de copie et migration depuis MinIO
`managing-nodes`	Enrôlement, mise à jour et réparation des nœuds, console et fichiers
`observability`	Journalisation, export SIEM, alertes, webhooks, pages de statut et journal d’audit
`access-control`	Utilisateurs, groupes, scopes, jetons d’API et autorisations OAuth

Le skill est du Markdown simple accompagné de références ciblées. Vous pouvez l’inspecter avant l’installation dans le dépôt opfield/opfield-skills et le garder sous gestion de versions lorsque vous l’installez au niveau du projet.

Installer en tant que plugin natif

Claude Code et Codex peuvent aussi installer le même skill canonique en tant que plugin natif. Choisissez soit la voie du plugin, soit npx skills pour un agent donné ; installer les deux est inutile.

Pour Claude Code :

claude plugin marketplace add opfield/opfield-skills
claude plugin install opfield@opfield-skills

Pour Codex :

codex plugin marketplace add opfield/opfield-skills --ref main
codex plugin add opfield@opfield-skills

Démarrez une nouvelle session après l’installation ou la mise à jour du plugin. Le dépôt ne contient aucun hook permanent : l’installation seule ne se connecte pas à Opfield et ne modifie pas l’infrastructure.

Les commandes complètes d’installation, de mise à jour et de vérification sont tenues à jour dans le fichier INSTALL.md du dépôt.

Skills servis par votre Opfield

Chaque installation Opfield sert les mêmes skills via MCP, dans la version correspondant à sa propre release : l’index est la ressource opfield://skills, chaque fichier est opfield://skills/<name>/SKILL.md, et chaque skill est aussi un prompt MCP nommé skill-<name>. Un agent connecté à Opfield peut les lire sans rien installer. Les skills sont également publiés à l’adresse https://docs.opfield.dev/agent/<name>/SKILL.md, listés dans /agent/index.json et dans llms.txt.

Connecter l’agent à Opfield

Un administrateur active d’abord Settings → Features → OAuth and MCP access → Enable MCP server et accorde à l’utilisateur Use MCP (mcp:use) ainsi que les scopes ordinaires correspondant aux ressources auxquelles l’agent peut accéder.

Pour Codex :

codex mcp add opfield --url https://opfield.example.com/api/mcp
codex mcp login opfield
codex mcp list

Pour Claude Code :

claude mcp add --transport http opfield --scope user https://opfield.example.com/api/mcp
claude mcp login opfield
claude mcp get opfield

Remplacez opfield.example.com par le nom d’hôte public canonique de votre installation Opfield. L’authentification s’effectue via OAuth Opfield dans un navigateur. Ne créez pas et ne collez pas de jeton d’API pour MCP.

Pour la politique des URL de rappel, la découverte compacte des outils et les erreurs de connexion, consultez le guide complet API REST et MCP.

Commencer par une tâche en lecture seule

Vérifiez la connexion et la frontière des permissions avant de demander à l’agent d’effectuer un changement :

Utilise $using-opfield. Liste les nœuds et les charges de travail Opfield auxquels
j'ai accès, résume les avertissements et les tâches actives, et recommande la
prochaine action la plus sûre. Ne modifie rien.

Essayez ensuite une demande de livraison limitée :

Utilise $using-opfield pour examiner comment cette application est actuellement
publiée. Propose un plan de mise à jour et de retour arrière natif Opfield.
Attends mon approbation avant de modifier l'infrastructure.

Le skill indique à l’agent de lire d’abord l’état actuel, de préserver la propriété des ressources, d’éviter les modifications directes sur les hôtes, de suivre les tâches asynchrones et de vérifier la ressource réelle ou le résultat HTTPS au lieu de considérer une requête acceptée comme un succès.

Permissions et sécurité

Créez un utilisateur ou un groupe Opfield dédié à l’accès des agents et n’accordez que les ressources et actions nécessaires. MCP ne contourne pas l’autorisation d’Opfield : retirer mcp:use, modifier l’appartenance à un groupe ou restreindre les scopes de ressources affecte les appels futurs effectués avec la connexion existante.

Un agent dont l’utilisateur ne peut travailler que dans certains dossiers, nœuds ou ressources reste à l’intérieur de ceux-ci. Lorsque la connexion est limitée, Opfield ajoute un résumé de ces accès aux instructions du serveur MCP au moment de la connexion. Les skills using-opfield et access-control indiquent à l’agent d’appeler get_my_access, ou de lire opfield://access, lorsqu’une liste revient vide ou qu’une création à la racine est refusée, et de passer folderId lors d’une création ; une création refusée indique aussi les dossiers qu’il peut utiliser. Voir Savoir à quoi l’appelant a accès.

Utilisez des identités et des installations Opfield distinctes pour le développement et la production. Un skill donne des instructions à un agent, pas d’autorité ; ce sont les scopes de l’utilisateur connecté et la demande explicite de cet utilisateur qui déterminent ce qu’il peut faire.