自动化与脚本
首次为项目安装配置 Vercel Workflow SDK…
在 workflow 尚未安装到 node_modules 时,为 Next.js、Express、Hono、Fastify、NestJS、Nitro、Nuxt、Astro、SvelteKit 或 Vite 项目完成 Vercel Workflow SDK 的初始化、配置与验证。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 59/100 ×0.15
适用场景
首次为项目安装配置 Vercel Wor特定
解决思路
- 初始设置:在 `workflow` 尚未安装时,为 Vercel Workflow SDK 做初始化,并获取用户框架对应的官方 getting-started 指南。
- 读取 `package.json`。如果 `workflow` 已经是依赖,告诉用户改用 `/workflow`,因为它会从 `node_modules/workflow/docs/` 读取版本化文档;只有 `workflow` 缺失时才继续。
- 非交互式确定框架:如果用户在提示中指定了框架,直接使用该框架。
- 自动检测框架:检查 `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` 依赖(且未被上述规则匹配)。
- 如果无匹配或有多个匹配,让用户选择框架。
- 根据框架获取且仅获取一个 getting-started 指南,并逐步照做: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。
- 每个 getting-started 指南都覆盖:安装依赖、配置框架、创建第一个 workflow、创建 route handler、运行并验证。
- 验证 setup:按指南启动 dev server。
- 用指南提供的 `curl` 触发示例 endpoint。
- 确认 logs 显示 workflow 和 steps 正在执行。
- 可选:运行 `npx workflow web` 或 `npx workflow inspect runs`。
- 如果尚无框架,询问用户想要哪类项目:Web app 选 Next.js / Nuxt / SvelteKit / Astro;API server 选 Express / Fastify / Hono;Minimal server 选 Nitro 或 Vite。
- 然后遵循所选指南的 “Create Your Project” 部分。
- 如果用户在安装前询问概念问题,获取 https://workflow-sdk.dev/docs/foundations/workflows-and-steps 和 https://workflow-sdk.dev/cookbook。
- setup 完成后,告诉用户:持续开发使用 `/workflow`,因为它读取 `node_modules/workflow/docs/` 中捆绑的版本化文档。
适用边界 · 注意事项
- 当 `workflow` 已经是依赖时,不使用此技能,改用 `/workflow`。
- 当用户已经完成初始安装、要做持续开发时,不使用此技能,改用 `/workflow`。