gws-forms

Vue d’ensemble de gws-forms

Ce que fait gws-forms

gws-forms est le skill Google Workspace CLI pour lire et écrire des Google Forms via la commande gws. Il aide à inspecter les schémas de formulaires, créer des formulaires vides, mettre à jour le contenu d’un formulaire par étapes contrôlées et gérer les opérations liées aux formulaires sans avoir à deviner les champs de l’API.

À qui s’adresse ce skill

Le gws-forms skill convient surtout aux agents et aux utilisateurs qui travaillent déjà dans un flux d’automatisation Google Workspace et ont besoin d’exécutions fiables de l’API Forms. Il est particulièrement utile lorsque vous voulez créer des formulaires de façon répétable, appliquer des mises à jour par lots ou inspecter un formulaire par programme plutôt que cliquer manuellement dans l’interface Forms.

Pourquoi ce skill est important

La valeur principale de gws-forms for Workflow Automation est qu’il expose le vrai flux de travail de l’API, y compris la découverte des méthodes et la construction des entrées à partir du schéma. C’est important parce que la création d’un formulaire ne se fait pas en une seule étape : forms.create ne crée qu’un formulaire vide, puis des opérations de type forms.update ajoutent les éléments et les paramètres.

Principales limites à connaître

Ce skill n’est pas un wrapper générique du type « crée un formulaire à partir d’un prompt ». Il dépend du CLI gws, requiert la configuration d’authentification et de sécurité partagée Google Workspace, et suit les contraintes de l’API Forms décrites dans le dépôt. Si vous avez surtout besoin d’une rédaction conversationnelle large plutôt que d’actions API précises, un simple prompt peut être plus adapté.

Comment utiliser le skill gws-forms

Installer le skill et préparer les prérequis

Pour gws-forms install, utilisez la commande CLI indiquée dans les métadonnées du skill : npx skills add googleworkspace/cli --skill gws-forms. Avant d’exécuter des commandes Forms, lisez ../gws-shared/SKILL.md comme indiqué dans le fichier du skill, car l’authentification, les flags globaux et les règles de sécurité s’y trouvent. Si ce fichier partagé est absent, lancez d’abord gws generate-skills.

Commencer par découvrir la méthode

Le schéma d’usage le plus fiable pour gws-forms usage est le suivant : inspecter d’abord, appeler ensuite. Utilisez gws forms --help pour parcourir les ressources et méthodes disponibles, puis exécutez gws schema forms.<resource>.<method> pour confirmer les paramètres requis, les types et les valeurs par défaut avant de construire les flags. Cela évite les requêtes mal formées et permet de garder votre prompt ou votre tâche aligné sur la structure réelle de l’API.

Transformer un objectif vague en requête exploitable

Une bonne entrée pour gws-forms guide décrit ce que vous voulez au niveau de l’API, pas seulement l’objectif métier. Par exemple, au lieu de dire « fais un formulaire de feedback », demandez un titre, un titre de document, les types de questions visés, si le formulaire doit commencer vide, et si vous avez besoin de paramètres de publication ou d’actions liées aux réponses. Cela donne au skill suffisamment de structure pour décider s’il doit appeler forms.create, forms.batchUpdate ou une autre méthode.

Lire d’abord ces fichiers et sorties

Commencez par SKILL.md, puis consultez le fichier du skill parent partagé et les sorties d’aide et de schéma du CLI vers lesquelles il renvoie. Dans ce dépôt, le corps du skill est compact et il n’y a pas de dossiers d’assistance, donc SKILL.md, gws forms --help et gws schema sont les principales sources de vérité. Si votre flux de travail s’appuie sur des skills Google Workspace voisins, comparez leurs modèles, mais ne supposez pas que leurs noms de champs ou leur séquencement s’appliquent ici.

FAQ sur le skill gws-forms

gws-forms sert-il surtout à créer des formulaires ?

Oui, mais uniquement au sens API. gws-forms prend en charge la lecture et l’écriture des formulaires, et la création est volontairement étagée : on crée d’abord la structure, puis on ajoute les éléments ou les mises à jour ensuite. Si vous vous attendez à ce qu’un seul prompt génère un formulaire final avec tous les champs remplis, cela ne correspond pas au workflow du dépôt.

Faut-il le CLI gws pour l’utiliser ?

Oui. Le skill exige explicitement le binaire gws, et la surface de commande indiquée dans le fichier du skill est gws forms <resource> <method> [flags]. Si votre environnement ne peut pas exécuter le CLI ni s’authentifier auprès de Google Workspace, le skill ne pourra pas être utilisé comme prévu.

Est-ce mieux qu’un prompt classique ?

Pour le travail API, oui. Un prompt classique peut décrire un formulaire, mais gws-forms skill aide à exécuter les appels réels aux ressources et aux méthodes avec des paramètres validés par le schéma, ce qui réduit les approximations et les requêtes cassées. Utilisez un prompt pour réfléchir au contenu ; utilisez ce skill quand vous avez besoin que l’action sur le formulaire soit réellement effectuée.

Quand ne faut-il pas l’utiliser ?

N’utilisez pas gws-forms si vous avez seulement besoin d’un brouillon rapide de questions de sondage, si vous n’avez pas les identifiants Workspace, ou si vous avez besoin d’un workflow hors du périmètre de l’API Forms. Ce n’est pas non plus le bon choix si vous voulez éviter l’inspection des commandes et vous reposer uniquement sur du langage naturel libre.

Comment améliorer le skill gws-forms

Donner au skill des entrées structurées comme l’API

Les meilleurs résultats viennent d’entrées qui précisent la ressource cible, la méthode et les champs souhaités. Incluez le titre du formulaire, indiquez si document_title doit être différent, et précisez si vous créez un nouveau formulaire, si vous le lisez ou si vous le mettez à jour. Par exemple, « Crée un formulaire intitulé X, laisse-le vide, puis ajoute 5 questions à choix multiples » est bien plus efficace que « construis un sondage ».

Respecter le comportement création puis mise à jour

Une erreur fréquente consiste à demander un formulaire complet en une seule étape alors que l’API n’autorise qu’une partie des données au moment de la création. Le dépôt indique que forms.create ne copie que form.info.title et form.info.document_title, et interdit la description, les éléments et les paramètres lors de la création. Améliorez la qualité du résultat en prévoyant dès le départ l’étape suivante.

S’appuyer sur la sortie du schéma pour lever l’ambiguïté

Si la première tentative échoue, revérifiez gws schema pour obtenir la signature exacte de la méthode et les noms précis des paramètres, puis réécrivez la requête avec ces champs. C’est la manière la plus rapide d’améliorer gws-forms usage, car vous remplacez les hypothèses par la structure attendue par le CLI.

Itérer avec des opérations plus ciblées

Quand une modification de formulaire est complexe, découpez-la en actions plus petites : inspecter, créer, mettre à jour, vérifier. Ce flux réduit les erreurs dans les mises à jour par lots et permet de voir plus facilement si le problème vient d’une mauvaise entrée, de champs non pris en charge ou d’un décalage entre votre intention et l’API Forms.