workflow-init について
Vercel Workflow SDKが未導入のプロジェクト向けのセットアップスキルです。フレームワークを検出または確認し、該当する公式ガイドに沿って初期設定を検証します。
主な機能
- 01Workflowの導入状況を確認
- 02プロジェクトのフレームワークを検出
- 03該当するセットアップガイドに従う
- 04サンプルワークフローを検証
活用シーン
- 01既存のフレームワークプロジェクトへのWorkflow導入
- 02セットアップ前のフレームワーク選定
- 03最初のワークフローエンドポイントのテスト
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/workflow-initを入力して読み込まれたか確認します。
詳細
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 のうち1つだけを取得し、ガイドの手順に沿って進めます。
各ガイドでは、依存関係のインストール、フレームワークの設定、最初のワークフローの作成、ルートハンドラーの作成、実行と確認について説明しています。
3）設定を確認する
- ガイドに従って開発サーバーを起動します。
- 提供された
curlを使って、サンプルエンドポイントを呼び出します。 - ログにワークフローとステップの実行が表示されることを確認します。
- 任意：
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/ に同梱されている、バージョンに対応したドキュメントを読み込みます。