navigation-debugging-qa
/navigation-debugging-qa
Sprawdza trasy agentów, koszty ścieżek, wersje nawigacji i utknięcia ruchu na podstawie telemetrii, bez pisania algorytmu wyszukiwania.
- Autor
- PixelWao ↗
- Repozytorium
- codex-gamedev-skills ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 30.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 14
- Skrypty
- 2
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 30.10.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
- 2 skrypty w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.
Skrypty: scripts/navigation_qa.py, tests/test_navigation_qa.py
Co robi i kiedy
Sprawdza trasy agentów, koszty ścieżek, wersje nawigacji i utknięcia ruchu na podstawie telemetrii, bez pisania algorytmu wyszukiwania.
Oryginalny opis (EN)
Use to validate agent routes, path costs, navigation versions and stuck movement from telemetry; not to implement pathfinding.
Jak działa
- Scope
- Workflow
- Implementation and references
- Limitations / quality bar
Podgląd SKILL.md
--- name: navigation-debugging-qa description: Use to validate agent routes, path costs, navigation versions and stuck movement from telemetry; not to implement pathfinding. --- # Navigation Debugging & QA ## Scope Independently validate route correctness and recorded NPC movement. This skill does not create an NPC AI, step physics, render a scene, or build a NavMesh. Works without depending on other skills. ## Workflow 1. Identify the authoritative map snapshot or navmesh revision. Capture movement permissions, tile weights, directions, links, agent dimensions and goal conditions. 2. Collect route fixtures at multiple seeds/topology versions, including blocked nodes, destructible walls, reachable and unreachable goals. Compare grid paths against an independent positive-weight Dijkstra implementation. 3. Capture *actual* agent trace data as JSON, JSONL or CSV containing agent ID, time, position, goal, state and optionally path revision. 4. Run the auditor; handle nonzero exit status as regression. Never report `unreachable` for `budget` results from a search that stopped early. 5. Analyze stuck agents, movement spikes, stale route revision, cost mismatch, corner cutting, out-of-bounds traversal and undue replanning. Where results depend on physics or geometry, use in-game tests. 6. Record baseline, fixed seeds, build version, device, FPS and test duration; compare after changes, preserving known good configurations. ## Implementation and references - [`scripts/navigation_qa.py`](scripts/navigation_qa.py): standalone Python stdlib CLI. - [`references/trace-schema.md`](references/trace-schema.md): file fields and measurement interpretation. - [`references/test-matrix.md`](references/test-matrix.md): static/dynamic/large-crowd scenario list and evidence level. - [`examples/routes.json`](examples/routes.json) and [`examples/trace.jsonl`](examples/trace.jsonl): sample inputs. - [`tests/test_navigation_qa.py`](tests/test_navigation_qa.py): unit tests. - [`assets/navigation-qa-report.md`](assets/navigation-qa-report.md): reporting template. ```bash python scripts/navigation_qa.py --routes examples/routes.json --trace examples/trace.jsonl --output navigation-report.json python -m unittest discover -s tests ``` ## Limitations / quality bar A grid-coordinate validation is not proof of NavMesh polygon clearance, physics feasibility, off-mesh transfer timing, crowd avoidance or game completion. A recorded `stale_route_in_use` is observable when `pathRevision < revision` and state is moving; this is a trace signal, not a universal engine-wide concurrency proof. Velocity spikes are diagnosed from telemetry and require investigation for legitimate teleport events. Compare all detected failures with expected behavior and classify waived tests explicitly.
Pliki w paczce (14)
- CHANGELOG.md 1 KB
- LICENSE 1 KB
- PROVENANCE.md 2 KB
- README.md 1 KB
- SKILL.md 3 KB
- assets/navigation-qa-report.md 1 KB
- attribution/upstream/LICENSE 11 KB
- attribution/upstream/NOTICE 1 KB
- examples/routes.json 1 KB
- examples/trace.jsonl 1 KB
- references/test-matrix.md 1 KB
- references/trace-schema.md 2 KB
- scripts/navigation_qa.py 8 KB
- tests/test_navigation_qa.py 3 KB
Wersje
W bazie nie ma innych skilli o nazwie navigation-debugging-qa.
Migawka bazy z 13.11.2026 · wersja paczki c2b0baaa92a9 (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
- 100navigation
Wdraża wyszukiwanie ścieżek i nawigację w Godot z NavigationAgent i NavigationRegion: siatki nawigacyjne, patrole, omijanie przeszkód i dynamiczną nawigację w grach 2D i 3D. - 100godot-navigation-pathfinding
Dostarcza plan wyszukiwania ścieżek AI w Godot z NavigationAgent2D i 3D, NavigationServer, omijaniem przeszkód i dynamicznym generowaniem siatki nawigacyjnej. - 100godot-navigation-pathfinding
Dostarcza plan wyszukiwania ścieżek AI w Godot z NavigationAgent2D i 3D, NavigationServer, omijaniem przeszkód i dynamicznym generowaniem siatki nawigacyjnej. - 100flutter-navigation
Wdraża wzorce nawigacji we Flutterze z go_router, deep linkingiem i trasami nazwanymi. - 100grid-pathfinding-strategy
Dobiera algorytmy wyznaczania ścieżek na siatce, takie jak A*, Dijkstra czy pola przepływu, do ruchu taktycznego w grach. - 100flutter-go-router-navigation
Wdraża typowane trasy, przekierowania i strażników z go_router we Flutterze, przy zmianach nawigacji opartej na go_router.