用途:以任务为中心衡量 UX,统计达成目标需要多少次点击、用户在哪里卡住,并生成可读报告与截图证据。
主要能力:通过 Playwright 执行定义好的流程步骤,支持 expect、fill、click 等动作;记录点击预算(max_clicks)、视口宽度、起始路由;输出任务索引、机器可读的 .flow.json、人类可读的 markdown 报告以及步骤截图。所有产物统一放在 .heyeddi/docs/ 与 .heyeddi/audits/ 下,不写入仓库根目录。
使用方式:先确保 .heyeddi/product.md 定义了用户任务(可选上下文);每个项目运行一次 python scripts/init_ux_flows.py --project-root <root>;在 .heyeddi/docs/ux-flows/<task-id>.flow.json 中定义步骤;启动开发服务器,若地址不是 http://localhost:5173 则设置 DEV_SERVER_URL;运行 python scripts/trace_flow.py --task-id <id> --project-root <root> --check;最后在生成的 markdown 报告中追加 Friction notes。流程 JSON 包含 task_id、goal、start_route、max_clicks、viewport_width 和 steps 数组。
适用场景:回答“更新设置需要几次点击”、发布后易用性检查、对比桌面与移动流程、产品验收中确认任务在点击预算内完成。
限制:需要开发服务器与 Playwright 环境;跨支柱同步需读取 reference/cross-pillar-handoff.md 并调用 @heyeddi 的 load_workflow_context 与 append_pillar_opinion;子代理运行方式见 reference/subagents.md。资料未提供具体安装命令、收费信息或平台支持范围。