Một đặc tả về cách viết React 19.3 bằng tiếng Nhật: khi đại diện viết, sửa đổi hoặc xem xét các thành phần và xử lý phía máy chủ, hãy dựa vào bảng để quyết định vị trí lưu trữ trạng thái (trạng thái giao diện dùng Effect Atom, dữ liệu từ máy chủ dùng TanStack Query), cách loại bỏ các chuỗi bất đồng bộ tuần tự (async waterfall), và khi nào nên sử dụng API đồng thời (concurrent API); tài liệu này được viết lại cho mẫu masseater/typescript-template của tác giả.
Kiểm toán bảo mật: Đã kiểm toán (không phát hiện rủi ro)
Cài đặt: npx skills add https://github.com/masseater/skills --skill how-to-use-react
Lý do
- Bảng “phân loại” liệt kê chi tiết từng mục những gì nên dùng và không nên dùng: không dùng useState / useContext (được chặn bởi no-restricted-imports), dùng useOptimistic cho cập nhật lạc quan, dùng useTransition thay cho chống rung (debounce) theo thời gian cho các cập nhật không khẩn cấp, dùng <Activity> để ẩn nhưng vẫn giữ trạng thái
- Các kho lưu trữ có React Compiler không viết useMemo / useCallback / memo; nếu không có, chỉ thêm chúng ở những nơi được quy tắc react-perf chỉ ra
- Các tác vụ bất đồng bộ độc lập được chạy đồng thời bằng Effect.all với concurrency: "unbounded"; nếu có yêu cầu về thứ tự, hãy ghi rõ concurrency: 1; tác giả ghi chú rằng tài liệu được chuyển thể từ các nguồn như react-best-practices của vercel-labs, không áp dụng Next.js, SWR, Redux từ đó
- 24 giờ cài đặt trên skills.sh 2801 (chỉ phản ánh mức độ quan tâm)
Cách sử dụng
- npx skills add https://github.com/masseater/skills --skill how-to-use-react
- Kích hoạt khi viết, sửa đổi hoặc xem xét các thành phần React, loader, và xử lý phía máy chủ; SKILL.md yêu cầu đọc đồng thời 8 tài liệu trong thư mục references/ (async, effects-and-data, component-apis, v.v.)
Rủi ro
- Kết quả kiểm toán là đạt; SKILL.md là đặc tả dạng văn bản thuần túy, không có script hay yêu cầu mạng, phù hợp với nội dung; các tài liệu trong thư mục references/ chưa được quét
- Các quy tắc gắn liền với ngăn xếp công nghệ của mẫu tác giả (Effect, TanStack Start, cấu trúc thư mục FSD), nếu áp dụng nguyên bản vào các dự án Next.js / Redux thông thường sẽ gây xung đột với mã hiện có
- Toàn bộ nội dung bằng tiếng Nhật; trang skills.sh cho thấy kho lưu trữ chỉ có 2 sao, và chỉ được đưa vào lần đầu vào ngày 12 tháng 10, số lượng cài đặt trong một ngày không tương xứng với quy mô của kho lưu trữ