gstack-openclaw-investigate — скилл для Claude Code: как установить
Скилл gstack-openclaw-investigate ведёт агента через отладку по шагам: сначала первопричина и проверка гипотезы, потом минимальный фикс с регрессионным тестом и отчёт.
MIT 302 установок ★ 142 291 обновлён 2026-10-25
npx skills add garrytan/gstack --skill gstack-openclaw-investigate -a claude-codeЧто делает gstack-openclaw-investigate
Скилл работает по правилу «никаких исправлений без поиска первопричины». Сначала агент собирает симптомы: читает ошибку, стектрейс, шаги воспроизведения, а если данных мало, задаёт один вопрос за раз. Потом идёт от места падения назад по коду и смотрит историю командой git log --oneline -20 -- <affected-files>, чтобы понять, не регрессия ли это. Итог этой фазы — конкретная проверяемая гипотеза.
Дальше гипотезу сверяют с типовыми случаями: гонка, null-значения, порча состояния, сбой интеграции, расхождение конфигурации между окружениями, устаревший кэш. Перед правкой её подтверждают временным логом или assert. Три неверные гипотезы подряд скилл считает сигналом, что проблема в архитектуре: он останавливается и предлагает продолжить с новой гипотезой, позвать человека или добавить логирование.
Правка получается минимальной, с регрессионным тестом, который падает без фикса и проходит с ним. Если затронуто больше 5 файлов, агент предупредит вас до продолжения. В конце он повторяет исходный сценарий, гоняет тесты и сохраняет отчёт с датой в memory/. Статус отчёта: DONE, DONE_WITH_CONCERNS или BLOCKED.
Какие задачи решает
- найти причину падения по стектрейсу, а не по догадке
- выяснить, не регрессия ли баг, по истории коммитов затронутых файлов
- разобраться, почему код работает локально и ломается на staging или prod
- добавить регрессионный тест, который падает без исправления
- сохранить отчёт об отладке в
memory/для следующих сессий
Примеры запросов агенту
- Используй скилл
gstack-openclaw-investigate: после вчерашнего коммита упала сборка, вот лог. - Найди первопричину этой ошибки и пока ничего не правь, сначала проверь гипотезу.
- Всё перестало работать после обновления зависимостей. Разберись, исправь и добавь регрессионный тест.
Как установить gstack-openclaw-investigate
1Через Skills CLI (Vercel)
npx skills add garrytan/gstack --skill gstack-openclaw-investigate -a claude-code2Вручную: положить файлы
~/.claude/skills/gstack-openclaw-investigate/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/gstack-openclaw-investigate/
1Через Skills CLI (Vercel)
npx skills add garrytan/gstack --skill gstack-openclaw-investigate -a codex2Вручную: положить файлы
.agents/skills/gstack-openclaw-investigate/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add garrytan/gstack --skill gstack-openclaw-investigate -a cursor2Вручную: положить файлы
.cursor/skills/gstack-openclaw-investigate/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install garrytan/gstack openclaw/skills/gstack-openclaw-investigate2Вручную: положить файлы
.github/skills/gstack-openclaw-investigate/SKILL.md1Через Skills CLI (Vercel)
npx skills add garrytan/gstack --skill gstack-openclaw-investigate -a gemini-cli2Командой платформы
gemini skills install https://github.com/garrytan/gstack --path openclaw/skills/gstack-openclaw-investigateВручную: положить файлы
.devin/skills/gstack-openclaw-investigate/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add garrytan/gstack --skill gstack-openclaw-investigate -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о gstack-openclaw-investigate
Как установить gstack-openclaw-investigate в Claude Code?
Выполните npx skills add garrytan/gstack --skill gstack-openclaw-investigate -a claude-code. Сам скилл лежит в файле ~/.claude/skills/gstack-openclaw-investigate/SKILL.md.
Что делает gstack-openclaw-investigate?
Он заставляет агента сначала найти и проверить первопричину бага, потом внести минимальную правку с регрессионным тестом. В конце агент выдаёт отчёт со статусом.
Что будет, если гипотезы не подтверждаются?
После трёх неудачных гипотез скилл останавливается и сообщает, что дело может быть в архитектуре. Он предлагает три пути: новая гипотеза, передача человеку или добавление логирования.
Исходный текст
SKILL.md · MIT
--- name: gstack-openclaw-investigate description: Use when asked to debug, fix a bug, investigate an error, or do root cause analysis, and when users report errors, stack traces, unexpected behavior, or say something stopped working. --- # Systematic Debugging ## Iron Law **NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST.** Fixing symptoms creates whack-a-mole debugging. Every fix that doesn't address root cause makes the next bug harder to find. Find the root cause, then fix it. --- ## Phase 1: Root Cause Investigation Gather context before forming any hypothesis. 1. **Collect symptoms:** Read the error messages, stack traces, and reproduction steps. If the user hasn't provided enough context, ask ONE question at a time. Don't ask five questions at once. 2. **Read the code:** Trace the code path from the symptom back to potential causes. Search for all references, read the logic around the failure point. 3. **Check recent changes:** ```bash git log --oneline -20 -- <affected-files> ``` Was this working before? What changed? A regression means the root cause is in the diff. 4. **Reproduce:** Can you trigger the bug deterministically? If not, gather more evidence before proceeding. 5. **Check memory** for prior debugging sessions on the same area. Recurring bugs in the same files are an architectural smell. Output: **"Root cause hypothesis: ..."** ... a specific, testable claim about what is wrong and why. --- ## Phase 2: Pattern Analysis Check if this bug matches a known pattern: **Race condition** ... Intermittent, timing-dependent. Look at concurrent access to shared state. **Nil/null propagation** ... NoMethodError, TypeError. Missing guards on optional values. **State corruption** ... Inconsistent data, partial updates. Check transactions, callbacks, hooks. **Integration failure** ... Timeout, unexpected response. External API calls, service boundaries. **Configuration drift** ... Works locally, fails in staging/prod. Env vars, feature flags, DB state. **Stale cache** ... Shows old data, fixes on cache clear. Redis, CDN, browser cache. Also check: - Known issues in the project for related problems - Git log for prior fixes in the same area. Recurring bugs in the same files are an architectural smell, not a coincidence. **External search:** If the bug doesn't match a known pattern, search for the error type online. **Sanitize first:** strip hostnames, IPs, file paths, SQL, customer data. Search the error category, not the raw message. --- ## Phase 3: Hypothesis Testing Before writing ANY fix, verify your hypothesis. 1. **Confirm the hypothesis:** Add a temporary log statement, assertion, or debug output at the suspected root cause. Run the reproduction. Does the evidence match? 2. **If the hypothesis is wrong:** Search for the error (sanitize sensitive data first). Return to Phase 1. Gather more evidence. Do not guess. 3. **3-strike rule:** If 3 hypotheses fail, **STOP**. Tell the user: "3 hypotheses tested, none match. This may be an architectural issue rather than a simple bug." Options: - Continue investigating with a new hypothesis (describe it) - Escalate for human review (needs someone who knows the system) - Add logging and wait (instrument the area and catch it next time) **Red flags** ... if you see any of these, slow down: - "Quick fix for now" ... there is no "for now." Fix it right or escalate. - Proposing a fix before tracing data flow ... you're guessing. - Each fix reveals a new problem elsewhere ... wrong layer, not wrong code. --- ## Phase 4: Implementation Once root cause is confirmed: 1. **Fix the root cause, not the symptom.** The smallest change that eliminates the actual problem. 2. **Minimal diff:** Fewest files touched, fewest lines changed. Resist the urge to refactor adjacent code. 3. **Write a regression test** that: - **Fails** without the fix (proves the test is meaningful) - **Passes** with the fix (proves the fix works) 4. **Run the full test suite.** No regressions allowed. 5. **If the fix touches >5 files:** Flag the blast radius to the user before proceeding. That's large for a bug fix. --- ## Phase 5: Verification & Report **Fresh verification:** Reproduce the original bug scenario and confirm it's fixed. This is not optional. Run the test suite. Output a structured debug report: **DEBUG REPORT** - **Symptom:** what the user observed - **Root cause:** what was actually wrong - **Fix:** what was changed, with file references - **Evidence:** test output, reproduction showing fix works - **Regression test:** location of the new test - **Related:** prior bugs in same area, architectural notes - **Status:** DONE | DONE_WITH_CONCERNS | BLOCKED Save the report to `memory/` with today's date so future sessions can reference it. --- ## Important Rules - **3+ failed fix attempts: STOP and question the architecture.** Wrong architecture, not failed hypothesis. - **Never apply a fix you cannot verify.** If you can't reproduce and confirm, don't ship it. - **Never say "this should fix it."** Verify and prove it. Run the tests. - **If fix touches >5 files:** Flag to user before proceeding. - **Completion status:** - DONE ... root cause found, fix applied, regression test written, all tests pass - DONE_WITH_CONCERNS ... fixed but cannot fully verify (e.g., intermittent bug, requires staging) - BLOCKED ... root cause unclear after investigation, escalated
© garrytan · MIT · garrytan/gstack