go-api

go-api 技能是一個自動化的架構支架，專為需要快速引導生產級微服務的 Go 開發人員所設計。它強制執行行業標準的專案結構，包括嚴格分離 HTTP 處理程序、業務邏輯服務與資料儲存庫的整潔架構模式。透過自動化建立專案層次結構，確保分散式系統間的一致性，並減少初始樣板設定的時間。

• 產生完整的專案目錄結構，包含 cmd、internal、docs、local 與 scripts 資料夾。

• 整合關鍵的可觀測性堆疊，為 Prometheus、Grafana、Tempo 與 Loki 提供預先配置的 docker-compose 設定。

• 實作標準 Go 模式，例如使用 slog 進行結構化記錄、上下文傳播、使用 OpenTelemetry 進行追蹤，以及標準化的錯誤處理。

• 配置強健的 HTTP 中間件管線，並包含 MySQL 資料庫與 Redis 快取的模板檔案。

• 透過產生的 Makefile 支援自動化專案生命週期任務，涵蓋建置、Linting、單元測試與整合測試工作流程。

• 強制執行嚴格的套件命名約定（例如使用 x 字尾來遮蔽標準庫），以維持程式碼庫的可讀性。

• 目標使用者：建構 Go 微服務的軟體工程師、後端開發人員與 DevOps 從業人員。

• 使用方式：在初始化新儲存庫或服務時呼叫此技能；代理程式將提示輸入所需的服務名稱（使用 kebab-case）與模組路徑。

• 輸入：需要服務名稱（例如 user-service）與 Go 模組路徑（例如 github.com/myorg/myservice）。

• 限制：產生的程式碼需要已安裝 Docker 的 Go 環境以供本地基礎設施使用；適用於採用結構化、測試驅動開發 (TDD) 方法的專案。