Expo 官方 AI 代理技能库
本文目录
Expo 技能#
来自 Expo 团队的官方 AI 代理技能（AI agent skills），用于构建、部署、升级和调试 Expo 应用。
工作原理#
技能为 AI 代理提供聚焦于 Expo 的知识：何时使用 Expo API、如何组织常见工作流，以及哪些 Expo、EAS、React Native、iOS 和 Android 约束值得注意。Expo 文档、Expo CLI 和 EAS CLI 仍然是事实来源（source of truth）；这些技能帮助代理正确地应用它们。
安装#
对于 Claude Code 或 Codex，请安装插件，以便由官方插件市场（plugin marketplace）处理更新。对于 Cursor、OpenCode 和其他 AI 编程代理，请使用技能 CLI（skills CLI）。
| 方式 | 最适合 |
|---|---|
| 插件安装 | Claude Code 或 Codex，更新由其官方插件市场处理。 |
| 技能 CLI | Cursor、OpenCode、GitHub Copilot、Windsurf、Gemini、Cline、AMP、Factory Droid、Antigravity、Kiro CLI 以及其他 AI 编程代理。 |
技能 CLI#
使用技能 CLI 安装所有 Expo 技能：
npx skills@latest add expo/skills --skill '*'这会选择每个 Expo 技能，但不会选择每个代理。CLI 仍会询问要将它们安装到哪里；若要直接指定一个代理，请添加 --agent <agent>。
对于大多数代理，这是你唯一需要的安装命令。请从项目根目录运行它，然后重启或刷新代理会话，以便它发现已安装的 SKILL.md 文件。
Claude Code 插件#
从官方 Claude Code 插件市场安装：
claude plugin install expo@claude-plugins-official你也可以在 Claude Code 中运行 /plugin install expo@claude-plugins-official。
Codex 插件#
从 OpenAI 精选的 Codex 市场安装：
codex plugin add expo@openai-curated你也可以在 Codex 中打开 /plugins，从 OpenAI 精选市场安装 expo。
更新#
Claude Code 和 Codex 的插件安装通过其官方插件市场更新。
对于技能 CLI 安装，使用以下命令更新已安装的技能：
npx skills@latest update要更新单个 Expo 技能，请传入其名称：
npx skills@latest update expo-router试一试#
安装后，向你的代理提出 Expo 相关问题，例如：
- “构建一个具有原生质感的 Expo Router 屏幕，包含标签页、模态框和动画。”
- “创建一个在拉取请求上构建预览版的 EAS 工作流。”
- “帮我将此应用升级到最新的 Expo SDK。”
- “检查这次 EAS Update 发布是否健康。”
代理会根据任务上下文和每个技能的描述选择正确的技能。
包含的技能#
技能分为两组，以便清晰区分免费与付费边界。每个技能的描述都带有相同的标签，并且每个服务类技能开头都有一则关于费用/套餐限制的说明。
从这里开始#
任何 Expo/EAS 任务都先加载这个技能，然后路由到下面的特定技能。
| 技能 | 用途 |
|---|---|
| expo-overview | Router 与共享设置规则；当请求含糊或用户未指定具体 Expo 工具时的入口。 |
框架（开源）#
免费、开源的 Expo SDK 与 React Native 技能。
| 技能 | 用途 |
|---|---|
| expo-project-structure | 新 Expo 应用的文件夹结构：src/ 布局、仅含路由的 app/、屏幕、服务器代码、平台特定文件。 |
| expo-router | Expo Router 导航：基于文件的路由、链接、原生栈、模态框、底部面板（sheets）、原生标签页和头部。 |
| expo-animation | 使用 Reanimated、Gesture Handler、Expo Router 和 expo-haptics 实现精致的 React Native 动画与手势。 |
| expo-native-ui | 原生质感的屏幕样式、语义化颜色、控件、图标、媒体和视觉效果。 |
| expo-design-system | 应用内设计系统：令牌主题（颜色、间距、字体排印、圆角、阴影、动效）、可复用组件约定，以及设计系统漂移审计。 |
| expo-ui | @expo/ui 原生组件：优先跨平台通用，针对平台特定需求使用 SwiftUI 和 Jetpack Compose。 |
| expo-data-fetching | API 调用、React Query、SWR、缓存、离线支持，以及 Expo Router 数据加载器（data loaders）。 |
| expo-dom | Expo DOM 组件，用于在原生应用中逐步使用 Web 代码。 |
| expo-web-to-native | 将现有的 Web/React 应用（Next.js、Vite、CRA）迁移为使用 Expo 的原生 iOS/Android 应用。 |
| expo-module | 使用 Swift、Kotlin、TypeScript、配置插件和自动链接的 Expo 原生模块与视图。 |
| expo-brownfield | 将 Expo 或 React Native 添加到现有的 iOS 或 Android 应用中。 |
| expo-dev-client | 开发客户端（本地构建免费；EAS Build/TestFlight 是付费步骤）。 |
| expo-examples | expo/examples 仓库中的 with-* 集成，可用于调整或作为新项目的脚手架。 |
| expo-app-clip | iOS App Clip 目标、AASA 文件、关联域（associated domains）和智能应用横幅（Smart App Banners）。 |
| expo-upgrade | Expo SDK 升级、依赖冲突、已弃用的包和缓存清理。 |
服务与付费分发#
核心用途依赖付费 Expo 应用服务（Expo Application Services, EAS）的技能。
| 技能 | 用途 |
|---|---|
| eas-app-stores | 构建并提交 iOS/Android 应用：Expo 及其他 React Native 项目，以及现有的原生应用；TestFlight、配置文件（profiles）、版本管理和元数据。 |
| eas-hosting | 将 Expo 网站和 Expo Router API 路由部署到 EAS Hosting：密钥、自定义域名、Cloudflare Workers。 |
| eas-workflows | EAS Workflow YAML 文件与 CI/CD 自动化。 |
| eas-observe | EAS Observe 的设置与发布、路由、事件和版本指标。 |
| eas-update | EAS Update 设置、OTA 发布、运行时兼容性、测试和调试。 |
| eas-update-insights | EAS Update 健康状况、崩溃率、启动次数、负载大小和发布门控（rollout gates）。 |
| eas-simulator | 在 EAS 云端的远程 iOS 模拟器或 Android 模拟器上运行和驱动你的应用——通过 CLI 或代理，并提供实时浏览器预览（仅 iOS）。 |
实验性#
针对尚未最终确定的 Expo API 的技能。内容可能会更改或停用；当底层 API 稳定后，技能会升级到上述分组。这些技能随单独的 expo-experiments 插件发布（与 expo 一同安装），或通过技能 CLI 单独安装。
| 技能 | 用途 |
|---|---|
| expo-migrate-module | 将 Swift Expo 模块从 Modules API 1.0 定义 DSL 迁移到 2.0 宏 API。 |
Expo MCP 服务器#
技能教会代理 Expo 工作如何完成。Expo MCP 服务器则让它实时访问，从而真正完成这些工作：按需阅读最新的 Expo 文档，使用 npx expo install 安装兼容的依赖，触发并监控 EAS 构建和工作流，从 TestFlight 拉取崩溃数据，以及在模拟器中截取运行中应用的屏幕截图。
expo 插件捆绑了此 MCP 配置，因此安装 Claude Code 和 Codex 插件时会自动接好。对于其他代理，或要单独添加它，请遵循 Expo MCP 设置指南。
常见问题#
支持哪些 AI 编程代理？#
对于 Cursor、OpenCode、GitHub Copilot、Windsurf、Gemini、Cline、AMP、Factory Droid、Antigravity、Kiro CLI 及类似的 AI 编程工具，请使用 npx skills@latest add expo/skills --skill '*'。
我应该安装技能还是插件？#
对于 Claude Code 或 Codex，请使用插件；它通过插件市场保持更新。对于 Cursor、OpenCode 和其他 AI 编程代理，请使用 npx skills@latest add expo/skills --skill '*'。
什么是事实来源？#
Expo 文档、Expo CLI 和 EAS CLI 是事实来源。这些技能教会代理如何在真实项目中应用 Expo 指南。
反馈#
每个技能都包含说明，指导使用 npx --yes @expo/agent-cli@latest feedback 提交具体、可操作的反馈。
许可证#
MIT