Go Patterns
測定済み: 現在の最先端かつ小型の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)
}()
}
コンテキスト伝搬
コンテキストは常に最初のパラメータとして渡します:
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("テストDBのオープンに失敗しました: %v", err)
}
// ":memory:" データベースは単一の接続に対してプライベートであり、database/sql
// は遅延プールです。これがないと、プールされた各接続は独自の空のデータベースを
// 取得し、ある接続で作成されたテーブルが次の接続では欠落します。
// プールを1つの接続に固定することで、テスト全体が1つのインメモリDBを共有します。
// 注意: 単一接続の場合、トランザクション(db.Begin)が開かれている間、そのトラン
// ザクションが唯一の接続を保持します。すべての作業をトランザクション経由で行い、
// Commit/Rollback まで行ってください。プールに対する同時の db.Query は、それが
// 解放されるのを待ってブロックされます。テストで複数のライブ接続が本当に必要な場合
// は、代わりに共有キャッシュDSN("file:testdb?mode=memory&cache=shared")を
// 使用し、インメモリDBがドロップされないように1つ以上の接続を開いたままにしてください。
db.SetMaxOpenConns(1)
t.Cleanup(func() { db.Close() })
return db
}
このスキルを使用するタイミング
- GoのAPIとパッケージを設計するとき
- 並行処理システムを実装するとき
- Goプロジェクトを構築するとき
- 慣用的なGoコードを書くとき
- Goコードベースをリファクタリングするとき