freeze

Vue d’ensemble de freeze skill

Ce que fait freeze

freeze est un skill de garde-fou qui limite les modifications de fichiers à un seul répertoire pendant la session. Il bloque Edit et Write en dehors du chemin autorisé, ce qui le rend utile quand vous voulez qu’un agent d’automatisation de workflow reste dans un module, un dossier de fonctionnalité ou un sandbox de débogage. Si vous avez besoin du freeze skill pour éviter des changements involontaires à grande échelle, c’est le bon choix.

Qui devrait l’installer

Installez freeze si vous demandez régulièrement à un agent de déboguer, refactorer ou corriger du code dans un périmètre étroit et que vous ne voulez pas qu’il touche “utilement” des fichiers sans rapport. Il est particulièrement intéressant pour les mainteneurs, les relecteurs et toute personne travaillant dans une base de code mêlée ou risquée, où les frontières d’édition comptent plus qu’une large autonomie.

Ce qui le distingue

La vraie différence, c’est l’application de la règle, pas le simple conseil. freeze s’appuie sur un hook pré-outil pour refuser les modifications hors du répertoire choisi, ce qui est bien plus robuste qu’un prompt qui demande seulement au modèle de rester concentré. Cela rend le guide freeze réellement utile pour contenir les actions dans la pratique, surtout lors des sessions où un écart accidentel coûterait cher.

Comment utiliser freeze skill

Installer et initialiser la frontière

Pour freeze install, ajoutez le skill à votre environnement avec le gestionnaire de skills du dépôt, puis choisissez le répertoire à verrouiller. Le flux d’installation du skill est interactif, car le chemin autorisé dépend de la session. En pratique, préparez-vous à répondre précisément à la question : « Quel répertoire doit être gelé ? », avec un chemin exact, pas une zone vague comme « le backend ».

Lire d’abord ces fichiers

Commencez par SKILL.md pour comprendre le flux de contrôle, puis examinez bin/check-freeze.sh pour voir comment la frontière est appliquée. Si vous adaptez le skill, consultez aussi SKILL.md.tmpl pour comprendre la structure générée. Ces fichiers montrent ce que l’usage de freeze autorise réellement, ce qui est bloqué, et où l’analyse des chemins peut échouer ou être plus permissive.

Donner au skill un prompt précis

La meilleure entrée combine une tâche ciblée et une frontière claire. Par exemple : « Geler les modifications dans apps/payments et corriger les tests unitaires en échec là-bas sans toucher aux bibliothèques partagées. » C’est mieux que « débogue cette application », parce que freeze a besoin d’une cible de répertoire et d’une tâche qui tient à l’intérieur. Plus le périmètre est précis, moins l’agent risque de demander des exceptions.

Conseils pratiques de workflow

Utilisez freeze lorsque la première passe doit être chirurgicale : localiser le bug, corriger dans un seul dossier, puis vérifier sans élargir le périmètre. Si la tâche exige vraiment des modifications sur plusieurs répertoires, n’essayez pas de la forcer dans freeze ; élargissez soit le chemin autorisé, soit changez de workflow. Le skill fonctionne mieux quand l’ensemble des changements demandés est naturellement borné et que la structure du dépôt est claire.

FAQ de freeze skill

freeze est-il réservé au débogage ?

Non. Le débogage est un usage courant, mais le freeze skill aide aussi pour des refactorings contraints, l’isolement de fonctionnalités et des modifications sûres pour la revue. La vraie question est de savoir si vous voulez que l’agent reste dans un seul répertoire pendant son travail.

En quoi est-ce différent d’un prompt normal ?

Un prompt normal repose sur le fait que le modèle suit les instructions. freeze ajoute une application réelle via des hooks, donc les modifications hors périmètre sont bloquées même si le modèle tente de les faire. Cela le rend plus fiable pour les tâches d’Automatisation de Workflow où les garde-fous comptent.

freeze est-il adapté aux débutants ?

Oui, si l’utilisateur peut nommer un répertoire avec assurance. L’erreur la plus fréquente chez les débutants est de choisir une frontière trop large ou trop étroite. Si le répertoire est ambigu, la session peut s’enliser pendant que vous clarifiez le périmètre.

Quand ne faut-il pas utiliser freeze ?

Ne l’utilisez pas lorsque la tâche doit traverser plusieurs modules, des configs partagées ou un formatage à l’échelle du dépôt. Dans ces cas-là, la restriction peut ralentir le travail ou provoquer des actions bloquées inutiles. Freeze est surtout pertinent quand la frontière est un vrai choix de cadrage, pas une simple préférence.

Comment améliorer freeze skill

Rendre la frontière explicite

Le plus grand gain de qualité vient du fait de nommer ensemble le répertoire exact et le résultat attendu. Une bonne demande ressemble à : « Geler les modifications dans services/auth et mettre à jour le flux de rafraîchissement des jetons sans toucher à shared/. » Une demande faible comme « corrige l’auth » oblige à deviner et augmente le risque de modifications bloquées ou incomplètes.

Donner les fichiers, les symptômes et les limites

Pour mieux utiliser freeze, indiquez le fichier en échec, le comportement observé et les fichiers interdits. Exemple : « Ne modifie que apps/admin ; le bug est dans src/table.ts ; ne change pas les contrats d’API. » Cela aide l’agent à rester dans la zone gelée tout en résolvant le vrai problème.

Surveiller le décalage de frontière

Le mode d’échec le plus courant, c’est une tâche qui a secrètement besoin d’un périmètre plus large que ce que le répertoire gelé autorise. Si l’agent se heurte sans cesse à des refus d’écriture, la solution consiste généralement à élargir la frontière ou à découper la tâche en plusieurs étapes. Ce n’est pas un bug, c’est un signal : freeze vous indique que le plan et le périmètre ne correspondent pas.

Itérer après la première passe

Après la première sortie, vérifiez si la solution s’appuie sur des hypothèses en dehors du chemin gelé. Si oui, resserrez le prompt en ajoutant une ou deux contraintes concrètes : répertoire cible, types de fichiers autorisés et ce qui doit rester intact. Pour obtenir les meilleurs résultats avec freeze skill, itérez en clarifiant le périmètre, pas en demandant davantage de créativité.