Agents IA et skills

Un agent IA peut piloter Fundamentum pour vous en langage naturel : il exécute la CLI fun en votre nom, guidé par les skills Fundamentum. Ce guide vous explique comment installer les skills, ce que chacun couvre et les garde-fous qu'ils imposent.

Un skill est un dossier d'instructions et de fichiers de référence qu'un agent de codage IA charge lorsque votre demande correspond à sa description. Les skills Fundamentum apprennent à l'agent à utiliser la CLI fun, quelle API appeler pour quel besoin et quelles erreurs éviter. L'agent exécute ensuite des commandes fun dans votre terminal, avec votre contexte et votre token. Il agit comme vous : il peut faire exactement ce que votre rôle autorise, rien de plus. Consultez Rôles et autorisations.

Avant de commencer

• La CLI fun est installée et vous êtes connecté. Consultez La CLI fun.
• Vous utilisez un agent de codage IA qui prend en charge les skills et les lit depuis ~/.claude/skills ou ~/.agents/skills.

1. Installer les skills

Les skills sont fournis avec la CLI. Installez-les avec :

fun install-skills

La commande copie les skills dans ~/.claude/skills si ~/.claude existe, sinon dans ~/.agents/skills, et affiche le répertoire utilisé. Exécutez-la de nouveau après avoir mis à jour la CLI pour obtenir la dernière version des skills.

Vous obtenez les skills suivants :

Les skills se transmettent le travail entre eux : une tâche cloud qui devient une tâche appareil passe de fun-api à fun-api-device.

2. Actualiser les spécifications de l'API

Le skill fun-api fonctionne via fun api, qui a besoin des spécifications mises en cache. Téléchargez-les une fois :

fun api refresh

Vous pouvez aussi demander à l'agent : « actualise les spécifications de l'API Fundamentum ».

3. Demander en langage naturel

Démarrez votre agent dans un terminal où fun fonctionne, puis posez votre demande. Vous n'avez pas besoin de nommer la CLI ni le skill. Par exemple :

• « Liste les appareils du projet 42 qui n'ont pas envoyé de heartbeat aujourd'hui. »
• « Crée un compte de service pour notre CI dans le projet 42 et donne-lui le rôle en lecture seule. »
• « Qui peut accéder au projet 42, et avec quel rôle ? »
• « Mets la LED de mon dongle AtomS3 en bleu. »
• « Comment mon micrologiciel se provisionne-t-il auprès de la Devices API ? »

L'agent découvre la bonne opération avec fun api … --help au lieu de répondre de mémoire, puis l'exécute et vous renvoie le résultat.

Garde-fous

Les skills fixent des règles que l'agent respecte :

• Les tokens ne sont jamais affichés. L'agent n'affiche ni ne répète jamais un token ou un token de compte de service, et ne l'écrit jamais dans un fichier, un dépôt ou un journal.
• Les erreurs d'autorisation sont signalées telles quelles. En cas de 401 ou 403, l'agent vous montre le statut HTTP et le message exacts. Il ne bascule jamais silencieusement vers un autre contexte pour contourner l'erreur.
• Aucun identifiant deviné. L'agent recherche les ID de projet, de registre et d'appareil au lieu de les inventer, et consulte l'aide de chaque opération avant de l'appeler.
• La bonne API pour la tâche. Le travail côté cloud passe par la Public API avec votre token d'utilisateur ou de compte de service. Les informations d'identification des appareils ne sont jamais utilisées avec la Public API.
• Les faits sont qualifiés. Pour le kit de démarrage, l'agent précise si un résultat a été observé sur l'appareil, seulement compilé ou non testé.

Vous restez responsable de ce que vous approuvez. Pour les opérations d'écriture, demandez à l'agent d'exécuter d'abord la commande avec --dry-run et vérifiez la requête.

Étapes suivantes

• La CLI fun : les commandes que l'agent exécute pour vous.
• Démarrage rapide : AtomS3 Lite : essayez le skill atoms3-lite sur le kit de démarrage.
• Référence de la CLI fun et référence de la Public API.