SuperAPI AI 工具集

flow-report

测试与质量

查看项目

更新于 10-15 21:41

技能介绍

用途:flow-report 用于分析某条流程的 walk 结果,生成按严重程度分类的摩擦报告,帮助定位用户流程中的问题。用法为 /flow-report <flow-name>,参数是流程名称,使用该流程最近一次快照。

主要能力:读取 snapshots/{latest}-{flow-name}/results.json、各步骤截图、裁剪后的视频与 GIF、flows/{flow-name}.yml 流程定义、knowledge/friction-taxonomy.md 分类知识、config.yml 配置(平台类型、时间阈值、业务目标)。将每个非干净通过的步骤分类为 Critical(用户无法完成任务,如步骤 error/fail、导航失败、表单提交服务器错误、重定向循环或死路)、Friction(可完成但体验痛苦,如步骤超时、预期部分满足、出现流程外额外步骤、截图显示 UI 混乱)、Cosmetic(功能正常但外观粗糙,如对齐、间距、对比度问题、文本截断或占位文本可见)。还会结合平台类型(SaaS、Website、Internal tool、Mobile)调整关注重点,并为每条发现给出问题描述、影响、具体修复建议和低/中/高工作量估计。若项目存在 .speckit/,会交叉比对规格,标记规格违规或缺失规格。

输出:在 .flowchad/reports/{YYYY-MM-DD}-{flow-name}-report.md 生成 Markdown 报告,包含日期、流程、URL、通过率、耗时、三类发现详情、汇总表、总体评估、视频与 GIF 引用及推荐后续步骤。报告生成后打印给用户并提示保存路径,建议修复后再次运行 /flow-walk {name} 跟踪改进,或运行 /flow-suggest {name} 获取 AI 优先级改进计划(需该技能存在)。

限制:依赖已有 walk 快照与相关文件;证据 URL 缺失时回退到本地路径;/flow-suggest 是否可用取决于该技能是否存在。