Community程式設計與開發github.com

sk-react

建構與修正 React 和 TypeScript 元件,涵蓋狀態擺放、Effect 依賴、資料擷取、列表渲染以及導致過時或無限循環 UI 的重新渲染陷阱。適用於撰寫或修改 React 元件或 Hook、偵錯過時資料、無限渲染循環或輸入遺失問題,以及審查前端程式碼時。

sk-react 是什麼?

此技能為使用 React 和 TypeScript 的開發者提供一套嚴謹但實用的指導原則,重點在於消除因狀態管理不當、Effect 依賴錯誤及資料擷取競爭條件所導致的常見 UI 錯誤。其核心哲學是「每個值應有唯一擁有者」,強烈建議從 props 和 state 推導值而非將其複製到 `useState`,以避免過時資料。關於 Effect,它正確界定其用途為同步外部系統(如訂閱、計時器),而非計算值或回應事件,並強調依賴陣列須完整,同時要實作清理函數以預防記憶體洩漏與競爭條件。在資料擷取方面,優先推薦使用專案內的資料函式庫,若手動實作則必須妥善處理載入、空值、錯誤與成功四種狀態,並在清理時取消請求。此外,技能也涵蓋使用穩定 key 進行列表渲染、非必要時避免過度使用 `memo` 和 `useMemo`、以及 TypeScript 中謹慎使用 `any` 與型別斷言等最佳實務。最後提醒開發者不要依賴建置成功作為唯一的驗證方式,因為許多框架會忽略建置中的 lint 與型別錯誤,必須手動執行檢查,並實際在各種情境(空狀態、錯誤狀態、慢速網路、連續互動)下測試元件。

相容平台~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 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

React 和 TypeScript

將狀態放在一個地方

每個值都應只有一個擁有者。大多數 React 錯誤源自於同一筆資料有兩個不同拷貝且彼此不一致。

請用推導取代儲存。如果某個值可以在渲染期間從 props 和 state 計算出來,就應該計算它——不要將其鏡像到 useState,因為當其來源改變時,拷貝就會立即過時。const total = items.reduce(...) 無需 state 且永遠不會出錯。

從 prop 複製而來的 state 是同一種錯誤,只是延後爆發:useState 的初始值只會讀取一次,之後便永遠被忽略。如果元件必須在 prop 改變時重置,請為它提供一個 key 並讓 React 重新掛載它。

僅將 state 提升到需要它的最近共同父元件。提升得越遠,每次按鍵都會導致所有兄弟元件重新渲染。

Effect

Effect 用於與 React 外部的系統進行同步:訂閱、計時器、document 或命令式函式庫。它不是用來計算值或回應點擊的地方——那是事件處理函式的職責。

依賴陣列必須列出 Effect 讀取的所有內容。為了停止迴圈而省略某個值,會將其凍結在第一個值上,並產生閉包過時錯誤。如果因為依賴項是每次渲染都會重建的物件或函式而導致 Effect 陷入循環,請修正依賴項——使用 useCallback、useMemo,或將其移出元件——而不是從陣列中刪除它。

每當 Effect 啟動任何可能超出其生命週期的東西時,都應返回一個清理函數。訂閱、計時器和進行中的請求都需要在元件卸載或依賴項改變時停止;在開發模式下,StrictMode 會讓 Effect 執行兩次,正是為了暴露缺少清理函數的問題。

async 函式不能作為 Effect 主體——它會回傳一個 Promise,而 React 預期的是清理函數。請在 Effect 內部宣告非同步工作並呼叫它。

資料擷取

優先使用專案的資料函式庫,而不是在 Effect 中手動擷取;它已經解決了快取、去重、重試以及你即將遇到的競爭條件。

在手動擷取時,請處理所有四種狀態——載入中、空值、錯誤、成功——並在清理時取消請求。順序發起的兩個請求仍可能以亂序解析,因此要麼中止前一個請求,要麼忽略已非當前的回應。

絕不要吞沒 rejection。在處理函式或 Effect 中未處理的 rejection 會默默地失敗,UI 便停止更新。

渲染

使用資料中穩定的唯一標識符作為列表的 key。索引 key 僅在列表永不重新排序、插入或刪除時才是正確的;當列表變動時,React 會重用錯誤的 DOM 節點,導致輸入框保留前一行的值。

在使用剖析器測量之後,再考慮使用 memo、useMemo 和 useCallback。預設到處使用它們會增加配置和容易出錯的依賴陣列,而且在真實成本是父元件重新渲染整個樹的情況下,它們也無法解決問題。

絕不要在條件、迴圈或過早返回之後呼叫 Hook。其呼叫順序必須在每一次渲染中都完全相同。

TypeScript

將 any 和型別斷言視為未解決的問題,而非修正。兩者都在編譯器恰好有有用資訊要提供的地方讓它保持沉默。當型別確實未知時,請使用 unknown 並縮小其範圍。

對跨越邊界的資料定義型別:API 回應、表單值、URL 參數。來自網路的資料在經過檢查之前並非你所宣告的型別,因此請在邊界處進行驗證,並讓應用程式的其餘部分信任驗證結果。

驗證

建置成功所代表的意義比表面上看起來少。許多專案會將框架配置為在建置時忽略 lint 和型別錯誤,因此在將建置結果當作證據之前,請檢查配置,並明確執行型別檢查和 linter。

然後實際使用該元件:測試空狀態、錯誤狀態、慢速網路,以及在第一次互動完成之前進行第二次快速互動。

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.

相關技能