ux-walkthrough

用途：对产品做系统性体验走查，输出结构化 Markdown 报告、report.json 与本地 .docx；以资深 B 端体验设计专家视角给可执行建议，而非主观吐槽。\n\n主要能力：按输入自动判定模式——本地项目目录走 code、http(s) URL 走 url、图片走 screenshot。走查依据 references/ux-checklist.md，HiUI 典型页参照 references/hiui-template-baseline.md 做 Delta 走查，辅助 Nielsen、WCAG 与品牌规范，冲突时以效率、理解成本、错误恢复、专业感为准；优先级按 references/severity-rubric.md 定 P0/P1/P2。\n\n使用方式：流程分三阶段。A 前置检查执行 python3 <SKILL_ROOT>/scripts/precheck_walkthrough.py <输入> --json，读取 next_action、mode、status、gate；code 模式还看 runtime_probe，可能改为先访问可达 URL 或启动 dev server 后再走 URL。B 走查与报告按 walkthrough-worksheet 的 Batch 1→4 顺序逐条对照 checklist，逐批填写工作表，再用 ignore-list 去误报并定级，输出完整 Markdown 报告；URL/截图模式须有标注图与 images[].bbox。C 生成 docx：先跑 validate_checklist_coverage.py 与 validate_report_annotations.py 校验覆盖与标注门禁，再执行 python3 <SKILL_ROOT>/scripts/generate_docx.py --report-json <report.json> --output <SKILL_ROOT>/output/<项目名>-ux-report-<YYYYMMDD>.docx --json。\n\n适用场景：代码库、线上页面或截图的体验评审，尤其是 HiUI 典型页型的合规走查。限制：生成 .docx 依赖 Python 包 python-docx，缺失时只能报告 docx_generation 失败；本 skill 不定义 usage stats、telemetry closeout、网络补传或授权重试 after-hook；证据不足须标「待确认／待交互验证」，不得硬写完整报告；正式完成需完整报告、report.json、标注校验与本地 docx 均具备，其余信息暂未提供。