spezi-platform-selection

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese
<!-- This source file is part of the Stanford Spezi open-source project. SPDX-FileCopyrightText: 2026 Stanford University and the project authors (see CONTRIBUTORS.md) SPDX-License-Identifier: MIT -->
<!-- 此源文件是斯坦福Spezi开源项目的一部分。 SPDX-FileCopyrightText: 2026 斯坦福大学及项目作者(详见CONTRIBUTORS.md) SPDX-License-Identifier: MIT -->

Spezi Platform Selection

Spezi平台选择

Use this skill when a user needs help choosing the right starter application and bootstrapping a new project.
当用户需要帮助选择合适的启动应用并搭建新项目时,可使用此技能。

Candidate Templates

候选模板

Read setup-guide.md before making the recommendation.
  • React Native Template App
  • Spezi Template Application for Apple Platforms
The Apple Platforms template supports iPhone, iPad, and Vision Pro.
在给出推荐前,请先阅读setup-guide.md
  • React Native模板应用
  • 适用于Apple平台的Spezi模板应用
Apple平台模板支持iPhone、iPad和Vision Pro。

Ask First

先进行询问

Ask concise questions that reveal whether the app is primarily:
  • content, forms, scheduling, chat, or cross-platform workflow support
  • deeply integrated with HealthKit, SensorKit, Bluetooth peripherals, background collection, or another Apple-native SDK
Confirm:
  1. who the users are
  2. whether cross-platform support matters at launch
  3. whether the app is iPhone-only or Apple-platform focused
  4. whether native Apple capabilities are core to product value
提出简洁的问题,以明确应用的主要类型:
  • 内容展示、表单、日程安排、聊天,或跨平台工作流支持
  • 与HealthKit、SensorKit、蓝牙外设、后台数据采集或其他Apple原生SDK深度集成
确认以下信息:
  1. 目标用户群体
  2. 发布时是否需要跨平台支持
  3. 应用仅针对iPhone还是全Apple平台
  4. Apple原生功能是否为产品核心价值

Decide The Platform

确定平台

Read platform-decision.md before deciding.
Choose the React Native Template App when:
  • cross-platform delivery matters
  • the product is primarily content, questionnaires, scheduling, chat, or lightweight integrations
Choose the Spezi Template Application for Apple Platforms when:
  • HealthKit, SensorKit, Bluetooth, or another Apple-native SDK is product-critical
  • the app is explicitly for iPhone, iPad, or Vision Pro
  • deep platform integration matters more than cross-platform reach
在做决定前,请先阅读platform-decision.md
当满足以下条件时,选择React Native模板应用
  • 跨平台交付至关重要
  • 产品主要用于内容展示、问卷、日程安排、聊天或轻量级集成
当满足以下条件时,选择适用于Apple平台的Spezi模板应用
  • HealthKit、SensorKit、蓝牙或其他Apple原生SDK是产品的核心需求
  • 应用明确针对iPhone、iPad或Vision Pro
  • 深度平台集成比跨平台覆盖更重要

Prepare The Machine

准备开发环境

After deciding on a platform, guide the user through the matching setup steps in setup-guide.md before cloning and implementation.
  • For the Spezi Template Application for Apple Platforms, prefer helping the user install and validate Xcode first.
  • For the React Native Template App, help the user set up a proper Expo and React Native development environment for the targets they care about.
Make sure the user is clear whether they want:
  • quick experimentation on a physical device
  • simulator or emulator-based development
  • development builds with native capabilities
确定平台后,在克隆和实施前,引导用户完成setup-guide.md中对应的设置步骤。
  • 对于适用于Apple平台的Spezi模板应用,优先帮助用户安装并验证Xcode。
  • 对于React Native模板应用,帮助用户为其关注的目标平台搭建合适的Expo和React Native开发环境。
确保用户明确自身需求:
  • 在物理设备上快速实验
  • 基于模拟器或仿真器的开发
  • 具备原生功能的开发构建版本

Clone The Selected Template

克隆选定的模板

Use the bundled clone helper instead of writing ad hoc clone commands:
  • scripts/clone-template.sh rn-cs342-template <destination>
  • scripts/clone-template.sh spezi-template <destination>
After cloning:
  1. inspect the cloned repository's local instructions
  2. inspect the cloned repository's
    skills/
    directory if present
  3. continue implementation inside the cloned repository rather than in this root repo
使用内置的克隆助手,而非编写临时克隆命令:
  • scripts/clone-template.sh rn-cs342-template <destination>
  • scripts/clone-template.sh spezi-template <destination>
克隆完成后:
  1. 查看克隆仓库的本地说明
  2. 若存在
    skills/
    目录,查看该目录内容
  3. 在克隆的仓库内继续实施,而非在根仓库中

Output

输出内容

End with a short summary containing:
  • chosen template
  • why it was selected
  • machine setup steps completed or still required
  • clone destination
  • the next local skills or instructions to inspect in the cloned repository
结尾处添加简短总结,包含:
  • 选定的模板
  • 选择该模板的原因
  • 已完成或仍需完成的开发环境设置步骤
  • 克隆目标路径
  • 接下来需查看的克隆仓库中的本地技能或说明文档