AIKraft/AI/Войти
AIKraft/Skills/OTel: инструментирование функциональности

OTel: инструментирование функциональности

Instrument any new feature, endpoint, route, handler, worker, job, CLI command, or user-facing flow with OpenTelemetry spans, metrics, and logs before it lands. Triggers on requests like 'add a new endpoint', 'implement X', 'create a handler for Y', 'build a job to Z', 'add this feature', 'wire up a new route', or any code change that introduces a new business operation.

SUSuperlog official Разработка

Что делает навык

Инструментирует новые бизнес-операции (endpoint, handler, job, CLI-команду и т.д.) с помощью OpenTelemetry, добавляя spans, метрики и логи. Проверяет наличие базовой настройки OTel в проекте перед внедрением.

Когда применять

  • Добавление нового HTTP-маршрута или RPC-хендлера
  • Реализация фонового задания (background job) или потребителя очереди
  • Создание CLI-подкоманды или cron-задачи
  • Добавление GraphQL-резолвера или агента-инструмента

Как работает

  1. Определить, является ли код новой бизнес-операцией (принимает запрос, выполняет работу, создает побочный эффект), а не просто вспомогательной логикой.
  2. Проверить наличие существующего bootstrap OTel (файлы telemetry.ts, init_observability() и т.д.).
  3. Если bootstrap отсутствует, сообщить пользователю о необходимости подключения через skill superlog-onboard, оставить один TODO в месте настройки и продолжить реализацию.
  4. Если bootstrap найден, прочитать соответствующий companion skill.
  5. Написать код функции с инструментированием OpenTelemetry.

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

добавить новый endpoint для обработки заказов
реализовать job для отправки email-рассылки
создать handler для Y и подключить новый route

Описание составлено по SKILL.md навыка, сверено 05.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «otel-instrument-feature» из репозитория: # https://github.com/superloglabs/skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r otel-instrument-feature/ ~/.claude/skills/otel-instrument-feature/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.