SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场testing

testing

测试与质量

查看项目

更新于 10-15 08:52

技能介绍

用途

本技能用于在 Lovable 项目的预览模式（Preview，即编辑器中正在运行的应用）下，通过浏览器自动化执行测试。它旨在将测试流程嵌入开发循环：代码 → 推送 → 部署 → 在真实运行的应用中测试 → 修复 → 重复。

主要能力

  1. 测试向导（/lovable:test-init）：引导创建测试工作区，包括搭建 .lovable-agent/tests/ 和 .lovable-agent/config.json 结构、捕获预览 URL 与令牌（或检测已登录浏览器）、扫描代码库识别主要用户操作（路由、表单、认证流程、CRUD 操作、边缘函数调用）、为每个主要操作建议测试计划、创建测试用户档案、编写标准化测试计划文件，并在配置中记录覆盖率状态（git 提交哈希）。

  2. 测试执行（/lovable:test-run）：通过浏览器自动化针对预览应用执行测试计划，包括导航到预览、逐步执行计划步骤（点击、填写表单、导航）、验证预期结果（UI 状态、控制台错误、网络响应）、将结果写入 results/ 并报告摘要。支持模式：--all（运行所有计划）、--changed（仅运行受近期更改影响的计划）、--smoke（仅运行标记为 smoke 的计划）、[plan-id]（运行特定计划）。

  3. 测试同步（/lovable:test-sync）：保持测试与代码库同步，包括比较当前代码库与配置中的 last_synced_commit、识别新增/变更的功能、映射到现有测试计划以发现覆盖缺口、建议新计划并更新过时计划、检查单元测试覆盖缺口，并更新同步点。

  4. 持续测试维护：在实现新功能后，自动添加/更新单元测试和测试计划；若 test_after_implementation 开启，则立即运行受影响的测试计划；否则提醒用户运行 /lovable:test-sync。

使用方式

  • 激活条件：在 .lovable-agent/config.json 或旧版 CLAUDE.md 中启用预览测试（Preview Testing → Status: on）；用户运行测试命令；实现功能后（若测试工作区存在）；自动部署后（若 test_after_deploy 开启）；用户以任何形式提及预览测试。
  • 预览访问：方法一，已登录浏览器（Chrome 中登录 Lovable，使用 Claude in Chrome 扩展）直接导航；方法二，令牌化预览 URL（https://preview--[app-name].lovable.app/?__lovable_token=[JWT]），令牌有效期为 7 天，需存储在 .lovable-agent/preview-token.local（gitignored）。访问优先级：有效存储令牌 → 令牌化 URL；无/过期令牌 + 已登录 → 浏览器会话；两者皆无 → 请求用户登录或提供新 URL；回退：提供手动测试清单。
  • 工作区结构：所有测试产物位于 .lovable-agent/tests/，包含 plans/、profiles/、results/ 等目录；旧版 .claude/lovable-claude/test/ 仍受支持，可通过 scripts/migrate-workspace.py 迁移。
  • 配置：在 CLAUDE.md 中配置 Status、Preview URL、Access Method、Token Captured、Test After Implementation、Test After Deploy、Last Test Sync 等字段。令牌绝不写入 AGENTS.md、CLAUDE.md 或配置 JSON。

适用场景

  • Lovable 项目的预览测试，确保在真实运行的应用中验证功能。
  • 与 Yolo 模式（自动部署）集成，在部署后运行 smoke 或全部测试计划。
  • 与自动推送集成，等待前端更改同步到 Lovable 后再运行预览测试。
  • 与 /lovable:init 集成，在初始化时询问预览测试并捕获 URL/令牌。

限制

  • 需要浏览器自动化环境（Claude in Chrome 扩展）。
  • 令牌有效期为 7 天，过期需重新捕获。
  • 若浏览器自动化不可用，则回退到手动测试清单。
  • 预览应用显示错误或空白页时，需捕获控制台错误并检查部署/同步状态，不得标记测试通过。
  • 测试失败时记录失败步骤、预期与实际、控制台/网络错误，并写入 FAIL 结果文件。

参考文件

  • references/preview-access.md：捕获、存储和验证预览 URL 与令牌；访问优先级；过期处理。
  • references/test-plan-format.md：测试计划、档案、配置、结果和工作区 README 的标准化格式。
  • references/test-wizard.md：代码库扫描、引导问题流程、计划生成。
  • references/test-execution.md：浏览器自动化工作流、验证、结果报告。