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

distributed-debugging-debug-trace — скилл для Claude Code: отладка

Скилл distributed-debugging-debug-trace помогает настроить отладку и распределённую трассировку: границы трейсов, ключевые спаны, корреляционные ID и проверка покрытия запроса.

MIT ★ 50 109 обновлён 2026-10-29

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add sickn33/agentic-awesome-skills --skill distributed-debugging-debug-trace -a claude-code
Открыть на GitHub

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

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

~/.claude/skills/distributed-debugging-debug-trace/SKILL.md

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

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

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

Все скиллы по теме «DevOps и инфраструктура» →
distributed-debugging Seth Hobson Плагин distributed-debugging для трассировки и отладки распределённых систем: помогает разбираться, что происходит между микросервисами. CX Codex ★ 42 780звёзд репо sentry-otel-exporter-setup getsentry Скилл sentry-otel-exporter-setup помогает агенту собрать OpenTelemetry Collector, который отправляет трейсы и логи в Sentry, с маршрутизацией по нескольким проектам. CX Codex +1 2 500установок debug-trace Seth Hobson Команда debug-trace настраивает среду отладки и трассировки: от готовых конфигов .vscode/launch.json до удалённого сервера на WebSockets. Помогает быстро локализовать сбои в коде. CX Codex +1 ★ 42 780звёзд репо analyzing-mlflow-trace mlflow Скилл analyzing-mlflow-trace разбирает один трейс MLflow по его ID: находит ошибки, объясняет поведение и указывает, где именно всё сломалось. CX Codex +1 1 000установок observe-trace ruvnet Скилл observe-trace собирает спаны распределённой трассировки по идентификатору задачи и строит дерево выполнения с таймингами. Помогает разобрать задержки между агентами. CX Codex +1 733установок agent-observability-trace-rca datadog-labs Скилл agent-observability-trace-rca для Claude Code и других платформ: идёт по дереву спанов продакшн-трейсов от симптома к корню сбоя LLM-приложения. Разбирает падение оценок и рантайм-ошибки. CX Codex +1 688установок

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

Весь набор →
security-compliance-compliance-check Скилл security-compliance-compliance-check помогает спланировать аудит ПО на соответствие GDPR, HIPAA, SOC2 и PCI-DSS, подготовить чеклисты контроля и шаблоны регламентов. CX Codex +1 ★ 50 109звёзд репо varlock-claude-skill Скилл varlock-claude-skill задаёт проверки для работы с переменными окружения и снижает риск утечки секретов в сессии, логах и коммитах. CX Codex +1 ★ 50 109звёзд репо secrets-management Скилл secrets-management проводит агента по работе с секретами в CI/CD: выбор хранилища, короткоживущие identity, ротация и проверка, что значения не утекли в логи и артефакты. CX Codex +1 ★ 50 109звёзд репо security-scanning-security-sast Скилл security-scanning-security-sast для Claude Code и Codex: статический анализ кода (SAST) выявляет уязвимости, захардкодированные секреты и нарушения политик безопасности во множестве языков и фреймворков. CX Codex +1 ★ 50 109звёзд репо distributed-tracing Скилл distributed-tracing для Claude Code помогает настроить сквозную трассировку микросервисов через OpenTelemetry, Jaeger и Tempo, связать спаны между сервисами и избежать утечки секретов в трейсы. CX Codex +1 ★ 50 109звёзд репо observability-monitoring-slo-implement Скилл observability-monitoring-slo-implement для Claude Code помогает определить SLI и SLO, настроить бюджеты ошибок и мониторинг надёжности сервиса. Связывает цели надёжности с развитием продукта. CX Codex +1 ★ 50 109звёзд репо create-pr Скилл create-pr для Claude Code и других агентов перенаправляет запросы на создание или обновление pull request в канонический процесс pr-writer. CX Codex +1 ★ 50 109звёзд репо observability-monitoring-monitor-setup Скилл observability-monitoring-monitor-setup, с которым агент проектирует сбор метрик, трейсинг, логи и дашборды для приложения и инфраструктуры под ним. CX Codex +1 ★ 50 109звёзд репо

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

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