Connecter et automatiserSkills portables

Préparer une Skill portable

Rédigez une procédure réutilisable, proposez-la au Brain et comprenez ce que sa publication autorise.

Objectif : transformer une méthode vérifiée en instructions portables qu’un client autorisé peut lire. Une Skill décrit une procédure ; sa présence dans Orbit n’installe ni extension ni automatisation sur vos outils.

Ce qu’une bonne Skill contient

PartieQuestion à résoudre
DéclenchementDans quelle situation utiliser cette méthode ?
EntréesQuels documents, faits ou décisions faut-il avoir ?
ÉtapesQue faire, dans quel ordre ?
VérificationComment constater que le résultat est correct ?
LimitesQue faut-il refuser, signaler ou faire valider ?

Téléchargez le modèle de procédure. C’est un document de préparation : adaptez-le et utilisez le format d’import décrit dans la référence. Ce n’est pas un paquet exécutable prêt à installer.

Du brouillon à la version publiée

Rédigez et testez la procédure

Prenez un cas réel mais non sensible. Faites suivre les étapes à quelqu’un qui ne connaît pas votre intention ; corrigez les ambiguïtés qu’il rencontre.

Soumettez l’import

Un client autorisé utilise brain_import_skill ou l’API d’import. L’import crée une proposition en attente ; il ne publie pas silencieusement la Skill.

Relisez dans Orbit

Ouvrez Brain → Revue. Vérifiez l’espace, le contenu et les changements proposés avant d’approuver. Un agent externe ne peut pas approuver à votre place.

Relisez ou exportez la version approuvée

Les clients autorisés peuvent lister et lire les Skills avec brain_list_skills et brain_get_skill. L’API permet aussi l’export et la comparaison avec une version antérieure.

Exemple de consigne de relecture

Relis cette procédure avant que je l’importe comme Skill.
Vérifie que chaque étape a une entrée et un résultat observable.
Signale les droits nécessaires, les actions payantes et les décisions humaines.
Ne transforme pas une hypothèse en règle et ne publie rien sans mon accord.

Ce qu’Orbit ne fait pas automatiquement

Le client qui récupère une Skill décide comment l’utiliser. Orbit ne l’installe pas dans votre éditeur, ne pose pas de hook et ne garantit pas qu’un hôte exécute toutes ses instructions. La version publiée ne dispense pas de vérifier les droits, les entrées et le résultat à chaque utilisation.

Référence des propositions et Skills

Comprenez la revue, les preuves et le versionnement.