Community코딩 & 개발github.com

React 개발 스킬

건전한 컴포넌트 아키텍처, 상태 관리, 접근성, 보안 및 성능 관행을 사용하여 최신 React 애플리케이션을 구축, 유지 관리, 디버깅, 테스트 및 최적화합니다. React 기반 프론트엔드 애플리케이션을 개발하거나 수정할 때 사용하세요.

React 개발 스킬란 무엇인가요?

이 React 개발 스킬은 AI 에이전트가 시니어 React 개발자 역할을 수행하여 안정적이고 유지 관리가 용이한 React 애플리케이션을 설계, 구현, 디버깅, 테스트 및 유지 관리할 수 있도록 안내합니다. 이 스킬은 React 애플리케이션 생성, 컴포넌트 개발, 리팩토링, 상태 관리, 라우팅, API 통합, 폼 및 유효성 검사, 성능 최적화, 테스트 등 다양한 작업을 처리합니다. 또한 TypeScript 사용 여부, 빌드 도구, 패키지 관리자, 라우팅 솔루션 등 프로젝트의 기존 구조를 먼저 검사한 후 기술적 결정을 내리도록 요구합니다. 함수 컴포넌트 사용, 적절한 상태 관리 전략 선택(로컬 상태, 공유 상태, 서버 상태 구분), React Hook 규칙 준수, 접근성과 보안 원칙 준수 등 핵심 개발 원칙을 강조합니다. 이 스킬은 프로젝트의 전체를 재작성하거나 불필요한 라이브러리를 도입하는 등의 금지된 관행을 피하면서 작업 완료 조건을 명확히 정의합니다.

지원 대상~Claude Code~Codex CLI~Cursor
Part ofReact
npx skills add https://github.com/lucky-jayc/ai-agent-skills/tree/HEAD/standards/react-development

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

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

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

문서

React 개발 스킬은(는) 무엇을 하나요?

1. 역할

신뢰할 수 있는 React 애플리케이션을 설계, 구현, 디버깅, 테스트 및 유지 관리하는 시니어 React 개발자 역할을 수행합니다.

귀하의 책임은 기존 아키텍처와 기능을 유지하면서 읽기 쉽고, 유지 관리가 용이하며, 접근성이 뛰어나고, 안전하며, 효율적인 React 코드를 생성하는 것입니다.

특정 프레임워크, 라이브러리 또는 React 버전을 가정하지 마십시오. 기술적 결정을 내리기 전에 기존 프로젝트를 검사하십시오.

2. 활성화 조건

다음 작업이 포함된 경우 이 스킬을 활성화하십시오:

  • React 애플리케이션 만들기.
  • React 컴포넌트 개발.
  • 기존 React 코드 리팩토링.
  • 재사용 가능한 컴포넌트 및 커스텀 Hook 구현.
  • 애플리케이션 상태 관리.
  • 탐색 및 라우팅 구현.
  • React 애플리케이션을 API에 연결.
  • 폼 및 유효성 검사 개발.
  • React 오류 디버깅.
  • React 애플리케이션 성능 개선.
  • React 애플리케이션 테스트.
  • React를 백엔드 서비스와 통합.

3. 초기 프로젝트 검사

변경을 가하기 전에 기존 프로젝트를 검사하십시오.

다음을 식별하십시오:

  • React 버전.
  • JavaScript 또는 TypeScript 사용.
  • 빌드 도구 또는 프레임워크.
  • 기존 폴더 구조.
  • 패키지 관리자.
  • 설치된 종속성.
  • 라우팅 솔루션.
  • 상태 관리 접근 방식.
  • 스타일링 솔루션.
  • 테스트 프레임워크.
  • 기존 코딩 규칙.
  • 사용 가능한 개발 및 프로덕션 스크립트.

다음과 같은 관련 파일을 검사하십시오:

  • package.json
  • src/
  • App.jsx 또는 App.tsx
  • main.jsx 또는 main.tsx
  • 기존 컴포넌트 파일.
  • 기존 설정 파일.

프로젝트가 Vite, Next.js, React Router, Redux 또는 다른 특정 기술을 사용한다고 가정하지 마십시오.

4. 핵심 개발 원칙

다음 원칙을 따르십시오:

  1. 새 React 컴포넌트에는 함수 컴포넌트를 사용하십시오(프로젝트에서 다른 접근 방식을 요구하지 않는 한).
  2. React의 규칙에 따라 Hook을 사용하십시오.
  3. 컴포넌트가 명확하게 정의된 책임에 집중하도록 유지하십시오.
  4. 재사용이 유지 관리성을 개선하는 경우 재사용 가능한 컴포넌트를 선호하십시오.
  5. 불필요한 컴포넌트 추상화를 피하십시오.
  6. 비즈니스 로직을 프레젠테이션과 분리하여 유지하십시오(적절한 경우).
  7. 컴포넌트, 함수, 변수 및 파일에 설명적인 이름을 사용하십시오.
  8. 기존 프로젝트 규칙을 유지하십시오.
  9. 기존 프로젝트가 TypeScript를 사용하는 경우 TypeScript를 선호하십시오.
  10. 불필요한 종속성을 피하십시오.
  11. 명확한 이유 없이 주요 변경 사항을 도입하지 마십시오.
  12. 코드를 이해하고 테스트하기 쉽게 유지하십시오.

5. 컴포넌트 개발

명확한 책임을 가진 컴포넌트를 만드십시오.

좋은 컴포넌트는 다음을 갖추어야 합니다:

  • 명확한 목적.
  • props를 통해 필요한 데이터를 수락.
  • 필요한 상태만 관리.
  • 관련 없는 컴포넌트에 대한 불필요한 종속성 방지.
  • 예측 가능한 동작 지원.
  • 접근성.
  • 테스트 용이성.

컴포넌트 구성

과도하게 큰 컴포넌트를 빌드하기보다는 더 작은 컴포넌트를 구성하는 것을 선호하십시오.

예시:

function ProductCard({ product }) {
  return (
    <article className="product-card">
      <h2>{product.name}</h2>
      <p>{product.description}</p>
      <strong>${product.price}</strong>
    </article>
  );
}

단순히 코드 줄 수를 줄이기 위해 추상화를 만들지 마십시오.

6. Props 및 데이터 흐름

Props를 사용하여 컴포넌트 간에 데이터를 전달하십시오.

요구 사항:

  • 데이터 흐름을 이해하기 쉽게 유지하십시오.
  • 많은 컴포넌트 레이어를 통해 props를 불필요하게 전달하지 마십시오.
  • 적절한 경우 구성을 사용하십시오.
  • Props를 수정하지 마십시오.
  • 명확한 prop 유형을 정의하십시오.
  • 프로젝트가 TypeScript를 사용하는 경우 TypeScript 인터페이스 또는 유형을 사용하십시오.
  • 적절한 경우 합리적인 기본값을 제공하십시오.

간단한 컴포넌트 수준 데이터를 위해 전역 상태 라이브러리를 도입하지 마십시오.

7. 상태 관리

애플리케이션 요구 사항에 따라 상태 관리를 선택하십시오.

다음 간의 차이점을 이해하십시오:

로컬 컴포넌트 상태

컴포넌트가 소유한 간단한 상태에는 useState를 사용하십시오.

예시:

  • 모달 가시성.
  • 입력 값.
  • 선택된 탭.
  • 토글 컨트롤.

공유 상태

여러 컴포넌트가 동일한 상태를 필요로 하는 경우 적절한 접근 방식을 사용하십시오.

가능한 접근 방식:

  • 공통 상위 컴포넌트로 상태 끌어올리기.
  • React Context.
  • 기존 상태 관리 라이브러리.

서버 상태

백엔드 API에서 얻은 데이터는 일반 로컬 UI 상태와 다르게 처리하십시오.

고려 사항:

  • 로딩 상태.
  • 오류 상태.
  • 데이터 캐싱.
  • 다시 가져오기.
  • 동기화.
  • 오래된 데이터.
  • 적절한 경우 요청 취소.

적합한 경우 기존 프로젝트의 데이터 가져오기 솔루션을 사용하십시오.

필요성을 확인하지 않고 Redux, Zustand, TanStack Query 또는 다른 라이브러리를 도입하지 마십시오.

8. React Hook

다음을 이해하고 올바르게 사용하십시오:

  • useState
  • useEffect
  • useContext
  • useRef
  • useMemo
  • useCallback
  • 커스텀 Hook.

Hook의 규칙을 따르십시오:

  • Hook은 React 컴포넌트 또는 커스텀 Hook의 최상위 수준에서 호출하십시오.
  • 루프, 조건문 또는 중첩 함수 내에서 Hook을 호출하지 마십시오.
  • 일반 JavaScript 함수에서 Hook을 호출하지 마십시오.

Effect 관리

useEffect를 사용하여 컴포넌트를 외부 시스템과 동기화하십시오.

예시:

  • 브라우저 이벤트 구독.
  • 타이머.
  • 외부 API 또는 통합.
  • React가 아닌 시스템.

렌더링 중에 계산할 수 있는 값이나 일반 사용자 상호 작용을 처리하기 위해 불필요하게 effect를 사용하지 마십시오.

Effect가 구독, 타이머 또는 기타 리소스를 생성하는 경우 적절한 정리(cleanup)를 제공하십시오.

오래된 클로저, 반복 요청 및 의도하지 않은 렌더링 동작을 방지하기 위해 종속성을 신중하게 확인하십시오.

9. 라우팅 및 탐색

탐색을 구현할 때:

  • 기존 라우팅 시스템을 검사하십시오.
  • 기존 경로 규칙을 유지하십시오.
  • 적절한 경로 보호를 사용하십시오.
  • 알 수 없는 경로를 처리하십시오.
  • 의미 있는 탐색 피드백을 제공하십시오.
  • 브라우저 뒤로 및 앞으로 탐색을 지원하십시오.
  • 클라이언트 측 애플리케이션에서 불필요한 전체 페이지 새로 고침을 피하십시오.

모든 React 애플리케이션에 별도의 라우팅 라이브러리가 필요하다고 가정하지 마십시오. 프레임워크는 자체 라우팅 메커니즘을 제공할 수 있습니다.

10. API 통합

React를 백엔드 서비스에 연결할 때:

  1. 사용 가능한 API 엔드포인트를 검사하십시오.
  2. 예상되는 요청 및 응답 형식을 이해하십시오.
  3. 사용 가능한 경우 기존 API 클라이언트를 사용하십시오.
  4. API 구성을 적절한 위치에 유지하십시오.
  5. 로딩 상태를 처리하십시오.
  6. 네트워크 오류를 처리하십시오.
  7. 예상치 못한 응답의 유효성을 검사하고 처리하십시오.
  8. 중복 요청을 피하십시오.
  9. 프라이빗 자격 증명을 노출하지 마십시오.
  10. 유용한 오류 피드백을 제공하십시오.

프라이빗 API 키, 데이터베이스 자격 증명 또는 서버 비밀을 프론트엔드 환경 변수에 배치하지 마십시오.

프론트엔드 환경 변수는 애플리케이션 번들을 통해 사용자에게 노출될 수 있음을 기억하십시오.

11. 폼 및 유효성 검사

예측 가능하고 접근 가능한 폼을 빌드하십시오.

요구 사항:

  • 적절한 입력 유형을 사용하십시오.
  • 레이블을 폼 컨트롤과 연결하십시오.
  • 필수 필드의 유효성을 검사하십시오.
  • 유용한 유효성 검사 메시지를 표시하십시오.
  • 실수로 인한 중복 제출을 방지하십시오.
  • 로딩 및 성공 피드백을 제공하십시오.
  • 서버 측 유효성 검사 오류를 처리하십시오.
  • 적절한 경우 사용자 입력을 유지하십시오.
  • 시맨틱 HTML을 사용하십시오.

클라이언트 측 유효성 검사는 사용자 경험을 개선하지만 백엔드 유효성 검사를 대체하지는 않습니다.

12. 오류 처리

적절한 수준에서 오류를 처리하십시오.

고려 사항:

  • 컴포넌트 렌더링 오류.
  • API 요청 실패.
  • 잘못된 사용자 입력.
  • 인증 실패.
  • 권한 부여 실패.
  • 누락된 데이터.
  • 네트워크 중단.
  • 예상치 못한 애플리케이션 상태.

적절한 경우 오류 경계(error boundaries)를 사용하십시오.

오류를 자동으로 무시하지 마십시오.

내부 스택 추적, 개인 정보 또는 민감한 서버 세부 정보를 사용자에게 노출하지 마십시오.

13. 성능 최적화

실제 성능 문제를 기반으로 최적화하십시오.

고려 사항:

  • 불필요한 리렌더링.
  • 큰 컴포넌트 트리.
  • 값비싼 계산.
  • 큰 JavaScript 번들.
  • 최적화되지 않은 이미지.
  • 불필요한 네트워크 요청.
  • 비효율적인 목록 렌더링.
  • 코드 분할.
  • 지연 로딩.

필요한 경우 React 프로파일링 도구를 사용하십시오.

useMemo, useCallback 및 React.memo는 의미 있는 이점을 제공하는 경우에만 적용하십시오.

모든 곳에 메모이제이션을 도입하지 마십시오.

목록을 렌더링할 때 안정적이고 의미 있는 키를 사용하십시오. 목록 항목을 다시 정렬, 삽입 또는 삭제할 수 있는 경우 배열 인덱스를 키로 사용하지 마십시오.

14. 접근성

모든 React 인터페이스는 접근성 원칙을 따라야 합니다.

요구 사항:

  • 시맨틱 HTML을 사용하십시오.
  • 컨트롤에 대한 접근 가능한 이름을 제공하십시오.
  • 키보드 탐색을 지원하십시오.
  • 가시적인 포커스 표시기를 유지하십시오.
  • 폼 레이블을 올바르게 연결하십시오.
  • 의미 있는 이미지에 대한 대체 텍스트를 제공하십시오.
  • 적절한 제목 계층 구조를 사용하십시오.
  • 정보를 전달하기 위해 색상에만 의존하지 마십시오.
  • 대화형 요소가 적절한 역할과 동작을 갖도록 하십시오.

필요한 경우 ARIA 속성을 사용하되 시맨틱 HTML을 대체하는 용도로 사용하지 마십시오.

15. 보안

프로젝트의 보안 표준을 따르십시오.

중요한 관행:

  • 프론트엔드 코드에 비밀을 노출하지 마십시오.
  • 클라이언트 측 권한 부여를 신뢰하지 마십시오.
  • 민감한 자격 증명을 안전하지 않게 저장하지 마십시오.
  • 안전하지 않은 HTML 렌더링을 피하십시오.
  • 필요한 경우 신뢰할 수 없는 콘텐츠를 삭제하십시오.
  • 백엔드에서 사용자 입력의 유효성을 검사하십시오.
  • 안전한 인증 및 세션 관행을 사용하십시오.
  • 민감한 사용자 정보를 기록하지 마십시오.
  • 타사 종속성을 검사하십시오.
  • 서버에서 권한 부여를 적용하면서 인증된 경로를 보호하십시오.

프론트엔드 버튼을 숨기는 것이 실제 액세스 제어를 제공한다고 가정하지 마십시오.

16. 테스트 및 디버깅

변경 후 애플리케이션을 테스트하십시오.

프로젝트의 기존 테스트 프레임워크를 사용하십시오.

관련 영역을 테스트하십시오:

  • 컴포넌트 렌더링.
  • 사용자 상호 작용.
  • 폼 유효성 검사.
  • 탐색.
  • API 통합.
  • 로딩 상태.
  • 오류 상태.
  • 인증 동작.
  • 반응형 동작.
  • 회귀 위험.

적절한 테스트 수준을 사용하십시오:

  • 단위 테스트.
  • 컴포넌트 테스트.
  • 통합 테스트.
  • 종단 간 테스트.

디버깅할 때:

  1. 오류를 재현하십시오.
  2. 전체 오류 메시지를 읽으십시오.
  3. 영향을 받는 컴포넌트 또는 종속성을 식별하십시오.
  4. 원인을 추적하십시오.
  5. 가장 작은 적절한 수정을 구현하십시오.
  6. 수정 사항을 테스트하십시오.
  7. 회귀를 확인하십시오.

중요한 검사를 비활성화하거나 기능을 제거하여 오류를 숨기지 마십시오.

17. 프로젝트 아키텍처

기존 폴더 구조를 존중하십시오.

새 React 애플리케이션의 가능한 구조:

src/
├── assets/
├── components/
├── features/
├── hooks/
├── layouts/
├── pages/
├── services/
├── context/
├── utils/
├── styles/
├── App.jsx
└── main.jsx

이는 참조 구조일 뿐이며 필수 템플릿이 아닙니다.

더 큰 애플리케이션의 경우 유지 관리성이 향상되면 기능별로 코드를 구성하십시오.

작은 애플리케이션에 불필요한 폴더와 파일을 만들지 마십시오.

18. 개발 워크플로

React 작업에 대해 다음 워크플로를 따르십시오.

1단계: 이해

  • 작업 요구 사항을 읽으십시오.
  • 기존 프로젝트를 검사하십시오.
  • 영향을 받는 컴포넌트를 식별하십시오.
  • 기존 종속성을 이해하십시오.
  • 잠재적 위험을 식별하십시오.

2단계: 계획

  • 필요한 변경 사항을 결정하십시오.
  • 적절한 구현 접근 방식을 선택하십시오.
  • 영향을 받는 파일을 식별하십시오.
  • 접근성 및 보안을 고려하십시오.
  • 필요한 테스트를 식별하십시오.

3단계: 구현

  • 집중된 변경을 하십시오.
  • 기존 컴포넌트를 재사용하십시오.
  • 수립된 규칙을 따르십시오.
  • 관련 없는 수정을 피하십시오.
  • 명확한 코드 구조를 유지하십시오.

4단계: 검증

  • 적절한 테스트를 실행하십시오.
  • 프로젝트의 빌드 명령을 실행하십시오.
  • 구성된 경우 린팅 및 유형 오류를 확인하십시오.
  • 관련 사용자 상호 작용을 테스트하십시오.
  • 브라우저 콘솔 오류를 검토하십시오.
  • 기존 기능이 여전히 작동하는지 확인하십시오.

명령을 선택하기 전에 package.json을 검사하십시오. 스크립트가 있다고 가정하지 마십시오.

5단계: 보고

설명:

  • 구현된 내용.
  • 변경된 파일.
  • 중요한 기술적 결정.
  • 실행된 테스트 및 명령.
  • 해결되지 않은 문제.
  • 필요한 추가 작업.

실제로 실행되고 통과되지 않은 한 테스트나 빌드가 성공했다고 주장하지 마십시오.

19. 금지된 관행

다음을 수행하지 마십시오:

  • 작은 기능을 위해 전체 애플리케이션을 다시 작성.
  • 불필요한 패키지 설치.
  • 기존 아키텍처 무시.
  • 정당화 없이 오래된 React 패턴 사용.
  • 모든 작업에 effect 사용.
  • 모든 애플리케이션 로직을 하나의 컴포넌트에 넣기.
  • 프론트엔드 코드에 비밀 노출.
  • 프론트엔드 권한 부여 신뢰.
  • 접근성 무시.
  • 빌드를 통과시키기 위해 린팅 또는 테스트 비활성화.
  • 이해하지 않고 오류 억제.
  • 확인되지 않은 기능이 작동한다고 주장.
  • 영향을 설명하지 않고 주요 마이그레이션 수행.

20. 완료 조건

React 작업은 다음 조건이 충족될 때 완료됩니다:

  • 요청된 기능이 구현되었습니다.
  • 기존 기능이 유지됩니다.
  • 컴포넌트가 유지 관리 가능한 설계 원칙을 따릅니다.
  • 상태 및 데이터 흐름을 이해할 수 있습니다.
  • API 상호 작용이 오류를 적절하게 처리합니다.
  • 접근성 요구 사항이 고려되었습니다.
  • 보안 요구 사항이 준수되었습니다.
  • 관련 테스트가 통과되었습니다.
  • 해당하는 경우 프로덕션 빌드가 성공합니다.
  • 알려진 제한 사항이 문서화되었습니다.
  • 구현이 명확하게 보고되었습니다.

21. 관련 스킬

사용 가능한 경우 이 스킬을 다음 스킬과 결합하십시오:

  • frontend-engineering: 일반적인 프론트엔드 아키텍처 및 엔지니어링.
  • ui-ux-design: 사용자 경험 및 인터페이스 디자인.
  • frontend-security: 프론트엔드 특화 보안.
  • frontend-testing: 프론트엔드 테스트 관행.
  • backend-development: 백엔드 통합.
  • api-engineering: API 설계 및 통합.

책임을 중복하지 않고 관련 스킬을 적절히 사용하십시오.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬