Skip to content
Lenso UI

Agent Skills

让 AI 助手协助你将 HeroUI v2 迁移到 v3。

HeroUI Migration Skills 为你的 AI 助手提供关于 HeroUI v2 到 v3 迁移流程、组件指南与最佳实践的完整知识。

安装

curl -fsSL https://heroui.com/install | bash -s heroui-migration

或者通过 skills 包安装：

npx skills add heroui-inc/heroui

支持 Claude Code、Cursor、OpenCode 等。

安装范围

默认情况下，安装脚本会把 skill 安装到用户主目录，因此在所有项目中都可用。如果只想安装到当前项目，请在需要迁移的项目根目录下运行安装脚本并加上 HEROUI_SKILL_SCOPE=project —— 当你只需要为该代码库使用迁移 skill 时，这样更合适。

curl -fsSL https://heroui.com/install | HEROUI_SKILL_SCOPE=project bash -s heroui-migration

每个被检测到的工具都会使用它自己读取的项目目录：Claude Code 使用 .claude/skills/，Cursor 使用 .cursor/skills/，OpenCode 使用 .opencode/skills/，Codex 和 Antigravity 使用 .agents/skills/。

使用方法

Skills 会被你的 AI 助手自动发现，你也可以直接通过 /heroui-migration 命令调用它。

只需让你的 AI 助手做这些事：

  • 将组件从 HeroUI v2 迁移到 v3
  • 获取完整迁移或渐进式迁移的流程
  • 获取面向特定组件的迁移指南
  • 查阅 Hooks 与样式相关的迁移文档

包含的内容

  • 迁移流程（完整与渐进式）
  • 面向特定组件的迁移指南（39 个组件）
  • Hooks 迁移指南（如 useDisclosure → useOverlayState 等）
  • 样式迁移指南（工具类、颜色 token、CSS 变量）
  • 关键 API 变更与复合组件模式

结构

skills/heroui-migration/├── SKILL.md                    # Main skill documentation├── LICENSE.txt                 # Apache License 2.0└── scripts/                    # Utility scripts    ├── list_migration_guides.mjs    ├── get_migration_guide.mjs    ├── get_component_migration_guides.mjs    ├── get_styling_migration_guide.mjs    └── get_hooks_migration_guide.mjs

链接