UX Walker 用于把 UX 故事目录放进真实浏览器逐条走查，检查每条用户旅程的功能正确性、视觉质量与体验表现。
用途与触发：可通过“walk the stories”“test the ux paths”“verify user journeys”“run ux tests”等语触发，命令用法为 /ux-walker [url] [--full] [--focus topic] [--session name]。url 默认从开发服务器或 package.json 自动检测；--full 忽略历史强制重走全部故事；--focus 只走指定主题；--session 复用现有 agent-browser 会话以保留登录状态。
主要能力：执行前检查 URL 响应、确认 docs/ux-paths/catalog.md 存在、创建输出目录并加载运行历史；随后规划走查顺序，未走过的故事优先，已通过且源码未变则跳过，源码变化或已合并修复的失败故事会重新验证。每个故事由 walker 子代理逐步执行快照、读取元素、点击输入、截图并核对预期结果，同时对当前页面做 UX 审查（简洁性、渐进披露、布局质量、视觉正确性、快乐路径清晰度、响应式、排版、交互反馈、错误状态等）。发现项按严重程度与类别记录，交互类问题可录像，静态视觉问题用标注截图。
修复与提交：发现项分为当场快速修复与提交 issue 两类。快速修复要求触及文件不超过 2 个、修复明确、回归风险低、严重程度中等及以下；每个修复在隔离 worktree 中由最多 3 个子代理并行执行，须编译通过并以指定文件提交，单次运行最多 10 个快速修复。严重程度为 critical 或 high、触及 3 个以上文件、需要设计讨论或可能影响其他功能的发现项，则用 gh issue create 提交 GitHub issue 并记录到 issues-filed.md。suggestion 级别只写进报告。
收尾：合并修复分支后重新构建并重走受影响故事，更新 docs/ux-walker/run-history.json，最后生成 latest-report.md，包含运行元数据、发现项汇总、已应用修复、已提交 issue、UX 审查总结、优先建议、仍失败故事与运行统计。
限制：必须已有 UX 故事目录，否则应先运行 /ux-paths；应直接使用 agent-browser 而非 npx agent-browser；合并冲突与构建失败不自动处理，需由用户解决。其他收费、平台或具体效果信息暂未提供。