Expo 集成示例助手
用 Expo 官方示例快速适配第三方库与服务。
技能明确限制工具,并要求只读参考、临时目录、非破坏性合并和占位符环境变量;但 gh、git clone、npx、bun 及远程仓库访问仍会产生外部影响或执行第三方代码,未要求逐次确认、锁定来源或提供回滚方案,因此扣分。
流程、示例命名、弃用检查、版本对齐和失败前提说明较一致;但依赖 gh、网络、分支名和外部仓库状态,未提供测试套件、命令失败诊断或离线替代路径,且静态评估上限限制为10分以内,因此扣分。
明确面向已有 Expo 项目集成和新项目脚手架,区分 inspiration 与 scaffold,并说明不适合直接复制完整架构;但触发边界、输入输出契约和非适用场景仍较有限,中文支持未说明,核心流程依赖 GitHub 等服务,在中国大陆网络环境下可达性不确定,因此扣分。
SKILL.md、catalog.md、agent 元数据和 README 结构清晰,包含安装、更新、相关技能、限制提示和 MIT 许可;但该技能缺少自身 changelog、维护责任人、版本兼容矩阵和故障排查,catalog 明确会漂移,因此扣分。
对查找 canonical integration pattern、依赖/config plugin 合并和从示例脚手架的目标明确,输出步骤可直接指导操作;但实际结果依赖外部示例当前内容,未有文件内的代表性执行证据或完整覆盖,仍需人工审查和适配,因此按静态上限保守扣分。
提供 GitHub 源仓库、实时目录和 meta.json 的核验路径,并有版本检查与技能限制 CI;但没有针对该技能关键路径的提交测试或第三方复现证据,结论主要来自文档声明,因此扣分。
- 执行 npx、bun、git clone 或远程 GitHub 命令前,应确认来源、版本和网络权限,并审查安装脚本及依赖。
- catalog.md 会漂移;必须核对实时目录、aliases 和 deprecated 信息,不能仅凭快照操作。
- 脚手架命令可能创建或修改项目文件;在隔离目录运行并先确认目标路径,保留可恢复副本。
- 示例可能涉及支付、认证、云存储或 API 密钥;不要复制真实密钥,并应审查权限、服务端路由和数据流。
- 未说明中文文档或大陆网络替代方案,GitHub 不可达时核心查找和下载流程可能受阻。
这个 Skill 能做什么,适合哪些场景?
这是 expo/skills 仓库中的一个 Expo 开源技能,专注于 expo/examples 中约 70 个第三方集成示例。它帮助已有 Expo 应用寻找与当前需求匹配的、版本相符的实现模式,也支持从示例创建新项目。技能强调读取依赖、配置插件、权限、环境变量和集成代码后再进行非破坏性适配。它适合需要具体集成路径的 Expo 开发者,不适合把示例当作完整应用架构直接复制。
根据用户需求匹配示例名称;通过 GitHub CLI 查询实时示例目录和 meta.json 中的别名或废弃信息;列出示例的完整文件树;读取 README.md、package.json、app.json、集成代码和 .env;必要时使用 degit 或稀疏 Git 克隆获取临时副本;在新项目中运行 create-expo 或 Bun 创建命令;为已有项目提出依赖、配置插件、权限、集成代码和环境变量的适配方案。
- 已有 Expo 应用需要接入 Stripe、Clerk、Supabase、地图或其他第三方服务时,查找官方集成模式。
- 项目依赖旧版 Expo SDK,需要参考最新示例但避免直接复制不兼容的固定版本时,进行版本对齐。
- 新建 Expo 项目并希望从官方 with-* 示例开始时,使用示例进行脚手架创建。
- 需要确认某个示例是否已重命名或废弃时,查询实时目录和 meta.json。
- 集成代码分布在客户端、服务端路由和配置文件中时,获取完整示例并按文件分析。
这个 Skill 有哪些优点和局限?
- 基于 Expo 官方 expo/examples 仓库,提供约 70 个具体集成示例。
- 覆盖依赖、配置插件、权限、环境变量和最小集成代码等关键组成部分。
- 强调使用 npx expo install 进行 SDK 兼容的版本解析,并避免覆盖已有项目配置。
- 支持已有项目适配和新项目脚手架两种模式。
- MIT 许可证,且官方插件安装支持自动更新。
- 示例通常是单屏 managed 项目,不适合作为完整应用架构直接采用。
- 示例追踪最新 SDK,旧项目可能需要先升级或额外处理兼容性。
- 工作流依赖网络、Shell、GitHub CLI 等命令行工具。
- 源材料未记录该技能自身的测试套件或跨平台验证范围。
- 单独安装 expo-examples 的命令未在源材料中明确提供。
如何安装这个 Skill?
该技能属于 expo/skills 集合。使用 Skills CLI 安装全部 Expo 技能:npx skills@latest add expo/skills --skill '*'。也可以安装 Expo 插件:Claude Code 使用 claude plugin install expo@claude-plugins-official;Codex 使用 codex plugin add expo@openai-curated。源材料未提供仅安装 expo-examples 的独立命令。
如何使用这个 Skill?
在已有项目中,可向代理提出:“为我的 Expo 应用寻找并适配 Stripe 的官方集成示例。”代理应先确认 live example 列表和 meta.json,再读取目标示例的关键文件并手动合并缺失依赖、配置和代码。新项目可使用 npx create-expo --example with-stripe、npx create-expo -e with-stripe 或 bun create expo --example with-stripe;具体示例名称应先从实时列表确认。