Communityコーディング&開発github.com

sk-react

React および TypeScript コンポーネントの構築・修正を支援します。状態の配置、エフェクトの依存関係、データフェッチ、リストレンダリング、そして古い状態や無限ループを引き起こす再レンダリングの罠をカバーします。React コンポーネントやフックの作成・変更時、古いデータ・無限レンダリングループ・入力消失のデバッグ時、またはフロントエンドコードのレビュー時に使用します。

sk-react とは?

このスキルは、React と TypeScript のコンポーネント開発において、保守性が高くバグの少ないコードを書くためのベストプラクティスを提供します。状態管理では「1つの値に1つの所有者」を原則とし、props や state から導出可能な値は `useState` にミラーリングせず、レンダリング中に計算することを推奨します。エフェクトは外部システムとの同期に限定し、依存配列は読み取るすべての値を漏れなく列挙し、クリーンアップ関数を返すことでメモリリークや競合状態を防ぎます。データフェッチは、可能な限り専用ライブラリを利用し、手動実装時はローディング・空・エラー・成功の4状態をすべてハンドリングし、リクエストのキャンセルと未ハンドルの拒否を避けるよう指導します。レンダリングではリストに安定したキーを使用し、`memo` や `useMemo` はプロファイラで計測した後に適用すること、フックは常に同じ順序で呼び出すことを強調します。TypeScript では `any` や型アサーションを安易に使わず、境界(API レスポンスやフォーム値)でバリデーションしてから型を信頼する設計を促します。最終的な検証として、ビルドが通っただけでは不十分で、型チェックとリンターを明示的に実行し、空状態・エラー状態・低速ネットワーク・連続操作など現実的なシナリオでコンポーネントをテストすることを推奨します。

対応~Claude Code~Codex CLI~Cursor
Part ofReact
npx skills add https://github.com/vanhuydotcom/sk-skills/tree/HEAD/skills/sk-react

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

React と TypeScript

状態は一箇所に

すべての値には、所有者が1つだけであるべきです。React のバグの大半は、同じ事実について2つのコピーが食い違うことで発生します。

格納する代わりに導出してください。もし値を props と state からレンダリング中に計算できるなら、計算してください — useState にミラーリングしないでください。なぜなら、コピーは元のソースが変わった瞬間に古くなるからです。const total = items.reduce(...) は state を必要とせず、決して間違うことはありません。

prop からコピーした state は、同じバグがより長いヒューズを持つだけです:useState の初期値は一度だけ読み取られ、その後は永遠に無視されます。コンポーネントが prop の変更時にリセットされる必要があるなら、key を与えて React に再マウントさせてください。

状態のリフトは、それを必要とする最も近い共通の親までの範囲にとどめてください。それ以上リフトすると、すべての兄弟がキーストロークごとに再レンダリングされます。

エフェクト

エフェクトは React の外部との何かと同期します:サブスクリプション、タイマー、ドキュメント、命令型ライブラリ。値を計算したりクリックに応答するための場所ではありません — それはイベントハンドラの役割です。

依存配列には、エフェクトが読み取るものをすべてリストアップしなければなりません。ループを止めるために値を省略すると、その値は最初の値で固定され、クロージャの値が古くなるバグ(stale-closure bug)が発生します。エフェクトがループする原因が、依存関係としてレンダリングごとに再作成されるオブジェクトや関数にある場合は、依存関係を修正してください — useCallback、useMemo、またはコンポーネントの外に移動する — 配列から削除するのではなく。

エフェクトがコンポーネントより長く生存する可能性のあるものを開始する場合は、必ずクリーンアップ関数を返してください。サブスクリプション、タイマー、進行中のリクエストはすべて、コンポーネントがアンマウントされるか依存関係が変更されたときに停止する必要があります。また、開発モードの StrictMode では、エフェクトは2回実行されることで、特にクリーンアップの欠落を露呈させます。

async 関数はエフェクトの本体になれません — プロミスを返すため、React はクリーンアップ関数を期待します。非同期の処理は内部で宣言して呼び出してください。

データフェッチ

エフェクト内での手動フェッチよりも、プロジェクトのデータライブラリを優先してください。キャッシュ、重複排除、リトライ、そしてあなたがまさに書きそうな競合状態をすでに解決してくれています。

手動でフェッチする場合は、ローディング、空、エラー、成功の4つの状態すべてを処理し、クリーンアップ時にリクエストをキャンセルしてください。順番に開始された2つのリクエストが順不同で解決される可能性があるため、前のリクエストを中止するか、もはや最新でないレスポンスを無視してください。

拒否(rejection)を飲み込まないでください。ハンドラやエフェクト内で未処理の拒否は、静かに失敗し、UI は単に更新を停止します。

レンダリング

リストには、データから安定した ID をキーとして使用してください。インデックスキーは、並べ替え、挿入、削除が決して行われないリストでのみ正しく動作します。そうでない場合、React は間違った DOM ノードを再利用し、入力は前の行の値を保持します。

memo、useMemo、useCallback は、プロファイラで計測した後に使用してください。デフォルトですべてに適用すると、アロケーションと誤った依存配列が追加され、問題を解決できません。本当のコストが親がツリー全体を再レンダリングすることである場合、これらは何も解決しません。

フックを条件付きで、ループ内で、または早期リターンの後で呼び出さないでください。フックの呼び出し順序は、すべてのレンダリングで同一でなければなりません。

TypeScript

any と型アサーションは、修正ではなく未解決の質問として扱ってください。どちらも、コンパイラが有用なことを言おうとしていたまさにその場所で、それを黙らせます。型が本当に不明な場合は、unknown を使用して絞り込んでください。

境界を越えるものに型を付けましょう:API レスポンス、フォームの値、URL パラメータ。ネットワークからのデータは、何かがチェックするまでは宣言した型ではありません。そのため、境界でバリデーションし、アプリの残りの部分はその結果を信頼できるようにしてください。

検証

グリーンビルドは見た目ほど確かな証拠にはなりません。多くのプロジェクトは、ビルド中に lint や型エラーを無視するようにフレームワークを構成しているため、ビルドを証拠として扱う前に設定を確認し、型チェックとリンターを明示的に実行してください。

その後、コンポーネントを使用してください:空の状態、エラー状態、低速なネットワーク、そして最初の操作が完了する前の2回目の素早い操作もテストしてください。

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

sk-api

Design and change API contracts (REST, gRPC, protobuf, events) so existing callers keep working, covering resource and method shape, error models, pagination, versioning and the deploy order a breaking change requires. Use when adding or altering an endpoint, message or event, or when judging whether a proposed change breaks a consumer.

sk-code-review

Shows an agent how to design, debug, or review "sk code review" so the concrete output is a code change with a check. The procedure moves through Code review, Establish the diff first, What to look for, in priority order. Use it when a new assignment calls for this craft.

sk-go-service

Implement, extend or debug a handler, service or repository in a Go backend service, covering context propagation, error wrapping, transaction boundaries, tenancy scoping and table-driven tests. Use when writing or changing Go server code, adding an endpoint or gRPC method, touching a repository query, or diagnosing a panic, leak or flaky test in a Go service.

sk-python

Write and debug Python with attention to the traps that produce silent wrong behaviour — mutable defaults, late-binding closures, shallow copies, swallowed exceptions — plus typing, environment and packaging with uv or venv, and pytest structure. Use when writing a Python script, service or library, setting up a Python project, or debugging behaviour that looks impossible.

sk-system-design

Design or evaluate a distributed system from its constraints — service boundaries, synchronous versus event-driven communication, consistency, failure behaviour and capacity — and state the trade-off each choice buys. Use when splitting or merging services, choosing between a call and an event, deciding where data lives, reviewing an architecture proposal, or answering a system design question.

関連スキル