DevOps i chmura · Analiza
debug-operator
/debug-operator
Prowadzi systematyczną diagnozę, gdy pojawiają się błędy operatora albo użytkownik zgłasza zepsute działanie.
Dla kogo
- Autor
- dylanroscover ↗
- Repozytorium
- embody ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 26.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
- 1
- Skrypty
- 0
- Komentarze HTML
- 1
- Adresy URL w SKILL.md
- 0
Przestarzałość
Brak sygnałów. Repozytorium zmienione 26.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ą
- SKILL.md zawiera komentarze HTML (1). Nie widać ich w podglądzie Markdown, a model je czyta.
Co robi i kiedy
Prowadzi systematyczną diagnozę, gdy pojawiają się błędy operatora albo użytkownik zgłasza zepsute działanie.
Oryginalny opis (EN)
TRIGGER when operator errors appear or user reports broken behavior. Systematic diagnosis workflow.
Jak działa
- Common Error Patterns
Sekcje z nagłówków SKILL.md, w oryginale · 24 linii, 556 słów
Podgląd SKILL.md
--- name: debug-operator description: "TRIGGER when operator errors appear or user reports broken behavior. Systematic diagnosis workflow." --- <!-- Generated by Embody/Envoy - Do not remove this comment - sha:c1677e9a9be6b4da --> # Debug Operator Workflow Systematic approach to diagnosing TD operator errors: 1. **Get errors and warnings**: `get_op_errors` with `recurse=true` on the suspected operator and its children. It covers all three surfaces TD paints red: cook errors, Python tracebacks (`kind: 'script'` entries), and GLSL compile failures (`shaderErrors`) 2. **Inspect the operator**: `get_op` to see type, family, parameters, inputs, outputs, children 3. **Check connections**: `get_connections` to verify input/output wiring is correct 4. **Read DAT content**: `get_dat_content` if the operator is a DAT with script errors 5. **Check parameters**: `get_parameter` on specific parameters that might be misconfigured 6. **Check performance**: `get_op_performance` if the issue is cook-time related ## Common Error Patterns - **Missing input**: Operator requires a specific input type -- check connections - **Script error in DAT**: Read the DAT content and fix the Python/expression - **Parameter out of range**: Check parameter values against valid ranges - **Missing operator reference**: An expression or parameter references a non-existent operator - **Script error (Python traceback)**: A raising callback, DAT script, or expression shows a red X but is NOT a cook error -- TD keeps it on a separate surface (`OP.scriptErrors()`), and `op.errors()` reports the op as perfectly clean. Two consequences: read the traceback from `get_op_errors`' `kind: 'script'` entries, and remember these errors PERSIST until cleared. An error thrown during an extension re-init window (the extension object is briefly the old one, so a method added later is missing) stays red long after the code is correct again -- re-cook the owning op, confirm it runs clean, then `clearScriptErrors(recurse=True, error='*')` to clear the stale badge. Field case 2026-08-22: Embody's own manager list sat red on `'EmbodyExt' object has no attribute 'DirtyState'` while the live extension had the method all along. A `SyntaxError ... Context:(Extension 1)` here with a `None` extension means the Extension Object par was set via `.expr` instead of `.val` (see /create-extension). - **Cook error**: The operator can't process its inputs -- check input data types match expectations - **Black or empty render**: Use `capture_top` on the intended output TOP, then check display/render flags on the output and upstream ops; missing light or camera (a 3D scene renders black without both); no cooking Null terminating the chain; a bypass flag left on; resolution is 0; alpha is premultiplied/zero so the image is present but invisible; and whether the op is cooking (check `cookedThisFrame` via `get_op_performance`, or force a cook). After each fix, use `capture_top` again to confirm the frame renders correctly. - **Stale content after a file change (cooks clean, shows old pixels)**: An op can cook with NO errors and the RIGHT resolution yet still hold STALE content. A Movie File In whose `par.file` changed serves its previous cached texture until it cooks on a real frame advance -- `cook(force=True)` in the same frame is not enough. And when a TOP chain's output looks exactly ONE frame stale, suspect same-pass reload propagation: a reload applied mid-pass may not reach downstream ops until the next real frame, even under forced cooks in dependency order. Verify CONTENT, not cook state -- read pixels back (`numpyArray()` / `capture_top`) at the POINT OF CAPTURE (the chain's output, not the source) and confirm they actually changed across a real frame advance. See rules/td-python.md (Cook Model) and rules/performance.md (Movie Export).
Wersje
W bazie nie ma innych skilli o nazwie debug-operator.
Migawka bazy z 13.11.2026 · wersja paczki f2a0fdeafabb (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
- 100n8n-debugging-official
Prowadzi diagnozę, gdy workflow n8n nie działa, pojawiają się błędy, wynik odbiega od oczekiwań lub przebieg zatrzymał się. - 100diagnosing-bugs
Prowadzi pętlę diagnozy trudnych błędów i regresji wydajności, gdy użytkownik prosi o diagnozę albo zgłasza awarię. - 90ci-debugging
Prowadzi systematyczną diagnozę awarii CI/CD, zaczynając od hipotez i różnic między środowiskiem lokalnym a CI. - 90diagnosing-bugs
Prowadzi pętlę diagnozy trudnych błędów i regresji wydajności, gdy użytkownik zgłasza awarię lub powolne działanie. - 90rhdh-operator-pr-test
Testuje obrazy operatora z pull requesta na żywym klastrze OpenShift i raportuje dowody oraz plan wycofania zmian. - 100kit-debug-prod
Bada błędy produkcyjne na podstawie logów, śladów, trackerów błędów i metryk, gdy użytkownik zgłasza błędy, identyfikatory sesji lub kody statusu.