用途:ux-collab-setup 是 ux-collab 的安装与依赖诊断技能,用于首次配置、排查失败或 check 脚本报错时,一站式检查和修复缺失依赖。
主要能力:先运行检查脚本,逐行读取 ✔(通过)、⚠(可选警告)、✘(必须修复)的输出;再运行安装脚本自动处理可自动化部分:检测并安装 agent-browser、安装 ImageMagick、为 optimize-screenshot.sh 添加可执行权限、在技能目录存在时复制该脚本到 ~/.agents/skills/ux-collab/、在当前目录创建起始 .ux-collab.md、可选生成 agent-browser.json,结束后重跑检查确认。
必要用法:在克隆的仓库/包目录中执行 npm run check(或 pnpm run check,或 bash scripts/check.sh);随后执行 npm run setup(或 bash scripts/setup.sh)。agent-browser 为主浏览器工具:brew install agent-browser 后执行 agent-browser install(仅首次下载 Chrome for Testing),或用 npm install -g agent-browser,并以 agent-browser --version 等命令验证。Playwright MCP 与 Lucid MCP 均为可选:Lucid 缺失时技能会自动回退到 Markdown 线框图,不构成阻塞;Playwright 安装后可重启会话,Claude Code 用 claude plugin install playwright@claude-plugins-official。若 MCP 卡住或出现 pnpm 路径错误,可用 npx @kylebrodeur/mcp-wsl-setup(WSL)或 npx @kylebrodeur/mcp-mac-setup(macOS)修复。手动配置 MCP 时可创建 .mcp.json;项目配置缺失时可由 .ux-collab.md.example 复制并编辑 defaultUrl、lucidShareEmail、品牌 token、目标文件与界面。
适用场景:需要终端或 CI 环境中的快速截图与审查、受限上下文下的 token 效率(约 200-400 对 3000-5000)、无头本地开发,或需要完整可访问性语义与复杂多页交互时。
限制:Lucid 与 Playwright MCP 属可选依赖,缺失不阻塞;自动安装依赖 brew(macOS)或 apt(Ubuntu/Debian);要求较新的 npm/pnpm 与可用的 agent 会话。价格为暂未提供;其他收费与平台细节暂未提供。