Go 言語開発を支援するプラグイン(品質総合チェック、モジュール更新)

version
3.1.1
GitHub stars
7

Install

/plugin install shiiman-go@shiiman-claude-code-plugins

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

Contents

Discovered from source

Skills 2

Go Code Quality Checker

Go プロジェクトの品質を総合的にチェックします。 5つのチェックを Task サブエージェントで並列実行し、統合レポートを出力します。

Help

$ARGUMENTS に --help が含まれる場合、以下を表示して終了:

/shiiman-go:check - Go Code Quality Checker

概要:
  Go プロジェクトの品質を総合的にチェックします。

使用方法:
  /shiiman-go:check [オプション]

オプション:
  --help  このヘルプを表示

ワークフロー

1. 事前確認

以下を確認:

  • Go プロジェクト(go.mod)の存在
  • タスクランナー(Makefile / Taskfile.yml)の有無
  • Benchmark テスト(func Benchmark を含むファイル)の有無

2. 並列チェック実行

以下の5つのチェックを Task ツールで並列起動 する。 必ず1つのメッセージで全ての Task を同時に呼び出すこと。

チェック 1: テスト(subagent_type: Bash)
go test -race -cover ./...

タスクランナーに test タスクがあればそちらを優先。

チェック 2: 静的解析(subagent_type: Bash)
golangci-lint run ./...

タスクランナーに lint タスクがあればそちらを優先。 golangci-lint がなければ go vet ./... にフォールバック。

チェック 3: 脆弱性スキャン(subagent_type: Bash)
govulncheck ./...

govulncheck がインストールされていない場合は go install golang.org/x/vuln/cmd/govulncheck@latest を先に実行。

チェック 4: ベンチマーク(subagent_type: Bash)
go test -bench=. -benchmem ./...

Benchmark テストが存在する場合のみ実行。存在しない場合はスキップ。

チェック 5: コードレビュー(subagent_type: general-purpose)

以下の観点で変更ファイルまたはプロジェクト全体をレビュー:

  • Effective Go 準拠(命名規則、エラーハンドリング、インターフェース設計)
  • Go Code Review Comments 準拠
  • goroutine リーク、レースコンディション、デッドロックのリスク
  • defer の適切な使用
  • パフォーマンス上の懸念(不要なアロケーション、N+1 等)

3. 統合レポート出力

全チェック完了後、以下の形式で結果をまとめて出力:

## Go Check 結果

| チェック項目 | 結果 | 詳細 |
|-------------|------|------|
| テスト       | ✅/❌ | カバレッジ率、失敗テスト数 |
| 静的解析     | ✅/⚠️ | 検出された問題数と内訳 |
| 脆弱性       | ✅/⚠️ | 検出された脆弱性数 |
| ベンチマーク | ℹ️/⏭️ | 主要なベンチマーク結果 or スキップ |
| コードレビュー | ✅/⚠️ | 指摘事項数と優先度 |

4. 改善提案

問題が検出された場合、優先度順に改善提案を提示:

  1. Critical: テスト失敗、脆弱性
  2. Warning: lint エラー、コードレビュー指摘
  3. Info: ベンチマーク結果、最適化提案

重要な注意事項

  • ✅ 5つのチェックは必ず Task で並列起動する(順番に実行しない)
  • ✅ タスクランナーがあればそちらを優先する
  • ✅ ベンチマークテストがない場合はスキップする
  • ✅ 結果は統合レポートとしてまとめて出力する
  • ❌ チェック結果を1つずつ個別に報告しない

Go Mod Update

Go モジュールのバージョンを更新します。危険度評価付きで安全な段階的更新をサポート。 更新後は check と同じ品質チェック(テスト・静的解析・脆弱性スキャン・ベンチマーク・コードレビュー)を並列実行します。

Help

$ARGUMENTS に --help が含まれる場合、以下を表示して終了:

/shiiman-go:mod-update - Go モジュール更新

概要:
  Go モジュールのバージョンを更新する。
  危険度評価付きで安全な段階的更新をサポート。
  更新後は check で品質チェックを自動実行。

使用方法:
  /shiiman-go:mod-update

オプション:
  --help  このヘルプを表示

実行モードの伝え方(フラグの代わり):
  「確認だけ」「更新可能なものを見せて」  → 更新せず一覧と危険度評価のみ表示
  指定なし                               → 更新を実行

例:
  /shiiman-go:mod-update          # モジュールを更新
  「更新できるモジュールを確認して」  # 更新せず一覧のみ表示

起動時の自動判断(フラグの代わり)

引数・発話から実行モードを判定する。明示がなければ「更新」とする。

モード条件動作
確認「確認だけ」「一覧」「見せて」等の発話あり更新可能なモジュールと危険度評価のみ表示し終了
更新既定危険度評価後に更新を実行し、check を呼び出す

ワークフロー

1. 現在の依存関係を確認

cat go.mod
go list -m -u all

2. 更新可能なモジュールを分析

各モジュールについて以下を評価:

危険度基準説明
🟢 安全パッチバージョン (v1.2.3 → v1.2.4)バグ修正のみ、後方互換性保証
🟡 注意マイナーバージョン (v1.2.0 → v1.3.0)新機能追加、非推奨警告あり
🔴 危険メジャーバージョン (v1.x.y → v2.0.0)破壊的変更、API の変更

3. 更新実行

# バックアップ作成
cp go.mod go.mod.backup
cp go.sum go.sum.backup

# 特定モジュールの更新
go get -u github.com/xxx/yyy@latest

# すべての依存関係を更新
go get -u ./...

# go.mod の整理
go mod tidy

4. 更新結果レポート

✅ 依存関係更新完了

更新されたモジュール:
- github.com/xxx/yyy: v1.2.0 → v1.3.0 (🟡 マイナー)
- github.com/aaa/bbb: v2.1.0 → v2.1.1 (🟢 パッチ)

更新をスキップ:
- github.com/ccc/ddd: v1.0.0 → v2.0.0 (🔴 メジャー - 手動確認推奨)

5. 品質チェック(check スキル呼び出し)

更新完了後、Skill ツールで shiiman-go:check を呼び出す。 check がテスト・静的解析・脆弱性スキャン・ベンチマーク・コードレビューを並列実行する。

重要な注意事項

  • ✅ メジャーバージョンアップは慎重に
  • ✅ 依存関係更新は独立したコミットに
  • ✅ CHANGELOG を確認
  • ✅ 更新後は Skill ツールで check を呼び出す
  • ✅ 確認モード(「確認だけ」)の場合は更新と check をスキップする

Sponsors

Details

Marketplace
shiiman/claude-code-plugins
Source
plugins/shiiman-go
Category
Developer Tools

More from shiiman/claude-code-plugins

All 9