creating-windsurf-packages

此技能為開發人員與 AI 代理提供了一個標準化框架，用於建立、維護與優化 Windsurf IDE 的規則。作為 PRPM 生態系統的一部分，它確保您的專案特定準則保持在 Windsurf 強制執行的硬性限制內，特別是 12,000 個字元的上限以及強制性的單一檔案結構（.windsurf/rules）。對於維護高品質、專案特定的上下文而不觸發系統錯誤或超過儲存預算來說，這是必備工具。

• 強制執行符合 .windsurf/rules 單一檔案架構的規範。

• 提供針對專案特定模式、技術堆疊文件與程式碼編寫慣例的模板。

• 提供字元優化策略，協助您在精簡冗餘或通用最佳實踐的同時，優先保留關鍵資訊。

• 促進將舊有規則集遷移至 Windsurf 所需的優化、無前言（frontmatter）的 Markdown 格式。

• 包含在實作前檢查字元數的驗證工作流程。

• 在初始化新專案或引導新開發人員進入基於 Windsurf 的工作流程時使用此技能。

• 非常適合記錄目錄結構、狀態管理（如 Zustand）、測試模式（如 React Testing Library）以及 API 客戶端設定。

• 請始終保持檔案結構平坦，並避免使用 YAML 前言以防止解析錯誤。

• 如果您的規則集接近 12,000 字元限制，請使用提供的壓縮技術，例如連結至外部文件，或專注於程式碼庫中獨有的差異模式。

• 定期執行 wc -m .windsurf/rules 以監控剩餘字元額度，確保未來專案擴展有足夠空間。

• 最適合需要確保其 AI 程式碼助手與團隊標準及架構需求保持一致的技術主管與工程師。