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

ns-investigator — скилл для Claude Code и Cursor: диагностика ошибок

Скилл ns-investigator для Claude Code анализирует стек-трейсы, логи и упавшие тесты, находит корневую причину и предлагает минимальный фикс без реализации.

Apache-2.0 153 установок обновлён 2026-10-24

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

Что делает ns-investigator

Скилл включается, когда нужна диагностика без немедленного исправления: упавший CI, непонятный тест, ошибка с неочевидной причиной — всё это входные данные для ns-investigator.

По каждой проблеме скилл проходит фиксированный маршрут: читает логи и стек трейс, определяет затронутую область (бэкенд, фронтенд, инфра, БД, аутентификация, сборка), формирует гипотезу, проверяет её по коду и выдаёт структурированный отчёт. В нём — краткий диагноз с уровнем уверенности (High / Medium / Low), найденные свидетельства, первичная гипотеза, корневая причина, рекомендованный фикс с объяснением рисков и шаги для валидации. Код предлагается минимальным фрагментом, не целым файлом.

Скилл зависит от ns-harness: правила проекта берутся из .nextstage-harness/rules/*.md, а таблица маршрутизации живёт в ../../ns-harness/references/code-skill-routing.md. Для реализации найденного фикса нужен отдельный скилл ns-coder — ns-investigator намеренно не передаёт управление автоматически и не запускает правки без участия человека.

Какие задачи решает

  • найти корневую причину упавшего CI без ручного разбора логов
  • разобрать стек трейс и определить, в какой области кода ошибка
  • отделить подтверждённые факты от гипотез при диагностике
  • получить предложение минимального фикса с оценкой рисков
  • сформировать шаги для валидации исправления до его реализации

Примеры запросов агенту

  • Почему падает тест auth.spec.ts в CI — разбери стек трейс
  • Вот лог деплоя, найди корневую причину ошибки и предложи фикс
  • Проанализируй этот стек трейс: TypeError: Cannot read properties of undefined

Как установить ns-investigator

1Через Skills CLI (Vercel)

npx skills add nextstage-brasil/skills --skill ns-investigator -a claude-code

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

~/.claude/skills/ns-investigator/SKILL.md

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

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о ns-investigator

Как установить ns-investigator в Claude Code?

Выполните команду npx skills add nextstage-brasil/skills --skill ns-investigator -a claude-code. После этого скилл будет доступен по пути ~/.claude/skills/ns-investigator/SKILL.md.

Что делает ns-investigator?

Скилл анализирует ошибки, логи, стек трейсы и упавшие тесты, определяет корневую причину и предлагает минимальный фикс с шагами для проверки. Реализацию фикса он не выполняет — для этого нужен ns-coder.

Когда ns-investigator не подходит?

Скилл не предназначен для реализации исправлений (ns-coder), разбора продуктовых баг-репортов с экраном ожидаемого поведения (ns-bug-report-diagnosis), работы с GitLab ISSUE_URL или код-ревью перед мержем (ns-reviewer).

Исходный текст

SKILL.md · Apache-2.0
---
name: ns-investigator
description: (NS) Root-cause diagnosis from errors, logs, stack traces, failing tests, or CI — entry priority 4b when the user wants diagnosis WITHOUT implement ("why does X break?"). Use proactively on unclear test/CI failures if they have not asked to fix yet. Do NOT use for implement/fix (ns-coder), product bug reports / screen expected-vs-actual (ns-bug-report-diagnosis), version scope (ns-spec-driven), GitLab ISSUE_URL execution, or pre-merge review (ns-reviewer).
license: Apache-2.0
metadata:
  author: nextstage-brasil
  version: "1.3"
depends:
  - ns-harness
---

# Code Investigator

Root-cause diagnosis and minimal fix **proposal** — not implementation. Entry priority **4b**. Full routing: `../../ns-harness/references/code-skill-routing.md`.

## Session boot

See `../../ns-harness/references/session-boot.md`. Load rules from `.nextstage-harness/rules/*.md`. Read `architecture-rules.md` first. Legacy: `.cursor/rules/*.mdc` only if `.nextstage-harness/` is absent.

## Routing (read first)

### Entry (priority 4b)

Trigger phrases: `references/entry-triggers.md`. Harness priority table: `../../ns-harness/references/code-skill-routing.md`.

Use when the user wants diagnosis only — stack trace, CI fail, obscure bug, "why does X break?" — **without** asking to implement the fix, and **without** a product screen story.

Do **not** enter when the user asks to implement or fix code → `ns-coder` (priority 5). Do **not** enter for a product bug report / expected vs actual on a screen → `ns-bug-report-diagnosis` (priority 4a). Do **not** enter for GitLab `ISSUE_URL` → `ns-execution-gitlab-issue` (priority 1). Do **not** enter for multi-day / version scope → `ns-spec-driven` (priority 2).

### Handoff out

End with root cause + fix proposal to the **user**. Do **not** auto-dispatch implementation.

When the user asks to implement the proposed fix, stop — they re-enter through the host entry router (usually priority 5 → `ns-coder`). There is no direct `I → C` skill handoff; the human gate sits between diagnosis and diff.

## Mission

Answer:

1. What is failing?
2. Where is the error likely located?
3. Why does it happen?
4. What is the smallest safe fix?
5. How to validate the fix?

Be evidence-based. Separate confirmed facts from hypotheses.

## Workflow

1. Read problem, logs, stack trace, test output, or bug description.
2. Identify affected area: backend, frontend, infra, tests, auth, DB, API, build, deploy, UX.
3. Load applicable project rules.
4. In a repo: `git status`, `git diff`, targeted search, safe test/lint commands.
5. Focus on smallest area explaining the failure.
6. Form hypotheses; confirm or reject with evidence.
7. Start immediately — no permission gate.

## Investigation principles

- **Evidence first** — do not guess when code/logs can confirm
- **Minimal safe fix** — no unrelated rewrites
- **Root cause over symptom** — trace behind the visible error
- **Security** — flag auth bypass, injection, secrets in logs

## Required output format

### Quick Diagnosis

- 2–4 line summary
- Confidence: High | Medium | Low
- Affected area

### Evidence Found

Concrete items from error, log, code, diff, or config. State clearly if insufficient.

### Primary Hypothesis

What is wrong, why it produces the observed error, under which conditions.

### Root Cause

Direct statement when confirmed; otherwise `Probable root cause: ...`

### Recommended Fix

What to change, where, why it resolves, risks/side effects.

### Suggested Code

Only when concrete fix is possible — minimal snippet, not whole files.

### How to Validate

Commands, tests, manual steps to confirm fix.

### Prevention

Regression test, dependency pin, guard, logging, documentation.

## Severity (multiple issues)

1. Critical — blocks execution, production, security, data loss
2. High — important flow broken or recurring
3. Medium — limited incorrect behavior
4. Low — robustness/clarity

## References

| File                         | When                             |
| ---------------------------- | -------------------------------- |
| `references/rca-template.md` | Optional structured RCA document |
| `references/entry-triggers.md` | Priority 4b entry phrases vs 4a and coder |
| `../../ns-harness/references/code-skill-routing.md` | Entry priority and investigator handoff |

## Constraints

- Do not blame the developer
- Do not invent unchecked files or logs
- Ask minimum missing info only at end if needed

© nextstage-brasil · Apache-2.0 · nextstage-brasil/skills

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
root-cause-tracing NeoLabHQ Скилл root-cause-tracing учит агента идти по стеку вызовов назад, пока не найдётся исходный триггер ошибки, и править там, а не на месте падения. CX Codex +1 1 400установок error-detective rohitg00 Субагент error-detective, который разбирается в stack trace, воспроизводит ошибки и находит корень проблемы. Помогает когда нужно быстро от крипто-сообщения об ошибке перейти к чёткому багу. CX Codex ★ 2 858звёзд репо gstack-openclaw-investigate garrytan Скилл gstack-openclaw-investigate ведёт агента через отладку по шагам: сначала первопричина и проверка гипотезы, потом минимальный фикс с регрессионным тестом и отчёт. CX Codex +1 302установок hallucination-investigator VoltAgent Субагент hallucination-investigator для Codex, который анализирует причины ошибок в ответах ИИ: не хватило контекста, неверный поиск, неправильный промпт или неподдержанный вывод. CX Codex ★ 6 505звёзд репо playwright-ci testdino-hq Скилл playwright-ci для Claude Code с готовыми конфигурациями CI/CD для Playwright: GitHub Actions, GitLab CI, CircleCI, Azure DevOps, Jenkins и Docker. Закрывает пайплайн, когда тесты уже написаны, а он всё ещё падает. CX Codex +1 604установок systematic-debugging Jesse Vincent Скилл systematic-debugging для Claude Code и Codex блокирует фиксы до завершения анализа первопричины. Включается при падении тестов, баге или неожиданном поведении. CX Codex +1 306 118установок

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

Весь набор →
ns-langgraph-agents Скилл ns-langgraph-agents для Claude Code, Codex, Cursor и других платформ, который ведёт разработку LangGraph.js agent-api от начального развёртывания до синхронизации graph-spec. CX Codex +1 171установок ns-execution-gitlab-issue Скилл ns-execution-gitlab-issue автоматизирует закрытие задач GitLab: изолирует работу в Git worktree, переключает статусы, запускает кодинг и создаёт Merge Request. CX Codex +1 165установок ns-requirements-enricher Скилл ns-requirements-enricher собирает бриф по реализации для одной задачи GitLab или вставленного описания: сначала смотрит код проекта, потом задаёт блокирующие вопросы в чате. CX Codex +1 163установок ns-best-practices Скилл ns-best-practices проверяет заголовки безопасности, базовую доступность интерфейса и правила Web Interface Guidelines. Находит уязвимости и готовит отчёт. CX Codex +1 154установок ns-frontend-design Скилл ns-frontend-design для Claude Code, Codex, Cursor и других агентов — строит production-интерфейсы с типографикой, иерархией и анимацией. Срабатывает на страницах, компонентах, дашбордах, формах и KPI-аналитике. CX Codex +1 153установок ns-autonomous Скилл ns-autonomous для Claude Code, Codex, Cursor, Copilot и Gemini CLI, который берёт локальный план или произвольный текст и выполняет его автономно в изолированном worktree. CX Codex +1 152установок ns-e2e-tests Скилл ns-e2e-tests задаёт структуру Cypress E2E-тестов, команд и сценариев для разных устройств. Нужен при создании и рефакторинге тестов. CX Codex +1 151установок ns-backend-tests Скилл ns-backend-tests для написания и запуска unit- и интеграционных тестов PHPUnit прямо в IDE. Работает только в Docker-контейнере, помогает быстро покрыть тестами новый Laravel-проект или переписать существующие тесты. CX Codex +1 151установок

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

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