go-concurrency-patterns

概覽

什麼是 go-concurrency-patterns？

go-concurrency-patterns 是一個實用技能，幫助你掌握 Go (Golang) 應用程式中的並發設計。涵蓋使用 goroutines、channels、同步原語（如 sync.Mutex 和 sync.WaitGroup）以及 context 管理取消與截止時間的核心模式。此技能專為需要構建、除錯或優化並發 Go 程式的後端與系統開發者設計。

誰適合使用這個技能？

• 開發並發或平行應用的 Go 工程師
• 實作工作池、資料管線或優雅關閉機制的工程師
• 處理競態條件或管理 goroutine 生命週期的團隊
• 尋求 Go 並發原語最佳實踐的任何人

解決的問題

• 在 Go 中安全且高效地執行並發
• 使用 channels 進行 goroutine 間通訊
• 管理同步並避免競態條件
• 利用 context 實作取消與逾時

使用方式

安裝步驟

1. 使用以下指令將技能加入你的 agent 或專案：

   npx skills add https://github.com/wshobson/agents --skill go-concurrency-patterns

2. 閱讀 SKILL.md 主要文件，獲得並發模式的導覽，包括程式碼範例與說明。

3. 探索相關檔案如 README.md、AGENTS.md 與 metadata.json，取得更多背景資訊、參考資料與整合說明。也可查看 rules/、resources/ 或 scripts/ 資料夾中的輔助資源。

調整並發模式

• 將提供的模式作為你 Go 專案的參考，依照應用架構與需求調整範例。
• 著重核心原語：使用 goroutines 實現並發、channels 進行通訊、context 管理生命週期。
• 運用 sync.Mutex 和 sync.WaitGroup 等同步工具，協調 goroutine 執行並避免資料競爭。

何時使用 go-concurrency-patterns

• 建構可擴展的後端服務或微服務
• 實作工作池、資料管線或並發處理任務
• 管理優雅關閉與資源清理
• 除錯或預防 Go 程式中的競態條件

常見問題

我應該先閱讀哪些檔案？

建議先從 SKILL.md 開始，獲得全面的概覽。接著查看 README.md 和 AGENTS.md，了解整合細節與進階用法。

這個技能有包含可執行的程式碼範例嗎？

有，文件中包含展示 Go 並發核心模式的實用程式碼片段。你可以依需求調整這些範例至自己的專案。

go-concurrency-patterns 適合初學者嗎？

此技能適合具備基本 Go 語言知識，想深化並發理解的開發者。內容包含概念說明與實務範例。

我在哪裡可以找到更多資源？

可瀏覽倉庫中的 resources/ 和 references/ 資料夾，獲取進階並發主題與延伸閱讀。

我該如何排解問題？

請參考 SKILL.md 中的程式碼範例與說明，辨識常見陷阱。並利用 Go 內建的競態偵測器與 context 管理工具進行除錯。

打開倉庫的檔案標籤，即可查看完整檔案結構，包括輔助腳本與巢狀參考資料。