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, le serveur MCP Mélodium connecté à celui-ci, ou les deux. Voir Installer la compétence Mélodium. Le serveur MCP fournit le même guide de migration via
get_cicd_migration_guide, et permet à l’IA de vérifier le programme qu’elle écrit.
É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_project et github_sha sont connectés aux bons paramètres du point d’entrée, et que le token est lu depuis le bon secret : github_token vaut par défaut "env:MELODIUM_SECRET_GITHUB_TOKEN", que fournissent les workflows réutilisables. 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 |
actions/cache | Paramètre cache de simpleStep, ou work/cache dans les programmes (voir Caches) |
actions/upload-artifact / download-artifact | Paramètre artifacts de simpleStep, ou work/artifact dans les programmes (voir Artefacts de run) |
| 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.