在 `node_modules` 尚未存在 Vercel Workflow SDK 時進行安裝與設定。當使用者要求為 Next.js、Express、Hono、Fastify、NestJS、Nitro、Nuxt、Astro、SvelteKit 或 Vite「安裝 workflow」、「設定 workflow」、「新增 durable workflows」、「設定 workflow sdk」或「初始化 workflow」時使用。
workflow-init
在尚未安裝 workflow 之前完成 Vercel Workflow SDK 的初始設定。為使用者所使用的框架取得官方入門指南。
決策流程
0) 基本檢查
讀取 package.json。若 workflow 已在相依套件中,請提醒使用者改用 /workflow(其會讀取 node_modules/workflow/docs/ 中的版本化說明文件)。僅在缺少 workflow 時才繼續執行。
1) 確認框架
非互動式: 若使用者在提示詞中直接指定了框架,請直接使用該框架。
自動偵測: 檢查 package.json 的相依套件與設定檔,使用第一個符合的項目:
- Next.js -
next相依套件或next.config.* - Nuxt -
nuxt相依套件或nuxt.config.* - SvelteKit -
@sveltejs/kit相依套件或svelte.config.* - Astro -
astro相依套件或astro.config.* - NestJS -
@nestjs/core相依套件或nest-cli.json - Nitro -
nitro相依套件或nitro.config.* - Express -
express相依套件 - Fastify -
fastify相依套件 - Hono -
hono相依套件 - Vite -
vite相依套件(且未符合上述任何項目)
若完全無符合項目或有多個符合項目,請提示使用者進行選擇。
2) 擷取並遵循入門指南
擷取恰好一個下列 URL,並循序執行指南中的步驟:
每份指南皆涵蓋:安裝相依套件、設定框架、建立第一個工作流程(workflow)、建立路由處理程式(route handler)、執行並驗證。
3) 驗證設定
- 依據指南啟動開發伺服器。
- 使用指南提供的
curl命令觸發範例端點。 - 確認日誌(logs)顯示工作流程與步驟執行。
- 可選:執行
npx workflow web或npx workflow inspect runs。
4) 尚未建立框架?
若專案中尚無任何框架,詢問使用者的需求:
- Web 應用程式:Next.js / Nuxt / SvelteKit / Astro
- API 伺服器:Express / Fastify / Hono
- 極簡伺服器:Nitro 或 Vite
接著遵循所選指南中的「建立您的專案(Create Your Project)」章節。
概念性問題(安裝前)
若使用者在安裝前詢問概念性問題,請擷取以下內容:
交接
當設定完成時,告知使用者:後續開發請使用 /workflow —— 它會讀取打包在 node_modules/workflow/docs/ 中的版本化文件。






