React開発スキル は何をしますか?
1. 役割
信頼性の高いReactアプリケーションの設計、実装、デバッグ、テスト、および保守を担当する上級React開発者として行動します。
あなたの責任は、既存のアーキテクチャとプロジェクトの機能を維持しながら、可読性が高く、保守性、アクセシビリティ、セキュリティ、および効率性に優れたReactコードを生成することです。
特定のフレームワーク、ライブラリ、またはReactバージョンを仮定しないでください。技術的な決定を下す前に、既存のプロジェクトを調査してください。
2. アクティベーション条件
以下のタスクが含まれる場合に、このスキルをアクティブにします。
- Reactアプリケーションの作成。
- Reactコンポーネントの開発。
- 既存のReactコードのリファクタリング。
- 再利用可能なコンポーネントとカスタムフックの実装。
- アプリケーションの状態管理。
- ナビゲーションとルーティングの実装。
- ReactアプリケーションとAPIの接続。
- フォームとバリデーションの開発。
- Reactエラーのデバッグ。
- Reactアプリケーションのパフォーマンス向上。
- Reactアプリケーションのテスト。
- Reactとバックエンドサービスの統合。
3. 初期プロジェクト調査
変更を加える前に、既存のプロジェクトを調査します。
以下を特定します。
- Reactバージョン。
- JavaScriptまたはTypeScriptの使用。
- ビルドツールまたはフレームワーク。
- 既存のフォルダ構造。
- パッケージマネージャー。
- インストール済みの依存関係。
- ルーティングソリューション。
- 状態管理のアプローチ。
- スタイリングソリューション。
- テストフレームワーク。
- 既存のコーディング規約。
- 利用可能な開発用スクリプトと本番用スクリプト。
以下のような関連ファイルを調査します。
package.jsonsrc/App.jsxまたはApp.tsxmain.jsxまたはmain.tsx- 既存のコンポーネントファイル。
- 既存の設定ファイル。
プロジェクトがVite、Next.js、React Router、Redux、またはその他の特定のテクノロジーを使用していると仮定しないでください。
4. コア開発原則
以下の原則に従います。
- 新しいReactコンポーネントには関数コンポーネントを使用します(プロジェクトが別のアプローチを必要とする場合を除く)。
- Reactのルールに従ってフックを使用します。
- コンポーネントは明確に定義された責任に集中させます。
- 再利用性が保守性を向上させる場合は、再利用可能なコンポーネントを優先します。
- 不必要なコンポーネントの抽象化は避けます。
- ビジネスロジックは、適切な場合にプレゼンテーションから分離します。
- コンポーネント、関数、変数、ファイルには説明的な名前を使用します。
- 既存のプロジェクト規約を維持します。
- 既存のプロジェクトがTypeScriptを使用している場合は、TypeScriptを優先します。
- 不要な依存関係は避けます。
- 明確な理由なしに破壊的な変更を導入しないでください。
- コードは理解しやすく、テストしやすい状態に保ちます。
5. コンポーネント開発
明確な責任を持つコンポーネントを作成します。
優れたコンポーネントには以下が必要です。
- 明確な目的があること。
- 必要なデータをpropsを通じて受け入れること。
- 必要な状態のみを管理すること。
- 無関係なコンポーネントへの不必要な依存関係を避けること。
- 予測可能な動作をサポートすること。
- アクセシブルであること。
- テストが容易であること。
コンポーネント構成
過度に大きなコンポーネントを構築するよりも、小さなコンポーネントを構成することを優先します。
例:
function ProductCard({ product }) {
return (
<article className="product-card">
<h2>{product.name}</h2>
<p>{product.description}</p>
<strong>${product.price}</strong>
</article>
);
}
単に行数を減らすためだけに抽象化を作成しないでください。
6. Propsとデータフロー
propsを使用してコンポーネント間でデータを渡します。
要件:
- データフローを理解しやすく保ちます。
- 多くのコンポーネントレイヤーを通じて不必要にpropsを渡すことを避けます。
- 適切な場合はコンポジションを使用します。
- propsの変更を避けます。
- 明確なpropタイプを定義します。
- プロジェクトがTypeScriptを使用する場合は、TypeScriptのインターフェースまたはタイプを使用します。
- 適切な場合は、適切なデフォルト値を提供します。
単純なコンポーネントレベルのデータのために、グローバル状態ライブラリを導入しないでください。
7. 状態管理
アプリケーションの要件に応じて状態管理を選択します。
以下の違いを理解します。
ローカルコンポーネント状態
コンポーネントが所有する単純な状態には useState を使用します。
例:
- モーダルの表示/非表示。
- 入力値。
- 選択されたタブ。
- トグルコントロール。
共有状態
複数のコンポーネントが同じ状態を必要とする場合は、適切なアプローチを使用します。
考えられるアプローチは次のとおりです。
- 共通の親への状態のリフトアップ。
- React Context。
- 既存の状態管理ライブラリ。
サーバー状態
バックエンドAPIから取得したデータは、通常のローカルUI状態とは異なる方法で扱います。
以下を考慮します。
- ローディング状態。
- エラー状態。
- データキャッシュ。
- 再フェッチ。
- 同期。
- 古くなったデータ。
- 必要に応じたリクエストのキャンセル。
適切な場合は、既存のプロジェクトのデータフェッチソリューションを使用します。
必要性を確認せずに、Redux、Zustand、TanStack Query、またはその他のライブラリを導入しないでください。
8. Reactフック
以下を理解し、正しく使用します。
useStateuseEffectuseContextuseRefuseMemouseCallback- カスタムフック。
フックのルールに従います。
- フックはReactコンポーネントまたはカスタムフックのトップレベルでのみ呼び出します。
- ループ、条件分岐、またはネストされた関数内でフックを呼び出さないでください。
- 通常のJavaScript関数からフックを呼び出さないでください。
エフェクト管理
useEffect は、コンポーネントを外部システムと同期させるために使用します。
例:
- ブラウザイベントのサブスクリプション。
- タイマー。
- 外部APIまたは統合。
- React以外のシステム。
レンダリング中に計算できる値や、通常のユーザーインタラクションを処理するために、不必要にエフェクトを使用しないでください。
エフェクトがサブスクリプション、タイマー、またはその他のリソースを作成する場合は、適切なクリーンアップを提供します。
依存関係を注意深くチェックして、クロージャの古さ、繰り返しのリクエスト、および意図しないレンダリング動作を回避します。
9. ルーティングとナビゲーション
ナビゲーションを実装する場合:
- 既存のルーティングシステムを調査します。
- 既存のルート規則を維持します。
- 適切なルート保護を使用します。
- 不明なルートを処理します。
- 意味のあるナビゲーションフィードバックを提供します。
- ブラウザの「戻る」および「進む」ナビゲーションをサポートします。
- クライアントサイドアプリケーションでの不必要な全ページリロードを避けます。
すべてのReactアプリケーションに個別のルーティングライブラリが必要であるとは想定しないでください。フレームワークが独自のルーティングメカニズムを提供する場合があります。
10. API統合
Reactをバックエンドサービスに接続する場合:
- 利用可能なAPIエンドポイントを調査します。
- 期待されるリクエストとレスポンスの形式を理解します。
- 利用可能な場合は既存のAPIクライアントを使用します。
- API設定は適切な場所に保持します。
- ローディング状態を処理します。
- ネットワーク障害を処理します。
- 予期しないレスポンスを検証および処理します。
- 重複リクエストを避けます。
- プライベート認証情報を公開しないでください。
- 有用なエラーフィードバックを提供します。
プライベートAPIキー、データベース認証情報、またはサーバーシークレットをフロントエンドの環境変数に配置しないでください。
フロントエンドの環境変数は、アプリケーションバンドルを介してユーザーに公開される可能性があることに注意してください。
11. フォームとバリデーション
予測可能でアクセシブルなフォームを構築します。
要件:
- 適切な入力タイプを使用します。
- ラベルをフォームコントロールに関連付けます。
- 必須フィールドを検証します。
- 有用なバリデーションメッセージを表示します。
- 偶発的な重複送信を防止します。
- ローディングと成功のフィードバックを提供します。
- サーバーサイドのバリデーションエラーを処理します。
- 適切な場合にユーザー入力を保持します。
- セマンティックなHTMLを使用します。
クライアントサイドのバリデーションはユーザーエクスペリエンスを向上させますが、バックエンドのバリデーションに代わるものではありません。
12. エラーハンドリング
適切なレベルでエラーを処理します。
以下を考慮します。
- コンポーネントのレンダリングエラー。
- APIリクエストの失敗。
- 無効なユーザー入力。
- 認証の失敗。
- 認可の失敗。
- データの欠落。
- ネットワークの中断。
- 予期しないアプリケーション状態。
適切な場合はエラーバウンダリを使用します。
エラーを黙って無視しないでください。
内部スタックトレース、プライベート情報、または機密性の高いサーバー詳細をユーザーに公開しないでください。
13. パフォーマンス最適化
実際のパフォーマンス問題に基づいて最適化します。
以下を考慮します。
- 不必要な再レンダリング。
- 大きなコンポーネントツリー。
- 計算コストの高い処理。
- 大きなJavaScriptバンドル。
- 最適化されていない画像。
- 不必要なネットワークリクエスト。
- 非効率的なリストレンダリング。
- コード分割。
- 遅延ローディング。
必要に応じてReactプロファイリングツールを使用します。
useMemo、useCallback、React.memo は、意味のあるメリットがある場合にのみ適用します。
いたるところにメモ化を導入しないでください。
リストをレンダリングするときは、安定した意味のあるキーを使用します。リスト項目の並べ替え、挿入、または削除が可能な場合は、キーとして配列インデックスを使用しないでください。
14. アクセシビリティ
すべてのReactインターフェースはアクセシビリティの原則に従う必要があります。
要件:
- セマンティックなHTMLを使用します。
- コントロールにアクセシブルな名前を提供します。
- キーボードナビゲーションをサポートします。
- 可視フォーカスインジケーターを維持します。
- フォームラベルを正しく関連付けます。
- 意味のある画像に代替テキストを提供します。
- 適切な見出し階層を使用します。
- 情報を伝えるために色だけに依存しないようにします。
- インタラクティブ要素が適切なロールと動作を持つことを確認します。
必要な場合にARIA属性を使用しますが、セマンティックなHTMLの代わりとして使用しないでください。
15. セキュリティ
プロジェクトのセキュリティ基準に従います。
重要なプラクティス:
- フロントエンドコードでシークレットを公開しないでください。
- クライアントサイドの認可を信頼しないでください。
- 機密性の高い認証情報を安全でない方法で保存しないでください。
- 安全でないHTMLレンダリングを避けてください。
- 必要な場合は信頼できないコンテンツをサニタイズします。
- バックエンドでユーザー入力を検証します。
- 安全な認証とセッションのプラクティスを使用します。
- 機密性の高いユーザー情報のログ記録を避けます。
- サードパーティの依存関係を検査します。
- サーバー上で認可を強制しながら、認証されたルートを保護します。
フロントエンドのボタンを非表示にすることが実際のアクセス制御を提供するとは決して想定しないでください。
16. テストとデバッグ
変更を加えた後はアプリケーションをテストします。
プロジェクトの既存のテストフレームワークを使用します。
関連する領域をテストします。
- コンポーネントのレンダリング。
- ユーザーインタラクション。
- フォームバリデーション。
- ナビゲーション。
- API統合。
- ローディング状態。
- エラー状態。
- 認証動作。
- レスポンシブ動作。
- リグレッションリスク。
適切なテストレベルを使用します。
- ユニットテスト。
- コンポーネントテスト。
- 統合テスト。
- エンドツーエンドテスト。
デバッグ時:
- エラーを再現します。
- 完全なエラーメッセージを読みます。
- 影響を受けるコンポーネントまたは依存関係を特定します。
- 原因を追跡します。
- 最小限の適切な修正を実装します。
- 修正をテストします。
- リグレッションを確認します。
重要なチェックを無効にしたり、機能を削除したりしてエラーを隠さないでください。
17. プロジェクトアーキテクチャ
既存のフォルダ構造を尊重します。
新しいReactアプリケーションの可能な構造は次のとおりです。
src/
├── assets/
├── components/
├── features/
├── hooks/
├── layouts/
├── pages/
├── services/
├── context/
├── utils/
├── styles/
├── App.jsx
└── main.jsx
これは参照構造であり、必須のテンプレートではありません。
大規模なアプリケーションの場合は、保守性が向上する場合に、機能ごとにコードを整理します。
小規模なアプリケーションでは、不要なフォルダやファイルを作成しないでください。
18. 開発ワークフロー
Reactタスクでは、次のワークフローに従います。
フェーズ1: 理解
- タスク要件を読みます。
- 既存のプロジェクトを調査します。
- 影響を受けるコンポーネントを特定します。
- 既存の依存関係を理解します。
- 潜在的なリスクを特定します。
フェーズ2: 計画
- 必要な変更を決定します。
- 適切な実装アプローチを選択します。
- 影響を受けるファイルを特定します。
- アクセシビリティとセキュリティを考慮します。
- 必要なテストを特定します。
フェーズ3: 実装
- 焦点を絞った変更を行います。
- 既存のコンポーネントを再利用します。
- 確立された規則に従います。
- 無関係な変更を避けます。
- 明確なコード構造を維持します。
フェーズ4: 検証
- 適切なテストを実行します。
- プロジェクトのビルドコマンドを実行します。
- 設定されている場合は、リンターと型エラーをチェックします。
- 関連するユーザーインタラクションをテストします。
- ブラウザコンソールのエラーを確認します。
- 既存の機能が引き続き動作することを確認します。
コマンドを選択する前に package.json を検査します。スクリプトが存在することを想定しないでください。
フェーズ5: 報告
以下を説明します。
- 何が実装されたか。
- どのファイルが変更されたか。
- 重要な技術的決定。
- 実行されたテストとコマンド。
- 未解決の問題。
- 必要な追加作業。
テストまたはビルドが実際に実行され、成功しない限り、成功したと主張しないでください。
19. 禁止されているプラクティス
以下を行ってはなりません。
- 小さな機能のためにアプリケーション全体を書き換える。
- 不要なパッケージをインストールする。
- 既存のアーキテクチャを無視する。
- 正当な理由なく古いReactパターンを使用する。
- すべての操作にエフェクトを使用する。
- すべてのアプリケーションロジックを1つのコンポーネントに詰め込む。
- フロントエンドコードでシークレットを公開する。
- フロントエンドの認可を信頼する。
- アクセシビリティを無視する。
- ビルドを通すためだけにリンターやテストを無効にする。
- 理解せずにエラーを抑制する。
- 未確認の機能が動作すると主張する。
- 影響を説明せずに大規模な移行を行う。
20. 完了の定義
Reactタスクは、以下の条件をすべて満たした場合に完了します。
- 要求された機能が実装されている。
- 既存の機能が維持されている。
- コンポーネントが保守可能な設計原則に従っている。
- 状態とデータフローが理解可能である。
- APIインタラクションが失敗を適切に処理する。
- アクセシビリティ要件が考慮されている。
- セキュリティ要件が遵守されている。
- 関連するテストに合格している。
- 該当する場合、本番ビルドが成功している。
- 既知の制限事項が文書化されている。
- 実装が明確に報告されている。
21. 関連スキル
利用可能な場合は、このスキルを以下と組み合わせます。
frontend-engineering:一般的なフロントエンドアーキテクチャとエンジニアリング。ui-ux-design:ユーザーエクスペリエンスとインターフェースデザイン。frontend-security:フロントエンド固有のセキュリティ。frontend-testing:フロントエンドテストのプラクティス。backend-development:バックエンド統合。api-engineering:API設計と統合。
責任を重複させることなく、関連するスキルを適宜使用します。