Przejdź do treści
Biblioteka skilli
Programowanie · Testowanie

mcp-driver

/mcp-driver

Debuguje projekty Godot w czasie działania przez godot-mcp, gdy narzędzia headless nie wystarczają: stan węzłów, konsola, renderowanie oraz błędy widoczne dopiero w runtime.

Repozytorium
godotmaker ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
23.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
4
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

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

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co robi i kiedy

Debuguje projekty Godot w czasie działania przez godot-mcp, gdy narzędzia headless nie wystarczają: stan węzłów, konsola, renderowanie oraz błędy widoczne dopiero w runtime.

Oryginalny opis (EN)

Runtime debugging and live project inspection via godot-mcp. Use when headless tools cannot diagnose the problem: code compiles but runtime behavior is wrong, tests pass but the game does not work as expected, or you need to inspect live state (node tree, console output, rendering). Escalation trigger: a task has failed 2+ times through the headless path (headless-build, gdunit-driver), or the issue is inherently runtime-only (visual glitches, input not responding, physics behaving unexpectedly at runtime). DO NOT use for: syntax/compile errors (use headless-build), unit test failures (use gdu

Jak działa

  1. When to use this skill
  2. Debug-fix loop (overview)
  3. Project path
  4. Tool quick reference
  5. Iteration budget
  6. Cross-references
Sekcje z nagłówków SKILL.md, w oryginale · 108 linii, 626 słów
Podgląd SKILL.md
---
name: mcp-driver
description: |
  Runtime debugging and live project inspection via godot-mcp.
  Use when headless tools cannot diagnose the problem: code compiles but runtime behavior
  is wrong, tests pass but the game does not work as expected, or you need to inspect
  live state (node tree, console output, rendering).
  Escalation trigger: a task has failed 2+ times through the headless path (headless-build,
  gdunit-driver), or the issue is inherently runtime-only (visual glitches, input not
  responding, physics behaving unexpectedly at runtime).
  DO NOT use for: syntax/compile errors (use headless-build), unit test failures
  (use gdunit-driver), API lookups (use godot-api).
  Requires: godot-mcp MCP server registered as "godot" (@coding-solo/godot-mcp).
---

# MCP Driver — Runtime Debug & Inspection

$ARGUMENTS

## When to use this skill

MCP is the **upgrade path** when faster tools hit a wall. The fast loop handles most issues:

| Problem type | Fast path (no MCP) |
|---|---|
| Syntax / parse error | headless-build |
| Unit test failure | gdunit-driver |
| API lookup | godot-api |

Escalate to MCP when:

- **Compile-pass / runtime-fail** — headless-build says OK but something is wrong when the game actually runs
- **Test-pass / behavior-wrong** — unit tests pass but the game does not behave correctly in practice
- **Visual issue** — screen is black, sprites missing, z-order wrong, camera not following
- **Input not working** — keys/mouse/gamepad produce no response at runtime
- **Physics misbehavior at runtime** — objects pass through each other, wrong gravity, jittery movement
- **Need live state** — want to see the actual node tree, console output, or runtime errors
- **Repeated headless failure** — a fix has been attempted 2+ times via headless path without success

If none of these apply, use the fast path skill instead.

## Debug-fix loop (overview)

When you escalate to MCP, follow this loop. Max **3 iterations** before asking the user for help.

```
1. RUN      — run_project (optionally with a specific scene)
2. CAPTURE  — get_debug_output → collect errors, warnings, prints
3. ANALYZE  — parse output, identify root cause
4. FIX      — modify code / scene / config to address the issue
5. VERIFY   — stop_project → run_project again, get_debug_output
6. REPORT   — summarize what was wrong, what was changed, and the outcome
```

Each step is detailed in `references/workflow.md`. Common runtime issue patterns are in `references/debug-patterns.md`.

## Project path

MCP tools require a `projectPath` parameter — the directory containing `project.godot`. Determine it from the current working directory or ask the user if ambiguous:

```bash
# Quick check
ls project.godot 2>/dev/null && echo "Project root: $(pwd)"
```

## Tool quick reference

Full tool documentation: `references/tools.md`

### Debug tools (primary use)

| Tool | Purpose |
|---|---|
| `run_project` | Launch project in debug mode, capture output |
| `get_debug_output` | Retrieve console output and errors from running project |
| `stop_project` | Stop the running project, get final output |

### Inspection tools

| Tool | Purpose |
|---|---|
| `get_project_info` | Analyze project structure (scene/script/asset counts) |
| `get_godot_version` | Check installed Godot version |
| `list_projects` | Find Godot projects in a directory |
| `launch_editor` | Open the Godot editor (for manual inspection) |

### Scene management tools

| Tool | Purpose |
|---|---|
| `create_scene` | Create new scene file |
| `add_node` | Add node to existing scene |
| `load_sprite` | Load texture into Sprite2D node |
| `save_scene` | Save/resave scene file |
| `export_mesh_library` | Export scene as MeshLibrary |

### UID tools (Godot 4.4+)

| Tool | Purpose |
|---|---|
| `get_uid` | Get UID for a specific file |
| `update_project_uids` | Resave all resources to update UID references |

## Iteration budget

| Iteration | Action |
|---|---|
| 1 | Run → capture → analyze → apply most likely fix → verify |
| 2 | Re-analyze output, try alternative hypothesis → verify |
| 3 | Broaden investigation (check project structure, cross-reference with reviewer skills) → verify |
| After 3 | **Stop and ask the user.** Report what was tried and what was observed. |

## Cross-references

After MCP reveals the root cause, hand off to the appropriate skill for the fix:

- Physics issues → physics reviewer skill
- Animation issues → animation reviewer skill
- UI layout issues → ui reviewer skill
- Shader/rendering → shader reviewer skill
- ECS entity problems → gecs skill
Pliki w paczce (4)
  • SKILL.md 5 KB
  • references/debug-patterns.md 8 KB
  • references/tools.md 10 KB
  • references/workflow.md 7 KB

Wersje

W bazie nie ma innych skilli o nazwie mcp-driver.

Migawka bazy z 13.11.2026 · wersja paczki 38564e866147 (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

  • 100headless-build
    Sprawdza kompilację projektu Godot w trybie headless po napisaniu lub zmianie kodu GDScript albo C#, przed testami i przy diagnozie błędów budowania.
  • 100godot
    Buduje, testuje, debuguje i eksportuje gry Godot 4.x, w tym testy headless, fizykę, nawigację i eksport na macOS, Web, Androida i iOS.
  • 100gdunit-driver
    Uruchamia testy jednostkowe gdUnit4 i zamienia wyniki w ustrukturyzowane wyjście, pomaga diagnozować porażki i pisać nowe testy w GDScript i C#.
  • 100godot-runtime-verify
    Weryfikuje zbudowaną scenę Godot 2D lub 3D w czasie działania: uruchamia ją, czyta wyjście debuggera, klasyfikuje błędy i wydaje werdykt PASS lub FAIL.
  • 100godot
    Prowadzi tworzenie gier w Godot 4: sceny, węzły, sygnały, eksport, błędy wolnych węzłów i portowanie z Godot 3.
  • 100running-headless-godot
    Uruchamia powtarzalne przepływy Godot 4.2+ bez interfejsu: polecenia CLI, eksporty, edycję scen przez skrypt i testy.

Uwagi i zgłoszenia

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