From unity-skills
Configure le pipeline de build Unity, CI/CD, et deployment. Triggers: /build-config, /ci, /deploy, 'configurer build', 'github actions unity', 'gitlab ci unity', 'gitignore unity', 'build automation'. Scanne le projet, genere les scripts de build C#, les workflows CI/CD, et les fichiers Git optimises.
How this skill is triggered — by the user, by Claude, or both
Slash command
/unity-skills:unity-build-configThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Configure l'ensemble du pipeline de build Unity : scripts de build C# automatises, workflows CI/CD (GitHub Actions ou GitLab CI), fichiers `.gitignore` et `.gitattributes` optimises avec Git LFS, et checklist pre-release par plateforme. Scanne le projet existant pour adapter la configuration.
Configure l'ensemble du pipeline de build Unity : scripts de build C# automatises, workflows CI/CD (GitHub Actions ou GitLab CI), fichiers .gitignore et .gitattributes optimises avec Git LFS, et checklist pre-release par plateforme. Scanne le projet existant pour adapter la configuration.
ProjectSettings/ et Assets/Que configurer ?
|
+-- Build automatise seulement ?
| +-- --> Etape 3 (script C# BuildAutomation)
|
+-- CI/CD complet ?
| +-- GitHub ? --> Etape 4 Option A (GitHub Actions + game-ci)
| +-- GitLab ? --> Etape 4 Option B (GitLab CI)
|
+-- Git setup (nouveau projet) ?
| +-- --> Etape 5 (.gitignore + .gitattributes + LFS)
|
+-- Build Profiles (Unity 6+) ?
+-- --> Section Build Profiles (etape 2)
Si l'utilisateur ne precise pas, demander les plateformes parmi :
Collecter les informations du projet avec les outils Claude Code :
Glob "Assets/**/*.unity" → lister les scenes
Glob "ProjectSettings/*" → verifier les settings existants
Read "Packages/manifest.json" → packages et version Unity
Read "ProjectSettings/ProjectSettings.asset" → scripting backend, company name
Grep "com.unity.render-pipelines" → pipeline de rendu
Glob ".gitignore" → verifier si existant
Glob ".gitattributes" → verifier si LFS configure
Unity 6 remplace les Build Settings par des Build Profiles (assets .buildprofile configurables par plateforme). Permet plusieurs configs independantes, switchables sans reconfigurer manuellement. En CLI, utiliser -activeBuildProfile au lieu de -buildTarget.
Voir les details et exemples de code dans references/build-templates.md section "Build Profiles".
Creer Assets/Editor/BuildAutomation.cs avec une classe statique contenant : helper GetEnabledScenes(), methode generique ExecuteBuild(), et une methode par plateforme cible avec [MenuItem]. Inclure un entrypoint BuildFromCommandLine() pour le CI.
Voir le template complet dans references/build-templates.md section "BuildAutomation.cs".
Option A : GitHub Actions (recommande) -- Utilise game-ci avec jobs test (EditMode + PlayMode) puis build en matrice multi-plateforme. Cache du dossier Library/ et upload des artifacts.
Option B : GitLab CI -- Image unityci/editor, stages test puis build. Dupliquer le job build par plateforme cible.
Voir les templates YAML complets dans references/build-templates.md sections "GitHub Actions" et "GitLab CI".
Generer un .gitignore excluant Library/, Temp/, obj/, Builds/, IDE files, et keystores. Generer un .gitattributes configurant le YAML merge Unity et Git LFS pour les binaires (3D, textures, audio, video, packages).
Voir les templates complets dans references/build-templates.md sections ".gitignore" et ".gitattributes".
Ajouter une methode PreBuildCheck() dans BuildAutomation.cs qui valide : scenes presentes dans Build Settings, pas d'erreurs de compilation. Verifier aussi les references manquantes et les tests EditMode.
Voir le code dans references/build-templates.md section "Pre-build Checks".
Checklist pre-release par plateforme disponible dans references/build-templates.md section "Checklist pre-release".
Library/, Temp/, ou obj/ dans le version control.keystore (sauf debug.keystore)Library/ pour accelerer les builds CI/unity-editor-tools (Unity Editor Tools)/unity-code-gen (Unity Code Gen) pour le code C# Editor/shader (Unity Shader Generator)| Probleme | Solution |
|---|---|
| Build CI echoue "No valid Unity license" | Configurer UNITY_LICENSE en secret. Generer via unity-editor -createManualActivationFile puis activer sur license.unity3d.com |
| Cache Library/ invalide | Changer la cle de cache ou la supprimer. Le cache depend de la version Unity |
| Build tres lent en CI | Activer le cache Library/, utiliser il2CppCodeGeneration: OptimizeSize pour les builds CI non-release |
| Erreur LFS "smudge filter" | Verifier que Git LFS est installe sur le runner CI (git lfs install) |
| WebGL build out of memory | Augmenter PlayerSettings.WebGL.memorySize, reduire les assets, activer le streaming |
| Android keystore introuvable | Utiliser un path relatif au projet ou une variable d'environnement pour le chemin du keystore |
| iOS signing echoue en CI | Utiliser fastlane match ou configurer les certificats via le Keychain du runner macOS |
| Scenes manquantes dans le build | Verifier EditorBuildSettings.scenes dans le script ou ajouter les scenes manuellement via le menu Build Settings |
npx claudepluginhub juliankerignard/unity-skillsContinuous integration and deployment pipelines, automated testing, build automation, and team workflows for game development.
Build workflow for Unity: verify compilation, check settings and scenes, execute builds, and resolve errors. Useful when running or troubleshooting builds.
Run Unity builds, CI, and release packaging with reproducible configuration and platform-aware checks.