Générer avec l’IA

Si vous avez déjà des workflows GitHub Actions, vous pouvez utiliser un assistant de code IA pour obtenir le pipeline Mélodium équivalent en quelques minutes, sans avoir à apprendre le langage au préalable.

Ce dont vous avez besoin

Votre répertoire .github/workflows/ existant (l’agent le lira directement).
Un assistant de code IA fonctionnant localement dans votre projet (Claude Code, Cursor, Zed, ou similaire).
La compétence Mélodium installée dans votre outil IA. Voir Installer la compétence Mélodium.

Étape 1 : Vérifier que la référence de migration est incluse

La compétence Mélodium générale couvre le langage et la structure de projet. Pour une migration depuis GitHub Actions, l’IA a également besoin de skills/melodium/references/github-migration.md, qui contient les patterns exacts pour runAction, prepareContexts, githubJobResult, les jobs matrix, et la remontée d’état.

Avec Claude Code, cela est inclus automatiquement lorsque la compétence est installée sous ~/.claude/skills/melodium. La compétence charge ses fichiers de référence à la demande.

Avec Cursor ou Zed, vérifiez que votre fichier de règle l’inclut :


# Cursor
cat skills/melodium/SKILL.md \
    skills/melodium/references/github-migration.md \
    skills/melodium/references/projects.md \
    > .cursor/rules/melodium.md
 
# Zed
cat skills/melodium/SKILL.md \
    skills/melodium/references/github-migration.md \
    skills/melodium/references/projects.md \
    > .rules

Étape 2 : Demander la migration

Votre agent IA fonctionne déjà dans votre projet et peut lire vos fichiers de workflow directement. Un prompt simple suffit :


Lis les workflows dans .github/workflows/ et migre-les vers Mélodium.
Génère un projet complet sous .melodium-ci/ avec Compo.toml et des fichiers .mel.
Utilise simpleStep pour les jobs conteneurisés, localStep pour les jobs self-hosted.
Remonte l'état vers GitHub en utilisant le token et les paramètres de projet.

Si vos workflows référencent des actions composites dans .github/actions/, mentionnez-les pour que l’agent les lise également :


Lis aussi les actions composites dans .github/actions/ et intègre-les comme des traitements.

L’IA produira un projet Mélodium prêt à l’emploi avec :

Un Compo.toml déclarant les bonnes dépendances.
Un fichier .mel par workflow, avec un traitement par job.
Un câblage parallèle pour les jobs de type matrix.
Un streaming d’artefacts entre les jobs qui dépendent les uns des autres.
La remontée d’état des commits GitHub.

Étape 3 : Relire et ajuster

Lisez le code généré avant de l’exécuter. Points utiles à vérifier :

Dimensionnement des ressources : les paramètres cpu, memory et storage dans simpleStep ont des valeurs par défaut qui peuvent ne pas correspondre à votre charge de travail. Ajustez-les en fonction de vos besoins réels.
Secrets et tokens : vérifiez que github_token, github_project et github_sha sont connectés aux bons paramètres du point d’entrée.
Actions tierces (uses:) : les actions de la marketplace ne peuvent pas être traduites automatiquement. L’IA intégrera leur logique sous forme de commandes shell quand c’est possible, mais les actions complexes peuvent nécessiter une attention manuelle.
Jobs conditionnels (if:) : vérifiez que le câblage filterBlock correspond bien à l’intention de la condition d’origine.

Référence des concepts

Si vous souhaitez comprendre ce que l’IA a produit, ou l’ajuster vous-même, ce tableau montre comment les concepts GitHub Actions se mappent vers Mélodium :

GitHub Actions	Mélodium
Fichier de workflow	Traitement `.mel`
Job	Traitement avec `simpleStep` ou `localStep`
Étape `run:`	`runAction[contexts=contexts]()`
Expression `${{ }}`	Évaluée via `JavaScriptEngine`
`jobs.<job>.needs`	Câblage séquentiel + `includeNeeds`
`strategy.matrix`	Instances de traitements parallèles avec `one<void>()`
`jobs.<job>.if`	`filterBlock<void>()` sur le déclencheur du job
Remontée d’état	`postGithubState` / `postGithubStateContext`

La documentation complète de l’API est disponible sur doc.melodium.tech .

Pour aller plus loin

Le code généré est un bon point de départ et peut être étendu avec n’importe quel élément Mélodium. Pour la distribution sur plusieurs machines et la parallélisation avancée, consultez Implémentation CI/CD Simple et Implémentation CI/CD Avancée.

Construire un pipeline avec l'IA Outil de Migration Automatisé