跳到主内容
智客 ZICQ

技能库 智客分类:Agent 工作流 react

React

带有 Tailwind, shadcn/ ui 和现代模式的反演和类型脚本开发

4 安装量

官方网址:skills.sh

技能介绍

先看中文介绍;官方 description 原文单独保留,不改写 SKILL.md。

做什么

带有 Tailwind, shadcn/ ui 和现代模式的反演和类型脚本开发

何时用

官方 description 未单独写出 Use when。按规范,代理会在用户任务与这段 description 的关键词匹配时激活本技能。

代理如何加载

按 Agent Skills 渐进披露:启动时只加载 name 与 description(约 100 token);任务匹配后才读入整份 SKILL.md 正文;scripts/、references/、assets/ 仅在需要时再读。 本文件正文结构:React、Tech Stack、Project Structure、TypeScript Patterns、Type Definitions、Generics。

文件分析

文件分析:这是一份仅含 SKILL.md 的指令型技能,代理激活后整份正文进入上下文。 正文约 549 行,超过规范建议的 500 行,激活时仍会整份载入。

官方 description(原文)

React and TypeScript development with Tailwind, shadcn/ui, and modern patterns

ReactTech StackProject StructureTypeScript PatternsType DefinitionsGenericsEvent HandlersComponent PatternsBasic StructureUsing shadcn/uiTailwind PatternsThe cn() Utility

来源分类:skills.sh agent-skill

SKILL.md 与 Agent 调用

官方规范 ↗
name
react
description
React and TypeScript development with Tailwind, shadcn/ui, and modern patterns
  1. 发现技能客户端向 Agent 提供名称与描述目录。
  2. 匹配与调用用户指定或任务匹配后,载入 SKILL.md 指令。
  3. 按需加载按步骤读取参考文档、使用脚本与素材。

具体调用语法与可用工具以目标 Agent 客户端为准。 查看调用机制说明 ↗

安装这个技能

Skills CLI ↗

先选择目标 Agent 和安装范围,保留技能包的附属文件,安装后检查客户端能否发现该技能。

交给 Agent 安装

复制安装指令给支持 Agent Skills 的代理,确认其中的目标目录与客户端匹配。

把 Agent Skill「react」安装到我的项目:SKILL.md 原文与官方 description 见 https://zicq.com/zh/skills/skl-b5888f3a01fc3116-%E5%8F%8D%E5%BA%94.html
请存为 .cursor/skills/react/SKILL.md 或 .claude/skills/react/SKILL.md,frontmatter 的 name 与 description 保持原样,不要改写。

GitHub 完整包 ↗

终端安装 · Skills CLI

需要 Node.js 与 npx。先查看仓库技能列表,确认实际名称。

npx skills add 'https://github.com/onmyway133/skills' --list

npx skills add 'https://github.com/onmyway133/skills' --skill 'react'

CLI 会交互选择目标 Agent,默认安装到项目;用户级安装使用 -g。先通过查看命令核对仓库内容,再用 npx skills list 检查已安装技能。

阅读排版
--- name: react description: React and TypeScript development with Tailwind, shadcn/ui, and modern patterns --- # React You are a React and TypeScript expert. Apply these guidelines when working on React projects. ## Tech Stack This skill assumes: - **TypeScript** for type safety - **React 18+** with functional components - **Tailwind CSS** for styling - **shadcn/ui** for components - **pnpm** as package manager ## Project Structure ``` src/ ├── app/ # Next.js app router pages ├── components/ │ ├── ui/ # shadcn/ui components │ └── features/ # Feature-specific components ├── hooks/ # Custom hooks ├── lib/ # Utilities (cn, api clients) ├── types/ # Shared TypeScript types └── services/ # API and data fetching ``` ## TypeScript Patterns ### Type Definitions ```typescript // Prefer interfaces for extendable objects interface User { id: string; name: string; email: string; } // Use type for unions and computed types type Status = 'idle' | 'loading' | 'success' | 'error'; type UserWithRole = User & { role: Role }; // Props interfaces above components interface ButtonProps { variant?: 'default' | 'destructive' | 'outline'; size?: 'sm' | 'md' | 'lg'; disabled?: boolean; onClick?: () => void; children: React.ReactNode; } ``` ### Generics ```typescript // Reusable hooks with generics function useLocalStorage(key: string, initialValue: T) { const [value, setValue] = useState(() => { const stored = localStorage.getItem(key); return stored ? JSON.parse(stored) : initialValue; }); return [value, setValue] as const; } // Constrained generics function getProperty(obj: T, key: K): T[K] { return obj[key]; } ``` ### Event Handlers ```typescript const handleChange = (e: React.ChangeEvent) => { setValue(e.target.value); }; const handleSubmit = (e: React.FormEvent) => { e.preventDefault(); onSubmit(formData); }; const handleClick = (e: React.MouseEvent) => { e.stopPropagation(); onClick?.(); }; ``` ## Component Patterns ### Basic Structure ```typescript interface CardProps { title: string; description?: string; children: React.ReactNode; className?: string; } export function Card({ title, description, children, className }: CardProps) { return (

{title}

{description && (

{description}

)}
{children}
); } ``` ### Using shadcn/ui ```typescript import { Button } from "@/components/ui/button"; import { Input } from "@/components/ui/input"; import { Dialog, DialogContent, DialogHeader, DialogTitle, DialogTrigger, } from "@/components/ui/dialog"; export function CreateItemDialog() { const [open, setOpen] = useState(false); return ( Create Item Create New Item Create ); } ``` ## Tailwind Patterns ### The cn() Utility ```typescript // lib/utils.ts import { type ClassValue, clsx } from "clsx"; import { twMerge } from "tailwind-merge"; export function cn(...inputs: ClassValue[]) { return twMerge(clsx(inputs)); } ``` ### Conditional Classes ```typescript
{children}
``` ### Responsive Design ```typescript
{items.map((item) => ( ))}
``` ### Common Patterns ```typescript // Centering
// Card container
// Flex with gap
// Truncated text

// Hover states ``` ## Hooks ### State Management ```typescript // useState with explicit type when needed const [user, setUser] = useState(null); const [items, setItems] = useState([]); // useReducer for complex state type Action = | { type: 'SET_LOADING'; payload: boolean } | { type: 'SET_DATA'; payload: Data } | { type: 'SET_ERROR'; payload: Error }; const [state, dispatch] = useReducer(reducer, initialState); ``` ### Effects ```typescript // With cleanup useEffect(() => { const controller = new AbortController(); fetchData(controller.signal) .then(setData) .catch((error) => { if (!controller.signal.aborted) { setError(error); } }); return () => controller.abort(); }, [dependency]); ``` ### Custom Hooks ```typescript function useDebounce(value: T, delay: number): T { const [debouncedValue, setDebouncedValue] = useState(value); useEffect(() => { const timer = setTimeout(() => setDebouncedValue(value), delay); return () => clearTimeout(timer); }, [value, delay]); return debouncedValue; } function useToggle(initial = false) { const [value, setValue] = useState(initial); const toggle = useCallback(() => setValue((v) => !v), []); const setTrue = useCallback(() => setValue(true), []); const setFalse = useCallback(() => setValue(false), []); return { value, toggle, setTrue, setFalse }; } ``` ## Data Fetching ### Server Components (Next.js) ```typescript // Server Component - no 'use client' directive async function UserList() { const users = await fetchUsers(); return (

    {users.map((user) => (
  • {user.name}
  • ))}
); } ``` ### Client-Side Fetching ```typescript 'use client'; function useUsers() { const [users, setUsers] = useState([]); const [isLoading, setIsLoading] = useState(true); const [error, setError] = useState(null); useEffect(() => { const controller = new AbortController(); async function load() { try { const data = await fetchUsers(controller.signal); setUsers(data); } catch (e) { if (!controller.signal.aborted) { setError(e as Error); } } finally { setIsLoading(false); } } load(); return () => controller.abort(); }, []); return { users, isLoading, error }; } ``` ## Forms ### With React Hook Form ```typescript import { useForm } from "react-hook-form"; import { zodResolver } from "@hookform/resolvers/zod"; import { z } from "zod"; const schema = z.object({ email: z.string().email("Invalid email"), password: z.string().min(8, "Password must be at least 8 characters"), }); type FormData = z.infer; export function LoginForm() { const { register, handleSubmit, formState: { errors, isSubmitting }, } = useForm({ resolver: zodResolver(schema), }); const onSubmit = async (data: FormData) => { await login(data); }; return (
{errors.email && (

{errors.email.message}

)}
{errors.password && (

{errors.password.message}

)}
{isSubmitting ? "Signing in..." : "Sign In"} ); } ``` ## Naming Conventions ### Files and Folders - Components: `kebab-case.tsx` or `PascalCase.tsx` - Hooks: `use-hook-name.ts` - Utilities: `kebab-case.ts` - Types: `types.ts` or `type-name.ts` ### Code ```typescript // Components: PascalCase function UserProfile() {} // Hooks: camelCase with 'use' prefix function useAuth() {} // Constants: SCREAMING_SNAKE_CASE const API_BASE_URL = '/api'; const MAX_RETRY_COUNT = 3; // Event handlers: handle + Event const handleClick = () => {}; const handleSubmit = () => {}; const handleInputChange = () => {}; // Boolean variables: is/has/can/should prefix const isLoading = true; const hasError = false; const canSubmit = true; ``` ## Error Handling ### Error Boundaries ```typescript 'use client'; interface ErrorBoundaryProps { children: React.ReactNode; fallback: React.ReactNode; } class ErrorBoundary extends Component { state = { hasError: false }; static getDerivedStateFromError() { return { hasError: true }; } render() { if (this.state.hasError) { return this.props.fallback; } return this.props.children; } } ``` ### API Error Handling ```typescript class ApiError extends Error { constructor( message: string, public statusCode: number, public code?: string ) { super(message); this.name = 'ApiError'; } } async function fetchWithError(url: string): Promise { const response = await fetch(url); if (!response.ok) { throw new ApiError( 'Request failed', response.status, response.statusText ); } return response.json(); } ``` ## Performance ### Memoization ```typescript // Memoize expensive computations const sortedItems = useMemo( () => items.sort((a, b) => a.name.localeCompare(b.name)), [items] ); // Memoize callbacks passed to children const handleDelete = useCallback((id: string) => { setItems((prev) => prev.filter((item) => item.id !== id)); }, []); // Memoize components that render often const MemoizedRow = memo(function Row({ item }: { item: Item }) { return
{item.name}
; }); ``` ### Code Splitting ```typescript // Lazy load heavy components const HeavyChart = lazy(() => import('./HeavyChart')); function Dashboard() { return ( }> ); } ``` ## Common Commands ```bash # Create new Next.js project pnpm create next-app@latest my-app --typescript --tailwind --eslint # Add shadcn/ui pnpm dlx shadcn@latest init # Add shadcn components pnpm dlx shadcn@latest add button input dialog # Add dependencies pnpm add zod react-hook-form @hookform/resolvers # Development pnpm dev # Build pnpm build ``` ## Common Pitfalls 1. **Missing keys** - Always provide stable, unique keys in lists 2. **Stale closures** - Include all dependencies in useEffect/useCallback 3. **Prop drilling** - Use context or composition for deep props 4. **Over-memoization** - Profile before optimizing 5. **Type assertions** - Prefer type guards over `as` casting 6. **Missing 'use client'** - Add directive for client-only features 7. **Inline objects in JSX** - Creates new references on every render

相关技能

Agent 工作流

Skill Creator

创造有效技能指南。 当用户想创造出新的技能(或更新现有的技能),以专业知识,工作流程,或工具集成来扩展克洛德的能力时,应该使用这种技能.

Agent 工作流

Clawdhub

使用ClawdHub CLI搜索,安装,更新并发布从taladhub.com的代理技能. 需要获取苍蝇上的新技能时使用,将安装的技能同步到最新版本或特定版本,或者发布 npm-instainddhub CLI 的新/更新的技能文件夹.

Agent 工作流

Agent Team Orchestration

管弦乐团多代理团队,任务设定周期,交接协议,审查工作流程. 使用时间: (1)建立2+特派员队伍,具有不同专业,(2)确定任务路线和生命周期(收录框_ spec_建设_审查_完成),(3)在特派员之间制定交接协议,(4)建立审查和质量关口,(5)管理特派员之间的交流和文物共享.

Agent 工作流

Superpowers

Spec-first,TDD,子代理驱动的软件开发工作流程. 当:(1)构建任何新功能或应用——触发脑暴_计划_子代理执行回路,(2)调试出一个bug或测试失败——触发系统性的根起过程,(3)用户说"让我们构建","帮助我计划","我想添加X",或"这个被打破",(4)完成一个功…