SuperAPI AI 工具集

multi-user-workflow-generator

测试与质量

查看项目

更新于 10-16 10:19

技能介绍

用途

该技能是一套面向多用户、并发与实时场景的 QA 工作流文档生成流程,服务于协作编辑器、共享仪表盘、基于角色的管理面板、邀请流程,以及任何“一个用户的操作会影响另一个用户体验”的功能。其目标是生成全面、带角色(persona)标签的工作流文档,使每位动作都明确标注由哪个角色执行,并包含显式的同步验证步骤,方便其他工程师或自动化 Playwright 多上下文脚本无歧义地跟随。

主要能力

  • 角色访谈:在探索代码库之前先向用户收集角色信息,包括应用中有哪些角色、每个角色用于测试的数量、测试账号是预置还是通过注册流程创建、各角色的凭据环境变量命名、是否存在注册流程及邮箱验证/审批要求、是否存在邀请或团队管理流程。答案会整理为角色注册表(Persona Registry),驱动后续所有阶段。
  • 三种手段协同:角色访谈 + 静态代码库分析 + 必需的实时交互式走查。静态分析通过并行的 Explore 智能体完成;走查通过 Playwright CLI 命令(经 Bash 执行)以每个角色的命名会话进行,在运行中的应用内导航、逐步截图,并将截图呈现给用户以确认、决定同步时序和边界情况。
  • 任务列表驱动:任务列表是执行模型的骨干,承担五项作用——并行智能体追踪、进度可见性、会话恢复、迭代追踪、审计留痕。

使用方式

技能按阶段执行:

  1. 评估当前状态:检查项目根目录下 /workflows/multi-user-workflows.md 等文件是否存在,读取并汇总已有内容;通过提问确定用户意图(Create 从零生成、Update 新增并刷新、Refactor 重构、Audit 审计缺口);创建主任务。若不存在已有文件则跳过提问直接进入 Create 模式。
  2. 角色访谈(必需):在探索代码库前收集角色信息,因为角色列表决定 Explore 智能体需要调查哪些认证流程、角色门控和跨用户功能。若回答含糊则进行针对性追问。完成后更新任务状态与元数据(角色数量、测试账号总数、配置策略、角色列表、凭据命名约定、是否存在邀请流程与注册流程)。
  3. 探索应用(委托给智能体):基于角色注册表并行启动三个 Explore 智能体,每个使用 Read、Grep、Glob 分析代码库,本阶段不使用浏览器自动化工具,属纯静态分析。
    • 智能体一:认证与角色,查找所有认证机制(登录、注册、会话管理、登出与会话失效)、角色与权限定义、授权强制(中间件、路由守卫、数据库行级安全策略、API 端点授权检查)、角色专属路由与视图、多会话处理,并产出一张角色—路由矩阵。
    • 智能体二:多用户功能,查找共享资源、邀请与团队管理流程、跨用户可见性、协作编辑、所有权与权限转移、跨用户通知,涵盖 share/team/invite/presence/comment/version/transfer/notify 等关键词。
    • 智能体三:实时同步(资料中该智能体的提示词未展开,暂未提供细节)。
  4. 走查:使用 Playwright CLI 以每个角色的命名会话遍历多用户旅程,逐步截图。
  5. 审批:用户审阅第 1 轮。
  6. 写入:输出 multi-user-workflows.md。

任务树结构为:主任务「Generate: Multi-User Workflows」下依次挂载访谈任务、三个并行 Explore 任务、Walkthrough 任务、Approval 任务与 Write 任务。任务按顺序完成,但 Explore 任务并行运行,访谈任务先于所有 Explore 任务。

会话恢复:每次调用开始时先检查是否存在任务列表。若不存在则从第一阶段开始;若存在,则找到最后一个状态为 completed 的任务,确定对应阶段,告知用户“Resuming from Phase N”,并跳到该阶段的后续阶段。

适用场景

适用于需要为多用户应用生成可执行、可审阅的 QA 工作流文档的团队,尤其是涉及角色权限、共享资源、邀请与团队管理、协作编辑与实时同步的产品。产出可被人工工程师或 Playwright 多上下文脚本直接跟随。

限制

  • 静态探索阶段不使用任何浏览器自动化工具。
  • 走查阶段依赖 Playwright CLI 与正在运行的应用,并使用按角色命名的会话。
  • 角色信息必须在代码探索前由用户提供,否则无法确定探索范围。
  • 关于收费、价格、平台支持范围、性能效果等资料中未提供,暂未提供。