AI Skill 大全

React组件属性类型收紧

按线上真实调用点判断组件属性该必填还是可选,把为了 Storybook 和测试放宽的类型收紧,并删掉对应的兜底逻辑。

功能与用途

组件为了配合 Storybook、测试和 mock 数据,props 被放宽了一堆可选项,结果类型里出现了线上根本不会走到的状态,组件里到处是 items ?? []、onSelect?.(...) 这种防御代码。这个 Skill 的做法是先找真实的线上调用点,以线上代码路径为准来判定哪些属性必填、哪些可选、哪些可以删,然后把内部子组件的属性也一起收紧,把只服务于放宽类型的兜底逻辑删掉。测试和故事挂了就改测试去适配严格契约,不允许为了让测试好写而把线上属性改回可选。

适用场景

  • 清理陈旧防御代码:排查因放宽类型产生的多余空值判断与默认值兜底,直接精简组件渲染逻辑。
  • 收紧组件接口契约:以生产环境调用点为基准,将为了写测试或故事书而设为可选的属性改回必填。
  • 同步级联子组件属性:在顶层属性收紧后,同步纠正内部子组件接收的事件与数据类型,消除无效调用。

适用人群

  • React/TypeScript 前端开发
  • 维护组件库的前端工程师
  • 用 Storybook 做组件开发的团队成员

使用步骤

  1. 先找出可疑组件:可选字段一大堆、到处是可选调用和 ?? 兜底、始终渲染的交互却配着可选回调。
  2. 搜出组件的全部引用,把调用点分类成线上代码路径和支持代码(Story、测试、fixture、mock)。
  3. 以线上调用点为准逐个属性定性:都传的是必填、有线上调用点省略且省略代表真实状态的是可选、没人用的是可删。
  4. 更新导出的属性类型并同步收紧内部子组件属性,把只为放宽类型存在的兜底逻辑去掉。
  5. 跑变更包和所有消费方的类型检查,让 Story 和测试适配严格契约,把改动理由和验证结果写进 PR 描述。

开始使用

将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。

查看 MCP 接入说明

技术信息

分类
编程
适用工具
Codex、Claude Code、OpenClaw、Hermes、国内 Agent
使用难度
进阶
版本
main
最近更新
2026-09-09
文件数
3
安装包大小
自动生成 ZIP
安全检查
基础检查通过

narrow React component prop types to match live code paths

使用前准备

  • 需要有可访问的代码仓库,并能运行该仓库的类型检查命令(示例用 bun --bun run typecheck --filter <package>)。

依赖与权限

  • 读取用户主动提供的内容

同类 Skill