vgpu : interroger la doc WebGPU de la version du projet, puis écrire des shaders

À qui ça s’adresse

vgpu s’adresse à qui écrit du WebGPU en TypeScript : imports de shaders typés, petite API orientée GPU, et le même code peut tourner dans le navigateur, Node sans tête et les tests. Le dépôt précise aussi : un assistant avec prise en charge des skills peut installer un routeur de documentation très mince, qui interroge la doc livrée avec « la version de vgpu déjà installée dans le projet courant ».

Usage plus proche : vous avez déjà, ou allez avoir, un projet TypeScript. Installez d’abord le paquet via Quick Start, puis laissez l’assistant interroger seulement la doc, ou utilisez la CLI pour des contrôles en lecture seule. Ce n’est pas un manuel d’API autonome et indépendant de la version — la skill elle-même ne contient pas de référence d’API versionnée.

Ne fusionnez pas les deux entrées. Les dépendances du projet passent par pnpm add vgpu. La skill d’assistant passe par npx skills add vercel-labs/vgpu. Sans prise en charge des skills, n’appliquez pas la seconde commande.

Premier essai en 3 minutes

Si l’assistant actuel prend en charge les skills, la commande officielle est npx skills add vercel-labs/vgpu. Le dépôt est https://github.com/vercel-labs/vgpu Suivez uniquement cette page. La skill s’installe dans le répertoire de skills de l’assistant ; elle ne remplace pas la dépendance du projet.

Prérequis : le projet devrait déjà avoir vgpu, car la skill interroge la doc bundlée avec cette version. S’il n’y a pas encore de paquet, exécutez d’abord Quick Start dans un projet jetable : pnpm add vgpu et pnpm add -D @webgpu/types. N’inventez pas un installateur non documenté.

Première tâche à faible risque : n’écrivez pas d’abord une scène formelle qui envoie du travail au GPU. Après le paquet, exécutez npx vgpu check pour valider les shaders, ou npx vgpu docs pour ouvrir la doc en lecture seule. Signal de succès : la CLI se termine et donne un résultat de contrôle ou de doc, pas que votre code métier a été réécrit. npx vgpu examples ouvre la galerie d’exemples ; la première fois, regardez seulement, sans modifier.

Chemin skill : après installation, posez à l’assistant une question en lecture seule sur l’usage de vgpu dans ce projet. Signal de succès : la réponse correspond au paquet que vous venez d’installer, pas à un manuel générique sans lien avec le projet. La documentation n’écrit pas de nom de commande slash pour la skill ; une question en langage naturel suffit.

Cas d’usage

Cas 1 : installer le routeur de documentation pour un assistant qui prend en charge les skills. La commande est npx skills add vercel-labs/vgpu. La skill est mince, sans référence d’API versionnée, et interroge la doc livrée avec le vgpu déjà installé. Cela convient quand vous changez une version précise et craignez que le manuel ne corresponde pas au code. S’il n’y a pas encore vgpu, installez via Quick Start puis posez la question. La documentation n’écrit ni miroir hors ligne ni adresse fixe de site de doc ; vgpu.sh publie agents.md et llms.txt pour les modèles, sans détailler les étapes de publication.

Cas 2 : développer avec la même API sur plusieurs runtimes et valider avec la CLI. L’API publique couvre le navigateur, Node sans tête (vgpu/node, backend Dawn) et un mock déterministe pour tests et CI (vgpu/mock). Au quotidien : npx vgpu docs, npx vgpu examples, npx vgpu check. Cela convient pour valider les shaders avant commit, ou lancer des tests en CI avec le mock. La documentation n’écrit ni le détail d’installation de Dawn ni un modèle CI ; tant que WebGPU/Dawn n’est pas prêt sur cette machine, ne supposez pas qu’un exemple navigateur passera en environnement sans tête. Si une commande échoue, revenez à https://github.com/vercel-labs/vgpu et comparez.

Limites d’usage

Limite d’installation : le projet utilise pnpm add vgpu et @webgpu/types ; l’assistant utilise npx skills add vercel-labs/vgpu. Sans skills, n’appliquez pas la seconde. Limite de skill : routage de documentation seulement, pas de référence d’API versionnée ; la cible est la version déjà installée. Limite de runtime : navigateur, vgpu/node et vgpu/mock partagent l’API publique ; la documentation ne promet pas un comportement identique de tous les exemples dans les trois environnements. Limite CLI : on peut vérifier docs, examples, check. Seul pnpm est écrit comme gestionnaire ; n’utilisez pas un installateur non consigné.