IA Disciplinée : Injecter les compétences d'agent de Google dans Antigravity
Soyons réalistes : le code généré par l'IA est rapide, mais c'est souvent un cauchemar de maintenance. Si vous avez utilisé des outils comme Antigravity sur un Mac, vous savez que la vitesse est là, mais la discipline fait généralement défaut.
Pour y remédier, la direction de l'ingénierie de Google a publié Agent Skills — un ensemble de 20 compétences atomiques et 7 commandes qui forcent l'IA à suivre les normes internes d'ingénierie logicielle. Voici comment intégrer ces normes dans l'environnement local de votre MacBook.
La valeur fondamentale : l'Anti-Rationalisation
L'IA a tendance à "halluciner" pour éviter d'écrire des tests ou à sauter la phase de documentation parce que c'est "trop simple".
Le cadre Agent Skills introduit l'Anti-rationalisation. Si l'IA essaie de sauter une étape, le système résiste. Il applique la Règle Beyoncé ("Si tu l'aimais, tu aurais dû mettre un test dessus") et s'assure que chaque ligne de code est soutenue par une spécification (Spec) avant que la première ligne ne soit écrite.
1. Configuration de votre Mac M3
Puisque nous sommes sur Apple Silicon, nous voulons garder nos outils natifs et nos chemins propres. Nous allons commencer avec Homebrew et la CLI GitHub (gh).
1.1 Installer les outils et s'authentifier
Ouvrez votre terminal et exécutez ce qui suit pour vous assurer que votre environnement est prêt :
# Installer Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# S'assurer que Brew est dans votre chemin
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
eval "$(/opt/homebrew/bin/brew shellenv)"
# Installer la CLI GitHub et se connecter
brew install gh
gh auth login
Après avoir exécuté gh auth login. Suivez les instructions à la lettre : sélectionnez GitHub.com -> HTTPS -> Yes (pour s'authentifier) -> Login with a web browser.
Conseil de pro : Votre terminal affichera un code de 8 caractères (comme 1234-ABCD). Appuyez sur Entrée pour ouvrir GitHub dans votre navigateur, collez ce code dans la case et cliquez sur le bouton vert Autoriser (Authorize) pour lier votre compte.
1.2 Injecter les compétences dans Antigravity
Antigravity recherche une structure de répertoire spécifique pour "apprendre" de nouveaux comportements. Nous allons cloner les normes d'ingénierie de Google directement dans le dossier d'agent caché de votre projet.
# Naviguer vers la racine de votre projet
cd ~/your-project-path
# Créer le répertoire standard pour les compétences d'IA
mkdir -p .agent/skills
# Cloner le repo Google Agent Skills
gh repo clone addyosmani/agent-skills .agent/skills/engineering-standards
# Nettoyer les données git imbriquées pour pouvoir les suivre dans votre propre repo
rm -rf .agent/skills/engineering-standards/.git
1.3 Activer le "Cerveau"
Maintenant que les compétences sont en place, vous devez les réveiller. Redémarrez Antigravity ou exécutez simplement ceci dans sa console :
/reload-skills
Tester la configuration : Déposez ceci dans le chat Antigravity :
"Je voudrais démarrer une nouvelle fonctionnalité. Utilise la compétence /spec pour m'aider à définir les exigences."
Si l'IA commence à vous poser des questions sur les objectifs, les scénarios d'utilisateurs et les exigences non fonctionnelles au lieu de simplement écrire du code, vous avez réussi à injecter les normes de Google dans votre environnement local.
2. Meilleures pratiques Git
Vous voulez que votre équipe utilise ces mêmes compétences, mais vous ne voulez pas polluer votre repo avec les "journaux de pensée" ou les données de session de l'IA. Ajoutez ceci à votre .gitignore :
# --- Config Agent IA ---
# Ignorer les données d'exécution du cerveau
.agent/workspaces/
.agent/logs/
.agent/cache/
.agent/sessions/
# GARDER les compétences
!.agent/skills/
2.1 Analyse approfondie : Pourquoi la stratégie Git est importante
Vous vous demandez peut-être pourquoi nous sommes si exigeants avec notre .gitignore. Voici les détails :
2.1.1 Pourquoi vous ne devriez pas ignorer .agent/skills
Le dossier agent-skills est essentiellement la "Procédure Opératoire Standard" de votre IA.
Cohérence : Si vous ne validez pas ce dossier, vos coéquipiers (ou vous sur une machine différente) obtiendront simplement une IA "générique". Vous perdrez l'accès aux compétences avancées comme /spec ou /review.
Contrôle de version : Si vous modifiez un SKILL.md — par exemple, en augmentant la couverture de test requise de 80 % à 90 % — cette logique devrait vivre et évoluer avec votre code source.
2.1.2 Pourquoi vous devez ignorer les autres sous-répertoires
Confidentialité et Sécurité : Les dossiers comme .agent/sessions ou workspaces peuvent contenir l'historique brut des conversations, des données intermédiaires sensibles ou des extraits de votre processus de travail. Vous ne voulez absolument pas que cela soit poussé sur un serveur.
Zéro Utilité : Les journaux (logs) et le cache sont générés localement et sont spécifiques à votre machine. Les valider ne fait que gonfler le dépôt et créer des conflits de fusion inutiles.
3. Passer de "Chatbot" à "Ingénieur"
Une fois que vous redémarrez Antigravity, l'IA n'est plus seulement un chatbot. Au lieu de dire "Construis-moi une page de connexion", vous commencez à utiliser les commandes slash :
/spec: Forcer l'IA à écrire d'abord une spécification technique./plan: Décomposer cette spécification en une liste de tâches./review: Auditer le travail par rapport aux normes "Clean Code".
Il faut 60 secondes supplémentaires pour exécuter un /spec, mais cela permet d'économiser 3 heures de débogage de la dette technique plus tard. Si vous utilisez un Mac M3, vous avez la puissance — maintenant vous avez les normes.