---
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.