菜单
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)