logging-best-practices · ncklrs — скилл для Claude Code
Скилл logging-best-practices учит агента внедрять широкие события, структурированные логи и сэмплирование вместо сотен разрозненных сообщений на один HTTP-запрос.
лицензия не указана 148 установок ★ 54 обновлён 2026-02-26
npx skills add ncklrs/startup-os-skills --skill logging-best-practices -a claude-codeЧто делает logging-best-practices
Скилл переносит в проект правила наблюдаемости по подходу Бориса Тане: вместо размазанных по коду logger.info агент формирует один детальный объект события на каждый входящий запрос. Такой лог собирает контекст выполнения шаг за шагом и сбрасывается в хранилище только в конце работы обработчика.
Внутри заложены шаблоны проектирования полей высокой кардинальности, правила сэмплирования по итогу запроса (tail sampling) и поиск антипаттернов в существующей кодовой базе. Рекомендации ориентируют на насыщенные события с 40 и более параметрами, по которым проще строить выборки в аналитике.
Если сервис пишет строчные сообщения без структуры, внедрение потребует перестройки контекста запросов, иначе польза от широких событий теряется.
Какие задачи решает
- переписать разрозненные вызовы логгера на модель единого широкого события
- спроектировать поля высокой кардинальности для поиска инцидентов
- настроить хвостовое сэмплирование для экономии дискового пространства
- найти антипаттерны логирования при ревью чужого пуллреквеста
Примеры запросов агенту
- Проверь логирование в
src/checkout.tsи переделай его на широкие события - Помоги спроектировать структуру полей лога для нового платёжного сервиса
- Настрой сэмплирование логов, чтобы сохранять только ошибки и медленные ответы
Как установить logging-best-practices
1Через Skills CLI (Vercel)
npx skills add ncklrs/startup-os-skills --skill logging-best-practices -a claude-code2Вручную: положить файлы
~/.claude/skills/logging-best-practices/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/logging-best-practices/
1Через Skills CLI (Vercel)
npx skills add ncklrs/startup-os-skills --skill logging-best-practices -a codex2Вручную: положить файлы
.agents/skills/logging-best-practices/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add ncklrs/startup-os-skills --skill logging-best-practices -a cursor2Вручную: положить файлы
.cursor/skills/logging-best-practices/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install ncklrs/startup-os-skills skills/logging-best-practices2Вручную: положить файлы
.github/skills/logging-best-practices/SKILL.md1Через Skills CLI (Vercel)
npx skills add ncklrs/startup-os-skills --skill logging-best-practices -a gemini-cli2Командой платформы
gemini skills install https://github.com/ncklrs/startup-os-skills --path skills/logging-best-practicesВручную: положить файлы
.devin/skills/logging-best-practices/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add ncklrs/startup-os-skills --skill logging-best-practices -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о logging-best-practices
Как установить logging-best-practices в Claude Code?
Выполните команду npx skills add ncklrs/startup-os-skills --skill logging-best-practices -a claude-code.
Что делает скилл logging-best-practices?
Он направляет ИИ-агента при настройке структурированного логирования, заменяя разрозненный вывод на одно подробное событие на запрос.
Что такое широкие события в архитектуре скилла?
Это подход, при котором система накапливает контекст обработки запроса и отправляет один подробный JSON с десятками параметров вместо множества мелких строк.
Похожие скиллы
Все скиллы по теме «Бэкенд и API» →Сначала — logging-best-practices от других авторов.