开发与工程

Expo 项目结构指南

为全新的 Expo Router 应用建立清晰、可扩展的文件结构。

57/ 100
谨慎使用

价值存在,但可靠性、证据或控制措施仍有明显缺口。

查看评分依据 ↓
可直接使用于
Codex · Claude Code
Star 数
★ 2.9k
最近更新
21 天前
License
MIT
expoexpo-routerproject-structurereact-native
+2typescriptplatform-specific-files

这个 Skill 能做什么,适合哪些场景?

这是一个面向新 Expo 应用的项目结构技能,适用于尚未提交目录结构的项目。它规划 src/app、components、screens、server、utils、hooks 等目录的职责,并说明路由、服务端 API、平台差异、样式和测试应如何放置。它不会要求重构已有应用;项目是否为新项目不明确时,应先确认。Expo 文档、Expo CLI 和 EAS CLI 仍是事实来源。

提供一个新 Expo 应用的目录骨架;规定 src/app 仅存放 Expo Router 路由;指导可复用组件、屏幕主体、服务端辅助代码、工具函数、钩子、配置和资源的放置;说明平台专属文件命名、默认文件、样式内聚和测试内聚规则;给出从 app 切换到 src/app 以及使用 @/* 别名时需要注意的配置。

适合
  • 正在用 Expo Router 创建第一个新应用、尚未决定目录结构的开发者。
  • 需要判断某个新文件应放在路由、组件、屏幕、服务端或工具目录中的团队。
  • 需要组织 app/api API 路由及其服务端专用辅助函数的开发者。
  • 需要为 iOS、Android 和 Web 变体安排平台专属文件的开发者。
  • 希望将测试文件与被测试工具函数放在一起的新项目维护者。

如何安装这个 Skill?

使用前请注意
  • 仅适用于尚无既定目录结构的新 Expo 项目;对已有项目应用这些规则可能造成不必要迁移。
  • 涉及 app/api、server/ 和秘密环境变量时,文档没有说明访问边界、部署安全、日志处理或回滚方案。
  • Expo Router、src/app 行为及相关最佳实践可能随版本变化,应在采用前核对当前官方文档。
开始前你需要
Agent 需要具备
  • 本地文件系统
需要预先安装
  • Expo Router

该仓库 README 记录的是整套 Expo skills 的安装方式,没有记录此技能的独立安装命令。使用 Skills CLI 可安装整个集合:npx skills@latest add expo/skills --skill '*'。Claude Code 可运行 claude plugin install expo@claude-plugins-official;Codex 可运行 codex plugin add expo@openai-curated。安装后重启或刷新 agent 会话。

通用方式:手动安装到 Claude Code(macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/expo/skills.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/plugins/expo/skills/expo-project-structure" ~/.claude/skills/
rm -rf "$tmp"

根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。

如何使用这个 Skill?

试试这样说

安装后,把下面任意一句发给 Agent 即可触发:

  • 为我的新 Expo Router 应用规划项目文件夹结构,并说明每个文件应放在哪里。

在一个尚未形成固定目录结构的新 Expo Router 项目中提出结构设计请求,例如:“为我的新 Expo Router 应用规划项目文件夹结构,并说明每个文件应放在哪里。”如果应用已有目录布局,不要用此技能强行迁移;不确定项目是否为新项目时,先确认。

这个 Skill 有哪些优点和局限?

优点
  • 目录职责明确,区分路由、屏幕主体、可复用组件和服务端代码。
  • 覆盖平台专属文件、样式内聚和测试内聚等常见组织问题。
  • 明确限制在新项目使用,避免将默认结构当作迁移标准。
  • 提供 API 路由分组和服务端辅助代码隔离建议。
局限
  • 只提供结构和组织规则,没有脚本、自动迁移工具或测试套件。
  • 适用范围限定为新 Expo 项目,不负责重构已有应用。
  • 源码没有展示对不同 Expo、React Native 或 Metro 版本的测试证据。
  • 具体业务架构和团队约定仍需由项目自行决定。

这个 Skill 与同类方案有什么区别?

与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。

Skill FS 评分 Star 数 最近更新 License
Expo 项目结构指南 本页 57 · 谨慎使用 ★ 2.9k 21 天前 MIT
Expo Web 转原生迁移指南 52 · 谨慎使用 ★ 2.9k 21 天前 MIT
Expo DOM 组件助手 49 · 谨慎使用 ★ 2.9k 21 天前 MIT
Expo 原生 UI 构建助手 59 · 推荐 ★ 2.9k 21 天前 MIT
Expo 集成示例助手 51 · 谨慎使用 ★ 2.9k 21 天前 MIT

Expo 文档、Expo CLI 和 EAS CLI 是官方事实来源;本技能主要提供项目文件结构指导,不能替代这些工具和文档。

FollowSkills 如何评估这个 Skill?

FollowSkills 评估 · FSRS-2.0
谨慎使用
57/ 100 五分制 2.9 / 5
上游仓库在本次评估后已有新提交;当前评分仍对应所示审查版本,可能尚未覆盖最新改动。
1信任安全17 / 25 · 3.4/5

技能明确限定仅用于新项目,并要求在不确定时先询问;没有发现恶意行为、凭据窃取、隐蔽外传或破坏性默认操作。它提到服务器代码可读取秘密环境变量,但未提供更细的数据流、权限隔离、确认、回滚或依赖安全指导,因此扣8分。

2可靠稳定8 / 20 · 2.0/5

目录规则、路由约束和平台文件规则整体一致,且描述了默认文件和命名要求。未提供测试、执行结果、异常输入处理或可诊断失败信息;仅凭静态材料无法验证关键路径,因此按静态上限给8分。

3适用触发12 / 15 · 4.0/5

名称、触发条件和非适用范围较清楚,明确面向新建 Expo Router 项目且不得重构已有应用;输出是可直接采用的目录骨架。未明确输入检查、更多边界场景、中文支持或本地网络适配,但核心功能不依赖海外服务,因此扣3分。

4规范维护9 / 15 · 3.0/5

文档分层清晰,包含目录示例、命名约定、平台变体、测试共置、许可证和版本1.0.0。缺少 FAQ、故障排查、变更日志、维护责任和明确更新路径;仓库级 README 提供了安装更新信息,但不完全属于该技能自身,因此扣6分。

5有效结果7 / 15 · 2.3/5

技能覆盖 src/app、components、screens、server、平台文件和测试共置等核心布局,示例可直接指导新项目起步。没有静态可验证的代表性执行输出,也缺少对替代方案和适用成本的比较;按静态评估上限给7分。

6证据核验4 / 10 · 2.0/5

技能引用了 Expo 博客和官方文档,并给出可审计的具体规则;仓库还有许可证和基础 CI 检查。但没有覆盖该技能关键路径的提交测试或第三方执行证据,且本评估未执行任何内容,因此给4分。

1 2 3 4 5 6

点击维度查看打分理由

评估于 2026年7月20日 审查版本 8bd359f8a44d 评估证据[1][2][3][4][5][6][7]

证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。

查看完整评分方法 →

常见问题

它适合重构已有 Expo 应用吗?
不适合。它只用于尚未提交目录结构的新项目;已有应用应遵循现有约定。
安装这个技能需要付费吗?
README 将它归入 Framework(开源)技能组,并标注仓库许可证为 MIT;源材料没有说明其他相关服务的费用。
它会自动创建或移动文件吗?
源材料只提供结构规则和示例,没有提供自动创建、移动或迁移文件的脚本。
它是否要求 Expo Router?
它围绕 Expo Router 的路由目录规则编写,尤其要求 src/app 只存放路由文件。

同仓库的其他 Skills

均来自 expo/skills

开发与工程

Expo Web 转原生迁移指南

将现有 React 网站逐屏迁移为可发布的 Expo 原生应用。

★ 2.9k FS 52 谨慎使用 21 天前
开发与工程

Expo DOM 组件助手

让 Expo 原生应用渐进式复用 Web 代码与 Web 专属库。

★ 2.9k FS 49 谨慎使用 21 天前
开发与工程

Expo 原生 UI 构建助手

用 @expo/ui 在 Expo 中构建跨平台原生界面。

★ 2.9k FS 59 推荐 21 天前
开发与工程

Expo 集成示例助手

用 Expo 官方示例快速适配第三方库与服务。

★ 2.9k FS 51 谨慎使用 21 天前
开发与工程

Expo Tailwind 样式配置助手

为 Expo 应用配置 Tailwind CSS v4、NativeWind v5 与跨平台样式支持。

★ 2.9k FS 43 不推荐 21 天前
开发与工程

Expo 棕地集成助手

帮助团队将 Expo 和 React Native 增量集成到现有的原生 iOS 或 Android 应用中。

★ 2.9k FS 58 推荐 21 天前
自动化与运维

EAS Observe 性能观测助手

帮助 Expo 团队接入、查询并解读生产环境中的启动、导航和自定义事件性能指标。

★ 2.9k FS 55 谨慎使用 21 天前
开发与工程

Expo 数据请求指南

为 Expo 应用提供从 API 请求到缓存、离线与身份验证的网络开发指导。

★ 2.9k FS 55 谨慎使用 21 天前
开发与工程

Expo 技能反馈

帮助用户提交 Expo 技能或框架反馈,并管理匿名使用遥测。

★ 2.9k FS 54 谨慎使用 21 天前
设计与前端

Expo 原生界面设计指南

帮助 Expo 开发者构建符合 Apple 设计规范、具备原生体验的响应式界面。

★ 2.9k FS 51 谨慎使用 21 天前
开发与工程

Expo SDK 升级助手

帮助 Expo 团队升级 SDK、处理依赖冲突并完成兼容性清理。

★ 2.9k FS 50 谨慎使用 21 天前
开发与工程

Expo 技能评测器

端到端验证 Expo 技能是否触发、产出可用代码并正确渲染。

★ 2.9k FS 48 谨慎使用 21 天前
开发与工程

Expo EAS 托管部署

帮助 Expo 项目部署网站与 API 路由,并配置密钥、域名和边缘运行时。

★ 2.9k FS 48 谨慎使用 21 天前
开发与工程

Expo Router 导航助手

为 Expo 应用设计文件路由与原生导航结构。

★ 2.9k FS 53 谨慎使用 21 天前
开发与工程

Expo 原生模块迁移助手

将现有 Expo 原生模块从 1.0 DSL 迁移到 2.0 宏 API,同时保持 JavaScript 接口不变。

★ 2.9k FS 60 推荐 21 天前
开发与工程

Expo 原生模块开发指南

帮助 Expo 开发者使用 Swift、Kotlin 和 TypeScript 构建原生模块与原生视图。

★ 2.9k FS 51 谨慎使用 21 天前
开发与工程

EAS 云端模拟器助手

让无法本地运行模拟器的团队在 EAS 云端运行、操控并截图 Expo 应用。

★ 2.9k FS 60 推荐 21 天前
自动化与运维

EAS 更新健康洞察

用 CLI 检查 EAS Update 的崩溃率、采用情况与发布健康度。

★ 2.9k FS 55 谨慎使用 21 天前
开发与工程

Expo App Clip 助手

为 Expo 应用配置可由网址唤起的 iOS App Clip。

★ 2.9k FS 55 谨慎使用 21 天前
开发与工程

Expo 开发客户端构建助手

为 Expo 原生代码测试构建并分发开发客户端。

★ 2.9k FS 54 谨慎使用 21 天前

相关 Skills