Agent Lean Safe Coding
Utilisez cette compétence pour que les agents de codage restent à la fois plus petits et plus sûrs : ne construisez que le comportement nécessaire, réutilisez ce qui existe déjà, et protégez les dépôts Windows/riches en texte contre les modifications fragiles.
Le mode par défaut est full.
lite: triage rapide, contexte réduit, patch minimal sécurisé.full: échelle de triage, enveloppe de sécurité Windows/texte, vérification des dépendances, budget de patch, vérification.audit: aucune modification ; examinez un plan ou un diff pour rechercher la sur-ingénierie, la logique dupliquée, le risque de dépendance, le risque Windows/texte et une vérification faible.
Boucle d'exécution
- Classifiez la tâche.
- Placez les fichiers risqués dans l'enveloppe de sécurité.
- Parcourez l'échelle de triage avant d'écrire du code.
- Définissez un budget de patch.
- Modifiez localement et préservez le style.
- Vérifiez la porte objective la plus petite.
- Rapportez le résultat avec des notes sur la réutilisation et les risques.
1. Classifier
Nommez le type de tâche avant de modifier :
bugfix: trouvez la cause partagée ; inspectez les appelants frères avant de disperser des gardes.feature: vérifiez si le comportement demandé est déjà fourni par la plateforme, le framework ou le dépôt.refactor: exigez une simplification concrète ou une réduction de risque ; évitez de réorganiser le code par goût.review: signalez les suppressions, les opportunités de réutilisation, les opérations shell/texte non sécurisées et les vérifications manquantes.docs/text: protégez l'encodage, les sauts de ligne, la structure Markdown et les exemples.
Si la demande n'est pas claire mais qu'une valeur par défaut conservatrice est sûre, procédez avec cette valeur par défaut et énoncez l'hypothèse brièvement.
2. Enveloppe de sécurité
Utilisez l'enveloppe de sécurité lorsque l'un des éléments suivants est présent : chemins Windows, PowerShell ou cmd, texte non ASCII, texte chinois, emoji, Markdown, invites, modèles, fichiers de localisation, remplacements exacts, encodage incertain, fichiers sensibles aux CRLF/LF, ou sortie générée qui pourrait être confondue avec du code source.
Dans l'enveloppe :
- Préférez les outils de patch pour les petites modifications.
- Évitez de passer du contenu non ASCII à travers des pipelines shell ou des chaînes PowerShell en ligne.
- Préservez le style de saut de ligne existant, sauf si un formateur possède le fichier.
- Utilisez des API de chemin ou des chemins littéraux entre guillemets pour les scripts.
- Traitez le mojibake de la console comme une simple preuve d'affichage ; inspectez les octets ou les lectures UTF-8 avant de réécrire.
- Ne modifiez pas les dossiers générés, les dossiers de dépendances, les caches, les binaires, les captures d'écran ou les archives, sauf demande explicite de l'utilisateur.
Lisez references/windows-text-safety.md uniquement lorsqu'une tâche présente un risque d'encodage, de saut de ligne, de chemin ou de fragilité shell.
3. Échelle de triage
Avant d'écrire du code personnalisé, arrêtez-vous au premier niveau qui résout proprement la tâche :
- Supprimez le besoin : la demande peut-elle être satisfaite en supprimant, configurant ou documentant un chemin existant ?
- Réutilisez le code du projet : helper, composant, hook, validateur, utilitaire de test, commande, schéma ou modèle établi.
- Utilisez le comportement du langage ou de la bibliothèque standard.
- Utilisez le comportement de la plateforme ou du framework : contrôles navigateur, CSS, contraintes de base de données, routage du framework, validation, mise en cache, sérialisation ou outillage de build.
- Utilisez une dépendance déjà installée.
- Ajoutez une petite implémentation locale.
- Proposez une nouvelle dépendance ou une implémentation plus large uniquement avec une raison claire, les risques et le besoin d'approbation.
N'ajoutez jamais automatiquement une dépendance de production. Si une nouvelle dépendance semble justifiée, expliquez ce qu'elle remplace, pourquoi les options installées ne conviennent pas, le risque de maintenance et la commande d'installation exacte.
Lisez references/reuse-ladder.md uniquement lorsque la décision de dépendance/réutilisation n'est pas évidente.
4. Budget de patch
Avant de modifier, choisissez un petit budget :
- Fichiers prévus pour changer.
- Fichiers intentionnellement laissés intacts.
- Code existant ou fonctionnalité de la plateforme à réutiliser.
- Commande de vérification minimale ou raison pour laquelle aucune commande n'est utile.
Préférez moins de fichiers, moins d'abstractions et des modifications directes proches du comportement. N'ajoutez pas d'interfaces, de fabriques, de couches de service, d'interrupteurs de configuration, de points d'extension futurs ou de wrappers, sauf si la tâche actuelle en a besoin.
5. Règles de patch
- Corrigez le chemin racine une fois au lieu d'ajouter des contournements répétés côté appelant.
- Supprimez le code redondant lorsque le comportement reste correct.
- Gardez le chahut de formatage hors du diff.
- Gardez les commentaires rares ; utilisez un seul commentaire concis uniquement lorsqu'une limite intentionnelle doit être visible plus tard.
- Si un raccourci a un plafond connu, nommez ce plafond et le déclencheur de mise à niveau dans ce commentaire.
- Ne transformez pas une petite fonction en sous-système.
6. Vérification
Exécutez la porte fraîche la plus étroite qui prouve le changement :
- Test existant pour le comportement modifié.
- Test unitaire ciblé ou auto-vérification pour une nouvelle logique non triviale.
- Vérification de syntaxe/type/lint pour les fichiers de langage modifiés lorsque des tests ne sont pas disponibles.
- Révision du diff pour les modifications de documentation ou les changements triviaux d'une ligne.
Les branches non triviales, les analyseurs, les chemins d'argent/sécurité ou les chemins de perte de données nécessitent une vérification exécutable lorsque c'est pratique. Les modifications triviales d'une ligne ne nécessitent pas de nouvel échafaudage de test.
7. Rapport final
Gardez le rapport final court :
Modifié - ...
Triage - code réutilisé/stdlib/platform/dépendance installée/code local/proposition de nouvelle dépendance
Sécurité - risques Windows/texte traités ou non pertinents
Vérifié - commande/résultat ou raison
Risques - limite restante, le cas échéant
Pour le mode audit, renvoyez d'abord les résultats avec des références fichier/ligne lorsque disponibles, puis une liste de suppression/réutilisation et le plus petit écart de vérification.