expo-deployment

expo-deployment 技能概览

expo-deployment 是一个面向 Expo 应用发布的技能，帮助智能体把“应用在本地能跑”推进到真正可发布的路径：通过 EAS 完成 iOS App Store、Google Play、Web Hosting 和 API routes 的上线。它真正解决的问题，不只是生成几条命令，而是帮你选对 Expo deployment 工作流、正确配置凭证，并避开那些最容易拖慢首次发布的提交流程阻塞点。

expo-deployment 适合哪些人

这个技能最适合正在交付 Expo 应用的开发者、创业者和团队，尤其是在以下场景中需要实操支持时：

• 首次配置 EAS
• 应用商店提交流程
• TestFlight 分发
• Play Console 提交
• 使用 EAS Hosting 进行 Web 部署
• 为可重复发布搭建 CI/CD 工作流

如果你已经熟悉 Expo 应用开发，但对发布和上线操作还不够有把握，expo-deployment 会非常适合你。

expo-deployment 与通用提示词的区别

通用 AI 提示词可能只会告诉你“运行 EAS build 和 submit”。而 expo-deployment 在你需要贴合平台实际情况的发布指导时更有价值：

• 它以基于 EAS 的部署为中心，而不是泛泛而谈的移动端发布建议
• 它会指向 iOS、Play Store、TestFlight、metadata 和工作流等具体参考资料
• 它覆盖了真实的 Expo 发布任务，例如 eas credentials、eas metadata:pull、submission profiles，以及 PR preview 工作流

因此，与一个泛 Expo 编码助手相比，它更值得在部署规划阶段安装使用。

用户通常最先关心什么

在安装 expo-deployment skill 之前，多数用户通常会先确认四件事：

1. 它能不能帮我发布到商店，而不只是本地构建？
2. 它是否同时覆盖手动发布和 CI/CD？
3. 它能不能帮我处理凭证配置和各商店特有的卡点？
4. 如果我只需要一个目标，比如 TestFlight 或 web，它还有没有用？

从仓库内容来看，这四个问题的答案都是肯定的，其中价值最突出的部分是 iOS/Android 商店发布流程和 EAS 自动化。

最大优势与实际限制

它最大的优势在于覆盖面广、任务导向明确。expo-deployment 以一个部署入口串起了生产构建、商店提交、TestFlight、metadata 管理和自动化工作流。

它最大的限制在于：这仍然是一个编排型技能，不是能绕过商店要求的“魔法工具”。你仍然需要：

• Apple Developer 和 Google Play 账号
• 对应的应用记录与 bundle IDs
• 凭证和 API keys
• 有效的 eas.json
• 商店素材与政策合规

如果你的卡点在账号开通、法务或合规审批，这个技能可以指导步骤，但无法替你消除这些外部依赖。

如何使用 expo-deployment 技能

expo-deployment 技能的安装场景

先把这个技能安装到你支持的 skills 环境中，然后在你希望智能体规划或执行 Expo 发布工作时调用它。常见安装方式如下：

npx skills add https://github.com/expo/skills --skill expo-deployment

如果你的仓库里已经有一个 Expo 应用，并且你能提供 app.json、app.config.js 或 eas.json 这类关键文件，使用这个技能时会获得更高价值。

先读这些仓库文件

针对这份 expo-deployment guide，最快能进入有效状态的阅读顺序是：

1. SKILL.md
2. references/workflows.md
3. references/testflight.md
4. references/ios-app-store.md
5. references/play-store.md
6. references/app-store-metadata.md

按这个顺序读的原因是：

• SKILL.md 先给你完整的部署能力范围
• workflows.md 展示自动化模式
• testflight.md 提供最快进入 iOS beta 的路径
• 各商店专属参考会处理真正的凭证与提交细节
• 等应用接近上线时，metadata 才会变得关键

技能要拿到哪些输入，效果才会好

expo-deployment skill 在你提供部署上下文时效果最好，而不是只说一句“帮我部署应用”。更有用的输入包括：

• 目标平台：ios、android、web 或 all
• 发布目标：TestFlight、internal Play track、production stores、preview web deploy
• 当前状态：EAS not initialized、eas.json exists、credentials partially configured
• 应用标识：bundle/package IDs
• CI/CD 偏好：手动发布还是自动化工作流
• 约束条件：managed workflow、截止时间、团队访问权限、凭证可用性

如果没有这些上下文，输出往往会比较泛，因为部署决策会随着目标平台和发布阶段而明显变化。

首次使用前的最小准备步骤

仓库已经很明确地给出了基础 Expo deployment 的起步路径：

npm install -g eas-cli
eas login
npx eas-cli@latest init

初始化后会生成 eas.json，它会成为 build 和 submit profiles 的核心配置。如果你还没有 eas.json，建议你直接让智能体使用 expo-deployment skill 为你的环境量身创建，而不是想都不想就接受默认配置。

expo-deployment 的核心使用方式

常见且实用的 expo-deployment usage 请求通常长这样：

• “Set up EAS for production iOS and Android builds.”
• “Prepare this Expo app for TestFlight first, then App Store release.”
• “Create an eas.json with preview and production profiles.”
• “Generate an EAS Workflow for web deploys on push to main.”
• “Explain what credentials I still need before Play Store submission.”

这些请求都比单纯说一句“部署这个应用”更好，因为它们会把技能强制拉回到一个明确的发布路径里。

把模糊目标改写成高质量提示词

弱提示词：

Deploy my Expo app.

强提示词：

Use the expo-deployment skill to prepare my Expo app for iOS TestFlight and Android internal testing. We already have an Expo project, but no eas.json. Bundle IDs are set. I want manual release first, then GitHub-triggered automation. Tell me what files to create or edit, what credentials are required for Apple and Google, and which commands to run in order.

为什么后者更有效：

• 明确点名了目标平台
• 说明了当前配置状态
• 要求按顺序给步骤
• 把手动发布和 CI/CD 分开
• 要求给出文件级改动，而不仅仅是命令

首次移动端发布的最佳工作流

使用 expo-deployment 时，一个很实用的首次发布顺序是：

1. 初始化 EAS
2. 确认 eas.json profiles
3. 配置凭证
4. 一次只构建一个平台
5. 先把 iOS 发到 TestFlight
6. 再把 Android 发到 internal track
7. 验证安装、崩溃、版本号和商店 metadata
8. 之后再进行更广泛的正式提交

这也与仓库中“先走 TestFlight 是最稳妥 iOS 首发路径”的思路一致。

iOS 路径：先上 TestFlight，再进 App Store

这个技能里最有价值的模式之一，就是明确建议先走 TestFlight。配套参考文档也强烈建议，不要一上来就直接送审 App Store。

典型命令包括：

eas build -p ios --profile production --submit

或者这个快捷方式：

npx testflight

在这个阶段，你可以用 expo-deployment skill 重点询问：

• Apple 凭证配置
• App Store Connect API key 配置
• autoIncrement 策略
• TestFlight 测试用户的分批投放顺序

这正是它比“一行构建命令”更有价值的地方。

Android 路径：先走 internal track，再推 production

在 Android 上，真正最容易卡住采用流程的，通常不是构建本身，而是 service account 配置。仓库里的指导已经表明，关键工作包括：

• 创建 Google service account
• 将其接入 Play Console API access
• 授予发布相关权限
• 在 eas.json 中配置 serviceAccountKeyPath 或基于 secret 的配置

如果你是在团队中使用 expo-deployment for Deployment，建议让智能体优先采用基于 secret 的 CI 配置，而不是把 key 文件直接提交进仓库。

Web 部署与预览工作流

如果你的 Expo 应用也面向 web，这个技能同样相关。仓库自带的 workflow 参考覆盖了：

• push 到 main 时进行生产 web 部署
• PR previews
• 面向原生 pull request 的 OTA 风格预览更新

如果你的发布问题不在商店提交，而在于如何稳定地提供预览环境，这部分会很有用。建议让技能根据你的分支策略映射到 .eas/workflows/*.yml，而不是只生成泛泛的 GitHub Actions 建议。

App Store metadata 支持很实用，但范围有限

这份 expo-deployment guide 里一个很有价值、但也容易被忽略的能力是 metadata 自动化。仓库包含基于 EAS Metadata 的 store.config.json 工作流，包括：

• eas metadata:pull
• eas metadata:push

一个重要前提是：参考文档明确说明它目前只针对 Apple App Store，且仍处于 preview 状态。你可以用它来实现可重复的 App Store metadata 管理，但不要默认它对 Google Play listing 管理也有同等能力。

能显著提升输出质量的实用技巧

如果你想让 expo-deployment skill 给出更高质量的结果，最好提供：

• 当前的 eas.json
• 这是首次提交还是版本更新
• App Store Connect 和 Play Console 中是否已经创建应用记录
• 你希望使用的 release tracks
• 你需要交互式本地命令，还是适合 CI 的自动化方案

这些信息会让回答从“给你几条命令”升级成“这是完整的部署计划，并且我已经把可能的阻塞点标出来了”。

expo-deployment 技能常见问题

expo-deployment skill 适合新手吗？

适合，前提是你已经能比较熟练地处理 Expo 应用代码库，只是刚接触发布操作。这个技能在首次提交到应用商店时尤其有帮助，因为它能减少你在 EAS 初始化、凭证配置和发布顺序上的试错。

但如果你对 Expo 本身还很陌生，建议先把项目基础补齐。这个技能解决的是“发布上线”，不是“从零创建应用”。

什么情况下应该用 expo-deployment，而不是普通提示词？

当你的请求涉及发布机制时，就该用 expo-deployment：

• 配置 eas.json
• 设置 Apple 或 Google 提交凭证
• 使用 EAS 构建并提交
• TestFlight 或 Play track 投放
• 工作流自动化
• 商店 metadata 处理

如果你处理的是 UI bug 或功能开发，通用的 Expo 编码技能会更合适。

expo-deployment 会往我的应用里安装什么吗？

expo-deployment install 这条路径，本质上是把技能加到你的 AI 环境里，然后配合 Expo 自己的工具链（例如 eas-cli）来完成工作。这个技能本身不会替代 EAS。实际需要安装的主要工具通常是：

npm install -g eas-cli

然后再初始化：

npx eas-cli@latest init

如果我只需要 TestFlight，它还能帮上忙吗？

可以。事实上，TestFlight 就是它最明确、最适合的使用场景之一。仓库里有专门的参考文档，也有快捷命令路径。如果你当前的目标就是“先把一个版本安全地装到真实 iPhone 上”，这个技能非常合适。

expo-deployment 也能处理 CI/CD 工作流吗？

能。仓库中的 references/workflows.md 涵盖了 EAS Workflows 的这些场景：

• push 时部署
• PR previews
• update previews
• 含 build 和 submit jobs 的 release workflows

所以它不只是适合一次性提交，也适合搭建长期可复用的发布流程。

什么情况下不该选 expo-deployment？

在以下情况下可以跳过这个技能：

• 你并不使用 Expo/EAS
• 你只需要泛化的移动端发布理论
• 你的阻塞点在法务、政策或企业账号审批
• 你需要的是超出 Expo 工作流范围的深度原生商店边缘场景

这些情况下，平台专属的发布专家或商店官方文档，可能比 Expo deployment 助手更重要。

如何把 expo-deployment skill 用得更好

给 expo-deployment 提供“发布状态”，不要只给目标

想提升 expo-deployment 结果质量，最快的方法就是告诉它哪些事实已经成立：

• eas.json 是否已存在
• 凭证是否已配置
• 应用记录是否已创建
• 这是首次发布还是更新
• 目标是手动流程还是 CI/CD

这样技能就不会把时间浪费在你已经做完的步骤上。

要求按顺序输出，并标明决策点

一个很强的请求结构是：

1. 审查当前部署准备情况
2. 按平台列出阻塞点
3. 提出文件改动建议
4. 按顺序给出命令
5. 分开手动路径和适合 CI 的路径

这种结构能让 expo-deployment skill 产出真正可执行的内容，而不是一堆混杂的建议。

提供真实配置文件，指导会更准

如果可以，尽量提供：

• eas.json
• app.json 或 app.config.*
• package name / bundle identifier
• 当前的 workflow YAML 文件

这些文件能帮助技能识别诸如 submit profiles 缺失、标识符不一致、环境隔离不足等问题。

留意常见失败模式

即使 expo-deployment 的输出本身没问题，最常见的失败原因仍然来自外部准备不足：

• App Store Connect 中还没有创建 app record
• Play Console 中应用尚未创建
• bundle/package IDs 不匹配
• API keys 缺失或权限不足
• version/build numbers 没有递增

在生成最终发布步骤之前，建议明确要求技能先校验这些点。

通过明确发布目标来改进提示词

“Deploy to production” 这个说法太宽泛。更好的表达是：

• “Ship iOS to internal TestFlight testers”
• “Submit Android to internal track only”
• “Create a web deploy workflow for pushes to main”
• “Prepare App Store metadata from existing listing”

目标说得越具体，expo-deployment usage 的结果通常越好，因为每条路径的前置条件和成功标准都不一样。

在第一轮输出后继续迭代

拿到第一轮回复后，可以继续用第二轮来收窄范围，例如：

• “Now convert this to CI-friendly steps only.”
• “Now generate the exact eas.json changes.”
• “Now focus only on iOS credential setup.”
• “Now list what I must do in App Store Connect manually.”

这种逐轮收窄的方式，是把 expo-deployment 从宽泛指导变成可执行清单的最佳方法。