Community코딩 & 개발github.com

sk-react

React 및 TypeScript 컴포넌트를 구축하고 수정합니다. 상태 배치, 효과 의존성, 데이터 가져오기, 목록 렌더링 및 스테일(stale) 또는 무한 루프 UI를 유발하는 리렌더링 트랩을 다룹니다. React 컴포넌트나 훅을 작성/변경할 때, 스테일 데이터, 무한 렌더링 루프, 입력 손실을 디버깅할 때, 또는 프론트엔드 코드를 리뷰할 때 사용하세요.

sk-react란 무엇인가요?

이 에이전트 스킬은 React와 TypeScript로 구축된 프론트엔드 개발을 지원합니다. 상태 관리, 효과(effect), 데이터 가져오기, 렌더링 및 TypeScript 사용 모범 사례를 중점적으로 다룹니다. 가장 일반적인 React 버그인 스테일 데이터와 무한 렌더링 루프를 방지하는 데 핵심적인 역할을 하는 '상태는 한 곳에' 원칙부터 시작합니다. 또한, 의존성 배열 관리, 정리(cleanup) 함수, 비동기 함수 처리 등 `useEffect`의 올바른 사용법을 안내합니다. 이 스킬은 VSCode, Cursor, Windsurf 등 다양한 AI 코딩 어시스턴트 플랫폼에서 사용 가능하며, 개발자가 직접 데이터 가져오기 로직을 작성할 때 놓치기 쉬운 로딩, 오류, 취소 처리 등 4가지 상태를 모두 다루도록 돕습니다. TypeScript 측면에서는 `any` 타입 사용을 지양하고, 경계(boundary)에서 타입을 검증하는 방법을 제안합니다. 결론적으로 이 스킬은 React 개발자가 흔히 범하는 실수를 예방하고, 유지보수 가능하고 안정적인 UI를 구축하도록 안내하는 실용적인 가이드 역할을 합니다.

지원 대상~Claude Code~Codex CLI~Cursor
Part ofReact
npx skills add https://github.com/vanhuydotcom/sk-skills/tree/HEAD/skills/sk-react

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

React와 TypeScript

상태는 한 곳에

모든 값은 정확히 하나의 소유자를 가져야 합니다. 대부분의 React 버그는 동일한 사실에 대한 두 개의 복사본이 서로 일치하지 않는 데서 발생합니다.

저장하는 대신 파생(derive)하세요. 값을 props와 state로부터 렌더링 중에 계산할 수 있다면, 계산하세요. useState에 복사하지 마세요. 복사본은 원본이 변경되는 순간 스테일(stale) 상태가 됩니다. const total = items.reduce(...)는 state가 필요 없으며 절대 잘못될 일이 없습니다.

props에서 복사한 state는 더 지연된 동일한 버그입니다. useState의 초기값은 한 번 읽힌 후 영원히 무시됩니다. 컴포넌트가 prop 변경 시 리셋되어야 한다면, key를 부여하고 React가 다시 마운트하도록 하세요.

state를 필요한 가장 가까운 공통 부모까지만 끌어올리세요. 더 위로 끌어올리면 모든 형제가 키 입력마다 리렌더링됩니다.

효과(Effects)

effect는 React 외부의 어떤 것(구독, 타이머, document, 명령형 라이브러리)과 동기화합니다. 값을 계산하거나 클릭에 응답하는 용도가 아닙니다. 클릭은 이벤트 핸들러가 처리합니다.

dependency 배열은 effect가 읽는 모든 것을 나열해야 합니다. 루프를 멈추기 위해 값을 생략하면 해당 값이 첫 번째 값으로 고정되어 스테일 클로저 버그가 발생합니다. effect가 의존성이 객체이거나 렌더링마다 재생성되는 함수일 때 루프를 유발한다면, 배열에서 삭제하는 대신 useCallback, useMemo를 사용하거나 컴포넌트 외부로 이동하여 의존성을 수정하세요.

effect가 자신보다 오래 지속될 수 있는 무언가를 시작할 때마다 정리(cleanup) 함수를 반환하세요. 구독, 타이머, 진행 중인 요청은 컴포넌트가 언마운트되거나 의존성이 변경될 때 중지되어야 합니다. StrictMode에서의 개발 환경에서는 effect가 특히 누락된 정리를 노출하기 위해 두 번 실행됩니다.

async 함수는 effect 본문이 될 수 없습니다. Promise를 반환하며, React는 정리 함수를 기대합니다. async 작업을 내부에서 선언하고 호출하세요.

데이터 가져오기

effect에서 수동으로 데이터를 가져오는 것보다 프로젝트의 데이터 라이브러리를 선호하세요. 캐싱, 중복 제거, 재시도 및 여러분이 곧 작성하게 될 경쟁 상태(race condition)를 이미 해결해 놓았습니다.

수동으로 가져올 때는 로딩, 빈 상태, 오류, 성공의 네 가지 상태를 모두 처리하고 정리 시 요청을 취소하세요. 순서대로 시작된 두 요청이 순서대로 완료되지 않을 수 있으므로, 이전 요청을 중단(abort)하거나 더 이상 최신이 아닌 응답을 무시하세요.

rejection(거부)을 삼키지 마세요. 핸들러나 effect에서 처리되지 않은 rejection은 조용히 실패하고 UI가 업데이트를 중단합니다.

렌더링

데이터의 안정적인 ID(identity)로 목록에 키를 지정하세요. 인덱스 키는 목록이 재정렬, 삽입 또는 삭제되지 않는 경우에만 정확합니다. 그렇지 않으면 React가 잘못된 DOM 노드를 재사용하고 입력이 이전 행의 값을 유지합니다.

memo, useMemo, useCallback은 프로파일러로 측정한 후에 사용하세요. 기본적으로 모든 곳에 적용하면 할당과 의존성 배열이 추가되어 문제가 발생하며, 실제 비용이 부모가 전체 트리를 리렌더링하는 것일 때는 아무것도 해결하지 못합니다.

훅을 조건부로, 루프 내에서, 또는 조기 반환(early return) 후에 호출하지 마세요. 순서는 모든 렌더링에서 동일해야 합니다.

TypeScript

any와 타입 단언(type assertion)은 해결책이 아닌 미해결 질문으로 취급하세요. 둘 다 컴파일러가 유용한 정보를 제공하려던 정확한 지점에서 컴파일러를 침묵시킵니다. 타입이 진정으로 알 수 없는 경우 unknown을 사용하고 좁혀나가세요.

경계(boundary)를 교차하는 데이터에 타입을 지정하세요: API 응답, 폼 값, URL 파라미터. 네트워크에서 가져온 데이터는 무언가 검증하기 전까지는 선언된 타입이 아닙니다. 따라서 경계에서 검증하고 나머지 앱은 결과를 신뢰하도록 하세요.

확인(Verify)

빌드 성공이 보이는 것보다 덜 의미합니다. 많은 프로젝트가 빌드 중 lint와 타입 오류를 무시하도록 프레임워크를 구성하므로, 빌드를 증거로 삼기 전에 설정을 확인하고 타입 검사와 linter를 명시적으로 실행하세요.

그런 다음 컴포넌트를 사용해 보세요: 빈 상태, 오류 상태, 느린 네트워크, 그리고 첫 번째 작업이 끝나기 전의 두 번째 빠른 상호작용을 테스트하세요.

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

sk-api

Design and change API contracts (REST, gRPC, protobuf, events) so existing callers keep working, covering resource and method shape, error models, pagination, versioning and the deploy order a breaking change requires. Use when adding or altering an endpoint, message or event, or when judging whether a proposed change breaks a consumer.

sk-code-review

Shows an agent how to design, debug, or review "sk code review" so the concrete output is a code change with a check. The procedure moves through Code review, Establish the diff first, What to look for, in priority order. Use it when a new assignment calls for this craft.

sk-go-service

Implement, extend or debug a handler, service or repository in a Go backend service, covering context propagation, error wrapping, transaction boundaries, tenancy scoping and table-driven tests. Use when writing or changing Go server code, adding an endpoint or gRPC method, touching a repository query, or diagnosing a panic, leak or flaky test in a Go service.

sk-python

Write and debug Python with attention to the traps that produce silent wrong behaviour — mutable defaults, late-binding closures, shallow copies, swallowed exceptions — plus typing, environment and packaging with uv or venv, and pytest structure. Use when writing a Python script, service or library, setting up a Python project, or debugging behaviour that looks impossible.

sk-system-design

Design or evaluate a distributed system from its constraints — service boundaries, synchronous versus event-driven communication, consistency, failure behaviour and capacity — and state the trade-off each choice buys. Use when splitting or merging services, choosing between a call and an event, deciding where data lives, reviewing an architecture proposal, or answering a system design question.

관련 스킬