Mit dem Workflow SDK TypeScript-Funktionen persistent und wiederholbar machen

Für wen

Dieses Skill passt zu Leuten, die in TypeScript oder JavaScript „persistente“ Funktionen schreiben wollen: der offizielle Text sagt, es speichert den Workflow-Fortschritt, wiederholt fehlgeschlagene Schritte und liefert eingebaute Beobachtbarkeit. Es passt auch zu Leuten, die Next.js schon nutzen und die offizielle Hülle in die Konfiguration einhängen wollen.

Es passt nicht zu Leuten, die einen Workflow nur direkt im Browser starten wollen. Der Ursprungstext begrenzt den Startort auf API-Routen, Server Actions oder anderen Servercode. Kannst du npm noch nicht ausführen oder eine lokale Paketinstallation nicht akzeptieren, beim Lesen der Anleitung stehen bleiben.

Nach der Paketinstallation kann ein Coding-Agent versionspassende Leitfäden aus node_modules/workflow/docs lesen. Das offizielle Repository ist

https://github.com/vercel/workflow

Die auf dieser Seite bereits geschriebenen Befehle befolgen.

Ersten Versuch in 3 Minuten abschließen

Nur den einen Installationsweg gehen, den der offizielle Text schreibt.

Voraussetzung: dieser Rechner kann npm ausführen, und das aktuelle Verzeichnis ist ein Projekt, das Abhängigkeiten schreiben darf. Zuerst bestätigen: npm install workflow ändert die Abhängigkeitliste und lädt ein Paket. Willst du dieses Projekt noch nicht ändern, nicht ausführen.

Installationsort: im Projektwurzelverzeichnis ein Terminal öffnen, die genannten Nebenwirkungen bestätigen, dann ausführen:

npm install workflow

Risikoarme Aufgabe: nach der Paketinstallation nicht sofort in einer Live-Route einen Workflow starten. Zuerst den Coding-Agenten node_modules/workflow/docs schreibgeschützt öffnen lassen, prüfen, ob ein lokaler Leitfaden zur aktuellen Version sichtbar ist, und den Import finden, den Next.js nutzen soll. Keine Dateien schreiben und keine Anfragen nach außen senden.

Erfolgssignal: das Paket workflow erscheint in den Projektabhängigkeiten, node_modules/workflow/docs lässt sich lokal öffnen, und der Agent kann auf den offiziellen Import import { withWorkflow } from 'workflow/next' zeigen. Erfindet der Agent einen anderen Installationsbefehl, zum offiziellen Befehl oben zurück und erneut versuchen.

Anwendungsfälle

Fall 1: Einem Next.js-Projekt die offizielle Hülle anschließen. Der Import im Ursprungstext ist import { withWorkflow } from 'workflow/next'. Das passt zu Leuten, die schon ein Next.js-Projekt haben und zuerst den Konfigurationseinstieg prüfen wollen. Zuerst den Agenten die zu ändernde Konfigurationsdatei schreibgeschützt markieren lassen, dann nach Bestätigung schreiben. Expandiert der Ursprungstext kein vollständiges Konfigurationsobjekt, bei „diesen Import nutzen“ stehen bleiben; keine nie genannten Optionen ergänzen.

Fall 2: Einen persistenten Workflow vom Server starten. Der Ursprungstext sagt, danach könne man einen Workflow von einer API-Route, einer Server Action oder anderem Servercode starten. Das passt zu Leuten, die das Paket schon installiert haben und einen Server-Einstieg besitzen. Beim ersten Mal den Agenten zeigen lassen, von welchem vorhandenen Server-Einstieg gestartet wird; keinen unerklärten Client-Einstieg anlegen. Fortschritt wird persistiert, fehlgeschlagene Schritte werden wiederholt; Wiederholungszahl und das Öffnen eines Beobachtungspanels stehen nicht — nichts ergänzen.

Nutzungsgrenzen

Nur ein offizieller Installationsbefehl steht im Ursprungstext: npm install workflow. Keinen nie genannten Installer auf den Hauptweg schreiben. Die Fähigkeiten decken Persistenz, Wiederholung fehlgeschlagener Schritte und eingebaute Beobachtbarkeit für TypeScript- und JavaScript-Funktionen ab; sie beweisen keine Nutzung in anderen Sprachen.

Der Startort ist nur als API-Routen, Server Actions oder anderer Servercode geschrieben. Nicht direkt aus dem Browser oder einem ungenannten Client starten. Der lokale Dokumentationspfad ist node_modules/workflow/docs, damit ein Coding-Agent versionspassende Leitfäden liest; es gibt keine Client-Liste, also nicht als Exklusivfunktion weniger Assistenten schreiben.

Geheimnisse, Queue-Backends und Produktions-Beobachtungskonten sind nicht ausgeführt. Die offizielle Seite ist

https://github.com/vercel/workflow

Weicht ein vom Agenten vorgeschlagener Befehl von dieser Seite ab, gilt diese Seite.