開發技能

結構化 git 工作流程實務。在進行任何程式碼變更時使用。在提交、分支、解決衝突，或需要跨多個平行串流組織工作時使用。在進行版本發布、選擇語意化版本升級、標記標籤或撰寫變更日誌時使用。

當使用者詢問如何撰寫、解釋、自訂、遷移、保護或疑難排解 GitHub Actions 工作流程、工作流程語法、觸發器、矩陣、執行器、可重複使用工作流程、成品、快取、密碼、OIDC、部署、自訂動作或 Actions Runner Controller 時使用，特別是當他們需要官方 GitHub 文件、精確連結或基於文件的 YAML 指引時。

將原始筆記、錯誤日誌、語音聽寫或截圖轉換為清晰的GitHub風格Markdown問題報告。當用戶貼上錯誤資訊、錯誤訊息或非正式描述並希望獲得結構化的GitHub問題時使用。支援圖片/GIF作為視覺證據。

Golang 基準測試、效能剖析與效能測量。適用於撰寫、執行或比較 Go 基準測試，使用 pprof 對熱點路徑進行效能剖析，解讀 CPU/記憶體/追蹤分析結果，透過 benchstat 分析結果，設定 CI 基準測試回歸檢測，或使用 Prometheus 執行時期指標調查生產環境效能。也適用於開發者需要針對特定效能指標進行深入分析時——此技能提供測量方法論，同時...

We need to translate the given text from English to Traditional Chinese. The text describes a skill for Golang CLI application development. We must preserve the name "golang-cli" if it appears, but it does not appear in the source text. The source text includes "golang-cli" only in the instruction, not in the text to translate. So we just translate the text. Also preserve product names like "cobra", "viper", "urfave/cli", and the reference to "samber/cc-skills-golang@golang-spf13-cobra". No extra commentary, no labels. Output only the translation. Translation: Golang CLI 應用程式開發。在建立、修改或審查 Go CLI 工具時使用——特別是命令結構、旗標處理、配置層疊、版本嵌入、退出碼、I/O 模式、訊號處理、Shell 自動補全、引數驗證以及 CLI 單元測試。當程式碼使用 cobra、viper 或 urfave/cli 時也會觸

Golang code style conventions — line length and breaking, variable declarations, control flow clarity, when comments help vs hurt. Use when writing or reviewing Go code, asking about style or clarity, or establishing project coding standards. Not for naming conventions (→ See `samber/cc-skills-golang@golang-naming` skill), linter configuration (→ See `samber/cc-skills-golang@golang-lint` skill), or doc comments (→ See `samber/cc-skills-golang@golang-documentation` skill).

Golang 並發模式。在撰寫或審查涉及 goroutine、channel、select、鎖、同步原語、errgroup、singleflight、工作者池或扇出/扇入管線的並發 Go 程式碼時使用。當偵測到 goroutine 洩漏、競態條件、channel 所有權問題，或需要在 channel 與 mutex 之間做出選擇時，也會觸發。

在 Golang 中慣用的 context.Context 使用方式 — 透過 API 邊界傳播、取消、超時與截止時間、請求範圍的值、用於背景工作的 context.WithoutCancel 以延續請求生命週期。適用於設計跨層級的 context 傳播、偵測洩漏或未過期的 context、在 context.Background/TODO/WithoutCancel 之間選擇，或將值存入 context。不適用於僅將 ctx 作為第一個參數的程式碼。

使用 GitHub Actions 為 Golang 專案配置 CI/CD 管道 — 包含測試、程式碼檢查、SAST、安全掃描、程式碼覆蓋率、Dependabot、Renovate、GoReleaser、程式碼審查自動化以及發布管道。適用於設定或改善 Go 專案的 CI、配置 GitHub Actions 工作流程、加入程式碼檢查工具或安全掃描器、自動化相依性更新，或加入品質關卡。

Golang 資料結構 — 切片（內部機制、容量增長、預先分配、slices 套件）、映射（內部機制、雜湊桶、maps 套件）、陣列、container/list/heap/ring、strings.Builder 與 bytes.Buffer 比較、泛型集合、指標（unsafe.Pointer、weak.Pointer）以及複製語義。適用於選擇或最佳化 Go 資料結構、實作泛型容器、使用 container/ 套件、unsafe 或 weak 指標，或探討切片/映射內部機制時。

Go 資料庫存取的全面指南 — 參數化查詢、結構掃描、可空欄位、交易、隔離層級、SELECT FOR UPDATE、連線池、批次處理、上下文傳遞與遷移工具。適用於撰寫、審查或除錯與 PostgreSQL、MariaDB、MySQL 或 SQLite 互動的 Golang 程式碼；資料庫測試；或關於 database/sql、sqlx 或 pgx 的問題。不產生資料庫結構或遷移 SQL。

Go語言中依賴注入（DI）的全面指南。涵蓋DI的重要性（可測試性、鬆散耦合、關注點分離、生命週期管理）、手動建構子注入，以及DI函式庫比較（google/wire、uber-go/dig、uber-go/fx、samber/do）。在設計服務架構、設定依賴注入、重構緊密耦合程式碼、管理單例或服務工廠，或當使用者詢問控制反轉、服務等問題時，使用此技能。

Golang 專案的依賴管理策略 — go.mod 管理、安裝/升級套件、最小版本選擇、漏洞掃描、過時依賴追蹤、二進位檔大小分析、Dependabot/Renovate 設定、衝突解決以及 go.work 工作區。適用於新增、移除或升級 Go 依賴、審查漏洞、解決版本衝突，或設定自動化依賴更新時使用。

符合慣例的 Golang 設計模式 — 函數選項、建構子、錯誤流程與串聯、資源管理與生命週期、優雅關閉、韌性、架構、依賴注入、資料處理、串流等。適用於明確選擇架構模式、實作函數選項、設計建構子 API、設定優雅關閉、應用韌性模式，或詢問哪種慣用 Go 模式適合特定問題時。

Golang 專案的全面文件指南，涵蓋 godoc 註解、README、CONTRIBUTING、CHANGELOG、Go Playground、範例測試、API 文件及 llms.txt。適用於撰寫或審查文件註解、文件內容、新增程式碼範例、設定文件網站，或討論文件最佳實務。同時適用於函式庫與應用程式/命令列工具。

We need to translate the given text from English to Traditional Chinese. The text is about Golang error handling. We must preserve the name "golang-error-handling" but it's not in the text, so we don't include it. Also preserve technical terms like %w, errors.Is/As, errors.Join, panic/recover, slog, samber/oops, etc. No extra commentary, no labels. Just the translation. Let's translate sentence by sentence: "Idiomatic Golang error handling — creation, wrapping with %w, errors.Is/As, errors.Join, custom error types, sentinel errors, panic/recover, the single handling rule, structured logging with slog, HTTP request logging middleware, and samber/oops for production errors." Translation: "慣用的 Golang 錯誤處理 — 建立、使用 %w 包裝、errors.Is/As、errors.Join、自訂錯誤類型、哨兵錯誤、panic/recover、單一處理規則、使用 slog 的結構化日誌、HTTP 請求日誌中介軟體

在 Golang 中使用 google/wire 進行編譯時期依賴注入 — wire.NewSet、wire.Build、wire.Bind（介面→具體實作）、wire.Struct、wire.Value、wire.InterfaceValue、wire.FieldsOf、清理函式、//go:build wireinject 注入器

Implements GraphQL APIs in Golang using gqlgen or graphql-go. Apply when building GraphQL servers, designing schemas, writing resolvers, handling subscriptions, or integrating GraphQL with existing Go HTTP services. Also apply when the codebase imports `github.com/99designs/gqlgen` or `github.com/graph-gophers/graphql-go`.

提供gRPC使用指南、protobuf組織方式，以及適用於Golang微服務的生產級模式。適用於實作、審查或除錯gRPC伺服器/客戶端、撰寫proto檔案、設定攔截器、使用狀態碼處理gRPC錯誤、配置TLS/mTLS、使用bufconn進行測試，或處理串流RPC時使用。

Golang 技能編排器 — 在任何 Golang 編碼、審查、除錯或設定任務中始終保持啟用。讀取任務上下文並從 samber/cc-skills-golang 載入最相關的技能，通常一次載入多個：撰寫 gRPC 服務時載入 golang-grpc + golang-testing + golang-error-handling；除錯 panic 時載入 golang-troubleshooting + golang-safety；審查安全性時載入 golang-security + golang-lint + golang-safety。此外：當兩個技能看似重疊時，消除競爭叢集的歧義...

針對 Golang 專案的 lint 最佳實務與 golangci-lint 配置 — 執行 linter、設定 .golangci.yml、使用 nolint 指令抑制警告、解讀 lint 輸出，以及選擇 linter。適用於配置 golangci-lint、詢問 lint 警告或 nolint 抑制方式、設定程式碼品質工具，或挑選 linter 時。亦適用於使用者提及 golangci-lint、go vet、staticcheck 或 revive 時。

golang-linter — 一個可安裝的 AI 代理技能。

將 Golang 程式碼現代化，使用最新的語言特性、標準函式庫改進及慣用模式。在撰寫或審查 Go 程式碼時，若偵測到舊式模式或遇到棄用警告，應主動觸發。當使用者明確要求現代化、Go 版本升級或 CI/工具鏈更新時，也應採用。

Go (Golang) 命名慣例 — 涵蓋套件、建構子、結構體、介面、常數、列舉、錯誤、布林值、接收器、getter/setter、函數選項、縮寫、測試函數及子測試名稱。在撰寫新 Go 程式碼、進行程式碼審查或重構、選擇命名替代方案（New 與 NewTypeName、isConnected 與 connected、ErrNotFound 與 NotFoundError、StatusReady 與 StatusUnknown 在 iota 0 時）、討論 Go 套件名稱（utils/helpers 反模式）時，可使用此技能。

Golang 日常可觀測性 — 生產環境中始終開啟的信號。涵蓋使用 slog 的結構化日誌、Prometheus 指標、OpenTelemetry 分散式追蹤、使用 pprof/Pyroscope 的持續效能分析、伺服器端 RUM 事件追蹤、警報以及 Grafana 儀表板。適用於為生產監控檢測 Go 服務、設定指標或警報、新增 OpenTelemetry 追蹤、將日誌與追蹤關聯、將舊版日誌程式（zap/logrus/zerolog）遷移至 slog、新增...

Golang 性能優化模式與方法論 - 若遇到 X 瓶頸，則應用 Y。涵蓋減少分配、CPU 效率、記憶體佈局、GC 調校、池化、快取以及熱路徑優化。適用於當性能分析或基準測試已識別出瓶頸，且需要正確的優化模式來解決時。亦適用於進行性能代碼審查時，提出改進建議或可協助快速識別性能增益的基準測試。不適用於測量方法論（→...

推薦適合生產環境的 Golang 函式庫與框架。適用於使用者明確要求函式庫建議、想比較替代方案、需要為特定任務選擇函式庫，或專案中正在新增相依套件時。

提供設定 Golang 專案佈局與工作區的指引。適用於開始新的 Go 專案、整理現有程式碼庫、設定包含多個套件的單一儲存庫、建立含多個 main 套件的 CLI 工具、決定 cmd/internal/pkg 目錄慣例，或討論套件重構、套件拆分、模組拆分時使用。

防禦性Golang編碼，用於防止恐慌、靜態數據損壞及微妙的運行時錯誤。在遇到nil恐慌、追加別名、映射並發訪問、浮點數比較陷阱或零值設計問題時使用。亦適用於審查代碼中的nil安全性、數值轉換溢出、資源生命週期問題（循環中的defer），或切片與映射的防禦性拷貝。

在 Golang 中使用 samber/do 進行依賴注入 — 服務容器、生命週期管理、作用域、健康檢查、優雅關閉與模組組織。適用於使用或採用 samber/do 時、程式碼導入 github.com/samber/do 或 github.com/samber/do/v2 時，或將手動建構子注入重構為 DI 容器時。