Comment dompter les agents IA avec le Skills Toolkit de Matt Pocock

Quand les développeurs commencent à travailler étroitement avec Claude Code ou Codex, ils se heurtent rapidement au même problème. L'agent accepte joyeusement la tâche, part écrire du code pendant cinq minutes, et revient avec cinq cents lignes de spaghetti cassé. Ça vous parle ? Matt Pocock, l'auteur de Total TypeScript, a décidé de s'attaquer à ce problème avec de la discipline d'ingénierie et a constitué un dépôt d'instructions pratiques (skills) pour les agents IA. Et le projet vinvcn/mattpocock-skills-zh-CN a adapté l'ensemble de cette boîte à outils pour travailler avec les modèles de langage chinois et les contextes mixtes.

Il ne s'agit pas de discussions abstraites sur l'avenir du développement. C'est un ensemble de commandes et de scénarios concrets qui font que le modèle de langage se comporte comme un développeur intermédiaire ou senior ordonné, plutôt que comme un générateur de fonctions aléatoire.

Quatre scénarios où les agents échouent généralement

Matt a identifié les pièges typiques sur lesquels les développeurs trébuchent lorsqu'ils délèguent des tâches à l'IA, et a rédigé un protocole de travail séparé pour chaque cas.

L'agent fait quelque chose de complètement différent de ce qui était demandé

Le mal de tête de développement le plus courant s'appelle le désalignement des attentes. Une personne pense à une architecture, le modèle complète les détails selon ses propres goûts. Pour combler ce fossé, l'auteur a créé la commande /grill-me (et sa variante d'ingénierie /grill-with-docs).

Avant de toucher au code, l'agent mène un interrogatoire formel. Il pose une série de questions ciblées sur les cas limites, la structure de données et les exigences d'interface. Le modèle n'écrira pas une seule ligne tant que l'arbre de décision ne converge pas. Cela fait gagner des heures de réécriture de code.

Le modèle gaspille le contexte en bavardages inutiles

Quand un agent entre dans un projet inconnu, il commence à inventer sa propre terminologie et dépense des dizaines de jetons pour expliquer des choses évidentes. La solution réside dans la création d'un document avec un vocabulaire de domaine unifié (dans le projet, il s'appelle CONTEXT.md).

La commande /grill-with-docs ne se contente pas de vous sonder, mais enregistre immédiatement la terminologie du projet et les décisions architecturales (ADR). Une fois que vous et l'agent partagez un langage commun, le dialogue se réduit considérablement, et les variables dans le code commencent à être nommées de la même manière dans tous les modules.

Le code généré ne s'exécute pas

Quand un modèle écrit du code sans retour d'information, il travaille à l'aveugle. Il a besoin de tests. Le skill /tdd force l'agent à suivre strictement le cycle red-green-refactor. D'abord le modèle écrit un test unitaire qui échoue, puis implémente exactement autant de code que nécessaire pour faire passer le test, et seulement ensuite nettoie.

Pour les bugs complexes, il existe un scénario /diagnosing-bugs séparé. Il guide le modèle à travers un protocole strict : reproduire l'erreur avec un test, réduire la zone de recherche, formuler une hypothèse, ajouter de la journalisation, corriger le code et exécuter un test de régression.

L'architecture se transforme en gâchis

La vitesse de génération de code alimente la croissance de l'entropie. Pour empêcher le projet de devenir une boule de spaghetti emmêlée, la commande /improve-codebase-architecture est utilisée.

Elle scanne le projet, recherche des candidats pour des modules profonds (avec des interfaces publiques simples et une logique complexe cachée) et génère un rapport. En essence, c'est un audit régulier de qualité de code directement dans le terminal.

Pourquoi localiser en chinois

Le dépôt d'origine est écrit en anglais, mais la localisation de vinvcn a un objectif technique intéressant. Il ne s'agit pas seulement de commodité pour les développeurs chinois.

Quand on travaille avec des LLM asiatiques comme Qwen ou DeepSeek, les invites système chinoises et les instructions réduisent la perte de contexte. Le modèle est moins perturbé par les nuances de formulation. Pendant ce temps, tous les identifiants, noms de commandes, chemins de fichiers et clés de configuration restent en anglais. Rien ne se casse lors de l'exécution des scripts.

Comment fonctionne l'architecture des skills

Tous les skills du dépôt se divisent en deux catégories :

1. Commandes déclenchées par l'utilisateur. Seul un humain les déclenche manuellement via un slash. Par exemple, /ask-matt aide à sélectionner le bon skill pour la tâche en cours, /to-spec compile la discussion en ticket, et /wayfinder planifie une fonctionnalité majeure sur plusieurs sessions.
2. Skills déclenchés par le modèle. L'utilisateur et l'agent peuvent tous deux les déclencher de leur propre initiative lorsqu'ils voient une sous-tâche appropriée. Il s'agit notamment du cycle TDD, de la résolution de conflits git sans abandons brutaux, de la revue de code et de la rédaction.

Les skills sont écrits sous forme de simples fichiers Markdown avec des instructions. Ils sont faciles à lire et peuvent être modifiés pour correspondre aux règles de votre équipe.

Installation en quelques minutes

Vous pouvez ajouter des skills à votre projet en utilisant l'installateur skills.sh :

npx skills@latest add vinvcn/mattpocock-skills-zh-CN

L'utilitaire vous demandera quels skills vous voulez copier et dans quels répertoires d'agent les enregistrer. Assurez-vous de sélectionner /setup-matt-pocock-skills.

Après l'installation, exécutez la configuration initiale directement dans le dialogue de l'agent :

/setup-matt-pocock-skills

L'agent clarifiera où vous suivez les tâches (GitHub Issues, Linear ou fichiers locaux), quelles étiquettes vous utilisez pour le tri et dans quel dossier stocker la documentation architecturale.

Si vous travaillez avec Claude Code et ne voulez pas stocker de copies de fichiers dans chaque dépôt, vous pouvez connecter les skills comme un plugin :

claude plugin marketplace add vinvcn/mattpocock-skills-zh-CN
claude plugin install mattpocock-skills@mattpocock

Dans ce mode, les skills se mettront à jour de manière centralisée lorsque de nouvelles versions seront publiées.

À qui cela s'adresse

Deux catégories d'ingénieurs devraient examiner ce dépôt.

Premièrement, ceux qui utilisent activement Claude Code, Codex ou OpenCodeInterpreter et qui sont fatigués de lutter contre les hallucinations du modèle. L'approche de Matt Pocock ramène la prévisibilité au développement grâce à des contraintes strictes et des boucles de rétroaction courtes.

Deuxièmement, c'est un excellent exemple de comment écrire des instructions système pour les assistants IA. Même si vous n'avez pas besoin de la traduction chinoise, la structure des fichiers dans ce dépôt offre une leçon claire sur la conception de skills pour les agents. Essayez d'incorporer quelques commandes comme /grill-me dans votre flux de travail quotidien, et vous remarquerez la différence dès le soir même.