list-performance-item-expensive — правило для Claude Code
Правило list-performance-item-expensive запрещает тяжёлые элементы списка: запросы данных, лишние хуки и обращения к React Context прямо в renderItem.
MIT ★ 1 216 обновлён 2026-10-24
/plugin marketplace add fcakyon/claude-codex-settings
/plugin install react-skills@claude-settingsЧто делает 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-settings2Вручную: положить файлы
.claude/rules/list-performance-item-expensive.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/list-performance-item-expensive.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/list-performance-item-expensive.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/list-performance-item-expensive.mdВручную: положить файлы
.clinerules/list-performance-item-expensive.mdПо шагам, с командами для каждой платформы: 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