React组件属性类型收紧
按线上真实调用点判断组件属性该必填还是可选,把为了 Storybook 和测试放宽的类型收紧,并删掉对应的兜底逻辑。
功能与用途
组件为了配合 Storybook、测试和 mock 数据,props 被放宽了一堆可选项,结果类型里出现了线上根本不会走到的状态,组件里到处是 items ?? []、onSelect?.(...) 这种防御代码。这个 Skill 的做法是先找真实的线上调用点,以线上代码路径为准来判定哪些属性必填、哪些可选、哪些可以删,然后把内部子组件的属性也一起收紧,把只服务于放宽类型的兜底逻辑删掉。测试和故事挂了就改测试去适配严格契约,不允许为了让测试好写而把线上属性改回可选。
适用场景
- 清理陈旧防御代码:排查因放宽类型产生的多余空值判断与默认值兜底,直接精简组件渲染逻辑。
- 收紧组件接口契约:以生产环境调用点为基准,将为了写测试或故事书而设为可选的属性改回必填。
- 同步级联子组件属性:在顶层属性收紧后,同步纠正内部子组件接收的事件与数据类型,消除无效调用。
适用人群
- React/TypeScript 前端开发
- 维护组件库的前端工程师
- 用 Storybook 做组件开发的团队成员
使用步骤
- 先找出可疑组件:可选字段一大堆、到处是可选调用和 ?? 兜底、始终渲染的交互却配着可选回调。
- 搜出组件的全部引用,把调用点分类成线上代码路径和支持代码(Story、测试、fixture、mock)。
- 以线上调用点为准逐个属性定性:都传的是必填、有线上调用点省略且省略代表真实状态的是可选、没人用的是可删。
- 更新导出的属性类型并同步收紧内部子组件属性,把只为放宽类型存在的兜底逻辑去掉。
- 跑变更包和所有消费方的类型检查,让 Story 和测试适配严格契约,把改动理由和验证结果写进 PR 描述。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- 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>)。
依赖与权限
- 读取用户主动提供的内容