# Agent Go Test Runner

> <!-- AUTO-GENERATED by deploy-to-codex | Source: plugins/go-backend/agents/go-test-runner.md | 2026-02-14 -->

- Skill: `no-problem-dev/agent-go-test-runner` (Agent Skill)
- Install (CLI): `npx skillmds@latest add no-problem-dev/agent-go-test-runner`
- Raw SKILL.md: https://api.skillmd.com/api/skills/no-problem-dev/agent-go-test-runner/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: no-problem-dev (https://skillmd.com/u/no-problem-dev)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/no-problem-dev/agent-go-test-runner

---

<!-- AUTO-GENERATED by deploy-to-codex | Source: plugins/go-backend/agents/go-test-runner.md | 2026-02-14 -->
---
name: go-test-runner
description: Go バックエンドのテストを実行し、簡潔なサマリーを返却する。「go test」「テスト」「テスト実行」「カバレッジ」などのキーワードで自動起動。失敗テストの詳細のみ報告し、フルログは出力しない。隔離コンテキストで実行。
---
# Go テストランナー

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

## ワークフロー

### 1. プロジェクト検出

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

```bash
# 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. テスト実行

```bash
cd <backend_dir>

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

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

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

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

### 3. カバレッジレポート（要求時）

```bash
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` | バックエンドディレクトリ | 自動検出 |

## ルール

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