Communitygithub.com

lawzava/megapowers

技能、插件與鉤子,用於改變編碼代理的工作方式 — Claude Code、Codex、OpenCode、Antigravity。可量化評估,不靠感覺。

megapowers 是什麼?

此技能「Go Patterns」是一套專為 Go 語言設計的模式與慣例,適用於 Claude Code、Codex、OpenCode 等編碼代理。它不僅涵蓋常見的並發機制(如工作者池、管線階段、通道關閉),更專注於設計決策——介面定義、依賴注入、錯誤處理、套件佈局——作為檢核查核清單,或是在驅動較弱模型時使用。技能基於實際研究(184/184 測試皆通過),確認當前模型在不使用此技能時已能正確處理基本並發語法,因此其主要價值在於協助開發者做出更好的架構選擇。支援平台包括 Claude Code、Codex、OpenCode、Antigravity。

相容平台✓Claude Code✓Codex CLI~Cursor✓Antigravity✓OpenCode
npx skills add lawzava/megapowers

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Go 模式

可量化評估: 當前前沿 和 小型 Claude 模型已經能在不借助此技能的情況下,單次正確寫出常見的並發機制(工作者池、管線階段、通道關閉)——一項對照研究發現正確性提升空間為零,兩組均通過 184/184 個測試(該儲存庫的 evals/RESULTS.md 第 2 節)。請在需要設計選擇時——介面、依賴接線、錯誤塑形、套件佈局——作為檢核查核清單,或驅動較弱模型時使用此技能;而非因為當前模型會導致死鎖。

範圍:Go 檔案、go.mod 與 go.sum。 來源:衍生自 Everything Claude Code (MIT,(c) 2026 Affaan Mustafa)。

此技能提供全面的 Go 模式,將常見設計原理延伸為 Go 特定的慣用寫法。

函數選項模式

使用函數選項模式以實現靈活的建構子配置:

type Option func(*Server)

func WithPort(port int) Option {
    return func(s *Server) { s.port = port }
}

func NewServer(opts ...Option) *Server {
    s := &Server{port: 8080}
    for _, opt := range opts {
        opt(s)
    }
    return s
}

優點:

  • 向後相容的 API 演化
  • 可選參數附帶預設值
  • 自我說明的配置

小型介面

在使用介面的地方定義介面,而非在實作介面的地方。

原則: 接受介面,回傳結構體

// 良好:小巧、聚焦的介面,在使用點定義
type UserStore interface {
    GetUser(id string) (*User, error)
}

func ProcessUser(store UserStore, id string) error {
    user, err := store.GetUser(id)
    // ...
}

優點:

  • 更易於測試與模擬
  • 鬆散耦合
  • 清晰的依賴關係

依賴注入

使用建構子函數注入依賴:

func NewUserService(repo UserRepository, logger Logger) *UserService {
    return &UserService{
        repo:   repo,
        logger: logger,
    }
}

模式:

  • 建構子函數(New* 前綴)
  • 明確的依賴作為參數
  • 回傳具體型別
  • 在建構子中驗證依賴

並發模式

工作者池

func workerPool(jobs <-chan Job, results chan<- Result, workers int) {
    var wg sync.WaitGroup
    for i := 0; i < workers; i++ {
        wg.Add(1)
        go func() {
            defer wg.Done()
            for job := range jobs {
                results <- processJob(job)
            }
        }()
    }
    // 在所有工作者完成後關閉 results——在一個獨立的 goroutine 中執行,這樣此函數
    // 就能立即返回,呼叫者可以在工作者仍在產生結果時對 results 進行 range。
    // 內聯的 wg.Wait() 會導致死鎖:工作者在將資料傳送至 results 時會阻塞,直到有讀取者消耗它,
    // 但讀取者只有在 workerPool 返回後才會執行。
    go func() {
        wg.Wait()
        close(results)
    }()
}

上下文傳播

始終將 context 作為第一個參數傳遞:

func FetchUser(ctx context.Context, id string) (*User, error) {
    // 檢查上下文取消
    select {
    case <-ctx.Done():
        return nil, ctx.Err()
    default:
    }
    // ... 取得邏輯
}

錯誤處理

錯誤包裝

if err != nil {
    return fmt.Errorf("無法取得使用者 %s:%w", id, err)
}

自訂錯誤

type ValidationError struct {
    Field string
    Msg   string
}

func (e *ValidationError) Error() string {
    return fmt.Sprintf("%s:%s", e.Field, e.Msg)
}

哨兵錯誤

var (
    ErrNotFound = errors.New("未找到")
    ErrInvalid  = errors.New("無效輸入")
)

// 使用 errors.Is 檢查
if errors.Is(err, ErrNotFound) {
    // 處理未找到的情況
}

套件組織

結構

project/
├── cmd/              # 主要應用程式
│   └── server/
│       └── main.go
├── internal/         # 私有應用程式碼
│   ├── domain/       # 業務邏輯
│   ├── handler/      # HTTP 處理器
│   └── repository/   # 資料存取
└── pkg/              # 公開函式庫

命名慣例

  • 套件名稱:小寫,單一單詞
  • 避免重複:user.User 而非 user.UserModel
  • 使用 internal/ 存放私有程式碼
  • 保持 main 套件儘量精簡

測試模式

表格驅動測試

func TestValidate(t *testing.T) {
    tests := []struct {
        name    string
        input   string
        wantErr bool
    }{
        {"有效", "[email protected]", false},
        {"無效", "not-an-email", true},
    }

    for _, tt := range tests {
        t.Run(tt.name, func(t *testing.T) {
            err := Validate(tt.input)
            if (err != nil) != tt.wantErr {
                t.Errorf("取得錯誤 %v,預期 wantErr %v", err, tt.wantErr)
            }
        })
    }
}

測試輔助函數

// 匯入純 Go 驅動程式:_ "modernc.org/sqlite"(註冊為 "sqlite")。
// 請勿使用 "sqlite3"(mattn/go-sqlite3)——它需要 CGO 且會破壞 CGO_ENABLED=0
// 的靜態建置。greenfield-go-stack 套裝要求純 Go / 無 CGO。
func testDB(t *testing.T) *sql.DB {
    t.Helper()
    db, err := sql.Open("sqlite", ":memory:")
    if err != nil {
        t.Fatalf("無法開啟測試資料庫:%v", err)
    }
    // ":memory:" 資料庫對單一連線是私有的,而 database/sql
    // 是一個惰性連線池:若不這麼做,每個連接池中的連線都會獲得自己獨立的空資料庫,
    // 因此在一個連線上建立的表格,在下一個連線上會找不到。
    // 將連線池固定為一個連線,可使整個測試共用一個記憶體中的 DB。
    // 注意:使用單一連線時,若有一個事務處於開啟狀態(db.Begin),
    // 該事務會獨佔該連線——所有工作都要透過該事務進行,直到 Commit/
    // Rollback;同時對連線池進行的 db.Query 會阻塞等待。如果測試真的需要多個即時連線,
    // 請改用共享快取 DSN("file:testdb?mode=memory&cache=shared")
    // 並保持至少一個連線開啟,以避免記憶體中 DB 被釋放。
    db.SetMaxOpenConns(1)
    t.Cleanup(func() { db.Close() })
    return db
}

何時使用此技能

  • 設計 Go API 與套件
  • 實作並發系統
  • 組織 Go 專案結構
  • 編寫慣用的 Go 程式碼
  • 重構 Go 程式碼庫

相關技能