React/Next.js 開発ワークフロー
概要
ReactおよびNext.js 14+アプリケーションを、App Router、Server Components、TypeScript、Tailwind CSSなどの最新パターンで構築するための専門ワークフローです。
このワークフローを使用するタイミング
以下の場合にこのワークフローを使用します。
- 新しいReactアプリケーションを構築する場合
- App Routerを使用したNext.js 14+プロジェクトを作成する場合
- Server Componentsを実装する場合
- ReactでTypeScriptをセットアップする場合
- Tailwind CSSでスタイリングする場合
- フルスタックのNext.jsアプリケーションを構築する場合
ワークフローのフェーズ
Phase 1: プロジェクトセットアップ
呼び出すスキル
app-builder- アプリケーションのスキャフォールディングsenior-fullstack- フルスタックガイダンスnextjs-app-router-patterns- Next.js 14+パターンtypescript-pro- TypeScriptセットアップ
アクション
- プロジェクトタイプを選択(React SPA、Next.jsアプリ)
- ビルドツールを選択(Vite、Next.js、Create React App)
- プロジェクト構造をスキャフォールド
- TypeScriptを設定
- ESLintとPrettierをセットアップ
コピー&ペースト用プロンプト
Use @app-builder to scaffold a new Next.js 14 project with App Router
Use @nextjs-app-router-patterns to set up Server Components
Phase 2: コンポーネントアーキテクチャ
呼び出すスキル
frontend-developer- コンポーネント開発react-patterns- Reactパターンreact-state-management- 状態管理react-ui-patterns- UIパターン
アクション
- コンポーネント階層を設計
- ベースコンポーネントを作成
- レイアウトコンポーネントを実装
- 状態管理をセットアップ
- カスタムフックを作成
コピー&ペースト用プロンプト
Use @frontend-developer to create reusable React components
Use @react-patterns to implement proper component composition
Use @react-state-management to set up Zustand store
Phase 3: スタイリングとデザイン
呼び出すスキル
frontend-design- UIデザインtailwind-patterns- Tailwind CSStailwind-design-system- デザインシステムcore-components- コンポーネントライブラリ
アクション
- Tailwind CSSをセットアップ
- デザイントークンを設定
- ユーティリティクラスを作成
- コンポーネントスタイルを構築
- レスポンシブデザインを実装
コピー&ペースト用プロンプト
Use @tailwind-patterns to style components with Tailwind CSS v4
Use @frontend-design to create a modern dashboard UI
Phase 4: データフェッチング
呼び出すスキル
nextjs-app-router-patterns- Server Componentsreact-state-management- React Queryapi-patterns- API統合
アクション
- Server Componentsを実装
- React Query/SWRをセットアップ
- APIクライアントを作成
- ローディング状態を処理
- エラーバウンダリを実装
コピー&ペースト用プロンプト
Use @nextjs-app-router-patterns to implement Server Components data fetching
Phase 5: ルーティングとナビゲーション
呼び出すスキル
nextjs-app-router-patterns- App Routernextjs-best-practices- Next.jsパターン
アクション
- ファイルベースルーティングをセットアップ
- 動的ルートを作成
- ネストされたルートを実装
- ルートガードを追加
- リダイレクトを設定
コピー&ペースト用プロンプト
Use @nextjs-app-router-patterns to set up parallel routes and intercepting routes
Phase 6: フォームとバリデーション
呼び出すスキル
frontend-developer- フォーム開発typescript-advanced-types- 型検証react-ui-patterns- フォームパターン
アクション
- フォームライブラリを選択(React Hook Form、Formik)
- バリデーションをセットアップ(Zod、Yup)
- フォームコンポーネントを作成
- 送信を処理
- エラーハンドリングを実装
コピー&ペースト用プロンプト
Use @frontend-developer to create forms with React Hook Form and Zod
Phase 7: テスト
呼び出すスキル
javascript-testing-patterns- Jest/Vitestplaywright-skill- E2Eテストe2e-testing-patterns- E2Eパターン
アクション
- テストフレームワークをセットアップ
- ユニットテストを作成
- コンポーネントテストを作成
- E2Eテストを実装
- CI統合を設定
コピー&ペースト用プロンプト
Use @javascript-testing-patterns to write Vitest tests
Use @playwright-skill to create E2E tests for critical flows
Phase 8: ビルドとデプロイ
呼び出すスキル
vercel-deployment- Vercelデプロイvercel-deploy-claimable- Vercelデプロイweb-performance-optimization- パフォーマンス
アクション
- ビルド設定を構成
- バンドルサイズを最適化
- 環境変数を設定
- Vercelにデプロイ
- プレビューデプロイを構成
コピー&ペースト用プロンプト
Use @vercel-deployment to deploy Next.js app to production
技術スタック
| カテゴリ | 技術 |
|---|---|
| フレームワーク | Next.js 14+, React 18+ |
| 言語 | TypeScript 5+ |
| スタイリング | Tailwind CSS v4 |
| 状態管理 | Zustand, React Query |
| フォーム | React Hook Form, Zod |
| テスト | Vitest, Playwright |
| デプロイ | Vercel |
品質ゲート
- TypeScriptがエラーなくコンパイルされる
- すべてのテストが成功する
- リントがクリーン
- パフォーマンス指標を満たす(LCP、CLS、FID)
- アクセシビリティがチェック済み(WCAG 2.1)
- レスポンシブデザインが確認済み
関連ワークフローバンドル
development- 一般的な開発testing-qa- テストワークフローdocumentation- ドキュメントtypescript-development- TypeScriptパターン
制限事項
- タスクが上記の範囲に明確に一致する場合にのみ、このスキルを使用してください。
- 出力を、環境固有の検証、テスト、または専門家によるレビューの代替として扱わないでください。
- 必要な入力、権限、安全境界、成功基準が不足している場合は、停止して明確化を求めてください。