Que fait éditions-conservatrices-de-code ?
Une compétence Codex pour maintenir les modifications de code minimales, ciblées, cohérentes en style et sûres pour les projets existants.
Objectif
Cette compétence vise à guider l'IA à effectuer des modifications de code qui sont :
- Minimales : ne modifiez que ce qui est nécessaire pour accomplir la tâche.
- Ciblées : limitez les changements à la portée spécifique de la demande.
- Cohérentes en style : respectez les conventions de style, de formatage et les modèles de code existants du projet.
- Sûres : ne cassez pas les fonctionnalités existantes ; privilégiez la stabilité.
Utilisation
Pour utiliser cette compétence, ajoutez simplement le fichier SKILL.md à votre projet Codex. La compétence s'intègre automatiquement dans le processus de génération de code.
Principes
- Analyser avant d'agir : avant d'écrire ou de modifier du code, analysez le contexte, les dépendances et l'impact potentiel.
- Modifications minimales : ne changez que les lignes nécessaires ; évitez de refondre ou de reformater le code existant.
- Respecter le style : suivez les conventions de dénomination, de formatage et la structure du projet.
- Privilégier la sécurité : ne supprimez pas de code sans comprendre sa fonction ; ne cassez pas les tests existants.
- Tester les changements : exécutez les tests pertinents (le cas échéant) après avoir effectué les modifications.
- Documenter les changements : fournissez des messages de commit clairs et des commentaires si nécessaire.
Exemples
- Correct : Ajouter un paramètre optionnel à une fonction existante, en maintenant la signature rétrocompatible.
- Incorrect : Reformater l'intégralité d'un fichier ou changer les noms de variables sans rapport avec la tâche.
Intégration
Cette compétence fonctionne avec Codex dans n'importe quel langage de programmation. Elle est conçue pour ne pas modifier les comportements de l'outil sous-jacent, mais uniquement pour guider la sortie de l'IA.