Agent Skills
返回列表
💻

蚂蚁社保组件属性边界收敛

开发编程 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @mayishebao/mayishebao-1245-0245

技能介绍

要解决的问题

前端组件(如 <UserSelect>、<PolicyCard />)为了覆盖多业务线场景,属性往往越加越多:必填项、默认值、回调回退、批量映射、第三方包装…… 最后,同一个 Prop 在不同分支里出现 3–4 个语义,入参校验散落在业务代码里,改一处就牵出三处回归。换句话说,属性边界失控——没有一个人能完整说出 <社保参保单 /> 组件到底接受哪些外部参数、哪些参数真实生效、哪些参数因历史包袱而“僵尸化”。

本技能聚焦“边界收敛”,不做重写框架,也不发明新 DSL。它只负责提供一套 可验证、可执行、可复盘 的任务流,让团队把当前混乱的属性表盘话。

技能如何工作

  1. 目标复述:先让用户用一句话写出“希望组件对外只暴露哪些 Prop、必须废弃哪些 Prop”,随后将这句话拆成验收标准(如 prop.**roleToggleMap** must be removed after release v1.2)。
  2. 问题复现:拿到仓库后,快速跑通 npm run storybook / Playwright 用例,把属性读取路径打印成树形,一眼看出谁在用、谁的分支没被任何测试命中。
  3. 最小可逆变更:

- 使用 deprecated 标记旧 Prop;
- 提供迁移映射,但保持读路径;
- 生成 PR 仅改动 types/*.d.ts 与示例,避免一次合并引发大面积 build break。

  1. 测试补齐:

一个单测锁定默认值;
一个集成测试校验错误提示文案;
* 一个 Storybook story 展示新旧并行效果。

  1. 发布与回滚:

建议独立 minor 版本,CHANGELOG 顶部列出“Remove-Prop 表”;
回滚只需 npm i component@prev-minor,无需应急 hotfix。

适用边界与注意点

  • 不处理运行环境的遗留 polyfill;如果属性瘦身导致 runtime 兼容问题,仍需项目侧评估。
  • 涉及金融机构的敏感字段(如身份证、合同)需二次合规审查,不要把它当作安全审计工具。
  • 法规、社保政策变更不在技能讨论范围内;本技能只交代码侧边界收敛的可执行范式。
小结:给它一个组件和可访问的源码,它给你一条“看得见—改得了—测得了—留痕在案”的属性收敛流程。

使用场景

  • 出现 props 混乱或 zombie 接口,需要系统化收敛
  • 组件升级导致业务回归,要快速定位和补测试
  • 团队缺少变更记录,需要可追溯的交付清单

适合人员

  • 中国职场前端工程师,负责维护共享组件
  • 组件库 Owner 或 Tech Lead,关注 API 契约
  • 质量工程师,需要为属性变更补测试并跟进发布