agent-skills

Il s'agit d'un pack de compétences open-source conçu pour les agents de codage IA, créé par Addy Osmani afin d'imposer une discipline d'ingénierie de qualité production tout au long du cycle de développement logiciel. Il répond au problème courant des agents IA sautant des étapes critiques comme la rédaction de spécifications, les tests, les revues de sécurité et les portes de qualité, en proposant des flux de travail structurés et opinionnés qui imitent les pratiques des ingénieurs seniors. Le pack comprend 25 compétences au total : 24 compétences axées sur le cycle de vie organisées en 6 phases de développement, plus 1 compétence meta pour acheminer le travail vers le flux de travail approprié. Les phases sont : Define (couvrant l'interview des besoins, le raffinement des idées, le développement piloté par les spécifications et la fixation des contraintes pour clarifier quoi construire), Plan (décomposition des tâches pour diviser les spécifications en unités vérifiables), Build (implémentation incrémentale, développement piloté par les tests, ingénierie UI frontend, conception API, ingénierie du contexte, développement piloté par les sources et développement piloté par les doutes pour écrire du code), Verify (tests navigateur avec DevTools et débogage/récupération d'erreurs pour prouver la fonctionnalité), Review (revue de code, simplification du code, durcissement de la sécurité et optimisation des performances pour fixer les standards de qualité), et Ship (flux de travail git, automatisation CI/CD, dépréciation et migration, documentation et ADR, observabilité et instrumentation, et processus de lancement pour le déploiement en production). Il inclut également 4 personnalités d'agent spécialiste préconfigurées (reviseur de code, ingénieur de test, auditeur de sécurité, auditeur de performance web) pour des tâches de révision ciblées, ainsi que 7 checklists de référence couvrant des standards partagés comme la définition de terminé, les patterns de test, la sécurité, la performance, l'accessibilité et l'observabilité. Le pack prend en charge l'intégration avec plus de 70 agents et outils de codage IA, dont Claude Code (avec support natif de plugin et 8 commandes slash), Cursor, Antigravity CLI, Gemini CLI, Windsurf, OpenCode, GitHub Copilot, byNara IDE/CLI, Codex et Command Code, ainsi que tout agent acceptant des instructions système ou des fichiers d'instructions. Il fournit 9 commandes slash principales mappées aux phases de développement : /spec, /plan, /build, /test, /constraints, /review, /webperf, /code-simplify et /ship. La commande /build auto prend en charge l'exécution autonome des tâches de planification et d'implémentation après une seule approbation utilisateur, tout en conservant la vérification test-driven par tâche, les commits individuels et une pause automatique en cas d'échec ou d'étapes risquées. Les compétences s'activent également automatiquement en fonction du contexte de la tâche actuelle, par exemple déclenchant les compétences d'ingénierie UI frontend lors de la construction d'interfaces utilisateur. Chaque compétence suit une anatomie cohérente avec des métadonnées frontmatter, des flux de travail étape par étape, des tableaux anti-rationalisation qui contrent les excuses courantes des agents pour sauter des étapes (comme "je rajouterai les tests plus tard"), des exigences de vérification non négociables qui exigent des preuves concrètes plutôt que des jugements du type "ça semble correct", et une divulgation progressive pour minimiser l'utilisation de tokens en ne chargeant le matériel de référence support que lorsque cela est nécessaire. Les flux de travail intègrent des pratiques d'ingénierie éprouvées issues de la culture engineering de Google, notamment la loi de Hyrum pour la conception API, la règle de Beyoncé et la pyramide de test 80/15/5, les normes de taille de changement d'environ ~100 lignes pour les revues de code, la clôture de Chesterton pour la simplification du code, le développement basé sur la branche principale pour le flux de travail git, le Shift Left et les feature flags pour le CI/CD, ainsi qu'une mentalité code-as-liability pour la dépréciation. Le dépôt comprend un guide d'adoption tant pour les projets greenfield que pour le déploiement incrémental sur des bases de code existantes, des directives de contribution exigeant que les compétences soient spécifiques, vérifiables, éprouvées et minimales, ainsi qu'un document de comparaison avec des packs de compétences similaires tels que Superpowers et les skills de Matt Pocock pour aider les utilisateurs à choisir le bon outil pour leurs besoins.