Skills

d3k : laisser un assistant prendre la chronologie de débogage Web locale

Pour qui veut qu’un assistant débogue depuis une seule chronologie locale ; il faut Node.js 24+, puis installer la skill d3k et le runtime global. N’ouvrez pas un second serveur ou navigateur.

Official source · d3k

Install

bunx skills add vercel-labs/dev3000 --skill d3k --agent '*' -g -y

À qui ça s’adresse

d3k s’adresse à qui débogue une application Web en local et veut qu’un assistant de code voie la chronologie complète. Il démarre votre serveur de développement, ouvre un navigateur surveillé avec une configuration Chrome stable pour le projet, et rassemble journaux serveur, erreurs navigateur, activité réseau, interactions et captures en une seule chronologie.

L’interface principale est la skill d3k : dites à l’assistant ce que vous voulez tester ou inspecter, et laissez-le prendre le runtime. Ce n’est pas un script générique « ouvrir un autre navigateur », ni le cas où vous lancez vous-même un autre serveur de développement et demandez à l’assistant de deviner les journaux.

Il faut Node.js 24 ou plus récent. L’installation de la skill et celle du runtime sont deux commandes ; ne les fusionnez pas. Sans prise en charge des skills, n’appliquez pas la commande d’installation de skill.

Premier essai en 3 minutes

La commande officielle de skill est bunx skills add vercel-labs/dev3000 --skill d3k --agent '*' -g -y. Le dépôt est https://github.com/vercel-labs/dev3000 Suivez uniquement cette page. La commande officielle de runtime est bun install -g dev3000. La documentation dit aussi que npm install -g dev3000 fonctionne, mais le chemin principal suit bun ; n’inventez pas un troisième installateur.

Prérequis : cette machine a Node.js ≥ 24, un projet Web démarrable en local, et vous acceptez que l’assistant lance un navigateur surveillé. La skill s’installe côté assistant (la commande contient -g) ; le runtime s’installe comme paquet global dev3000. Après installation, confirmez d’abord que l’assistant peut parler de d3k, puis décidez de démarrer.

Première tâche à faible risque : utilisez une application locale jetable. Dites clairement à l’assistant : démarrer d3k de façon non interactive, garder le processus en arrière-plan, réutiliser le navigateur qu’il gère, ne consulter que les preuves unifiées. Avant de démarrer, confirmez le port et le répertoire du projet ; ne visez pas la production. Signal de succès : une chronologie horodatée apparaît (journaux, erreurs, réseau ou captures), et l’assistant n’a pas ouvert à part un autre serveur de développement ni un autre navigateur.

Si vous voulez seulement confirmer l’installation, demandez d’abord « comment démarrer d3k de façon non interactive » et n’approuvez qu’après avoir vu la commande prévue. La documentation n’écrit ni numéro de port par défaut ni arrêt du processus ; au premier essai, demandez l’arrêt avant de démarrer.

Cas d’usage

Cas 1 : confier le débogage à la skill d3k. Après installation, décrivez le problème de page à reproduire et laissez l’assistant posséder le runtime. Cela convient quand vous pouvez déjà dire en une phrase quelle page, quelle action, quelle erreur. Il n’y a pas de commande slash fixe ; le langage naturel suffit. Si l’assistant lance lui-même npm run dev et ouvre le navigateur système, exigez le passage à d3k. La page de comparaison est https://github.com/vercel-labs/dev3000

Cas 2 : une fois le runtime global en place, laisser l’assistant démarrer de façon non interactive et ne lire que la chronologie. La skill enseigne : démarrage non interactif, conservation du processus en arrière-plan, réutilisation du navigateur hébergé, examen des preuves unifiées — pas un autre serveur ou navigateur. Cela convient pour régresser une interaction connue quand réseau et captures sont nécessaires ensemble. La documentation ne liste ni chemin de fichier de chronologie ni adresse d’UI ; vous ne pouvez aller que jusqu’à « après démarrage, voir les preuves dans l’entrée donnée par l’assistant ». Tant que la chronologie unifiée n’est pas visible, n’ouvrez pas un second moniteur en même temps.

Limites d’usage

Limite de version : Node.js 24 ou plus récent. Limite d’installation : la skill utilise bunx skills add vercel-labs/dev3000 --skill d3k --agent '*' -g -y ; le runtime utilise bun install -g dev3000 (npm aussi). Sans skills, n’appliquez pas la première. Limite d’usage : l’interface principale est de dire l’objectif à l’assistant et de lui laisser le runtime ; réutilisez le navigateur hébergé et la chronologie unifiée, n’ouvrez pas un autre serveur ou navigateur. Limite de portée : serveur de développement local, navigateur surveillé, journaux, erreurs, réseau, interactions, captures ; pas d’environnement distant ni de sondage de production. L’arrêt et le port ne sont pas détaillés ; demandez clairement au premier essai avant de démarrer.