前言¶
Go 項目的代碼風格問題通常分兩層。一層是 gofmt、go vet 這類工具能直接管住的，另一層是工具管不住的：錯誤處理的返回順序、接口返回值的語義、map 併發讀寫、context 傳遞、命名長度等。這些需要一份統一的、成文的規範，再靠 review 時逐條對照。
麻煩在於，規範本身不容易統一。團隊裏常見的做法是貼一篇英文風格指南在 wiki 裏，實際執行時靠各人記憶，評審標準隨人而異。另一種做法是直接照抄某家公司的規範，但原文面向其內部項目結構，落到自己的倉庫裏會出現”寫了也做不到”的條款。
下面介紹的這個 Skill，就是把 Uber Go 風格指南整理成中文學習與工程落地參考，用於在代碼評審環節給出一致的修改意見。
這是什麼¶
一句話定位：面向 Go 項目的編碼規範知識庫，內容以 Uber Go 風格指南的中文整理爲核心，用於人工或在 Agent 協作中做代碼評審時的規範依據。
- 名稱：Go 編碼規範 工程實踐 代碼審查
- 座標：
@user_a10ab3ad/uber-go-guide-pl - 分類：
dev-programming - 來源：community（社區發佈，非平臺官方出品）
- 發佈者：
user_a10ab3ad - 版本：1.0.1
- 是否需要 API Key：不需要（
requires_api_key=false） - 官方地址：https://api.skillhub.cn/user_a10ab3ad/uber-go-guide-pl
它解決的不是”把代碼格式化”這件事（那是 gofmt/goimports 的範疇），而是”這段代碼爲什麼不符合團隊規範、應該怎麼改”的判定與表達問題。
核心能力¶
根據官方頁面給出的簡介，這個 Skill 提供的能力是：
- Uber Go 風格指南的中文表述。原文爲英文，直接在評審意見裏引用英文條款，團隊成員的理解成本較高；整理成中文後，意見可以貼具體的規範條目而不是籠統地說”這裏不太好”。
- 工程落地參考。即把指南中的條款對應到實際代碼寫法上，而不是隻講原則。
- 代碼審查場景。Skill 名稱中的”代碼審查”指明瞭主要使用場景：在 review 過程中產出結構化的修改建議。
需要注意的是，官方頁面對能力的說明只到這一層，沒有列出更細的功能清單（例如是否包含 lint 配置、是否提供修改補丁、是否覆蓋併發/錯誤處理等具體章節）。這部分內容無法從現有資料覈實，本文不做推斷。
安裝與啓用¶
官方資料中沒有提供一行式的安裝命令（如 npx、curl 或 npm 包名），只有 SkillHub 上的座標與頁面地址。因此可用的啓用方式是：在支持通用 SKILL.md 格式的 Agent 環境中，把該 Skill 從 SkillHub 加載/添加後啓用。
座標：@user_a10ab3ad/uber-go-guide-pl
版本：1.0.1
來源：community
分類：dev-programming
關於不同編輯器的差異：現有資料沒有分別給出 Cursor、Codex CLI、Claude Code 的安裝路徑。這類 Skill 基於通用 SKILL.md 格式，但各環境的 Skill 加載機制並不完全一致（有的是在項目根目錄放 SKILL.md，有的是通過命令行添加），具體做法請以你所用環境的官方文檔爲準，本文不做未經覈實的配置說明。
另外，requires_api_key=false 說明該 Skill 的運行不依賴外部付費模型 API Key，可以直接使用。
典型用法¶
官方資料中沒有給出可直接復現的調用示例（例如具體 prompt 寫法或輸入輸出樣例），因此本節不給虛構示例，只說明它在流程裏的位置：
- 評審前：把待評審的 Go 文件作爲上下文，說明”按 Uber Go 風格指南檢查”。
- 評審中：Skill 依據規範條目逐條給出意見，指向具體行或寫法。
- 評審後：作者按意見修改，再複覈。
上面是使用方式的一般描述，不是官方提供的樣例。若要確認具體調用形式，建議直接打開官方頁面查看其說明。
適用場景與注意¶
適合的場景：
- 使用 Go 的團隊，希望在代碼評審中統一風格判定標準。
- 新成員上手時，需要一個可查閱的中文規範條目來源，而不是散落在聊天記錄裏的口頭約定。
- 在 Agent 協作的評審流程裏，需要一個有明確出處的規範依據，便於作者追溯和反駁。
需要注意的限制：
- 它不是 linter。 能用
gofmt、goimports、staticcheck、go vet自動檢查的部分，仍應由工具完成；這個 Skill 的價值在於工具覆蓋不到的那部分規範判斷。 - 條款需結合自身項目裁剪。 Uber 的規範服務於其代碼規模與組織方式，某些條款（例如大量接口返回值約定、context 傳遞細節）在小體量項目裏可能過重，照抄會帶來不必要的成本。
- 資料未覆蓋的部分不要假定存在。 官方頁面沒有列出章節目錄、沒有給安裝命令、沒有給使用樣例，也沒有說明是否隨附配置文件。
結尾¶
這個 Skill 的價值在於把 Uber Go 風格指南變成中文的、可引用的評審依據，而不是替代工具鏈。它適合作爲團隊 Go 規範的落地層，配合 gofmt 等工具一起使用。
官方地址：https://api.skillhub.cn/user_a10ab3ad/uber-go-guide-pl
