tidb-realtikv-runner - SKILL.md Agent Skill

name: tidb-realtikv-runner description: Use when running tests under tests/realtikvtest that require a local TiUP playground lifecycle with strict startup, readiness checks, and cleanup.

TiDB RealTiKV Runner

Overview

Use this skill for test targets under tests/realtikvtest/**. Always start playground in the background, verify readiness, run scoped tests, then clean up process and data. Canonical command details live in docs/agents/testing-flow.md -> RealTiKV tests (/tests/realtikvtest).

Workflow Checklist

Choose the standard flow or Cleanup-safe template from docs/agents/testing-flow.md -> RealTiKV tests (/tests/realtikvtest).
Use default PD_ADDR=127.0.0.1:2379 unless a port conflict requires --pd.port or --port-offset.
Keep the test scope narrow (-run <TestName> and target subdir only).
If failpoints are needed, enable before tests and disable afterward.
Verify teardown by confirming the PD endpoint is unreachable after cleanup.