Ant Design CLI
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/ant-design-antd-skill-antd。
技能介绍
问题从哪来
在企业项目里写 Ant Design 组件,最常见的事故不是「不会写 JSX」,而是记错 props 名字、按 v5 文档改 v4 项目,或者升级大版本时漏掉 breaking change。官方文档要翻墙、要切版本页,IDE 里也很难保证和你 package.json 里的 antd 版本一致。这个技能把查询、排查、迁移收敛到本地 CLI:数据离线打包,用 --version 对齐你真实依赖,用 --format json 让助手可解析结构化结果,而不是凭训练数据瞎猜 API。
技能如何驱动工作流
技能假设环境里可以调用 @ant-design/cli(首次使用会检查并引导安装;有更新提示时应先 npm install -g @ant-design/cli)。典型链路如下:
- 写组件前:
antd info查 props →antd demo拿可运行示例,再落代码;需要长文档时用antd doc。 - 报错排查:
antd doctor看环境 → 带--version的antd info核对 API →antd lint扫废弃用法。 - 升版:
antd migrate出清单 →antd changelog读破坏性变更 → 改代码后再antd lint。 - 摸底项目:分析项目里 antd 使用方式(技能文档中的「分析项目」场景)。
- 选组件 / 查变更:
antd list探索组件;按版本查 changelog。
全局习惯:始终加 --format json;项目若是 4.x 就显式 --version 4.24.0 之类;中文说明可加 --lang zh,细节字段用 --detail。确认是组件库自身 bug 可走 antd bug(先预览、用户确认再提交)。若在 CLI 执行中发现命令崩溃、返回错误版本数据、JSON 格式不符等,应主动走 antd bug-cli 反馈,而不是默许错误数据继续指导编码。支持 MCP 时,CLI 还可暴露 antd_list、antd_info 等工具供 IDE 直连。
边界与注意点
这是编排 CLI 工作流的技能,不能替代你项目里的构建、测试或视觉验收。版本检测虽可从 node_modules 推断,但 monorepo、别名安装、多套 antd 并存时仍以你指定的 --version 为准。迁移与 lint 输出是检查清单导向,最终是否可上线仍要跑你自己的测试套件。
使用场景
- 维护仍跑 antd 4.x 的老系统,改 Table 分页 API 前先查该版本 `antd info` 避免抄 v5 写法
- React 页面白屏且用户怀疑组件库,依次用 `antd doctor`、带 `--version` 的 info 与 `antd lint` 定位废弃用法
- 业务要升到 antd 5,先跑 `antd migrate` 和 `antd changelog` 列 breaking,再按清单改代码并 lint
- 技术评审前要说明项目里用了哪些 antd 组件,用项目分析类流程梳理实际引用而非翻目录猜
适合人员
- 负责银行/政企遗留 React 栈、短期内不能大版本跃迁的前端,需要按精确小版本查 API
- 带团队做 antd 4→5 升级的技术负责人,要把 migrate 清单和 changelog 对齐到每次 PR
- 在 Cursor/Claude Desktop 里写 antd 页面、希望助手先查 demo 再生成代码的全栈工程师
- 维护设计系统封装层、需要核对 token/semantic 与官方文档是否一致的组件库作者