Générer avec l’IA

Si vous avez déjà des workflows GitHub Actions, un assistant de code IA peut produire le pipeline Mélodium équivalent en quelques minutes, sans que vous ayez à 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 aussi 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, c’est inclus automatiquement dès que la compétence est installée sous ~/.claude/skills/melodium, elle 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 aussi :


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 : 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 jobs qui dépendent les uns des autres, et la remontée d’état des commits GitHub.

Étape 3 : relire et ajuster

Lisez le code généré avant de l’exécuter. Les paramètres cpu, memory et storage dans simpleStep ont des valeurs par défaut génériques, ajustez-les à vos besoins réels de build. Vérifiez que github_token, github_project et github_sha sont connectés aux bons paramètres du point d’entrée. Les actions tierces (uses:) de la marketplace ne peuvent pas être traduites automatiquement, l’IA intègre leur logique sous forme de commandes shell quand c’est possible, mais les actions complexes peuvent demander votre attention. Et pour les 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 une parallélisation plus 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é