Go Backend Workflow

Go バックエンドプロジェクトのビルド・テスト・品質管理ワークフロー。

コマンド一覧

コマンド	用途	実行時間
`/go-backend:go-build`	バイナリビルド	〜30秒
`/go-backend:go-test`	テスト実行	〜1分
`/go-backend:go-lint`	静的解析 (golangci-lint)	〜30秒
`/go-backend:go-run`	開発サーバー起動	即時
`/go-backend:go-tidy`	依存関係整理	〜10秒
`/go-backend:go-swagger`	Swagger生成	〜20秒

推奨ワークフロー

コード変更 → go-build（コンパイル確認）
    ↓ 成功
go-test（テスト実行）
    ↓ 全パス
go-lint（品質チェック）
    ↓ 問題なし
コミット・PR

プロジェクト構成の検出

このプラグインは以下の順序でプロジェクトを検出:

Makefile優先: make test, make lint 等のターゲットがあれば使用
go.mod検出: go.mod を探索して直接 go コマンドを実行
サブディレクトリ: backend/, server/, api/ 等を探索

環境変数

変数	説明	デフォルト
`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

対処:

bash

export GO111MODULE=on
go mod tidy

golangci-lint が見つからない

golangci-lint: command not found

対処:

bash

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

swag が見つからない

swag: command not found

対処:

bash

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

テストカバレッジ

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

bash

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

Lint 設定

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

推奨設定例:

yaml

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

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

Search AI Tools

go-backend-workflow

Install this agent skill to your Project

SKILL.md

Go Backend Workflow

コマンド一覧

推奨ワークフロー

プロジェクト構成の検出

環境変数

よくあるエラーと対処

go mod tidy が必要

golangci-lint が見つからない

swag が見つからない

テストカバレッジ

Lint 設定