opencode-workflow/skills/storage-knowledge/README.zh-TW.md

1.6 KiB
Raw Permalink Blame History

儲存知識 (Storage Knowledge) 知識合約指南

概述

storage-knowledge 是知識合約,用來提供儲存技術選擇的原則與框架。涵蓋關聯式、寬列式、文件式與鍵值式儲存,並提供 Use-When 與 Avoid-When 判斷標準。供 design-architecture 在做儲存決策時參考。

核心原則

儲存選擇必須由 PRD 中識別的查詢模式、寫入模式、一致性需求與規模預期驅動。不要因為熟悉、時尚或覺得可能需要就選擇儲存技術。

儲存選擇標準

選擇儲存前,必須先回答:

  1. 主要查詢模式是什麼?(按鍵、按範圍、按複雜過濾、全文搜索)
  2. 寫入模式是什麼?(寫入為主、更新為主、僅附加)
  3. 需要什麼一致性Strong、Eventual、Tunable
  4. 預期規模是多少?(每天列數、總列數、生長率)
  5. 存取延遲需求是什麼?(毫秒、秒、最終一致)
  6. 與其他實體的關係是什麼?(外鍵、嵌套文件、圖形遍歷)

儲存類型

  • Relational (PostgreSQL):強一致性、複雜 JOIN、交易完整性
  • Wide-Column (Cassandra):高寫入吞吐量、查詢優先建模、線性水平擴展
  • Document (MongoDB)文件中心資料、Schema 彈性、豐富查詢能力
  • Key-Value (Redis)快取、速率限制、Idempotency Keys、工作階段

知識合約職責

  • 提供各儲存技術的比較與選擇框架
  • 不替 PRD 做最終儲存選擇

不應做的事

  • 不替系統選擇特定儲存技術
  • 不基於時尚或流行選擇儲存
  • 不假設某種儲存適合所有場景