Que fait repo-architect ?
Compétence d'agent 'repo-architect' de alphasafal/production-agent-skills.
Cette compétence définit un processus structuré pour les agents d'IA afin d'analyser et de comprendre l'architecture d'un dépôt de code. Elle garantit que l'agent ne manque pas de composants critiques ou de relations entre les fichiers.
Objectif
Permettre à un agent d'IA de cartographier rapidement la structure, les dépendances et les flux de données d'une base de code, afin de fournir des réponses pertinentes et contextuelles pour des tâches de génie logiciel.
Processus
- Lire les fichiers de configuration racine : Commencez par les fichiers de configuration les plus importants (p. ex.,
package.json,requirements.txt,go.mod,Makefile,Dockerfile,.env.example). Comprenez le système de build, les dépendances principales et les variables d'environnement. - Explorer la structure des répertoires : Listez la structure des dossiers jusqu'à une profondeur de 2-3 niveaux. Identifiez les modules ou services principaux (p. ex.,
src/,app/,api/,models/). - Analyser les dépendances : Examinez les fichiers de dépendances pour identifier les frameworks, bibliothèques et outils externes. Notez comment ils sont utilisés dans le projet.
- Revoir les modèles de données : Si le projet utilise une base de données (SQL, NoSQL, etc.), lisez les schémas, migrations ou fichiers de définition de modèles.
- Cartographier les chemins API : Si le projet expose une API (REST, GraphQL, etc.), lisez les fichiers de définition de routes ou de points de terminaison API.
- Comprendre les flux de données : Tracez un flux simple d'un point d'entrée (requête, événement) à la sortie (réponse, notification). Identifiez les fonctions ou classes clés impliquées.
- Résumer : Fournissez un résumé concis de l'architecture, incluant les composants principaux, les dépendances et les flux de données. Mettez en évidence les zones à fort couplage ou les choix de conception inhabituels.
Utilisation
Lorsqu'un utilisateur demande d'effectuer une modification ou d'analyser la base de code, l'agent doit d'abord invoquer ce processus d'architecture de dépôt avant de suggérer des changements. Cela permet de garantir que toutes les parties pertinentes du système sont prises en compte.
Plateformes Supportées
Conçu pour les agents sur Claude Code, Cursor, Codex, et d'autres assistants de codage IA s'appuyant sur des compétences markdown structurées.