This is a structured React reference that breaks best practices into focused chapters on Hooks, Context, and performance optimization. It's designed to load content on demand rather than dumping everything into your context window at once, which is smart for keeping Claude sessions lean. The quick reference sections give you naming conventions for custom Hooks and a sensible component file structure. It covers the fundamentals you'd want junior devs to internalize: single responsibility components, minimal state lifting, and composition over inheritance. The Chinese documentation with English code examples suggests it's targeting Chinese-speaking React developers who want practical patterns without wading through theory.

GitHub stars
826
last updated
May 30, 2026

Install

$ npx -y skills add huangjia2019/claude-code-engineering --skill 'React 最佳实践' --agent claude-code

Installs into .claude/skills of the current project.

Files

React 最佳实践

本技能包含 React 开发的最佳实践,帮助你编写高质量的 React 代码。

目录

当用户需要特定主题时,加载对应章节:

只在用户明确需要时加载完整内容,避免浪费上下文窗口。

核心原则

  1. 组件单一职责:一个组件做一件事
  2. 状态提升最小化:状态放在需要它的最近公共祖先
  3. 避免过早优化:先让它工作,再让它快
  4. 优先组合而非继承:使用 children 和 render props

快速参考

自定义 Hook 命名

// 好的命名
useUser()
useLocalStorage()
useDebounce()

// 不好的命名
fetchUser()      // 不是 use 开头
useData()        // 太模糊

组件文件结构

ComponentName/
├── index.ts           # 导出
├── ComponentName.tsx  # 组件实现
├── ComponentName.test.tsx
├── ComponentName.styles.ts
└── types.ts           # 类型定义

Sponsors

Details

Repository
github.com/huangjia2019/claude-code-engineering
Category
Frontend Development
First seen
Jun 11, 2026

More from huangjia2019/claude-code-engineering

All 11
1kettleofketchup avatarfrontend-dev-guidelineskettleofketchup/DraftForgeFrontend development guidelines for React/TypeScript applications. Modern patterns including Suspense, lazy loading, useSuspenseQuery, file organization with fe0skills.sh installs
2recomby-ai avatargeo-review-htmlrecomby-ai/recomby-geoRender an interactive, self-contained HTML companion for a GEO content brief (04-content-brief) or a publish-ready draft (05-production), so a NON-technical cli0skills.sh installs
3TheOrcDev avatarrerender-memoTheOrcDev/8bitcn-uiExtract expensive work into memoized components with React.memo. Apply when components perform expensive computations that can be skipped when props haven't cha0skills.sh installs
4zhixiangluo avatardiscover-ui-surfacezhixiangluo/10xproductivityWalk through a UI flow once manually and capture a durable interaction map — which DOM elements to click, which network requests they trigger, and what field sh0skills.sh installs
5vercel-labs avatarvercel-react-best-practicesvercel-labs/agent-skillsReact and Next.js performance optimization across 70 rules prioritized by impact.885.1Kskills.sh installs
6shadcn avatarshadcnshadcn/uiComplete shadcn/ui component management for adding, searching, fixing, styling, and composing UI.234.7Kskills.sh installs