advanced-use-latest — правило для Claude Code
Правило advanced-use-latest для Claude показывает, как в эффектах React брать свежий колбэк, не добавляя его в массив зависимостей.
MIT ★ 7 191 обновлён 2026-10-24
.claude/rules/advanced-use-latest.mdЧто делает advanced-use-latest
Правило описывает один приём в React: обработчик, нужный эффекту, оборачивают в useEffectEvent. Свежее значение колбэка остаётся доступным внутри эффекта, а перезапуск происходит только по тем значениям, которые эффект действительно читает.
В примере — поле поиска с дебаунсом на 300 мс. В неудачной версии onSearch лежит в зависимостях рядом с query, поэтому таймер сбрасывается каждый раз, когда родитель передал новую функцию. В исправленной версии обёртка onSearchEvent держит актуальный колбэк, а в массиве остаётся только query.
Сам файл помечен как LOW impact: правка точечная, структуру компонента она не меняет. Рассчитан приём на useEffectEvent из react, поэтому в проекте, где этот хук ещё не экспортируется, пример из правила не соберётся.
Какие задачи решает
- убрать колбэк из массива зависимостей эффекта
- остановить повторный запуск эффекта при каждой смене обработчика
- избежать устаревшего замыкания в таймере поиска
- переписать дебаунс на
useEffectEvent
Примеры запросов агенту
- Перепиши этот эффект на
useEffectEvent, чтобыonSearchне попадал в зависимости. - Проверь
SearchInput: из-за колбэка в зависимостях таймер перезапускается на каждый рендер. - Покажи, как оставить в зависимостях только
query, а обработчик брать свежим.
Как установить advanced-use-latest
Вручную: положить файлы
.claude/rules/advanced-use-latest.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/advanced-use-latest.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/advanced-use-latest.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/advanced-use-latest.mdВручную: положить файлы
.clinerules/advanced-use-latest.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы об advanced-use-latest
Как установить advanced-use-latest в Claude Code?
Добавьте в проект файл по пути .claude/rules/advanced-use-latest.md с текстом правила.
Что делает advanced-use-latest?
Описывает, как обернуть обработчик в useEffectEvent, чтобы эффект читал его последнюю версию и не зависел от него в массиве зависимостей.
Что нужно, чтобы пример из правила заработал?
Хук useEffectEvent, импортированный из react. В версии React, где его нет, код из примера не скомпилируется.
Исходный текст
advanced-use-latest.md · MIT
---
title: useEffectEvent for Stable Callback Refs
impact: LOW
impactDescription: prevents effect re-runs
tags: advanced, hooks, useEffectEvent, refs, optimization
---
## useEffectEvent for Stable Callback Refs
Access latest values in callbacks without adding them to dependency arrays. Prevents effect re-runs while avoiding stale closures.
**Incorrect (effect re-runs on every callback change):**
```tsx
function SearchInput({ onSearch }: { onSearch: (q: string) => void }) {
const [query, setQuery] = useState('')
useEffect(() => {
const timeout = setTimeout(() => onSearch(query), 300)
return () => clearTimeout(timeout)
}, [query, onSearch])
}
```
**Correct (using React's useEffectEvent):**
```tsx
import { useEffectEvent } from 'react';
function SearchInput({ onSearch }: { onSearch: (q: string) => void }) {
const [query, setQuery] = useState('')
const onSearchEvent = useEffectEvent(onSearch)
useEffect(() => {
const timeout = setTimeout(() => onSearchEvent(query), 300)
return () => clearTimeout(timeout)
}, [query])
}
```
© tech-leads-club · MIT · tech-leads-club/agent-skills