用途：帮助智能体将 HeroUI v2 应用迁移到 v3，并在迁移前获取官方迁移文档。
主要能力：提供完整迁移与增量迁移两种策略的指南，以及按组件、样式、hooks 分类的迁移文档获取脚本。
关键变更：v2 需要 <HeroUIProvider>，v3 无需 Provider；组件 API 从扁平 props（如 <Card title="x">）改为复合组件（如 <Card><Card.Header>）；事件处理从 onClick 改为 onPress；样式从 classNames 改为 className；hooks 如 useSwitch、useDisclosure 改为复合组件与 useOverlayState；包从 @heroui/system、@heroui/theme 改为 @heroui/react、@heroui/styles。
安装：curl -fsSL https://heroui.com/install | bash -s heroui-migration
使用方式：应用变更前务必先获取迁移文档，不要假设 v2 模式在 v3 可用。可用脚本：node scripts/list_migration_guides.mjs 列出组件迁移指南；node scripts/get_migration_guide.mjs full 或 incremental 获取主流程；node scripts/get_component_migration_guides.mjs button card modal 获取组件指南；node scripts/get_styling_migration_guide.mjs 与 node scripts/get_hooks_migration_guide.mjs 获取样式与 hooks 指南。也可通过 MCP 配置 {"mcpServers":{"heroui-migration":{"url":"https://migration-mcp.heroui.com"}}} 访问。
适用场景：可专注迁移的项目适合完整迁移；需保持可用的项目适合增量迁移，通过 pnpm 别名或组件包让 v2 与 v3 共存。
限制：当前技能面向文档/迁移分支的 staging 部署，文档合并到 main 后需设置 HEROUI_MIGRATION_DOCS_BASE=https://heroui.com/docs/react/migration 或更新脚本默认值。具体组件迁移细节需按脚本获取，资料未提供完整示例。