用途:在 TypeScript 与 TSX 任务中应用 TypeScript Style Guide 的 React 约定。使用前先检查所在仓库的 React、框架与状态管理约定,仓库显式约定优先于本指南;只应用、审查或解释与当前任务相关的部分,并对依赖应用上下文的组件或状态设计说明权衡。
主要能力:一,props 转 state:一般避免用 props 作为初始 state,因为 props 变化时 state 不会更新,易产生难排查的缺陷和副作用;确实需要使用时要加 initial 前缀(如 initialProductName)。二,props 类型:避免 React.FC,改用带类型的 props 参数。三,组件类型:容器组件带 Container 或 Page 后缀,含业务逻辑与 API 集成;UI-Feature 组件为满足功能需求的表现型组件,嵌套于容器文件夹内,不做 API 集成;UI-Design system 为全局复用组件。四,数据传递:只传必要 props,不传整个对象;筛选、排序等状态尽量放 URL,且不与本地 state 同步;优先用 props、URL 或组合,全局状态(Zustand、Context)作为最后手段;组合组件如菜单、手风琴、导航、标签、列表应共同工作;UI 组件只展示派生状态并发送事件,不含业务逻辑;数据获取只允许在容器组件中,鼓励使用服务端状态库(TanStack Query、Apollo Client 等),不鼓励用客户端全局状态库。
使用方式:作为技能在相关任务中按上述流程应用或审查,组件与 hooks 属于函数,也适用相应的函数约定;函数设计细节可参考 typescript-functions。
限制:TypeScript、React 和 ESLint 能自动检查的内容仍交由它们负责;不因技能激活而重设计无关组件或状态。资料未提供安装命令、价格与平台支持等信息。