Go バックエンド ビルド・テスト・Lint コマンド群 - APIサーバー開発をサポート

version
2.0.0
GitHub stars
5

Install

/plugin install go-backend@no-problem-plugins

Run it inside Claude Code after adding the marketplace with /plugin marketplace add no-problem-dev/claude-code-plugins.

Contents

Discovered from source

Skills 4

Go バックエンド開発ワークフロー(v2.0)

Go バックエンドプロジェクトのビルド・テスト・品質管理を統合管理するオーケストレーター。

エージェント(重い処理はサブエージェントで実行)

エージェント用途使いどころ
go-build-runnerバイナリビルド「ビルドして」「コンパイルして」
go-test-runnerテスト実行「テストして」「テスト走らせて」

原則: ビルド・テストは必ずサブエージェントで実行。メインコンテキストにログを流さない。

スキル(品質・開発・メンテナンス)

スキル用途使いどころ
go-quality静的解析 + Swagger 生成「lint して」「Swagger 生成」
go-dev-server開発サーバー起動「サーバー起動」「go run」
go-maintenance依存整理・キャッシュクリア「go mod tidy」「キャッシュクリア」

推奨ワークフロー

コード変更
    ↓
go-build-runner(ビルド)
    ↓ 成功
go-test-runner(テスト)
    ↓ 全テストパス
go-quality(品質チェック)
    ↓ 問題なし
コミット・PR

プロジェクト検出順序

  1. 環境変数 GO_BACKEND_DIR(go.mod の存在を確認)
  2. カレントディレクトリの go.mod
  3. サブディレクトリ(backend/, server/, api/, go/)
  4. 再帰検索(深さ2まで)

環境変数

変数説明デフォルト
GO_BACKEND_DIRバックエンドディレクトリ自動検出
GO_MAIN_PATHmain.go のパスcmd/server/main.go
GO_BIN_NAME出力バイナリ名server

よくあるエラーと対処

go mod tidy が必要

go: modules disabled by GO111MODULE=off

対処:

export GO111MODULE=on
go mod tidy

golangci-lint が見つからない

golangci-lint: command not found

対処:

brew install golangci-lint
# または
go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest

swag が見つからない

swag: command not found

対処:

go install github.com/swaggo/swag/cmd/swag@latest

テストカバレッジ

カバレッジ付きテストの実行:

go test -cover -coverprofile=coverage.out ./...
go tool cover -html=coverage.out -o coverage.html
open coverage.html

Lint 設定

プロジェクトルートに .golangci.yml を配置することでLintルールをカスタマイズ可能。

推奨設定例:

linters:
  enable:
    - errcheck
    - gosimple
    - govet
    - ineffassign
    - staticcheck
    - unused

linters-settings:
  errcheck:
    check-type-assertions: true

Go 開発サーバー

Go バックエンドの開発サーバーを起動・管理する。

プロジェクト検出

以下の優先順位で Go プロジェクトを検出:

  1. 環境変数 GO_BACKEND_DIR(go.mod の存在を確認)
  2. カレントディレクトリの go.mod
  3. サブディレクトリ(backend/, server/, api/, go/)
  4. 再帰検索(深さ2まで)

サーバー起動

cd <backend_dir>

# main.go の検出
# GO_MAIN_PATH > cmd/server/main.go > cmd/api/main.go > cmd/main.go > main.go
MAIN_PATH="${GO_MAIN_PATH:-}"
if [[ -z "$MAIN_PATH" ]]; then
  for p in cmd/server/main.go cmd/api/main.go cmd/main.go main.go; do
    [[ -f "$p" ]] && MAIN_PATH="$p" && break
  done
fi

# 開発サーバー起動(フォアグラウンド)
go run "$MAIN_PATH"

環境変数

変数説明デフォルト
GO_BACKEND_DIRバックエンドディレクトリ自動検出
GO_MAIN_PATHmain.go のパスcmd/server/main.go

注意事項

  • go run はフォアグラウンドで実行される(ブロッキング)
  • 停止するには Ctrl+C
  • Firebase Emulator と併用する場合、エミュレーターを先に起動すること

Go メンテナンス

Go バックエンドの依存関係整理とキャッシュ管理。

プロジェクト検出

以下の優先順位で Go プロジェクトを検出:

  1. 環境変数 GO_BACKEND_DIR(go.mod の存在を確認)
  2. カレントディレクトリの go.mod
  3. サブディレクトリ(backend/, server/, api/, go/)
  4. 再帰検索(深さ2まで)

依存関係整理

cd <backend_dir>

# 未使用の依存を削除、不足している依存を追加
go mod tidy

キャッシュクリア

# ビルドキャッシュのクリア
go clean -cache

# テストキャッシュのクリア
go clean -testcache

# モジュールキャッシュのクリア(全プロジェクトに影響)
go clean -modcache

使用タイミング

  • パッケージの追加・削除後 → go mod tidy
  • go.mod / go.sum のコンフリクト解決後 → go mod tidy
  • ビルドが不安定な場合 → キャッシュクリア
  • ディスク容量確保 → モジュールキャッシュクリア

よくあるエラー

go mod tidy が動作しない

go: modules disabled by GO111MODULE=off

対処:

export GO111MODULE=on
go mod tidy

注意事項

  • go clean -modcache は全プロジェクトのモジュールキャッシュを削除する
  • 実行前にユーザーに確認すること

Go 品質チェック(lint + Swagger)

Go バックエンドの静的解析と API ドキュメント生成。

プロジェクト検出

以下の優先順位で Go プロジェクトを検出:

  1. 環境変数 GO_BACKEND_DIR(go.mod の存在を確認)
  2. カレントディレクトリの go.mod
  3. サブディレクトリ(backend/, server/, api/, go/)
  4. 再帰検索(深さ2まで)

静的解析(golangci-lint)

実行

cd <backend_dir>

# golangci-lint の存在確認
command -v golangci-lint || {
  echo "golangci-lint がインストールされていません"
  echo "インストール: brew install golangci-lint"
  echo "または: go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest"
}

# Lint 実行
golangci-lint run ./...

Lint 設定

プロジェクトルートに .golangci.yml を配置してカスタマイズ可能:

linters:
  enable:
    - errcheck
    - gosimple
    - govet
    - ineffassign
    - staticcheck
    - unused

linters-settings:
  errcheck:
    check-type-assertions: true

Swagger / OpenAPI 生成

実行

cd <backend_dir>

# swag の存在確認(未インストール時は自動インストール)
command -v swag || [[ -f "$HOME/go/bin/swag" ]] || {
  echo "swag をインストール中..."
  go install github.com/swaggo/swag/cmd/swag@latest
}

# swag コマンドパス
SWAG_CMD=$(command -v swag 2>/dev/null || echo "$HOME/go/bin/swag")

# main.go の検出(GO_MAIN_PATH > cmd/server/main.go > cmd/api/main.go > main.go)
MAIN_PATH="${GO_MAIN_PATH:-}"
if [[ -z "$MAIN_PATH" ]]; then
  for p in cmd/server/main.go cmd/api/main.go cmd/main.go main.go; do
    [[ -f "$p" ]] && MAIN_PATH="$p" && break
  done
fi

# Swagger 生成
$SWAG_CMD init -g "$MAIN_PATH" -o docs --parseDependency --parseInternal

出力

生成されるファイル:

  • docs/docs.go — Go コード
  • docs/swagger.json — JSON 仕様
  • docs/swagger.yaml — YAML 仕様

よくあるエラー

golangci-lint が見つからない

golangci-lint: command not found

対処:

brew install golangci-lint
# または
go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest

swag が見つからない

swag: command not found

対処:

go install github.com/swaggo/swag/cmd/swag@latest

Agents 2

Go ビルドランナー

Go バックエンドのバイナリビルドを実行する。結果はサマリーのみ返却(成功/失敗、エラー、警告)。

ワークフロー

1. プロジェクト検出

以下の優先順位で Go プロジェクトを検出:

# 1. 環境変数 GO_BACKEND_DIR が設定されている場合
if [[ -n "$GO_BACKEND_DIR" && -f "$GO_BACKEND_DIR/go.mod" ]]; then
  # GO_BACKEND_DIR を使用
fi

# 2. カレントディレクトリに go.mod がある場合
ls go.mod 2>/dev/null

# 3. 一般的なサブディレクトリ(backend, server, api, go)
for dir in backend server api go; do
  ls "$dir/go.mod" 2>/dev/null
done

# 4. 再帰検索(深さ2まで)
find . -maxdepth 2 -name "go.mod" -type f | head -1

2. main.go の検出

以下の優先順位で main.go を検出:

  1. 環境変数 GO_MAIN_PATH が設定されている場合はそれを使用
  2. 一般的なパス: cmd/server/main.go, cmd/api/main.go, cmd/main.go, main.go
  3. cmd/ 以下を検索
  4. ルートの main.go

3. ビルド実行

cd <backend_dir>

# 出力ディレクトリ作成
mkdir -p bin

# バイナリ名(GO_BIN_NAME 環境変数 or デフォルト "server")
BIN_NAME="${GO_BIN_NAME:-server}"

# ビルド
go build -o "bin/$BIN_NAME" <main_path>

出力フォーマット

成功時:

## Build Succeeded
- Project: <directory>
- Binary: bin/<name>
- Main: <main_path>

失敗時:

## Build Failed
- Project: <directory>

### Errors
<error messages>

### Fix Suggestions
<recommendations>

環境変数

変数説明デフォルト
GO_BACKEND_DIRバックエンドディレクトリ自動検出
GO_MAIN_PATHmain.go のパスcmd/server/main.go
GO_BIN_NAME出力バイナリ名server

ルール

  • フルビルドログは絶対に出力しない
  • エラーのみアクション可能な詳細付きで報告
  • ビルド成功時は簡潔なサマリーのみ

Go テストランナー

Go バックエンドのテストを実行する。結果はサマリーのみ返却(合格/不合格数、失敗テスト詳細)。

ワークフロー

1. プロジェクト検出

以下の優先順位で Go プロジェクトを検出:

# 1. 環境変数 GO_BACKEND_DIR が設定されている場合
if [[ -n "$GO_BACKEND_DIR" && -f "$GO_BACKEND_DIR/go.mod" ]]; then
  # GO_BACKEND_DIR を使用
fi

# 2. カレントディレクトリに go.mod がある場合
ls go.mod 2>/dev/null

# 3. 一般的なサブディレクトリ(backend, server, api, go)
for dir in backend server api go; do
  ls "$dir/go.mod" 2>/dev/null
done

# 4. 再帰検索(深さ2まで)
find . -maxdepth 2 -name "go.mod" -type f | head -1

2. テスト実行

cd <backend_dir>

# 基本テスト
go test ./...

# カバレッジ付き(ユーザーが要求した場合)
go test -cover -coverprofile=coverage.out ./...

# 詳細出力(ユーザーが要求した場合)
go test -v ./...

# 特定パッケージ(ユーザーが指定した場合)
go test <package_path>

3. カバレッジレポート(要求時)

go tool cover -html=coverage.out -o coverage.html

出力フォーマット

全テストパス:

## Tests Passed
- Package: <target>
- Duration: <seconds>

一部失敗:

## Tests Failed

### Failed Tests

#### <package>/<TestFunction>
- File: <path>:<line>
- Expected: <value>
- Actual: <value>

### Fix Suggestions
<recommendations>

カバレッジ付き:

## Tests Passed (with Coverage)
- Package: <target>
- Coverage: <percentage>
- Report: coverage.html

環境変数

変数説明デフォルト
GO_BACKEND_DIRバックエンドディレクトリ自動検出

ルール

  • フルテストログは絶対に出力しない
  • 失敗テストのみアクション可能な詳細付きで報告
  • カバレッジレポート生成はユーザーが要求した場合のみ
  • テスト対象パッケージはデフォルト ./...(全パッケージ)

Sponsors

Details

Marketplace
no-problem-dev/claude-code-plugins
Source
plugins/go-backend
Category
Development

More from no-problem-dev/claude-code-plugins

All 9