| name | go-agent |
| description | Run go-agent.sh — a lean Go workflow runner that produces agent-friendly output.
Use when: running Go checks (fmt, vet, staticcheck, test), verifying Go code before committing,
or when the user asks to run go checks, lint, format, or test a Go project.
Triggers on: go agent, run go checks, golang checks, go fmt vet test, verify go code.
|
| context | fork |
| allowed-tools | ["Bash(scripts/go-agent.sh*)","Bash(RUN_*=* scripts/go-agent.sh*)","Bash(FMT_MODE=* scripts/go-agent.sh*)","Bash(MAX_LINES=* scripts/go-agent.sh*)","Bash(KEEP_DIR=* scripts/go-agent.sh*)","Bash(FAIL_FAST=* scripts/go-agent.sh*)","Bash(CHANGED_FILES=* scripts/go-agent.sh*)"] |
Go Agent
Run the go-agent.sh script for lean, structured Go validation output designed for coding agents.
Script Location
scripts/go-agent.sh
Usage
Run Full Suite (fmt + vet + staticcheck + test)
scripts/go-agent.sh
Run Individual Steps
scripts/go-agent.sh fmt
scripts/go-agent.sh vet
scripts/go-agent.sh staticcheck
scripts/go-agent.sh test
scripts/go-agent.sh all
Environment Knobs
| Variable | Default | Description |
|---|
RUN_FMT | 1 | Set to 0 to skip fmt step |
RUN_VET | 1 | Set to 0 to skip vet step |
RUN_STATICCHECK | 1 | Set to 0 to skip staticcheck step |
RUN_TESTS | 1 | Set to 0 to skip test step |
FMT_MODE | auto | auto = fix locally, check in CI; check = list only; fix = rewrite |
FAIL_FAST | 0 | Set to 1 to stop after first failure (or use --fail-fast) |
CHANGED_FILES | (empty) | Space-separated changed file paths; scopes checks to those .go packages |
MAX_LINES | 40 | Max output lines printed per step (unlimited in CI) |
KEEP_DIR | 0 | Set to 1 to keep temp log dir on success |
Output Format
- Each step prints a header (
Step: fmt, Step: vet, etc.)
- Results are
PASS, FAIL, or SKIP
- On failure, output is truncated to
MAX_LINES
- Failed test results include extracted failing test names
staticcheck is skipped with a notice if not installed- Full logs are saved to a temp directory (path printed in output)
- Overall result is printed at the end:
Overall: PASS or Overall: FAIL
Important Notes
FMT_MODE=auto fixes formatting locally but only checks in CI (CI=true)staticcheck is optional; if not installed, the step is skipped (not failed)CHANGED_FILES scopes checks to only the listed .go file packages- In CI (
CI=true), MAX_LINES defaults to unlimited; locally it defaults to 40
