SuperAPI AI 工具集

leavn multi-language ux verification skill

测试与质量

查看项目

更新于 10-16 04:26

技能介绍

用途

该技能用于对 Leavn iOS 应用进行多语言用户体验验证,覆盖 6 种支持语言:英语(en,LTR)、西班牙语(es,LTR)、德语(de,LTR)、简体中文(zh-Hans,LTR)、阿拉伯语(ar,RTL)、希伯来语(he,RTL)。其目标是系统性地测试语言切换、本地化、RTL 支持以及内容渲染,并生成一份详细报告,说明哪些功能正常、哪些存在问题。

主要能力

该技能通过静态代码分析执行 12 个测试类别:

  1. 语言切换机制:检查设置中的语言选择器、6 种语言是否全部列出、选择是否持久化到 PreferencesStore、切换后应用是否立即更新或需要重启、切换时是否崩溃或产生控制台错误。
  2. 标签栏与导航:标签标签、导航标题、返回按钮文本、模态/表单标题的本地化。
  3. 首页内容:每日经文卡片 UI 文本、问候语、区块标题、快捷操作按钮、日期时间格式是否匹配区域设置。
  4. 圣经阅读器体验:书名翻译、章节/经文标签、搜索占位符、空状态、圣经内容 API 是否返回正确翻译、RTL 下经文编号渲染。
  5. 社区功能:祷告请求表单标签、群组名称/描述、消息 UI、时间戳格式、空状态。
  6. 图书馆内容:讲道列表 UI 文本、灵修卡片、筛选/排序选项、播放控制文本。
  7. 引导体验:冥想指导语、音频控制、计时器/时长显示。
  8. 引导流程:欢迎屏幕、权限请求、跳过/继续按钮、功能说明文本。
  9. RTL 布局验证(阿拉伯语/希伯来语):UI 是否正确镜像、文本对齐是否翻转、图标是否适当翻转、导航是否从右到左、标签栏图标顺序、经文引用格式。
  10. 日期/时间格式化:日期格式、时间格式(12 小时制 vs 24 小时制)、相对时间翻译、日历系统。
  11. 搜索功能:搜索占位符翻译、搜索结果渲染、圣经搜索是否支持翻译后的书名、搜索建议本地化。
  12. AI 生成内容:灵修内容是否以所选语言生成、AI 提示是否包含语言上下文、生成内容在 RTL 下是否正确显示。

使用方式

该技能按四个阶段执行:

  • 阶段 1:代码分析。定位本地化基础设施(I18n 门面、.lproj 目录、PreferencesStore、设置视图),识别关键测试屏幕,检查 RTL 支持实现。
  • 阶段 2:测试执行计划。按上述 12 个测试类别逐项验证,每个测试列出需要验证的内容和关键文件。
  • 阶段 3:报告生成。生成结构化 Markdown 报告,包含执行摘要、按语言分类的测试结果、P0/P1/P2 严重级别问题、建议、覆盖率分析以及代码位置附录。
  • 阶段 4:执行步骤。分析代码库、检查本地化覆盖率、验证 RTL 实现、测试日期时间格式化、分析圣经服务、生成报告。

输出交付物包括:综合 Markdown 报告、可导入待办列表或 GitHub Issues 的问题列表、展示问题模式的代码片段、所有问题的文件路径引用。

适用场景

适用于 Leavn iOS 应用在新增语言、新增主要功能(新标签页、新流程)、本地化架构变更或 RTL 支持实现变更时进行多语言 UX 验证。

限制

该技能执行的是代码静态分析,不运行模拟器。如需运行时测试,建议创建互补的 UI 测试套件。该技能侧重于发现架构问题,而不仅仅是缺失的翻译。需要特别关注 RTL,因为这通常是最容易出问题的领域。还需检查绕过本地化系统的硬编码字符串。

维护

当 Leavn 新增语言、新增主要功能、本地化架构变更或 RTL 支持实现变更时,应更新此技能。