К основному содержанию
правило CX Codex

list-performance-item-expensive — правило для Claude Code

Правило list-performance-item-expensive запрещает тяжёлые элементы списка: запросы данных, лишние хуки и обращения к React Context прямо в renderItem.

MIT ★ 1 216 обновлён 2026-10-24

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add fcakyon/claude-codex-settings
/plugin install react-skills@claude-settings
Открыть на GitHub

Что делает list-performance-item-expensive

Правило требует держать компоненты строк списка максимально простыми: только пропсы-примитивы и минимум хуков. Запросы данных, вычисления рекомендаций и обращения к нескольким React Context внутри элемента списка запрещены — такой код должен уйти в родительский компонент, который один раз получает данные и передаёт их вниз готовыми значениями.

Для общих значений, которые меняются часто (например, статус товара в корзине), правило советует Zustand-селекторы вместо Context: Context триггерит перерендер всех строк при любом изменении значения, а селектор — только у того элемента, которого изменение касается. Отдельно упомянут приём с Set.has() вместо Array.includes() для проверки принадлежности элемента.

Ограничение по смыслу правила — виртуализированные списки прогоняют через рендер много элементов при скролле, и любая дорогая операция в строке превращается в заметные подвисания.

Какие задачи решает

  • убрать запросы данных из компонентов строк списка
  • заменить React Context на Zustand-селекторы в элементах списка
  • найти тяжёлые вычисления внутри renderItem
  • вынести загрузку данных в родительский компонент списка
  • устранить лишние перерендеры при скролле виртуализированного списка

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

  • Проверь компоненты строк списка на тяжёлые хуки и запросы по правилу list-performance-item-expensive
  • Перепиши ProductRow так, чтобы он получал только примитивы в пропсах
  • Замени useContext на Zustand-селектор в элементе списка

Как установить list-performance-item-expensive

1Через маркетплейс плагинов

/plugin marketplace add fcakyon/claude-codex-settings
/plugin install react-skills@claude-settings

2Вручную: положить файлы

.claude/rules/list-performance-item-expensive.md

Поле paths во frontmatter ограничивает файлы

По шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать

Вопросы о list-performance-item-expensive

Как установить list-performance-item-expensive в Claude Code?

Выполните /plugin marketplace add fcakyon/claude-codex-settings, затем /plugin install react-skills@claude-settings. Правило появится в проекте как .claude/rules/list-performance-item-expensive.md.

Что делает list-performance-item-expensive?

Правило требует, чтобы элементы списка оставались простыми функциями рендера: без запросов данных, без тяжёлых вычислений и с минимумом хуков и обращений к React Context.

Почему правило рекомендует Zustand вместо Context в списках?

Context вызывает перерендер всех элементов при изменении любого значения, а Zustand-селектор обновляет только тот элемент, которого касается конкретное изменение — это важно для виртуализированных списков с частым скроллом.

Исходный текст

list-performance-item-expensive.md · MIT
---
title: Keep List Items Lightweight
impact: HIGH
impactDescription: reduces render time for visible items during scroll
tags: lists, performance, virtualization, hooks
---

## Keep List Items Lightweight

List items should be as inexpensive as possible to render. Minimize hooks, avoid
queries, and limit React Context access. Virtualized lists render many items
during scroll—expensive items cause jank.

**Incorrect (heavy list item):**

```tsx
function ProductRow({ id }: { id: string }) {
  // Bad: query inside list item
  const { data: product } = useQuery(['product', id], () => fetchProduct(id))
  // Bad: multiple context accesses
  const theme = useContext(ThemeContext)
  const user = useContext(UserContext)
  const cart = useContext(CartContext)
  // Bad: expensive computation
  const recommendations = useMemo(
    () => computeRecommendations(product),
    [product]
  )

  return <View>{/* ... */}</View>
}
```

**Correct (lightweight list item):**

```tsx
function ProductRow({ name, price, imageUrl }: Props) {
  // Good: receives only primitives, minimal hooks
  return (
    <View>
      <Image source={{ uri: imageUrl }} />
      <Text>{name}</Text>
      <Text>{price}</Text>
    </View>
  )
}
```

**Move data fetching to parent:**

```tsx
// Parent fetches all data once
function ProductList() {
  const { data: products } = useQuery(['products'], fetchProducts)

  return (
    <LegendList
      data={products}
      renderItem={({ item }) => (
        <ProductRow name={item.name} price={item.price} imageUrl={item.image} />
      )}
    />
  )
}
```

**For shared values, use Zustand selectors instead of Context:**

```tsx
// Incorrect: Context causes re-render when any cart value changes
function ProductRow({ id, name }: Props) {
  const { items } = useContext(CartContext)
  const inCart = items.includes(id)
  // ...
}

// Correct: Zustand selector only re-renders when this specific value changes
function ProductRow({ id, name }: Props) {
  // use Set.has (created once at the root) instead of Array.includes()
  const inCart = useCartStore((s) => s.items.has(id))
  // ...
}
```

**Guidelines for list items:**

- No queries or data fetching
- No expensive computations (move to parent or memoize at parent level)
- Prefer Zustand selectors over React Context
- Minimize useState/useEffect hooks
- Pass pre-computed values as props

The goal: list items should be simple rendering functions that take props and
return JSX.

© fcakyon · MIT · fcakyon/claude-codex-settings

Похожие правила IDE

Все правила IDE по теме «Фронтенд и UI» →
list-performance-virtualize alexj11324 Правило list-performance-virtualize для Claude Code направляет работу со списками на виртуализацию. Оно срабатывает при создании прокручиваемого содержимого. CX Codex +1 ★ 88звёзд репо react-performance-optimizer curiositech Скилл react-performance-optimizer находит узкие места в рендере React-приложений для достижения 60fps. Решает проблемы с зависанием списков и раздутыми бандлами. CX Codex +1 215установок conductor-rewrite-performance boraoztunc Скилл conductor-rewrite-performance для Claude Code оптимизирует React-интерфейсы локальных десктопных приложений на Tauri, устраняя каскадные перерендеры и задержки при стриминге сообщений. CX Codex +1 186установок react-performance-expert carlrannaberg Субагент react-performance-expert ищет узкие места в React: медленные рендеры, лишние перерисовки, большие бандлы и проблемы с памятью. CX Codex ★ 763звёзд репо legend-list-best-practices LegendApp Скилл legend-list-best-practices для работы с виртуализированным списком @legendapp/list: помогает внедрить его по контрактам библиотеки или провести аудит существующего кода. CX Codex +1 562установок list-performance-images alexj11324 Правило list-performance-images для Claude Code задаёт способ загружать изображения в списках без лишних пикселей. Срабатывает при работе с миниатюрами в интерфейсе. CX Codex +1 ★ 88звёзд репо

Из того же набора113

Весь набор →
setup Скилл setup для Claude Code разворачивает интеграционные тесты и пользовательские сценарии тестирования в проекте. Включается при запросах настроить сквозное тестирование или добавить QA-сценарии. CX Codex +1 ★ 1 216звёзд репо list-performance-inline-objects Правило list-performance-inline-objects запрещает создавать объекты внутри renderItem для передачи в пропсы. Встроенные объекты создают новые ссылки на каждом рендере и ломают мемоизацию. CX Codex +1 ★ 1 216звёзд репо setup Команда setup настраивает ключ API для MCP-сервера Tavily в Claude Code и сохраняет его в конфигурационном файле плагина. CX Codex +1 ★ 1 216звёзд репо bundle-analyzable-paths Правило bundle-analyzable-paths просит оставлять пути импортов и файлов понятными для статического анализа. Это помогает не расширять сборку и трассировку файлов без необходимости. CX Codex +1 ★ 1 216звёзд репо ui-image-gallery Правило ui-image-gallery задаёт стандарты для мобильных галерей: заставляет ИИ использовать библиотеку @nandorojo/galeria вместо самодельных модальных окон на Modal. CX Codex +1 ★ 1 216звёзд репо rendering-resource-hints Правило rendering-resource-hints учит агента вставлять в React-компоненты вызовы API React DOM для подсказок браузеру о ресурсах. Встраивается в серверные компоненты, чтобы загрузка файлов стартовала раньше, чем клиент получит HTML. CX Codex +1 ★ 1 216звёзд репо animation-gesture-detector-press Правило animation-gesture-detector-press для Claude Code переносит анимацию нажатия кнопки React Native в UI-поток, без перехода в JS. Меняет масштаб или прозрачность при нажатии. CX Codex +1 ★ 1 216звёзд репо commit-staged Скилл commit-staged формирует структурированные коммиты: прогоняет diff через /simplify, смотрит только staged-файлы и собирает понятные сообщения из контекста сессии. CX Codex +1 ★ 1 216звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой