workflow-init

workflow-init

熱門

在 `node_modules` 尚未存在 Vercel Workflow SDK 時進行安裝與設定。當使用者要求為 Next.js、Express、Hono、Fastify、NestJS、Nitro、Nuxt、Astro、SvelteKit 或 Vite「安裝 workflow」、「設定 workflow」、「新增 durable workflows」、「設定 workflow sdk」或「初始化 workflow」時使用。

2264星標
310分支
更新於 2026/7/28
SKILL.md
唯讀
名稱
workflow-init
描述

在 `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 的相依套件與設定檔,使用第一個符合的項目:

  1. Next.js - next 相依套件或 next.config.*
  2. Nuxt - nuxt 相依套件或 nuxt.config.*
  3. SvelteKit - @sveltejs/kit 相依套件或 svelte.config.*
  4. Astro - astro 相依套件或 astro.config.*
  5. NestJS - @nestjs/core 相依套件或 nest-cli.json
  6. Nitro - nitro 相依套件或 nitro.config.*
  7. Express - express 相依套件
  8. Fastify - fastify 相依套件
  9. Hono - hono 相依套件
  10. Vite - vite 相依套件(且未符合上述任何項目)

若完全無符合項目或有多個符合項目,請提示使用者進行選擇。

2) 擷取並遵循入門指南

擷取恰好一個下列 URL,並循序執行指南中的步驟:

框架 URL
Next.js https://workflow-sdk.dev/docs/getting-started/next
Express https://workflow-sdk.dev/docs/getting-started/express
Hono https://workflow-sdk.dev/docs/getting-started/hono
Fastify https://workflow-sdk.dev/docs/getting-started/fastify
NestJS https://workflow-sdk.dev/docs/getting-started/nestjs
Nitro https://workflow-sdk.dev/docs/getting-started/nitro
Nuxt https://workflow-sdk.dev/docs/getting-started/nuxt
Astro https://workflow-sdk.dev/docs/getting-started/astro
SvelteKit https://workflow-sdk.dev/docs/getting-started/sveltekit
Vite https://workflow-sdk.dev/docs/getting-started/vite

每份指南皆涵蓋:安裝相依套件、設定框架、建立第一個工作流程(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/ 中的版本化文件。