Notre avis

Cette compétence permet de générer du code prêt pour la production en suivant les meilleures pratiques et les conventions du projet.

Points forts

Analyse la structure du projet avant la génération pour respecter les conventions existantes.
Inclut automatiquement la gestion des erreurs, la validation des entrées et des stubs de tests.
Applique des standards de qualité comme les types explicites et des fonctions courtes.
Évite les anti-patrons courants comme les classes god, l'imbrication profonde et les nombres magiques.

Limites

La qualité dépend de la précision de l'analyse du projet existant.
Peut ne pas couvrir tous les cas d'utilisation spécifiques ou les règles métier complexes.
Nécessite que les références (guides de style, exemples) soient à jour.

Quand l'utiliser

Utilisez cette compétence lorsque vous avez besoin de produire rapidement du code robuste et maintenable qui s'intègre dans une base de code existante.

Quand l'éviter

Ne l'utilisez pas pour des prototypes exploratoires ou lorsque la flexibilité prime sur la rigueur du code.

Exemples

Generate a Python function with validation

Generate a function that validates email addresses using regex. Include type hints, docstring, and error handling.

Generate a TypeScript service class

Create a UserService class with CRUD operations. Use dependency injection and proper typing.

Generate a complete REST endpoint

Generate a Python Flask endpoint for user registration. Include input validation, error handling, logging, and a unit test stub.

name: code-generation description: Generate high-quality, production-ready code following best practices version: 1.0.0 author: Vertice Agency tools:

filesystem
shell
git

Code Generation Skill

Overview

This skill enables agents to generate production-ready code following industry best practices, design patterns, and the project's coding standards.

Instructions

Before Generating Code

Analyze the project structure using scripts/analyze_project.py
Load relevant context from references/
Check existing patterns in the codebase

Code Quality Standards

Follow language-specific style guides
Include type hints (Python) or TypeScript types
Write self-documenting code with clear names
Keep functions under 50 lines
Single responsibility principle

Generated Code Must Include

Proper error handling
Input validation at boundaries
Logging for debugging
Unit test stubs when appropriate

Anti-Patterns to Avoid

God classes/functions
Deep nesting (max 3 levels)
Magic numbers/strings
Commented-out code
Print debugging

Scripts

analyze_project.py

Analyzes project structure and returns coding conventions.

generate_tests.py

Generates test stubs for new code.

References

references/style_guides/ - Language-specific guides
references/patterns/ - Common design patterns
references/examples/ - Code examples

Examples

Generate a Python function

Generate a function that validates email addresses using regex.
Include type hints, docstring, and error handling.

Generate a TypeScript class

Create a UserService class with CRUD operations.
Use dependency injection and proper typing.

Génération de code production

Recommandé pour