Przejdź do treści
Biblioteka skilli
Programowanie · Testowanie

camera-debugging-qa

/camera-debugging-qa

Mierzy w gierach drgania kamery, błędy podążania, granice i teleportacje na podstawie śladów, bez budowania rigu kamery.

Licencja
MIT
Ostatnia zmiana repozytorium
30.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
12
Skrypty
2
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 30.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 2 skrypty w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/camera_trace_qa.py, tests/test_camera_trace_qa.py

Co robi i kiedy

Mierzy w gierach drgania kamery, błędy podążania, granice i teleportacje na podstawie śladów, bez budowania rigu kamery.

Oryginalny opis (EN)

Use to measure camera jitter, follow errors, bounds, occlusion and teleport regressions from traces; not to build a camera rig.

Jak działa

  1. Procedure
  2. Built-in tools
  3. Measurement limitations
  4. Verification
Sekcje z nagłówków SKILL.md, w oryginale · 34 linii, 399 słów
Podgląd SKILL.md
---
name: camera-debugging-qa
description: Use to measure camera jitter, follow errors, bounds, occlusion and teleport regressions from traces; not to build a camera rig.
---
# Camera Debugging & QA

Diagnose camera behavior with falsifiable metrics and scene reproduction. Do not assert visual comfort or GPU performance based only on numeric traces.

## Procedure

1. State the camera's intended behavior and operating conditions (platformer look-ahead, RTS pan, target group, scripted shot). Select measurements appropriate to that design; a camera deliberately framing *ahead* of the player will not have zero follow error.
2. Collect telemetry from **the existing render loop**. Write one record per rendered frame: timestamp `t` in seconds, world `target` and visual `camera` positions, optional `teleport`, optional `occluded`. Never store user-identifying data.
3. For 2D bounds, record the effective logical viewport, zoom, and rectangular level bounds. Match units: world positions and viewport divided by zoom. Do not conflate CSS pixels with backing pixels.
4. Save as JSONL, JSON array / `{ "records": [...] }`, or CSV with flat fields; see `references/trace-schema.md`.
5. Run `python scripts/camera_trace_qa.py TRACE.jsonl --max-speed 500 --max-velocity-jump 60 --output report.json` (thresholds illustrative, must be adapted per game). Exit 0=pass, 2=threshold breach, 3=bad input.
6. Review failure frames and reproduce them visually. Rerun the same seed, scene, machine class and input trace after change. Include 30/60/144 Hz or frame-time variation, direction reversal, pause/resume, resize, teleports and obstructions.
7. Report summary, pass/fail thresholds, any intentional violations and any GPU/browser/mobile tests not performed.

## Built-in tools

- `scripts/camera_trace_qa.py` — standard-library Python 3, JSONL/JSON/CSV, robust input validation, p50/p95 following error, speed, velocity jump, occlusion and bounds.
- `tests/test_camera_trace_qa.py` — automated edge-case tests.
- `examples/trace.jsonl` — known-good demonstration trace.
- `references/trace-schema.md` — schema, metric semantics and constraints.
- `assets/camera-qa-report.md` — reusable report.

## Measurement limitations

- Velocity jump is `|v[n]-v[n-1]|`, **not** acceleration per second squared and **not** jerk.
- A camera is not meant to sit on its target for all game styles; following error is diagnostic, not universally a failure.
- Samples recorded directly after teleports are excluded from follow/speed checks for a configurable grace interval; other failures are still tracked.
- Occlusion flag requires a **real visibility or collision query** supplied by the game; this tool cannot infer it from camera/target positions alone.
- Unit tests alone cannot prove screen composition, image stability, comfort, input latency or CPU/GPU performance.

## Verification

Run `python -m unittest discover -s tests -v` from the skill root; invoke CLI on the example trace; inspect JSON report. Validate that missing fields, NaN, non-monotonic timestamps and impossible bounds fail closed.
Pliki w paczce (12)
  • CHANGELOG.md 1 KB
  • LICENSE 1 KB
  • PROVENANCE.md 1 KB
  • README.md 1 KB
  • SKILL.md 3 KB
  • assets/camera-qa-report.md 1 KB
  • attribution/upstream/LICENSE 11 KB
  • attribution/upstream/NOTICE 1 KB
  • examples/trace.jsonl 1 KB
  • references/trace-schema.md 2 KB
  • scripts/camera_trace_qa.py 9 KB
  • tests/test_camera_trace_qa.py 3 KB

Wersje

W bazie nie ma innych skilli o nazwie camera-debugging-qa.

Migawka bazy z 13.11.2026 · wersja paczki debbdba22f42 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100camera-system
    Implementuje kamery 2D i 3D w grach: płynne śledzenie, drżenie ekranu, strefy kamery i przejścia.
  • 100camera-system
    Pomaga implementować kamery w grach 2D i 3D: płynne śledzenie, wstrząsy ekranu, strefy kamery i przejścia.
  • 100browser-camera-2d
    Ustawia w grze 2D lub pikselowej kamerę, która podąża za postacią, z martwą strefą, wyprzedzeniem i zoomem, bez 3D.
  • 100camera-systems
    Buduje kamery w grach: podążanie 2D z martwą strefą, wyprzedzanie, wygładzanie, orbitę 3D, pierwszą osobę i kadrowanie wielu celów.
  • 100camera-systems
    Buduje kamery do gier: śledzenie 2D z martwą strefą, orbita 3D z kolizjami, widok z pierwszej osoby, kadrowanie wielu celów i wstrząsy.
  • 90esp32-camera-xclk-timing-validation
    Waliduje czas sygnału XCLK kamery w ESP32, z ograniczeniami układu, analizą awarii i pomiarami przed wydaniem produktu.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.