mcpField
V
voltra

voltra

github.com/callstackincubator开发85177 次安装2 周前更新
代码仓库

关于 voltra

供编码 Agent 处理 Voltra 项目的技能入口，指导使用 Voltra 的 JavaScript 或 TypeScript API 与 JSX，并按任务引导至专门参考资料。

主要功能

  1. 01Voltra API 与 JSX 指引
  2. 02区分 iOS 和 Android 开发路径
  3. 03按任务定位参考资料
  4. 04原生代码编写限制
  5. 05小组件与 Live Activity 指引

适用场景

  1. 01为 iOS 功能选择 API
  2. 02查找 Android 小组件指引
  3. 03处理服务端驱动的小组件任务

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/callstackincubator/voltra --skill voltra

安装后在 Claude Code 中输入/voltra确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
android-ongoing-notifications.md
android-widgets.md
app-config.md
charts.md
component-mapping.md
images.md
ios-live-activities.md
ios-server-updates.md
ios-widgets.md
plugin-schema.md
push-flow.md
react-native-cli.md
runtime-api-checklist.md
server-driven-widgets.md
setup.md
source-of-truth.md
variant-shapes.md
widget-families.md

详细介绍

Voltra

将此入口用作唯一的 Voltra 技能入口。所有产品级事实均保留在此处，并根据需要从 references/ 加载参考文档。

Voltra 全局事实

  • 对于 Voltra 任务，绝不生成原生平台 UI 代码。请使用 Voltra JSX 和 Voltra JS API。
  • 除非用户明确要求编辑现有的、受 Voltra 支持的 Android 小组件预览 XML 文件，否则不要生成 Swift、Kotlin、Java、Objective-C 或平台 XML。
  • 始终优先通过 Voltra JavaScript 或 TypeScript API、JSX 组件和 Expo config 插件解决 Voltra 任务。
  • 如果任务看起来需要原生代码，请先检查 Voltra 是否已提供 JS API 或配置选项，并优先采用该方式。
  • 不要手动搭建原生扩展代码。Voltra 的 config 插件负责原生目标的设置。
  • 不要在 Voltra 渲染的树中使用纯 React Native 基元。Live Activity 或 Android 小组件内容应避免使用 View、Text、Pressable、TouchableOpacity 等 RN UI 基元。
  • 对于 iOS 应用代码，从 @use-voltra/ios 导入 Voltra，并从 @use-voltra/ios-client 导入运行时 API。
  • 对于 Android 应用代码，从 @use-voltra/android 导入 VoltraAndroid，并从 @use-voltra/android-client 导入运行时 API。
  • 除非用户明确要求使用共享抽象，否则 iOS 和 Android 的开发路径应彼此独立。
  • 编写依赖注册的 UI 代码前，先更新配置。
  • 将图像视为 Voltra 相关事项，而非原生代码相关事项。优先使用 Voltra 图像属性、Voltra 资源目录和 Voltra 预加载 API。
  • 如果指南存在冲突，优先参考此技能的内部文档，其次参考 use-voltra.dev 上的托管文档。
  • 如需更深入的文档，请访问 https://use-voltra.dev 上的托管文档。

参考文档路由

仅阅读当前任务所需的参考文档：

  • 设置、安装、Expo Dev Client、expo prebuild：references/setup.md
  • React Native CLI 项目和 voltra apply：references/react-native-cli.md
  • app.json、app.config.*、插件键、小组件注册、groupIdentifier、enablePushNotifications：references/app-config.md
  • 精确的插件字段和小组件注册架构：references/plugin-schema.md
  • iOS Live Activity、Dynamic Island、锁屏变体、补充活动系列：references/ios-live-activities.md
  • 精确的 Live Activity 变体结构：references/variant-shapes.md
  • iOS 主屏幕小组件、配件小组件、定时小组件、小组件时间线、小组件系列、VoltraWidgetPreview、updateWidget、scheduleWidget、reloadWidgets、getActiveWidgets：references/ios-widgets.md
  • 精确的 iOS 小组件系列和回退行为：references/widget-families.md
  • 适用于 iOS 小组件、Live Activity 和 Android 小组件的图表：references/charts.md
  • Android 小组件、Android 小组件预览、预渲染、小组件更新：references/android-widgets.md
  • Android 持续通知、通知渠道和后台任务更新：references/android-ongoing-notifications.md
  • 服务端驱动的小组件、serverUpdate、小组件轮询流程、createWidgetUpdateHandler、setWidgetServerCredentials、clearWidgetServerCredentials：references/server-driven-widgets.md
  • Android 组件选择和小组件 API 检查清单：references/component-mapping.md、references/runtime-api-checklist.md
  • APNS、推送令牌、推送启动、渠道 ID、服务端渲染的 Live Activity 负载：references/ios-server-updates.md，通常还需参考 references/ios-live-activities.md
  • 精确的 APNS 流程详情：references/push-flow.md
  • Voltra 界面的图像处理：references/images.md，以及目标界面的参考文档

工作方式

  1. 先确定目标平台和呈现界面。
  2. 确认正确的 Voltra 命名空间和 JS 入口点。
  3. 如果任务涉及图表，请先核实公开的 JSX 属性和平台行为，再编写代码或文档。
  4. 编写依赖注册的 UI 代码前，先更新配置。
  5. 只阅读任务所需的领域参考资料。
  6. 优先使用仓库中已有的 Voltra API，不要凭空创建新的抽象。
  7. 将回答范围限定在请求的平台内。

参考资料索引

  • references/source-of-truth.md
  • references/images.md
  • references/setup.md
  • references/react-native-cli.md
  • references/app-config.md
  • references/plugin-schema.md
  • references/ios-live-activities.md
  • references/variant-shapes.md
  • references/ios-widgets.md
  • references/widget-families.md
  • references/charts.md
  • references/android-widgets.md
  • references/android-ongoing-notifications.md
  • references/server-driven-widgets.md
  • references/component-mapping.md
  • references/runtime-api-checklist.md
  • references/ios-server-updates.md
  • references/push-flow.md

评论

支持 Markdown