--- name: kalinotes-automation description: "Génère un script AUTOMATE (navigation, clics, saisie, captures, conditions) à partir d'un scénario décrit en langage naturel, prêt à être exécuté depuis le champ JavaScript d'une note." --- # Kalinotes – Script d'automatisation (AUTOMATE) Transforme un scénario décrit par l'utilisateur en script AUTOMATE : un script d'interaction avec une page web, interprété commande par commande par Kalinotes, que l'utilisateur lance lui-même avec le bouton ▶ de la section JavaScript d'une note. ## Prérequis MCP Ce skill utilise les outils MCP suivants : `list_projects`, `list_categories`, `get_note`, `create_note`, `update_note`. ## Instructions 1. Fais préciser le scénario si nécessaire : - **URL de départ** et enchaînement des pages - **Actions** à réaliser (clics, champs à remplir, valeurs à relever) - **Résultat attendu** : alerte, commentaire sur la note, capture d'écran - **Données variables** (identifiant, mot de passe, référence…) à demander à l'exécution 2. Identifie les sélecteurs CSS de chaque élément. Si tu as accès à la page (navigateur, HTML fourni), relève-les réellement. Sinon, demande-les à l'utilisateur ou signale clairement ceux que tu as supposés. 3. Rédige le script en respectant la syntaxe et les règles ci-dessous. 4. Relis le script : première ligne exacte, chaque label ciblé par un `GOTO` existe, chaque branche se termine par `Stop` ou par la fin du script, aucune boucle sans sortie. 5. Enregistre toi-même le script dans le champ `javascript` de la note, sans demander à l'utilisateur de le copier : - **Nouvelle note** : appelle `list_projects` puis `list_categories`, choisis le projet et la catégorie adaptés (catégorie « Automatisation » si elle existe), puis appelle `create_note` avec `project_id`, `url` (URL de départ du scénario), `title` (`Automate – [description courte]`), `comment` (description du scénario en markdown) et `javascript` (le script complet). - **Note existante** (l'utilisateur donne un ID ou une référence) : appelle `get_note` pour lire le script actuel, puis `update_note` avec `note_id`, `project_id` et `javascript`. Les autres champs restent inchangés. 6. Le champ `javascript` contient le script brut : pas de bloc de code markdown, pas de texte avant `#!AUTOMATE`. Il est remplacé en entier à chaque mise à jour, envoie donc toujours le script complet. 7. Pour corriger ou faire évoluer un script, modifie-le puis rappelle `update_note` sur la même note plutôt que d'en créer une nouvelle. 8. Explique à l'utilisateur comment lancer le script : ouvrir la note, cliquer sur **▶** dans l'en-tête de la section JavaScript, suivre la console en bas du formulaire, **⏹** pour annuler. ## Syntaxe - La **première ligne** doit être exactement `#!AUTOMATE` (sans espace ni ligne vide avant). C'est elle qui fait apparaître le bouton ▶. - Une commande par ligne : `COMMANDE argument1 "argument avec espaces" $VARIABLE` - Les arguments contenant des espaces sont entre guillemets `"..."` ou `'...'`. - Les variables sont préfixées par `$`, globales au script, et résolues dans tous les arguments avant chaque commande. - Les noms de commandes sont insensibles à la casse. - Les lignes vides et celles commençant par `#` sont ignorées. - `$__SCREENSHOT__` est réservée : elle contient la dernière capture de `CopyPage` (data-URL PNG). ## Commandes disponibles | Commande | Effet | |----------|-------| | `SetVal $VAR "valeur"` | Affecte une valeur littérale à une variable | | `Input $VAR "Message"` | Demande une saisie à l'utilisateur et la stocke | | `Wget $VAR "url"` | Charge le contenu texte d'une URL (GET sans authentification) | | `LoadUrl "url"` | Navigue dans l'onglet actif et attend le chargement (max 15 s) | | `Sleep ms` | Pause en millisecondes | | `ClickElement "selecteur"` | Clique sur le premier élément correspondant | | `FillElement "selecteur" "valeur"` | Remplit un input, textarea ou select (déclenche `input` et `change`) | | `CopyElement "selecteur" $VAR` | Stocke la valeur (`.value`) ou le texte (`.textContent`) de l'élément | | `WaitUntilExist "selecteur"` | Attend l'apparition de l'élément (timeout 10 s, erreur au-delà) | | `WaitUntilNoExist "selecteur"` | Attend la disparition de l'élément (timeout 10 s) | | `CopyPage` | Capture la partie visible de l'onglet et l'attache à la note | | `CreateComment "texte" [$VAR ...]` | Ajoute un commentaire à la note (arguments concaténés par un espace) | | `Alert "message" [$VAR ...]` | Notification flottante de 10 s (arguments concaténés par un espace) | | `If $VAR OP "valeur" GOTO :label` | Saute au label si la condition est vraie | | `:label` | Définit un point de saut | | `Stop` | Arrête le script proprement, sans erreur | Opérateurs de `If` : `==` et `!=` comparent du texte ; `>`, `<`, `>=`, `<=` comparent des nombres. N'utilise **aucune autre commande** : il n'existe ni boucle dédiée, ni calcul, ni concaténation dans une variable, ni `else`. Tout branchement passe par `If ... GOTO :label`. ## Règles de rédaction - **Synchronisation** : après `LoadUrl` ou un clic qui change la page, ajoute un `WaitUntilExist` sur un élément de la page attendue. `LoadUrl` n'attend pas les scripts asynchrones. Réserve `Sleep` aux cas sans élément observable. - **Chargements** : pour un indicateur de chargement, utilise `WaitUntilNoExist ".spinner"` avant de lire le résultat. - **Sélecteurs** : privilégie les `id`, puis les attributs stables (`name`, `type`, `data-*`). Évite les classes générées et les sélecteurs dépendant de la position. - **Secrets** : n'écris jamais de mot de passe ni de jeton en dur dans le script. Demande-les avec `Input` à l'exécution. - **Branches** : termine la branche nominale par `Stop` avant les labels d'erreur, sinon l'exécution continue dans le label suivant. - **Boucles** : un `GOTO` vers un label précédent crée une boucle. Elle doit dépendre d'une valeur relue dans la page (`CopyElement`) et rester sous la limite de **2 000 instructions** par exécution. - **Note sauvegardée** : `CreateComment` exige une note enregistrée ; `CopyPage` n'attache la capture que dans ce cas (sinon elle reste dans `$__SCREENSHOT__`). - **Lisibilité** : commente chaque étape avec une ligne `# ...` et nomme les variables en majuscules. ## Limitations à signaler à l'utilisateur - `Input` utilise `window.prompt()` : à éviter dans un onglet Firefox en mode kiosque. - `Wget` est soumis aux règles CORS du navigateur ; certaines API refusent la requête. - Les temps d'attente sont fixes : 15 s pour `LoadUrl`, 10 s pour `WaitUntilExist` et `WaitUntilNoExist`. ## Exemple ``` #!AUTOMATE # Connexion puis relevé du nombre de courriers Input $LOGIN "Identifiant :" Input $PASSWORD "Mot de passe :" # Étape 1 : connexion LoadUrl "https://example.com/login" WaitUntilExist "#form-login" FillElement "#username" $LOGIN FillElement "#password" $PASSWORD ClickElement "#btn-submit" # Étape 2 : attente du tableau de bord WaitUntilNoExist ".spinner" WaitUntilExist "#dashboard" # Étape 3 : relevé et compte rendu CopyElement "#mail-count" $COUNTER CopyPage If $COUNTER > "0" GOTO :courriers Alert "Aucun courrier" Stop :courriers CreateComment "Nombre de courriers :" $COUNTER Alert "Courriers à traiter : " $COUNTER ``` ## Restitution Présente à l'utilisateur : - le script complet dans un bloc de code ; - la liste des sélecteurs supposés, à vérifier avant la première exécution ; - les valeurs qui lui seront demandées au lancement ; - le lien vers la note créée.