distributed-debugging-debug-trace — скилл для Claude Code: отладка
Скилл distributed-debugging-debug-trace помогает настроить отладку и распределённую трассировку: границы трейсов, ключевые спаны, корреляционные ID и проверка покрытия запроса.
MIT ★ 50 109 обновлён 2026-10-29
npx skills add sickn33/agentic-awesome-skills --skill distributed-debugging-debug-trace -a claude-codeЧто делает distributed-debugging-debug-trace
Скилл ведёт агента по шагам: найти сервисы и границы трейсов, выделить ключевые спаны, поднять локальную отладку и трассировку, безопасную для прода, свести поля логов и correlation ID к одному виду, проверить покрытие пути запроса и сэмплирование. Задачу вы описываете в $ARGUMENTS, а детальные паттерны лежат в resources/implementation-playbook.md.
Плейбук — не готовый стек. Классы там иллюстративные, часть методов и импортов не дописана, конфиги OpenTelemetry и Sentry привязаны к конкретным версиям. Сверьте их с закреплёнными у вас версиями и с тем, что уже инструментировано, иначе получите дублирующиеся серверные спаны. Автор помечает скилл как risk: critical, и это по делу: отладчик исполняет код, а снимки heap и core выносят наружу всё, что было в памяти.
Инспекторы и дашборды держите на loopback за авторизованным туннелем, ограничьте длительность и объём снимков, вычищайте секреты и PII до экспорта, временный доступ снимайте после работы. Пауза, профилирование и правки телеметрии на проде требуют разрешения с ограниченным scope и плана отката. Успешный парсинг конфига ещё не доказывает, что трассировка сквозная.
Какие задачи решает
- Настроить трассировку в системе из нескольких сервисов
- Свести поля логов и correlation ID к одному виду
- Проверить, что трейсы покрывают весь путь запроса
- Разобрать инцидент на проде, не оставляя verbose-логинг включённым
- Убрать секреты и PII из трейсов перед выгрузкой
Примеры запросов агенту
- Опиши, как настроить распределённую трассировку для сервиса заказов: границы трейсов, ключевые спаны, корреляционные ID
- Проверь, что наши трейсы покрывают весь путь запроса и сэмплирование не режет медленные вызовы
- Разбери инцидент на проде: какие снимки снять и как не утащить секреты в выгрузку
Как установить distributed-debugging-debug-trace
1Через Skills CLI (Vercel)
npx skills add sickn33/agentic-awesome-skills --skill distributed-debugging-debug-trace -a claude-code2Вручную: положить файлы
~/.claude/skills/distributed-debugging-debug-trace/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/distributed-debugging-debug-trace/
1Через Skills CLI (Vercel)
npx skills add sickn33/agentic-awesome-skills --skill distributed-debugging-debug-trace -a codex2Вручную: положить файлы
.agents/skills/distributed-debugging-debug-trace/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add sickn33/agentic-awesome-skills --skill distributed-debugging-debug-trace -a cursor2Вручную: положить файлы
.cursor/skills/distributed-debugging-debug-trace/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install sickn33/agentic-awesome-skills skills/distributed-debugging-debug-trace2Вручную: положить файлы
.github/skills/distributed-debugging-debug-trace/SKILL.md1Через Skills CLI (Vercel)
npx skills add sickn33/agentic-awesome-skills --skill distributed-debugging-debug-trace -a gemini-cli2Командой платформы
gemini skills install https://github.com/sickn33/agentic-awesome-skills --path skills/distributed-debugging-debug-traceВручную: положить файлы
.devin/skills/distributed-debugging-debug-trace/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add sickn33/agentic-awesome-skills --skill distributed-debugging-debug-trace -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о distributed-debugging-debug-trace
Как установить distributed-debugging-debug-trace в Claude Code?
Выполните npx skills add sickn33/agentic-awesome-skills --skill distributed-debugging-debug-trace -a claude-code. Файл скилла появится по пути ~/.claude/skills/distributed-debugging-debug-trace/SKILL.md.
Что делает distributed-debugging-debug-trace?
Разбирает настройку отладки и трассировки: границы трейсов, ключевые спаны, единые поля логов и correlation ID, проверку покрытия и сэмплирования. Отдельно оговаривает, как не уронить прод и не слить секреты.
Можно ли применять его на продакшене?
Для продакшн-безопасной трассировки да, с оговорками. Verbose-трейсинг без защиты включать нельзя, а пауза, профилирование и правки телеметрии требуют разрешения с ограниченным scope и плана отката.
Исходный текст
SKILL.md · MIT
--- name: distributed-debugging-debug-trace description: "You are a debugging expert specializing in setting up comprehensive debugging environments, distributed tracing, and diagnostic tools. Configure debugging workflows, implement tracing solutions, and establish troubleshooting practices for development and production environments." risk: critical source: community date_added: "2026-02-27" --- # Debug and Trace Configuration You are a debugging expert specializing in setting up comprehensive debugging environments, distributed tracing, and diagnostic tools. Configure debugging workflows, implement tracing solutions, and establish troubleshooting practices for development and production environments. ## Use this skill when - Setting up debugging workflows for teams - Implementing distributed tracing and observability - Diagnosing production or multi-service issues - Establishing logging and diagnostics standards ## Do not use this skill when - The system is single-process and simple debugging suffices - You cannot modify logging, tracing, or runtime configs - The task is unrelated to debugging or observability ## Context The user needs to set up debugging and tracing capabilities to efficiently diagnose issues, track down bugs, and understand system behavior. Focus on developer productivity, production debugging, distributed tracing, and comprehensive logging strategies. ## Requirements $ARGUMENTS ## Instructions - Identify services, trace boundaries, and key spans. - Configure local debugging and production-safe tracing. - Standardize log/trace fields and correlation IDs. - Validate end-to-end trace coverage and sampling. - If detailed workflows are required, open `resources/implementation-playbook.md`. ## Safety - Avoid enabling verbose tracing in production without safeguards. - Redact secrets and PII from logs and traces. ## Deployment and evidence boundary The playbook contains incomplete illustrative classes, undefined helper methods/imports and version-specific OpenTelemetry/Sentry configuration, not a ready-to-run debug stack. Inspect pinned APIs and existing instrumentation before adapting it; avoid duplicate server spans and extract/propagate trace context through supported instrumentation. Debuggers can execute code and heap/core snapshots can expose every in-memory secret. Keep inspectors and dashboards loopback-only behind approved authenticated tunnels, cap snapshot duration/disk/overhead, redact before export and remove temporary access after use. Production pause/profile/telemetry changes require scoped authorization and rollback. Do not replace process-global console methods per request or return sensitive diagnostics in response headers. A successful config parse does not establish end-to-end trace coverage or application correctness. ## Resources - `resources/implementation-playbook.md` for detailed tooling and configuration patterns. ## Limitations - Use this skill only when the task clearly matches the scope described above. - Do not treat the output as a substitute for environment-specific validation, testing, or expert review. - Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
© sickn33 · MIT · sickn33/agentic-awesome-skills