메뉴
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)