odyssey-ui

odyssey-ui 是面向 UI 的长期优化循环工作流。用途是按阶段对目标（组件、页面、路由、暂存/HEAD 差异或功能区域）做视觉勘察、多维度审计、发散探索、修复、验证、泛化、发现与记录，目标是持续消除视觉与交互问题。主要能力：六维审计（视觉层级、交互状态、无障碍、响应式、微交互、边界情况），Wave 1 先做设计令牌审计与模式盘点；Wave 2 六维代理并行审计并输出严重级矩阵；Wave 3 由 Polish 与 Delight 两个代理做发散探索；Wave 4 用语法 grep、语义扫描、结构匹配、历史 grep 做泛化扫描。使用方式：先读 base 文件并应用基础不变量，再按状态机 S_SURVEY→S_AUDIT→S_DIVERGE→S_FIX→S_VERIFY→S_GENERALIZE→S_DISCOVER→S_RECORD 推进；会话产物写入 .workflow/scratch/{YYYYMMDD}-ui-odyssey-{slug}/，含 session.json、evidence.ndjson、understanding.md；supported flags 包括 --dimensions、--fix-threshold、--skip-fix、--skip-generalize、--auto、-y、-c、--heartbeat。终止需调用 report_agent_job_result 恰好一次，且不得修改源码外的会话文件。限制：需先提供 target，否则 E001；目标路径不存在 E002；资料未提供具体价格、平台或效果数据。