К основному содержанию
скилл CX Codex

gstack-openclaw-investigate — скилл для Claude Code: как установить

Скилл gstack-openclaw-investigate ведёт агента через отладку по шагам: сначала первопричина и проверка гипотезы, потом минимальный фикс с регрессионным тестом и отчёт.

MIT 302 установок ★ 142 291 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add garrytan/gstack --skill gstack-openclaw-investigate -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/gstack-openclaw-investigate/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/gstack-openclaw-investigate/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Тесты и QA» →
investigate-first JuliusBrussee Скилл investigate-first для Claude Code держит агента в режиме разбора: собрать доказательства, назвать причину — и только потом трогать код. Останавливает плавающие падения с неясной причиной. CX Codex +1 129 600установок root-cause-tracing NeoLabHQ Скилл root-cause-tracing учит агента идти по стеку вызовов назад, пока не найдётся исходный триггер ошибки, и править там, а не на месте падения. CX Codex +1 1 400установок ns-investigator nextstage-brasil Скилл ns-investigator для Claude Code анализирует стек-трейсы, логи и упавшие тесты, находит корневую причину и предлагает минимальный фикс без реализации. CX Codex +1 153установок error-detective rohitg00 Субагент error-detective, который разбирается в stack trace, воспроизводит ошибки и находит корень проблемы. Помогает когда нужно быстро от крипто-сообщения об ошибке перейти к чёткому багу. CX Codex ★ 2 858звёзд репо debugging-wizard https://github.com/Jeffallan Скилл debugging-wizard разбирает ошибки, стек-трейсы и логи, чтобы найти причину сбоя. Нужен при падениях, исключениях и неожиданном поведении кода. CX Codex +1 5 600установок red-green-proof Alireza Rezvani Скилл red-green-proof для Claude Code, который превращает предполагаемый баг в доказанный: пишет тест, который сначала падает, затем проходит после фикса, затем снова падает после отката. CX Codex +1 3установок

Из того же набора26

Весь набор →
landing-report Скилл landing-report для Claude Code показывает очередь версий и занятые слоты релизов в параллельных воркспейсах. Работает в режиме чтения через утилиту gstack-next-version без изменения файлов. CX Codex +1 336установок scrape Скилл scrape для Claude Code вытаскивает данные со страницы через браузер Aside, где вход в сервисы уже выполнен. Запускается на просьбе вроде «собери данные с этой страницы». CX Codex +1 335установок gstack-openclaw-office-hours Скилл gstack-openclaw-office-hours проводит сессию YC Office Hours для проверки идеи и формулирования требований. Он запрещает агенту писать код и выдаёт готовый дизайн-документ. CX Codex +1 327установок document-generate Скилл document-generate для Claude Code создаёт документацию для функции, модуля или всего проекта. Запускается по просьбе написать документацию или объяснить код. CX Codex +1 319установок gstack-openclaw-ceo-review Скилл gstack-openclaw-ceo-review заставляет агента разобрать план как CEO: оспорить постановку задачи, найти слабые места и решить, расширять объём или сокращать. CX Codex +1 318установок gstack-openclaw-retro Скилл gstack-openclaw-retro формирует инженерную ретроспективу по коммитам в git: считает сессии, соотношение тестов, частые зоны правок и вклад каждого участника команды. CX Codex +1 314установок hackernews-frontpage Скилл hackernews-frontpage снимает главную Hacker News и отдаёт 30 верхних историй в JSON: заголовок, ссылка, очки, число комментариев. CX Codex +1 311установок diagram Скилл diagram для Claude Code превращает описание или Mermaid-код в набор файлов диаграммы. Запускается по просьбе сделать, нарисовать или визуализировать схему. CX Codex +1 266установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой