gws-drive

Présentation de gws-drive

Ce que fait gws-drive

gws-drive est le skill Google Drive pour Google Workspace CLI. Il vous aide à gérer des fichiers, des dossiers, des lecteurs partagés et les workflows associés à l’API Drive depuis la ligne de commande, avec les নির্দেশications spécifiques au skill nécessaires pour éviter d’avoir à deviner les noms de ressources, les champs obligatoires et les contraintes de permissions.

À qui il s’adresse

Utilisez le skill gws-drive si vous travaillez en Backend Development, en automatisation ou en ops, et que vous avez besoin d’actions Drive répétables dans des scripts ou des workflows d’agent. Il est particulièrement utile quand vous voulez un processus piloté par CLI pour les tâches Drive plutôt qu’une requête ponctuelle, surtout pour les envois de fichiers, les opérations tenant compte des métadonnées et les requêtes pilotées par l’API.

Ce qu’il faut savoir avant l’installation

La vraie valeur de gws-drive n’est pas sa largeur fonctionnelle, mais sa fiabilité : il oriente l’agent vers les bonnes ressources Drive et la bonne structure de requête. Le principal frein à l’adoption reste l’authentification et la configuration partagée, car le skill dépend de l’environnement plus large gws ainsi que des instructions partagées gws-shared pour les flags et les règles de sécurité.

Comment utiliser le skill gws-drive

Installation et vérification des prérequis

Installez le skill gws-drive dans le contexte Google Workspace CLI, puis vérifiez d’abord le prérequis partagé : ../gws-shared/SKILL.md. Les métadonnées du skill supposent aussi que le binaire gws est disponible, donc assurez-vous que la CLI fonctionne avant de lancer un workflow Drive. Une bonne façon de procéder consiste à exécuter gws drive --help après l’installation, puis à le comparer à la liste des ressources du skill.

Partir de la bonne forme d’entrée

Le schéma d’utilisation de gws-drive est gws drive <resource> <method> [flags], donc votre prompt doit nommer la ressource cible, l’action, et les contraintes exactes de sortie. Une bonne entrée ressemble à ceci : « Liste les lecteurs partagés auxquels j’ai accès, retourne uniquement le nom et l’id, et exclue les éléments dans la corbeille. » Une mauvaise entrée ressemble à : « Vérifie Drive. » Si vous utilisez le guide gws-drive pour le Backend Development, indiquez d’emblée les identifiants, les dossiers parents et toutes les hypothèses de permission ou de scope.

Lire ces fichiers en premier

Commencez par SKILL.md, puis inspectez ../gws-shared/SKILL.md, car il encadre l’authentification, les flags globaux et le comportement de sécurité. Dans cette portion du repo, il n’y a ni scripts d’aide ni dossiers de support sur lesquels s’appuyer, donc le fichier du skill est la principale source de vérité. Accordez une attention particulière aux sections sur les ressources API et à la commande d’aide +upload, car elles montrent le workflow prévu au lieu de vous laisser l’inférer à partir d’une documentation Drive générique.

Workflow qui donne de meilleurs résultats

Adoptez un flux en trois étapes : définir la ressource, préciser la méthode, puis n’ajouter que les flags qui influencent la réponse de l’API. Par exemple, une demande pour récupérer les informations du compte Drive doit mentionner que l’appel about.get exige fields, tandis que les opérations d’envoi doivent passer par la commande d’aide si vous voulez des métadonnées automatiques. C’est la discipline d’utilisation centrale de gws-drive : demander la réponse la plus petite utile, pas la plus large possible.

FAQ sur le skill gws-drive

gws-drive sert-il seulement aux bases de Drive ?

Non. gws-drive couvre les ressources Drive principales ainsi que des comportements API précis qui comptent en automatisation, comme l’obligation de fields pour about.get et la gestion des propositions d’accès avec des contraintes réservées aux approbateurs. Il est donc plus adapté qu’un prompt générique lorsque votre tâche dépend de la forme exacte de l’API plutôt que d’une simple explication générale de Drive.

Quand ne faut-il pas utiliser ce skill ?

Évitez le skill gws-drive si vous n’avez besoin que d’un conseil manuel et ponctuel sur Drive, ou si vous n’avez pas encore en place la CLI gws et la configuration d’authentification partagée. Il est aussi mal adapté lorsque votre tâche sort complètement du périmètre des opérations Drive, car le skill est optimisé pour la construction de requêtes et l’exécution CLI, pas pour des conseils généraux sur Workspace.

Est-il adapté aux débutants ?

Oui, à condition de pouvoir décrire un objectif Drive concret. Le skill réduit les approximations en montrant le schéma ressource-méthode et les principaux pièges, mais les débutants doivent quand même fournir un fichier, un dossier, un lecteur partagé ou un scénario de permission ciblé. Sans cela, l’agent risque de produire une commande vague ou de choisir un appel API trop large.

Quelle est la plus grande différence avec un prompt classique ?

Un prompt classique peut expliquer les concepts Drive ; gws-drive vous donne un workflow ancré dans la vraie CLI et les vraies ressources API. Cela compte lorsque vous avez besoin d’une commande déterministe, d’une sélection de champs valide ou d’une opération sensible aux permissions qui ne doit pas échouer dès la première exécution.

Comment améliorer le skill gws-drive

Donner à l’agent un contexte Drive exact

Les meilleurs résultats viennent d’une ressource, d’une action et d’un périmètre formulés dans une seule phrase. Exemple : « Utilise gws-drive pour lister les fichiers du dossier abc123, retourne id, name, mimeType et modifiedTime, et n’inclus pas les éléments supprimés. » C’est bien plus solide que de demander à « trouver des documents », parce que cela réduit l’ambiguïté de recherche et évite un excès de sortie API inutile.

Indiquer les contraintes qui changent l’appel API

Précisez si vous avez besoin de lecteurs partagés, d’un dossier spécifique, d’une proposition d’accès ou d’informations au niveau du compte. Pour gws-drive, ces détails comptent, car les ressources n’ont pas toutes les mêmes permissions ni les mêmes exigences de réponse. Si vous les omettez, la première sortie échoue souvent à cause d’un fields manquant, d’un accès d’approbateur absent ou d’une requête trop large.

Itérer de la commande vers le résultat

Si la première sortie est trop large, resserrez la demande en supprimant la sortie optionnelle et en ajoutant les identifiants exacts qui vous importent. Si elle échoue, vérifiez si le problème vient de l’authentification, d’un prérequis manquant dans gws-shared ou d’une paire ressource-méthode incorrecte. Le workflow le plus rapide avec gws-drive consiste à corriger la forme de la commande avant de modifier la tâche elle-même.