gws-forms

Überblick über gws-forms

Was gws-forms macht

gws-forms ist die Google-Workspace-CLI-Skill für das Lesen und Schreiben von Google Forms über den gws-Befehl. Sie hilft dir, Form-Schemata zu prüfen, leere Formulare anzulegen, Formularinhalte in kontrollierten Schritten zu aktualisieren und formularbezogene Aufgaben ohne Rätselraten bei API-Feldern zu verwalten.

Für wen sich das eignet

Der gws-forms skill ist vor allem für Agenten und Nutzer gedacht, die bereits in einem Google-Workspace-Automatisierungsworkflow arbeiten und verlässliche Forms-API-Ausführung brauchen. Besonders nützlich ist er, wenn du wiederholbare Formularerstellung, Batch-Updates oder programmgesteuerte Inspektion statt manueller Klicks in der Forms-Oberfläche willst.

Warum dieser Skill wichtig ist

Der zentrale Mehrwert von gws-forms for Workflow Automation liegt darin, dass er den echten API-Workflow sichtbar macht, einschließlich Methodenfindung und schema-basierter Eingabekonstruktion. Das ist wichtig, weil Formularerstellung kein Ein-Schritt-Prozess ist: forms.create legt nur ein leeres Formular an, danach fügen forms.update-ähnliche Operationen die Elemente und Einstellungen hinzu.

Wichtige Grenzen

Dieser Skill ist kein generischer „Mach mir ein Formular aus einem Prompt“-Wrapper. Er hängt von der gws-CLI ab, benötigt das gemeinsame Google-Workspace-Auth- und Security-Setup und folgt den Forms-API-Einschränkungen im Repo. Wenn du eher eine breite, konversationelle Entwurfsarbeit als präzise API-Aktionen brauchst, ist ein normaler Prompt oft einfacher.

So verwendest du den gws-forms Skill

Installation und Voraussetzungen

Für gws-forms install verwende die CLI aus den Skill-Metadaten: npx skills add googleworkspace/cli --skill gws-forms. Bevor du Forms-Befehle ausführst, lies wie in der Skill-Datei angegeben ../gws-shared/SKILL.md, denn Auth, globale Flags und Sicherheitsregeln stehen dort. Wenn diese gemeinsame Datei fehlt, führe zuerst gws generate-skills aus.

Beginne mit der Methodenfindung

Das verlässlichste gws-forms usage-Muster lautet: erst prüfen, dann aufrufen. Nutze gws forms --help, um verfügbare Ressourcen und Methoden zu durchsuchen, und führe anschließend gws schema forms.<resource>.<method> aus, um erforderliche Parameter, Typen und Defaults vor dem Aufbau der Flags zu bestätigen. So vermeidest du fehlerhafte Requests und hältst deinen Prompt oder Task an die tatsächliche API-Struktur angepasst.

Eine grobe Zielsetzung in eine umsetzbare Anfrage übersetzen

Ein guter gws-forms guide-Input beschreibt, was du auf API-Ebene brauchst, nicht nur das fachliche Ziel. Statt „mach ein Feedback-Formular“ fragst du zum Beispiel nach Titel, Dokumenttitel, den gewünschten Fragetypen, ob das Formular leer starten soll und ob du Publish-Settings oder response-bezogene Aktionen brauchst. Dadurch bekommt der Skill genug Struktur, um zu entscheiden, ob forms.create, forms.batchUpdate oder eine andere Methode aufgerufen werden soll.

Diese Dateien und Ausgaben zuerst lesen

Beginne mit SKILL.md und prüfe dann die geerbte Parent-Skill-Datei sowie die CLI-Help- und Schema-Ausgabe, auf die sie verweist. In diesem Repo ist der Skill-Body kompakt und es gibt keine Helper-Ordner, daher sind SKILL.md plus gws forms --help und gws schema die wichtigsten Quellen der Wahrheit. Wenn dein Workflow von benachbarten Google-Workspace-Skills abhängt, vergleiche deren Muster, aber nimm nicht an, dass ihre Feldnamen oder ihre Reihenfolge hier ebenfalls gelten.

gws-forms Skill FAQ

Ist gws-forms vor allem zum Erstellen von Formularen gedacht?

Ja, aber nur im API-Sinn. gws-forms unterstützt das Lesen und Schreiben von Formularen, und die Erstellung ist bewusst in Stufen aufgebaut: erst die Hülle anlegen, danach Elemente oder Updates hinzufügen. Wenn du erwartest, dass ein einzelner Prompt direkt ein fertiges Formular mit allen Feldern erzeugt, passt das nicht zum Workflow des Repos.

Brauche ich die gws-CLI, um es zu nutzen?

Ja. Der Skill setzt das gws-Binary ausdrücklich voraus, und die im Skill-File gezeigte Befehlsoberfläche lautet gws forms <resource> <method> [flags]. Wenn deine Umgebung die CLI nicht ausführen oder sich nicht bei Google Workspace authentifizieren kann, lässt sich der Skill nicht wie vorgesehen nutzen.

Ist das besser als ein normaler Prompt?

Für API-Arbeit: ja. Ein normaler Prompt kann ein Formular beschreiben, aber gws-forms skill hilft dabei, die tatsächlichen Resource- und Method-Calls mit schema-gestützten Parametern auszuführen, was Rätselraten und fehlerhafte Requests reduziert. Nutze einen Prompt, wenn du Inhalte erst brainstormen willst; nutze diesen Skill, wenn die Formularaktion wirklich ausgeführt werden soll.

Wann sollte ich ihn nicht verwenden?

Verwende gws-forms nicht, wenn du nur einen schnellen Entwurf für Umfragefragen brauchst, wenn dir Workspace-Anmeldedaten fehlen oder wenn du einen Workflow außerhalb des Forms-API-Scopes brauchst. Er ist auch nicht die richtige Wahl, wenn du die Befehlsprüfung überspringen und dich ausschließlich auf freie natürliche Sprache verlassen willst.

So verbesserst du den gws-forms Skill

Gib dem Skill API-förmige Eingaben

Die besten Ergebnisse kommen von Eingaben, die die Ziel-Resource, die Methode und die gewünschten Felder klar benennen. Nenne den Formtitel, ob sich document_title davon unterscheiden soll, und ob du ein neues Formular, einen Lesezugriff oder ein Update durchführst. Zum Beispiel ist „Erstelle ein Formular mit dem Titel X, lass es leer und füge dann 5 Multiple-Choice-Fragen hinzu“ deutlich stärker als „bau eine Umfrage“.

Halte dich an das Create-then-Update-Verhalten

Ein häufiger Fehler ist, ein vollständiges Formular in einem Schritt zu verlangen, obwohl die API bei der Erstellung nur Teilinformationen zulässt. Das Repo weist darauf hin, dass forms.create nur form.info.title und form.info.document_title übernimmt und Description, Items und Settings bei der Erstellung nicht erlaubt. Verbessere die Ausgabequalität, indem du den zweiten Schritt von Anfang an mitplanst.

Nutze Schema-Ausgaben, um Unklarheiten zu beseitigen

Wenn der erste Versuch fehlschlägt, prüfe gws schema noch einmal auf die exakte Method-Signatur und die Parameternamen und formuliere die Anfrage dann mit genau diesen Feldern neu. Das ist der schnellste Weg, gws-forms usage zu verbessern, weil du Annahmen durch dieselbe Struktur ersetzt, die die CLI erwartet.

Iteriere mit kleineren, enger gefassten Schritten

Wenn eine Formularänderung komplex ist, zerlege sie in kleinere Aktionen: prüfen, erstellen, aktualisieren, verifizieren. Dieser Workflow reduziert Fehler bei Batch-Updates und macht es leichter zu erkennen, ob das Problem an fehlerhaften Eingaben, nicht unterstützten Feldern oder einem Missverhältnis zwischen deiner Absicht und der Forms API liegt.