用途:为已有 Web 项目做移动端适配,把桌面优先的页面改成手机上可用的界面。
主要能力:扫描项目中的移动端问题,包括 viewport meta 是否存在及 viewport-fit=cover、CSS 溢出风险(固定宽度、min-width)、100vh 用法(建议改为 100dvh)、fixed/sticky 元素的 safe-area-inset、小于 44px 的触摸目标、响应式断点覆盖、Tailwind 相关问题(h-screen 改 h-dvh)、文本溢出未处理等。
使用方式:先定位 SKILL_DIR,然后运行扫描脚本: python3 "$SKILL_DIR/scripts/scan_mobile_issues.py" <project-path> 需要 JSON 输出时加 --format json。项目路径为必填参数。扫描后需用 AskUserQuestion 确认修复范围,再按优先级修复:viewport meta、全局 overflow-x: hidden、100vh 改 100dvh、固定元素加 env(safe-area-inset-*)、图片媒体 max-width、文本省略、增大触摸目标、移动优先断点;如需要可把侧边栏/标签导航改成带返回按钮的全屏页面栈,桌面布局在 md 断点以上保持不变。完成后重新扫描并在 375px 宽度验证无横向滚动、内容不被刘海遮挡、可点击区域不小于 44px、返回按钮可用、全高布局不溢出。
限制:资料未提供安装命令、收费、价格、平台要求或效果保证,均暂未提供;修复结果取决于具体项目结构。