
go-backend
Go バックエンド ビルド・テスト・Lint コマンド群 - APIサーバー開発をサポート
- version
- 2.0.0
- GitHub stars
- 5
Install
/plugin install go-backend@no-problem-pluginsRun it inside Claude Code after adding the marketplace with /plugin marketplace add no-problem-dev/claude-code-plugins.
Contents
Discovered from sourceSkills 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
プロジェクト検出順序
- 環境変数
GO_BACKEND_DIR(go.mod の存在を確認) - カレントディレクトリの
go.mod - サブディレクトリ(
backend/,server/,api/,go/) - 再帰検索(深さ2まで)
環境変数
| 変数 | 説明 | デフォルト |
|---|---|---|
GO_BACKEND_DIR | バックエンドディレクトリ | 自動検出 |
GO_MAIN_PATH | main.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 プロジェクトを検出:
- 環境変数
GO_BACKEND_DIR(go.mod の存在を確認) - カレントディレクトリの
go.mod - サブディレクトリ(
backend/,server/,api/,go/) - 再帰検索(深さ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_PATH | main.go のパス | cmd/server/main.go |
注意事項
go runはフォアグラウンドで実行される(ブロッキング)- 停止するには Ctrl+C
- Firebase Emulator と併用する場合、エミュレーターを先に起動すること
Go メンテナンス
Go バックエンドの依存関係整理とキャッシュ管理。
プロジェクト検出
以下の優先順位で Go プロジェクトを検出:
- 環境変数
GO_BACKEND_DIR(go.mod の存在を確認) - カレントディレクトリの
go.mod - サブディレクトリ(
backend/,server/,api/,go/) - 再帰検索(深さ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 プロジェクトを検出:
- 環境変数
GO_BACKEND_DIR(go.mod の存在を確認) - カレントディレクトリの
go.mod - サブディレクトリ(
backend/,server/,api/,go/) - 再帰検索(深さ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 を検出:
- 環境変数
GO_MAIN_PATHが設定されている場合はそれを使用 - 一般的なパス:
cmd/server/main.go,cmd/api/main.go,cmd/main.go,main.go cmd/以下を検索- ルートの
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_PATH | main.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