certification-proflie

此技能作為一個綜合性的專案指南模板，專為構建複雜、AI 整合應用程式的工程團隊而設計。它提供了一個標準化的框架，幫助開發人員在架構決策、檔案結構和編碼模式上保持一致，特別適用於涉及 Next.js、FastAPI、Supabase 和 Claude API 的現代技術棧。透過將這些標準編碼化，該技能可協助團隊最大限度地減少技術債，簡化新成員的入職流程，並確保在開發、測試和生產部署生命週期中維持一致的品質。

• 標準化的架構概覽：整合了前端 (Next.js 15, TypeScript)、後端 (FastAPI, Python) 和資料庫 (Supabase) 配置，以確保系統級的一致性。

• 最佳實踐編碼模式：包含用於結構化 API 回應、前端資料獲取 Hook 以及強大的 Claude AI 結構化輸出整合之可重用實作。

• 系統化測試需求：定義了使用 Playwright 進行端到端測試、使用 pytest 進行單元/整合測試以及覆蓋率報告的明確協定。

• 部署與維護流程：記錄了 Google Cloud Run 的部署策略和配置管理，以促進可靠的生產版本發佈。

• 可擴展的專案模板：作為可適應任何軟體專案的基礎，允許團隊注入其特定的限制和模式。

• 適用於需要在大規模或多服務程式碼庫中強制執行一致性的軟體架構師與首席開發人員。

• 在啟動新專案模組、引導新團隊成員或進行架構審查時使用此技能。

• 輸入通常包括專案需求與技術限制；輸出則是已建立的編碼標準與系統設計文件。

• 限制：使用者必須根據當前的儲存庫狀態維護文件，以確保其保持為可靠的唯一真實來源。

• 確保所有架構決策皆附有架構決策記錄 (ADR)，以追蹤系統隨時間的演變。