cc-skill-project-guidelines-example

專案指南技能作為將領域特定工程標準嵌入 AI 程式碼編寫代理的基礎模板。它使開發人員能夠記錄專案的關鍵架構、技術堆疊和約定，確保代理充當確定性的助手，而不是錯誤程式碼的來源。此技能專為複雜的生產環境而設計，例如使用 Next.js、FastAPI、Supabase 和 Claude API 的系統。透過提供關於檔案結構、API 回應格式和測試要求的明確指導，它幫助團隊在大型軟體專案中保持一致性。

• 封裝架構概覽，包括前端和後端服務通訊模式。

• 標準化程式碼模式，例如 API 回應包裝器、用於狀態管理的 React Hooks 以及結構化的 AI 工具使用方式。

• 定義檔案結構約定，例如路由邏輯、組件組織和公用程式放置位置。

• 嵌入測試要求，包括對 Playwright、pytest 和整合測試的要求，以確保程式碼驗證。

• 提供用於記錄部署工作流程和組態管理的強大框架。

• 非常適合管理生產環境中複雜代理工作流程的團隊主管和架構師。

• 適用於引導新開發人員，或使用具有特定組織知識的自動化程式碼編寫助手進行設定。

• 輸入包括您的具體專案結構和指南，而輸出則為代理提供了一個指導其程式碼生成的「單一事實來源」。

• 限制：當本地文件與儲存庫保持同步時可獲得最佳結果；依賴於對定義架構的嚴格遵守以防止偏離。建議與其他專門的代理套件一起使用，以確保全面涵蓋專案領域和營運需求。