本技能用于创建、更新、验证或预览 Lexsis Quiz 岛屿,主要面向电商商品推荐场景。
用途
借助实时的 Quiz 岛屿引导用户完成商品推荐旅程。在开始编写之前,需要阅读 references/quiz-authoring.md 以及当前的 vibe://schema/island/Quiz。遇到不熟悉的 MCP 参数时,通过 lexsis_discover 解析。
主要能力
- 支持带真实商品推荐的测验,并包含分支逻辑与变体匹配。
- 可选保存用户的回答。
- 规划稳定的键、问题、分支、评分、确定性回退、结果解释、商品与变体映射,以及进入和退出动作。
- 决定是否保存回答,并定义保存的目的、披露方式、问题分类、商家可见性、保留期、恢复窗口以及可选的联系目的。
- 使用 Quiz add_items 实现结果中的商品操作。
- 在 390、768、1280 三种宽度下测试可达分支与结果、平局与回退、必填与可选输入、返回与重试、不可用变体、Cart V2 结果、焦点、过渡动画以及减少动效。
使用方式
- 解析确切的工作区、商店、页面和主题。加载品牌上下文并检查可用的桌面端与移动端参考,全程保持相同的主题。
- 使用 lexsis_catalog 刷新真实的候选商品和变体;绝不能虚构 Shopify ID、价格、库存、选项值或结果图片。
- 规划稳定的键、问题、分支、评分、确定性回退、结果解释、商品与变体映射,以及进入和退出动作。移除对推荐或既定捕获目的没有作用的问题。
- 决定是否保存回答。若保存,则定义目的、披露、问题分类、商家可见性、保留期、恢复窗口以及可选的联系目的。保存与分析是相互独立的;收集联系方式并不会让访客订阅营销。
- 在普通页面源码中编写一份完整的 Quiz 定义。使用作用域 CSS、受支持的 hooks 以及受管动效来实现过渡。保持焦点并尊重减少动效行为;不要虚构运行时预设或自定义状态机。
- 编译、修复阻塞项,然后创建或更新请求的未发布草稿,并启用版本保护。将源码与 QA 保留在 MCP 中;不要保存本地 JSON 转储、截图报告或临时页面产物。
- 如果请求保存,则使用 lexsis_capture.quiz_inspect 检查不可变的页面版本 UUID,并用 lexsis_drafts.quiz_prepare 准备其非活动策略。任何源码编辑后都要重新检查。
- 测试可达分支与结果、平局与回退、必填与可选输入、返回与重试、不可用变体、Cart V2 结果、焦点、过渡以及减少动效,覆盖 390、768、1280 宽度。通过 MCP 记录受支持的托管 QA。
- 在 QA 或批准待处理期间返回 DRAFT_CREATED。只有在完成托管 QA 并明确批准同一版本后,才记录 DESIGN_APPROVED。这是对 /publish 的有效移交。
- 在得到明确授权后,用 lexsis_live_ops.quiz_activate 激活已审查的策略,并通过 /publish 发布已审查的页面。这是两个独立的决定;可以复用已针对确切范围给出的批准。预览不能证明生产环境捕获。
- 发布后,验证保存允许与拒绝、分析允许与拒绝、编辑与重新加载与重试、一个完整的 Forms 响应以及经过脱敏的 MCP 读取。使用返回的已发布 URL。报告任何未测试的路径或线上限制。
适用场景
适用于需要在电商页面中创建或维护 Lexsis Quiz 岛屿的商家或开发者,用于商品推荐、分支问卷、变体匹配以及可选的回答保存与分析。
限制
- 定义位于页面源码中。保存的回答使用受管捕获策略和 Forms 响应查看器;不要编辑通用 Forms 模式来绕过它。
- 个人和敏感回答受保护;MCP 只暴露允许的分类值。analytics.answerAllowlist 不允许原始分析。
- 结果中的商品操作使用 Quiz add_items。不要添加隐藏的 BuyBoxes、直接 Shopify 请求、编写的购物车外壳或程序化点击。
- reward 和 offer 动作不可用。在声称折扣或赠品之前,请单独验证现有的购物车促销。
- 只使用实时模式中存在的已注册岛屿和宿主能力。如果受支持的 hooks 无法表达设计,请指出所需的可复用宿主变更;不要虚构岛屿或注入任意 JavaScript。
- 不要承诺自动结果邮件、营销同步、专门的测验漏斗仪表板、已付款订单归因、预览捕获或历史版本恢复。
返回内容
报告页面与版本及托管 URL;商品来源与已测试路径;响应式、购物车与动效 QA;保存策略状态;激活与发布状态;以及实时捕获与分析证据或待处理检查。保持设计批准、策略激活、发布、确认保存和购买为独立结果。