AIKraft/AI/Войти
AIKraft/Skills/convex-performance-audit

convex-performance-audit

Аудит производительности Convex: чтение, подписки, конфликты записей и лимиты функций. Помогает при медленных запросах, ошибках OCC и избыточном чтении. Начинает со сбора данных, затем направляет к справочным материалам для исправления паттернов.

get-convex official Разработка ★ 63

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

Skill диагностирует и устраняет проблемы производительности в приложениях Convex, такие как медленные запросы, ошибки OCC и избыточное чтение. Он помогает оптимизировать чтение, подписки, конфликты записей и лимиты функций, начиная со сбора данных и направляя к справочным материалам для исправления паттернов.

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

  • Страница или функция Convex работают медленно или дорого.
  • npx convex insights --details показывает высокое потребление байт, документов или частые конфликты OCC.
  • Потоки чтения с низкой свежестью используют реактивность там, где достаточно чтения в момент времени (point-in-time).
  • Возникают ошибки конфликтов OCC или чрезмерные повторные попытки мутаций.
  • Высокое количество подписок, медленные обновления UI или функции приближаются к лимитам выполнения.

Как работает

  1. Соберите сигналы производительности из Health insights, CLI (npx convex insights --details) или кода.
  2. Определите класс проблемы (горячий путь, конфликты OCC, стоимость подписок, бюджет функции) и прочитайте соответствующий reference файл.
  3. Ограничьте область проблемы одним конкретным пользовательским потоком, выявив функции входа, вызовы клиента и используемые таблицы.
  4. Отследите полный набор операций чтения и записи (ctx.db.get, query, patch, insert) для каждой функции в пути.
  5. Примените исправления из справочного файла, учитывая рекомендации по порядку действий.
  6. Проверите и исправьте функции-соседи (sibling functions), обращающиеся к тем же таблицам, чтобы обеспечить консистентность.

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

Проанализируй производительность функции listItems, так как npx convex insights --details показывает высокое потребление байт.
Устрани ошибки OCC в мутации updateProfile, используя справочник по конфликтам записей.
Оптимизируй подписки на странице Dashboard, где наблюдается медленное обновление UI и высокая стоимость реактивности.

Что понадобится

  • Установленный Convex CLI (npx convex)
  • Доступ к деплою для получения Health insights или возможность запуска insights локально
  • Наличие файлов references/hot-path-rules.md, references/occ-conflicts.md, references/subscription-cost.md, references/function-budget.md в репозитории

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

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

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

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