Przejdź do treści
Biblioteka skilli
Programowanie · Testowanie

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.

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
14
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/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

  1. Scope
  2. Workflow
  3. Implementation and references
  4. Limitations / quality bar
Sekcje z nagłówków SKILL.md, w oryginale · 29 linii, 307 słów
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.

Uwagi i zgłoszenia

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