Agent Skills
返回列表
💻

TypeScript React 类型模式

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/asyrafhussin-agent-skills-typescript-react-patterns。

技能介绍

为什么 React 里的 TS 容易「能跑但类型在说谎」

在 React 项目里,props 用 any、事件处理器参数写错、useRef(null) 推断成宽泛类型、Context 默认值导致 useContext 处处加非空断言——这类问题编译往往仍能通过,却在重构或升级依赖时集中爆雷。本技能是一份按优先级组织的规则清单(v2.0.0,MIT),共 33 条、7 个类别,面向「把类型写对」而不是泛泛讲 TypeScript 语法。

技能如何组织与使用

规则带前缀便于检索,例如组件侧 comp-props-interface、comp-forward-ref,Hooks 侧 hook-use-reducer、hook-custom-hooks,事件 event-form,ref ref-imperative-handle,泛型 generic-table,上下文 ctx-provider,工具类型 util-discriminated-unions。资料中的 Rule Categories by Priority 把 Component Typing 与 Hook Typing 标为 CRITICAL,Event Handling 与 Ref Typing 为 HIGH,其余为 MEDIUM/LOW,适合在修报错或写新组件时按类别翻规则文件,而不是一次读完。

核心覆盖面包括:用 interface/type 区分 props 与联合类型、正确标注 children(ReactNode/ReactElement)、forwardRef 与多态 as prop、带判别联合的 useReducer、表单与键盘事件类型、useImperativeHandle、ComponentPropsWithoutRef 与 Pick/Omit 推导 props 等。文末指向 React TypeScript Cheatsheet 等外部参考,完整展开版见 AGENTS.md。

适用边界

这是 React + TypeScript 编码约定与模式,不替代构建配置、路由或状态库文档;也不覆盖测试、SSR 框架专属 API。若项目仍大量使用 React.FC 或旧版 @types/react,部分条目需结合你们团队的类型策略微调。建议在 IDE 里对照具体 rule 文件名阅读细则,而不是只依赖 Quick Reference 一行摘要。

使用场景

  • 封装带 `forwardRef` 的 UI 组件时,需要把 ref 与 rest props 的类型一次写对
  • 表单页要为 `onSubmit`/`onChange` 补全事件类型,避免把 `target` 当成 `any` 传播
  • 用 `useReducer` 管理多步骤流程时,想用判别联合给 action 做穷尽检查
  • 做泛型 `Table`/`Select` 时,要为列定义与选项值约束 `extends`,减少调用方传错泛型

适合人员

  • 维护中后台组件库的前端,要把 props/ref/泛型 API 写成可复用且不自相矛盾
  • 从 JavaScript 迁到 TypeScript 的 React 工程师,经常被 `useContext` 和自定义 Hook 返回值报错卡住
  • 负责 Code Review 的 Tech Lead,希望团队统一 children、事件与 `React.FC` 的写法依据
  • 做设计系统多态组件(`as` prop)的开发者,需要对照规则避免破坏 DOM 属性推断