run-acceptance-tests

Guidance for running acceptance tests for a Terraform provider. In this context an acceptance test is a Go test function whose name carries the `TestAcc` prefix, and the skill is intended for use whenever someone asks to run an acceptance test or to run a test with that prefix.

To run a focused acceptance test, the skill invokes `go test -run=<TestName>` with the `TF_ACC=1` environment variable set, defaulting to non-verbose output. Because acceptance tests for specific providers may require additional environment variables, when the test output indicates missing variables the skill suggests how to set them up securely. For diagnosing a failing acceptance test, it applies a set of cumulative options in order, each building on the ones above it: rerun the test with `-count=1` so `go test` does not use a cached result; offer verbose output with `-v`; offer debug-level logging by setting `TF_LOG=debug`; and offer to persist the test's Terraform workspace by setting `TF_ACC_WORKING_DIR_PERSIST=1`.

The skill also addresses the risk that a passing acceptance test may be a false negative. To validate a passing test, it describes a flip procedure: edit the value of one of the TestCheckFuncs in one of the TestSteps within the TestCase, run the test, and expect it to fail. If the test fails as expected, the edit is undone and a successful flip is reported; otherwise the edit is kept and an unsuccessful flip is reported, signaling that the test does not actually exercise what it claims.