debug-plan-cache-misses — скилл Claude Code: отладка кэша
Выявляет промахи кэша планов в логах движка Chalk и сопоставляет тела запросов. Помогает устранить скачки времени ответа из-за повторной компиляции.
npx skills add chalk-ai/chalk-ai-plugins --skill debug-plan-cache-misses -a claude-codeЧто делает debug-plan-cache-misses
Скилл автоматизирует разбор логов Chalk через консольную утилиту. Когда внешне одинаковые запросы повторно компилируют план выполнения на горячем пути, растёт время ответа. Агент находит записи о промахах кэша, извлекает строки расчёта плана и сравнивает их структуру.
Ключ кэша строится на основе всего объекта BatchQuery. Чаще всего план строится заново из-за разного набора признаков в given_features — например, когда сервис то передаёт сырые данные, то опускает их. Скилл сопоставляет списки переданных признаков и параметры планировщика, чтобы точно указать причину несовпадения.
Инструмент только считывает логи и находит расхождения. Без установленной утилиты chalk CLI и доступа к нужному окружению проверить логи не получится. Править код вызывающего сервиса разработчику придётся вручную.
Какие задачи решает
- найти причину частых промахов кэша планов в Chalk
- сравнить два запроса и выявить различия в given_features
- отследить предупреждения о промахах кэша через chalk logs
- снизить задержки вызовов из-за повторной компиляции планов
Примеры запросов агенту
- Найди в логах Chalk промахи кэша для запроса sv5_idplus_features_parallel за последние сутки и сравни их
- Проверь через chalk logs, почему запросы с одинаковым именем компилируют план заново
- Посмотри частоту предупреждений missed the plan cache за последние 6 часов
Как установить debug-plan-cache-misses
1Через Skills CLI (Vercel)
npx skills add chalk-ai/chalk-ai-plugins --skill debug-plan-cache-misses -a claude-code2Вручную: положить файлы
~/.claude/skills/debug-plan-cache-misses/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/debug-plan-cache-misses/
1Через Skills CLI (Vercel)
npx skills add chalk-ai/chalk-ai-plugins --skill debug-plan-cache-misses -a codex2Вручную: положить файлы
.agents/skills/debug-plan-cache-misses/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add chalk-ai/chalk-ai-plugins --skill debug-plan-cache-misses -a cursor2Вручную: положить файлы
.cursor/skills/debug-plan-cache-misses/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install chalk-ai/chalk-ai-plugins debug-plan-cache-misses2Вручную: положить файлы
.github/skills/debug-plan-cache-misses/SKILL.md1Через Skills CLI (Vercel)
npx skills add chalk-ai/chalk-ai-plugins --skill debug-plan-cache-misses -a gemini-cli2Командой платформы
gemini skills install https://github.com/chalk-ai/chalk-ai-plugins --path plugins/chalk-plan-cache/skills/debug-plan-cache-missesВручную: положить файлы
.devin/skills/debug-plan-cache-misses/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add chalk-ai/chalk-ai-plugins --skill debug-plan-cache-misses -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о debug-plan-cache-misses
Как установить debug-plan-cache-misses в Claude Code?
Выполните в терминале команду npx skills add chalk-ai/chalk-ai-plugins --skill debug-plan-cache-misses -a claude-code. Конфигурация скилла запишется в ~/.claude/skills/debug-plan-cache-misses/SKILL.md.
Что делает скилл debug-plan-cache-misses?
Он ищет события вычисления плана в логах Chalk и сверяет параметры запросов. Это помогает выяснить, почему похожие запросы не используют готовый кэшированный план.
Что чаще всего вызывает промах кэша планов в Chalk?
Основная причина кроется в нестабильном наборе полей в given_features. Если вызывающий сервис меняет состав входных признаков между вызовами, движок формирует новый план исполнения.
