tidb-failpoint-test-runner
Use when running TiDB package tests and deciding whether failpoint enable/disable is required before and after the test command.
Source facts
- Repository
- pingcap/tidb
- Last source activity
- March 12, 2026 at 11:55
- Detected SKILL.md language
- English
- Stars
- 40,563
- Forks
- 6,243
Install options
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Review the source files
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Showing SKILL.md
SKILL.md
Source instructions · Read-only preview- name
- tidb-failpoint-test-runner
- description
- Use when running TiDB package tests and deciding whether failpoint enable/disable is required before and after the test command.
# TiDB Failpoint Test Runner
## Overview
Follow this workflow before running package tests under `pkg/...`.
`-tags=intest,deadlock` does not enable failpoints.
Canonical command details live in `docs/agents/testing-flow.md` -> `Failpoint decision for unit tests`.
## Workflow
1. Use `docs/agents/testing-flow.md` -> `Failpoint decision for unit tests` to decide whether the package needs failpoint enablement.
2. Run the matching command set from `docs/agents/testing-flow.md`:
- `Failpoint-enabled run` when the package matches the failpoint checks.
- `Unit tests (/pkg/...)` when it does not.
3. Keep the run targeted with `-run <TestName>`; for Bazel-specific variants, see the Bazel notes in `docs/agents/testing-flow.md` -> `Failpoint-enabled run`.
4. Record the decision evidence and exact test command in the final report.
View on GitHub