how-to-use-react(masseater の React 19.3 規約、日本語)

エージェントがコンポーネントやサーバー処理の作成・修正・レビューを行う際に参照する、日本語の React 19.3 記述規約です。状態の配置場所(UI 状態には Effect Atom、サーバーデータには TanStack Query)をテーブルに基づいて決定し、非同期のウォーターフォールを解消する方法や、並行 API を使用すべきタイミングを示しています。作者の masseater/typescript-template テンプレート向けに書き直されたものです。

エージェントがコンポーネントやサーバー処理の作成・修正・レビューを行う際に参照する、日本語の React 19.3 記述規約です。状態の配置場所(UI 状態には Effect Atom、サーバーデータには TanStack Query)をテーブルに基づいて決定し、非同期のウォーターフォールを解消する方法や、並行 API を使用すべきタイミングを示しています。作者の masseater/typescript-template テンプレート向けに書き直されたものです。

セキュリティ監査:監査済み(リスクなし)

インストール:npx skills add https://github.com/masseater/skills --skill how-to-use-react

理由

  • 「置き分け」テーブルでは、使用するものと使用しないものを項目ごとに明確にしています。useState / useContext は使用せず(no-restricted-imports でブロック)、楽観的更新には useOptimistic、急を要さない更新にはタイマーによるデバウンスの代わりに useTransition を使用し、非表示だが状態を保持する場合は <Activity> を使用します
  • React Compiler を導入しているリポジトリでは useMemo / useCallback / memo を記述しません。導入していない場合のみ、react-perf ルールが指摘する箇所に限定して追加します
  • 相互依存性のない非同期処理は Effect.all と concurrency: "unbounded" を使用して並行実行し、順序が重要な場合は concurrency: 1 を明示します。作者は vercel-labs の react-best-practices などの資料を改変して作成したと明記しており、その中の Next.js、SWR、Redux は採用していません
  • skills.sh での 24 時間あたりのインストール数 2801(注目度を示すのみ)

使い方

  • npx skills add https://github.com/masseater/skills --skill how-to-use-react
  • React コンポーネント、ローダー、サーバー処理の作成・修正・レビュー時にトリガーされます。SKILL.md では、references/ 配下の 8 件のドキュメント(async、effects-and-data、component-apis など)を同時に読むことが要求されています

リスク

  • 監査結果は合格。SKILL.md は純粋なテキスト規約であり、スクリプトやネットワークリクエストを含みません。内容と一致しています。references/ 配下のドキュメントはスキャンされていません
  • ルールは作者のテンプレートの技術スタック(Effect、TanStack Start、FSD ディレクトリ構造)に紐付いています。一般的な Next.js / Redux プロジェクトでそのまま使用すると、既存のコードと競合する可能性があります
  • 全文が日本語です。skills.sh のページによると、リポジトリのスター数は 2 件、初回収録は 10 月 12 日であり、1日あたりのインストール数とリポジトリの規模が不釣り合いです

開く · リポジトリ

Best Skills 每日数据(LinklyAI / @BlueeonY,CC BY 4.0)

最新の AI ニュースを見る