debug-voice — скилл для Claude Code: лог голосовых сессий

Что делает debug-voice

Скилл нужен, когда голосовой режим работает криво, а посмотреть, что именно произошло в сессии, негде. Агент не слышит приложение, поэтому лог становится его ушами, а вы — судьёй: сначала он читает проект, потом показывает план правок и останавливается. Ничего не редактируется, пока вы не согласитесь или не вычеркнете лишние строки.

Дальше в код приложения добавляется контракт логирования: клиентский логгер копит записи и раз в секунду (или на 200 записях) шлёт их на dev-эндпоинт POST /api/voice/log, а тот дописывает NDJSON в .voice-logs/<sessionId>.ndjson. Хуки ставятся на старт сессии, получение токена, доступ к микрофону, состояние сокета, события клиента и сервера, а также на аудио: входящие чанки агрегируются окнами по 2 с, первый и последний дельты ответа считаются по байтам и задержкам. Аудио никогда не пишется в лог — только количество байт и RMS. Токены, ключи и строки длиннее 400 символов тоже вырезаются.

Всё это работает на любом стеке: скилл пишет код на языке и в стиле самого проекта, вторую тулчейн-линию для логирования не заводит. Эндпоинт отдаёт 404 вне dev, если не выставлен VOICE_LOG=1, — это главная защита от того, чтобы отладочный поток уехал в прод. Дальше начинается цикл правок: жалоба сопоставляется с сигнатурами в логе, правится одна вещь, потом повторный тест.