القائمة
Run and fix backend pytest tests after API, scanner, model, or router changes. Use when modifying backend/app/, adding endpoints, or when API tests fail.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Run the full test suite (ruff + all layers), fix failures, then draft and commit with a human-readable message. Use when the user asks for a commit message, wants help summarizing changes before committing, or before running git commit.
Run Vitest component tests after React component or page changes. Use when modifying frontend/src/ components, pages, or api.js mocks.
Bump VERSION, sync E2E version checks, run the full test suite, and commit only if green — then tag and publish VLCouchSetup.exe. ALWAYS use this skill when the user mentions version, release, bump, semver, tag, ship, publish, next version, prepare release, or cutting a release — even vague one-line prompts.
Run Playwright E2E browser tests to verify UI flows end-to-end. Use before declaring work complete, after UI flow changes, or when browser behavior must be validated.
Keep AGENTS.md, selector rules, verify skills, and CONTRIBUTING.md in sync with code. Use after adding or changing data-testid values, API endpoints, env vars, test file locations, project structure, or verification commands.
End-to-end recipe for adding a new API endpoint — router, tests, api.js, UI, and verification. Use when implementing a new backend route that the frontend will call.
| name | verify-backend |
| description | Run and fix backend pytest tests after API, scanner, model, or router changes. Use when modifying backend/app/, adding endpoints, or when API tests fail. |
After any change under backend/app/ — routers, models, scanner, config, VLC/thumbnails.
.\scripts\test.ps1 -Layer api
cd backend
$env:APP_ENV="test"; $env:TEST_MODE="true"
.\.venv\Scripts\pytest tests/test_library_api.py -q
| File | Covers |
|---|---|
test_health.py | GET /api/health, GET /api/thumbnails/status |
test_thumbnail_worker.py | thumbnail queue worker_status() |
test_folder_picker.py | Windows folder picker subprocess |
test_media_roots_api.py | media roots CRUD, pick-folder responses |
test_library_api.py | browse, movies, shows, show detail, search |
test_watch_api.py | watch-status, season watch-status, continue-watching |
test_play_api.py | play endpoint, TEST_MODE VLC skip |
test_settings_api.py | GET/PATCH settings |
test_thumbnails.py | thumbnail cache, seek logic, cache version |
test_ffmpeg_detection.py | ffmpeg path detection, winget fallbacks |
test_scanner.py | scan_library against fixture media (see verify-scanner skill) |
run pytest → read traceback → fix code → re-run failing file → run full api layer
tmp_path; never touch backend/data/library.dbTEST_MODE=true skips VLC and thumbnail background jobsapp.db as db and use db.engine after overrides (not from app.db import engine)