test-runner

Run tests in the fdb-record-layer codebase, interpret results, and diagnose failures.

インストール方法

デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。

Codex または Claude でインストールこの Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。

直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。

npx skills add https://github.com/FoundationDB/fdb-record-layer --skill test-runner

コマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。

ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。

インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。

SKILL.md

ソースの指示 · 読み取り専用プレビュー

name	test-runner
description	Run tests in the fdb-record-layer codebase, interpret results, and diagnose failures.

Always apply the using-gradle skill for Gradle task syntax and build commands.

For yaml-tests: ./gradlew :yaml-tests:test (or --tests 'YamlIntegrationTests.<name>').
For embedded-only yaml-tests (faster): ./gradlew :yaml-tests:quickTest.
For mixed-mode yaml-tests locally: ./gradlew :yaml-tests:mixedModeTest.
For JUnit tests in a module: ./gradlew :<module>:test --tests '<fully.qualified.ClassName>'.

Read the full test output — look for the stack trace and the assertion message.
Check if the failure is in a yaml test:
- plan mismatch → the actual query plan changed; edit YamlIntegrationTests.java to add @MaintainYamlTestConfig(YamlTestConfigFilters.CORRECT_EXPECTATIONS) to the test entry, then re-run — the framework will auto-correct the expected plan.
- result mismatch → data or query logic changed; inspect the yamsql file.
Check if the failure is an async issue:
- BlockingInAsyncContextException → something called join()/get() inside a future.
- Timeout → possible deadlock; check for blocking calls in completion lambdas.
Check if FDB connectivity is the issue:
- FDBException or connection refused → FDB is not running or cluster file is wrong.