Skip to Content
DocsGithubGénérer avec l'IA

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 ActionsMélodium
Fichier de workflowTraitement .mel
JobTraitement avec simpleStep ou localStep
Étape run:runAction[contexts=contexts]()
Expression ${{ }}Évaluée via JavaScriptEngine
jobs.<job>.needsCâblage séquentiel + includeNeeds
strategy.matrixInstances de traitements parallèles avec one<void>()
jobs.<job>.iffilterBlock<void>() sur le déclencheur du job
actions/cacheParamètre cache de simpleStep, ou work/cache dans les programmes (voir Caches)
actions/upload-artifact / download-artifactParamètre artifacts de simpleStep, ou work/artifact dans les programmes (voir Artefacts de run)
Remontée d’étatpostGithubState / 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.