SuperAPI AI 工具集

flow

通用与其它

查看项目

更新于 10-15 22:14

技能介绍

用途:从代码库中发现用户流程,将其保存为可执行的流程产物(walkable artifacts),并在浏览器中实际运行以验证可用性。

主要能力:包含五种模式。discover 扫描代码库并生成流程产物;walk 在浏览器中执行已存储的流程;check 通过文件校验和检测代码漂移;gaps 根据应用信号识别缺失的用户旅程;无参数时进入智能路由,评估当前状态并询问用户意图。

使用方式:以第一个参数指定模式,如 discover、walk、check、gaps,无参数时智能路由。discover 会检测框架(支持 Next.js App Router/Pages Router、SvelteKit、Remix),按 glob 模式匹配路由文件,读取中间件判断鉴权级别(none/user/admin 等),并识别鉴权提供方(Clerk、WorkOS、自研、无)。随后按顶层路径分组,并行调度 flow-discoverer 代理,将流程写入 docs/arc/flows/*.md;支持 --force 覆盖已有流程。walk 优先使用 Chrome MCP,其次 agent-browser,最后 Playwright;需确认 dev server URL,已验证服务可用性;按公开流程优先、鉴权流程在后的顺序执行,支持 --flow <name> 与 --all,执行 navigate/click/fill/select/wait 等步骤并检查 url/visible/heading/not-visible 期望,遇错记录并跳过后续步骤。check 用 sha256sum 计算源文件校验和,比对存储值判断是否过期并更新 status: stale。gaps 依据依赖与路由结构信号推断应有但缺失的流程。

适用场景:希望在开发阶段自动生成并回归验证用户流程、检测代码变更导致的流程漂移、发现遗漏的用户旅程。

限制:仅支持 Next.js、SvelteKit、Remix,无法检测框架时终止;walk 需可用的浏览器工具与运行中的开发服务器;鉴权流程需用户先登录,环境变量未设置时中止;部分步骤依赖外部工具与用户交互,具体实现细节与可用性以实际环境为准,资料未提供完整 gaps 后续步骤与代理协议全文。