🧠 Normes de codage IA & Compétences Agent
Apprenez les principes d'ingénierie. Appliquez-les en contexte. Vérifiez le résultat.
Une collection publique de compétences réutilisables et conscientes du contexte pour les agents de codage IA et les développeurs.
Ces compétences aident l'IA à comprendre les conventions existantes d'un projet, à prendre de meilleures décisions d'ingénierie, à appliquer des pratiques de codage appropriées et à vérifier les modifications sans introduire de complexité inutile.
📑 Catalogue de Compétences
🛡️ Gouvernance & Discipline
| Compétence | Description | Idéal pour |
|---|---|---|
cite-or-stop | Impose des affirmations fondées sur des preuves, empêche les tentatives infructueuses répétées et fournit des transmissions structurées en cas de blocage. | Éviter les hallucinations, les hypothèses non fondées et les boucles de répétition. |
🔄 Méta-apprentissage & Auto-guérison
| Compétence | Description | Idéal pour |
|---|---|---|
lesson-to-skill | Convertit les erreurs confirmées, les corrections utilisateur et les problèmes récurrents en instructions réutilisables pour aider à éviter les mêmes erreurs dans les tâches futures. | Apprentissage continu, prévention des erreurs et amélioration du comportement de l'agent IA. |
🏗️ Normes de codage & Bonnes pratiques
| Compétence | Description | Idéal pour |
|---|---|---|
solid-principles | Aide les développeurs à apprendre et appliquer les principes SOLID. Analyse le code existant et suggère des améliorations de conception sans introduire d'abstractions inutiles. | Code propre, maintenable et extensible. |
precision-and-rounding | Analyse les types numériques existants, les règles d'arrondi, les calculs et les configurations avant de suggérer des modifications. Préserve le comportement établi du projet sauf indication contraire explicite. | Prévenir la perte de précision, les arrondis incorrects et les incohérences de calcul. |
database-query-patterns | Analyse les requêtes de base de données, les motifs ORM, les schémas et les index avant de recommander des améliorations. Aide à identifier les requêtes inefficaces tout en préservant le comportement existant des données. | Optimisation des requêtes, performance des bases de données et exactitude des données. |
Apprendre → Appliquer → Vérifier : Comprenez le principe, appliquez-le selon les conventions du projet existant et vérifiez le résultat.
🚀 Installation & Utilisation Rapides
⚡ Installation Rapide (Recommandée)
Installez les compétences IA directement depuis GitHub :
npx skills add geek-prateek/ai-coding-standards
Installez une compétence spécifique :
npx skills add geek-prateek/ai-coding-standards --skill precision-and-rounding
Installation globale entre projets :
npx skills add geek-prateek/ai-coding-standards -g
Parcourez les compétences disponibles :
npx skills add geek-prateek/ai-coding-standards --list
Explorez les compétences sur skills.sh.
Option 1 : Configuration Globale (Fonctionne sur Tous les Projets)
Installez une fois pour rendre ces compétences disponibles sur tous les projets.
Google Antigravity
# Windows (PowerShell)
cd $HOME\.gemini\config\skills
git clone https://github.com/geek-prateek/ai-coding-standards.git .
# macOS / Linux
cd ~/.gemini/config/skills
git clone https://github.com/geek-prateek/ai-coding-standards.git .
Claude Code
cd ~/.claude/skills
git clone https://github.com/geek-prateek/ai-coding-standards.git .
Note : Les chemins de découverte des compétences peuvent varier selon l'agent et la version. La CLI Skills est la méthode d'installation recommandée pour les agents pris en charge.
Option 2 : Configuration par Projet
Pour utiliser les compétences dans un projet spécifique, copiez les dossiers de compétences requis dans le répertoire des compétences pris en charge par votre agent.
Exemple :
mon-projet/
├── .agents/
│ └── skills/
│ ├── cite-or-stop/
│ │ └── SKILL.md
│ ├── lesson-to-skill/
│ │ └── SKILL.md
│ ├── solid-principles/
│ │ └── SKILL.md
│ ├── precision-and-rounding/
│ │ └── SKILL.md
│ └── database-query-patterns/
│ └── SKILL.md
└── src/
Ou via un sous-module Git
git submodule add https://github.com/geek-prateek/ai-coding-standards.git .agents/skills/shared
Assurez-vous que votre agent de codage peut découvrir les dossiers de compétences imbriqués.
📂 Structure du Dépôt
ai-coding-standards/
├── README.md
├── cite-or-stop/
│ └── SKILL.md
├── lesson-to-skill/
│ └── SKILL.md
├── solid-principles/
│ └── SKILL.md
├── precision-and-rounding/
│ └── SKILL.md
└── database-query-patterns/
└── SKILL.md
Chaque compétence peut également contenir des références de support, des exemples et des cas d'évaluation.
➕ Comment Ajouter une Nouvelle Compétence
Pour garder le dépôt propre et évolutif :
- Créez un répertoire :
<nom-de-la-competence>/ - Ajoutez
SKILL.md: Incluez un frontmatter YAML valide. - Définissez quand l'utiliser : Décrivez le problème spécifique et les critères d'activation.
- Suivez les conventions existantes du projet : Évitez d'imposer des motifs ou de modifier le comportement établi sans justification.
- Gardez-le générique : N'incluez pas de code propriétaire, d'identifiants, d'URL internes ou d'informations spécifiques à l'entreprise.
- Ajoutez des évaluations si utile : Incluez des scénarios pratiques pour vérifier l'efficacité de la compétence.
- Mettez à jour le catalogue : Ajoutez la nouvelle compétence au catalogue des compétences.
Exemple de SKILL.md :
---
name: nom-de-la-competence
description: >-
Décrivez ce que fait la compétence et quand l'utiliser.
---
# Titre de la Compétence
## Apprendre
Expliquez le concept avec des exemples pratiques.
## Appliquer
Analysez les conventions existantes du projet avant de suggérer des modifications.
## Vérifier
Validez l'exactitude, la compatibilité et les cas limites.
Important : Ne créez pas une compétence simplement parce qu'un concept de programmation existe. Créez-en une lorsqu'un problème récurrent bénéficie d'un workflow spécifique et réutilisable.
🤝 Contribuer
Les contributions, suggestions et améliorations sont les bienvenues !
N'hésitez pas à ouvrir une issue ou à soumettre une pull request pour améliorer les compétences existantes ou en proposer de nouvelles.
📄 Licence
Consultez le fichier LICENSE du dépôt pour les informations de licence.