Communitygithub.com

sujith011/agentic-pro-skills 前端狀態管理

設計或修復客戶端、URL 和伺服器狀態的所有權,包括請求競態、樂觀更新和會話變更。

agentic-pro-skills 前端狀態管理 是什麼?

這項技能專門處理前端狀態管理中的複雜所有權問題。它幫助開發者釐清每個資料值的歸屬—究竟是持久化伺服器資料、可共享的 URL/導航狀態、表單草稿,還是暫時性的呈現狀態,並為每個值選擇唯一的權威擁有者。技能涵蓋了請求競態(例如先發後到的請求)、樂觀更新(先顯示結果再與伺服器同步)以及會話變更(登出、租戶切換、身分變更)等典型難題。它支援所有主流前端框架,並要求明確建模載入、空、錯誤和成功等狀態。對於競態請求,建議透過取消請求減少工作量,同時保護結果接受邏輯,避免舊回應覆蓋新意圖。樂觀更新後必須與伺服器協調,並定義失敗行為,確保回滾不會抹掉後續成功的變更。驗證場景包括前進/後退導航、重試、快速輸入變更、失敗的變更操作以及帳戶切換。技能遵循「不要為了解決局部競態而更換狀態庫」和「不要將同一個伺服器值複製到多個獨立全域 Store 中」的停止條件。

相容平台✓Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/sujith011/agentic-pro-skills/tree/HEAD/skills/frontend-state

在你喜歡的 AI 中提問

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

說明文件

前端狀態

流程

  1. 分類每個值:持久化伺服器資料、可共享的 URL/導航狀態、表單草稿,或暫時性的呈現狀態。為每個值選擇一個權威的擁有者。
  2. 重複使用已安裝的狀態/資料擷取工具。將本地狀態保持在它的消費者附近;只有在需要具體協調時才引入共享狀態。
  3. 根據所有查詢和授權維度來鍵入伺服器快取。在登出、租戶切換和身分變更時清除或隔離它們。
  4. 明確建模載入、空、錯誤和成功狀態。對於並行請求,取消可以減少工作量,但也應保護結果接受邏輯,使舊回應不能取代新意圖。
  5. 對於樂觀變更,與伺服器協調並定義失敗行為。回滾不得抹掉後續成功的變更;追蹤操作或使用函式庫支援的並行模式。
  6. 驗證前進/後退導航、重試、快速輸入變更、失敗的變更操作和帳戶切換。

範例

搜尋 A 然後搜尋 B,B 先返回而 A 後返回。顯示的結果保持為 B,URL 反映的是當前搜尋而非回應完成的順序。

停止條件

不要為了解決局部競態而更換狀態庫。將同一個伺服器值複製到多個獨立的全域 Store 中會造成同步責任。

證據

  • 狀態所有權圖和快取鍵。
  • 競態/回滾/會話轉換檢查。
  • 可見的載入和復原行為。

參考

此工作流程是在審閱 react-state-management 後獨立撰寫的。

相關技能