用途:为应用生成“快速上手(Quick Win)”会话系统,引导新用户在首次 60 秒内完成一个有意义的操作,从而降低首次价值达成时间、提升激活与留存。适用于询问快速上手流程、首次操作体验、引导式首个任务、首次成功时刻、激活指标、新用户激活或引导留存等场景。
主要能力:生成任务模型与步骤(QuickWinTask)、可观察的会话管理器(QuickWinSession,负责任务选择、步骤跟踪、计时与完成状态)、分步引导浮层(QuickWinGuideView)、聚光灯提示浮层(SpotlightHintView)、完成庆祝视图(QuickWinCelebrationView)以及触发新用户流程的 ViewModifier(QuickWinModifier)。支持三种引导样式:分步浮层、聚光灯提示、教练标记;支持完成庆祝(动画、横幅或静默);可选记录完成时间与逐步进度作为激活指标。
使用方式:技能会先做生成前检查,包括部署目标(需 iOS 17+/macOS 14+ 以使用 @Observable)、Swift 版本(需 5.9+)、源文件位置,并搜索已有引导代码与用户状态跟踪(UserDefaults、@AppStorage 等)。随后通过提问确认快速上手类型(创建首个条目、完善资料、导入数据、探索功能)、引导样式、是否庆祝、是否作为激活指标。生成后按项目结构放入 Sources/QuickWin/、App/QuickWin/ 或 QuickWin/。集成时在根视图附加 .quickWinSession(task:),用扩展定义任务与步骤,用 .quickWinTarget(id:) 标记聚光灯目标,也可在已有引导后以 session.start(task:) 程序化启动。
适用场景:新用户首次操作引导、激活指标埋点、引导后衔接的首次成功体验。
限制与注意:不要阻塞老用户,展示前检查完成状态并提供跳过;完成后或关闭后不再展示。快速上手应产出真实成果而非演示。需优雅处理中断并持久化进度。不同用户类型应使用不同快速上手。步骤控制在 3 步、最多 5 步,确保 60 秒内完成。需遵守 App Store 相关准则(如不强制注册、真实功能、再参与推送需同意、避免垃圾应用)。具体模板与完整代码见 templates.md。