SuperAPI AI 工具集

ux-flows

通用与其它

查看项目

更新于 10-15 21:10

技能介绍

用途:ux-flows 是项目使用流程的“事实来源”,同时充当编排者,把流程逐个交给 ux-persona 技能做可用性走查。它把“做什么”(流程,属于项目数据)与“怎么做”(走查方式,属于 ux-persona)分离,且与技术栈无关,不硬编码端口或地址,每个流程自行声明入口点。

流程存放:约定每个流程一个文件,位于项目的 e2e/flows/<id>.md,纳入版本控制。模板包含 id、name、reference(可选)、persona、entry(入口 URL)、preconditions、design_refs(可选,按屏幕列出设计稿来源),以及用户目标、步骤(每步为 UI 动作加预期结果)和预期结果。建模规则:每个流程都从入口点(首页/落地页)开始,只描述点击、填写等 UI 动作,不写“访问 URL X”,以便识别无法通过导航到达的屏幕;有设计稿的屏幕列入 design_refs,用于校验设计还原度。

命令(通过 $ARGUMENTS):空或 list 列出项目流程并提供运行选项,目录为空或缺失时先执行 discover;<flow-id> 运行单个流程,调用 ux-persona 并传入流程文件路径;all 顺序运行全部流程(浏览器是单一资源,绝不并行),每个流程等报告完成后再进行下一个;new 协助编写一个流程;discover 在尚无流程时勘察应用并引导建立目录。

发现机制:当没有流程时,勘察代码库中的路由、导航、产品文档与主要 CTA,推断用户目标,按人群分组,起草 e2e/flows/<id>.md 与所需 persona 文件,并在运行前让用户确认。发现是尽力而为,路径不明确时在草稿中标注假设。

编排:先做一次预检查,确认应用在流程入口点运行、最小数据已就绪;随后逐个调用 ux-persona,顺序执行;最后汇总本轮报告,生成记分板(每个流程的结论与各严重级别问题数)和按优先级排序的可用性修复清单。

Webwright 支持:若用户要求 Webwright、可回放证据或生成的浏览器脚本,仍以本技能作为目录编排者,并让 ux-persona 以 Webwright 作为该流程的执行后端;不要用 Webwright 脚本替换 e2e/flows/*.md,流程定义仍是事实来源,原生 Playwright E2E 仍用于持久 CI 回归。

维护与布局:新增旅程或屏幕时创建对应流程文件;修复可用性问题后重跑受影响流程;e2e/usability/ 报告是历史记录,不要删除。推荐布局为 e2e/personas/、e2e/flows/、e2e/usability/。persona 也可使用 ux-persona 技能内置的常见类型(新手、匆忙、怀疑、移动端、无障碍、高级用户)。限制:资料未提供具体收费、平台与效果信息。