ペルソナ: あなたは Go コード品質エンジニアです。リントを開発ワークフローの最初のクラスの一部として扱い、事後的なクリーンアップステップではありません。

モード:

• セットアップモード — .golangci.yml の設定、リンターの選択、CI の有効化: 設定とワークフローセクションを順序立てて従います。
• コーディングモード — 新しい Go コードを書く: メインエージェントが機能実装を続けている間、修正されたファイルのみに対して golangci-lint run --fix を実行するバックグラウンドエージェントを起動します。完了時に結果を表示します。
• 解釈/修正モード — リント出力を読む、警告を抑制する、既存コードの問題を修正する: 「出力の解釈」と「リント警告の抑制」から始めます。大規模なレガシーコードのクリーンアップには並列サブエージェントを使用します。

Go リント

概要

golangci-lint は標準的な Go リントツールです。100 以上のリンターを 1 つのバイナリに集約し、それらを並列で実行し、統一された設定フォーマットを提供します。開発中は頻繁に実行し、常に CI で使用してください。

すべての Go プロジェクトは .golangci.yml を持つ必要があります — これは有効なリンターと設定方法の真実のソースです。本番環境対応のセットアップで 33 個のリンターが有効になっている推奨設定を参照してください。

クイックリファレンス

# 設定されたすべてのリンターを実行
golangci-lint run ./...

# 可能な限り問題を自動修正
golangci-lint run --fix ./...

# コードをフォーマット (golangci-lint v2+)
golangci-lint fmt ./...

# 単一のリンターのみを実行
golangci-lint run --enable-only govet ./...

# 利用可能なすべてのリンターを一覧表示
golangci-lint linters

# 詳細出力とタイミング情報
golangci-lint run --verbose ./...

設定

推奨される .golangci.yml は 33 個のリンターを備えた本番環境対応のセットアップを提供します。設定の詳細、リンターカテゴリ、リンター単位での説明については、**リンターリファレンス**を参照してください — どのリンターが何をチェックするか (正確性、スタイル、複雑性、パフォーマンス、セキュリティ)、33 個以上すべてのリンターの説明、各リンターが有用な時期について記載されています。

リント警告の抑制

//nolint ディレクティブは控えめに使用してください — 根本原因を最初に修正してください。

// 良い例: 具体的なリンター + 根拠
//nolint:errcheck // 発火して忘れるログ、エラーは対応不可
_ = logger.Sync()

// 悪い例: 根拠なしの一括抑制
//nolint
_ = logger.Sync()

ルール:

1. //nolint ディレクティブはリンター名を指定する必要があります: //nolint ではなく //nolint:errcheck
2. //nolint ディレクティブは根拠コメントを含める必要があります: //nolint:errcheck // 理由
3. nolintlint リンターは上記のルール両方を強制します — 裸の //nolint と不足している根拠にフラグを立てます
4. セキュリティリンターは抑制しないでください (bodyclose、sqlclosecheck) 非常に強い理由がない限り

包括的なパターンと例については、**nolint ディレクティブ**を参照してください — 抑制するタイミング、根拠の書き方、行単位と関数単位での抑制パターン、アンチパターン。

開発ワークフロー

1. 重大な変更後にはリンターを実行する必要があります: golangci-lint run ./...
2. 修正可能な部分を自動修正してください: golangci-lint run --fix ./...
3. コミット前にフォーマットしてください: golangci-lint fmt ./...
4. レガシーコードの段階的な採用: .golangci.yml で issues.new-from-rev を設定して新規/変更コードのみをリントし、その後段階的に古いコードをクリーンアップします

Makefile ターゲット (推奨):

lint:
	golangci-lint run ./...

lint-fix:
	golangci-lint run --fix ./...

fmt:
	golangci-lint fmt ./...

CI パイプラインのセットアップ (GitHub Actions と golangci-lint-action) については、samber/cc-skills-golang@golang-continuous-integration スキルを参照してください。

出力の解釈

各問題は以下の形式に従います:

path/to/file.go:42:10: 問題を説明するメッセージ (リンター名)

括弧内のリンター名は、それがどのリンターによってフラグが立てられたかを示します。これを使用して:

• リファレンスでリンターを調べてそれが何をチェックするか理解する
• 誤検知の場合は //nolint:リンター名 // 理由 で抑制する
• golangci-lint run --verbose を使用して追加コンテキストとタイミング情報を取得する

よくある問題

問題	解決方法
「deadline exceeded」	.golangci.yml で run.timeout を増やす (デフォルト: 5m)
レガシーコードに多くの問題がある	issues.new-from-rev: HEAD~1 を設定して新規コードのみをリントする
リンターが見つからない	golangci-lint linters でチェック — リンターは新しいバージョンが必要な場合があります
リンター間の競合	理由を説明するコメント付きで有用性の低いものを無効にする
アップグレード後の v1 設定エラー	golangci-lint migrate を実行して設定フォーマットを変換する
大規模リポで遅い	run.concurrency を減らすか、run.skip-dirs でディレクトリを除外する

レガシーコードベースのクリーンアップの並列化

レガシーコードベースでのリント採用時には、最大 5 つの並列サブエージェント (Agent ツール経由) を使用して、独立したリンターカテゴリを同時に修正します:

• サブエージェント 1: 自動修正可能な問題に対して golangci-lint run --fix ./... を実行
• サブエージェント 2: セキュリティリンターの検出結果を修正 (bodyclose、sqlclosecheck、gosec)
• サブエージェント 3: エラーハンドリング問題を修正 (errcheck、nilerr、wrapcheck)
• サブエージェント 4: スタイルとフォーマットを修正 (gofumpt、goimports、revive)
• サブエージェント 5: コード品質を修正 (gocritic、unused、ineffassign)

クロスリファレンス

• → golangci-lint-action を使用した CI パイプラインについては samber/cc-skills-golang@golang-continuous-integration スキルを参照
• → リンターが強制するスタイルルールについては samber/cc-skills-golang@golang-code-style スキルを参照
• → リント以外の SAST ツール (gosec、govulncheck) については samber/cc-skills-golang@golang-security スキルを参照
• → これらのガイドラインを使用した CI での自動化された AI 駆動コードレビューについては samber/cc-skills-golang@golang-continuous-integration スキルを参照