用 responsive-qa 按多宽度测试并修复布局

你需要一个要测试的网站或本地网页应用，以及一个代理可以在分支或 git worktree 上工作、而不是直接在主分支上工作的仓库。脚本需要 Node 和 Puppeteer：它们会从本 Skill 复制到临时目录再运行。若缺少 Puppeteer，Skill 会让代理在该临时目录安装，或把 NODE_PATH 指到已有的 node_modules。若要使用本机已安装的 Chrome 而不是 Puppeteer 自带的浏览器，请设置 CHROME_PATH。测试在真实浏览器中进行，而不是只看设备工具栏。截图、qa-reports 目录和书面报告是产出，不是你必须事先准备的材料。公开页面不需要登录；登录后才能访问的页面，除非你安排好访问方式，否则保持不测。

在分支或 git worktree 上工作，不要在主分支上工作。启动项目的开发服务器并记下地址。若用户尚未说明优先页面，先询问。打开真实浏览器，按 Skill 列出的宽度测试：280、320、375、430、560、600、768、820、1024、1440、1920，以及横向手机的 667x375、932x430 和矮窗口的 1280x480。宽度小于 1024 时启用移动和触控标志以及 iPhone 用户代理。检查加载时使用慢速 3G。在浏览器里实测，不要只信任样式表。对每一个问题：说明发现了什么，先拍修复前截图，做一处小修改，自己在浏览器里验证，再拍修复后截图，只提交源文件并用普通句子写提交说明，然后进入下一项。绝不要因为代码看起来正确就宣布修复完成。截图和左右对照页放在 qa-reports/ 下，并且不要把该目录纳入 git。报告用日常语言写访问者看到的现象。若被要求长时间运行，就继续测试新页面、新宽度、错误状态、打开的下拉菜单以及横向或矮窗口，直到连续多轮都没有新发现。属于设计选择的改动先询问；明确的缺陷直接修。最后用通俗语言写出测了什么、修了什么、发现但未修的问题，以及未测试的部分。可请第二人审阅完整 diff，并在浏览器中核实每条发现。只有在用户要求发布时，才合并主分支、必要时重新构建、再检查主要页面并交付。除非被要求，不要推送。不要运行格式化工具，只改修复所需的内容。

本 Skill 在真实浏览器里测试并修复页面，不能替代完整的设计系统；修复必须在浏览器中核实后才算完成。工作按一次一处小修复进行，在分支或 worktree 上而不是主分支上进行，每一次修复都要有前后截图。除非用户要求，否则不得推送；不得运行格式化工具，只改修复所需的内容。不要创建账户或用真实用户身份登录：登录后才能访问的页面，除非用户安排好访问方式，否则保持不测。属于设计选择的改动先询问。qa-reports 目录（包括截图和书面报告）不纳入 git，是产出而不是前置条件。钉死的 SKILL.md 除上述登录、访问和本地报告边界外，没有关于 API 密钥、遥测或把用户数据送出本机的规则，此处不发明进一步的隐私规则。钉死的 LICENSE 为 MIT，Copyright (c) 2026 mkmaker，须保留声明且无保证；已附上的根目录 README 的 Licence 一节也写 MIT，与 LICENSE 文件一致，不是限制性冲突。主帖未声明许可证。起草时默认分支 HEAD 与 SKILL.md 的准确路径最近提交相同（bca98b00896a6c2195c58cb46693a6da5f513d36，2026-11-13 14:02:58 Asia/Shanghai，说明为 “Add the responsive-qa skill”）。SKILL.md 字节仍与发现快照一致，本稿按该 HEAD 绑定。GitHub 登录名 mkmaker 与发帖 handle themkmaker 不同；已记录公开映射 twitter_username=themkmaker 和 mkmaker 的准确路径参与。仓库所有者是个人用户 mkmaker，不是组织，因此组织成员规则不适用。合格原帖的 entities.urls 含 https://t.co/yf1XI7mYt3（展开为 https://github.com/mkmaker/responsive-qa）以及 https://t.co/XawMuOUnFC（展开为父帖），均按返回结果索引，没有 note_tweet。父帖（2120887574113997219）是同一作者关于用 Fable 5.2 通宵测试并得到 “20 fixes” 的第一人称语境，不是第二条合格卡片，本次获取中其 entities.urls 为空，该作者陈述不视为本 Skill 已核实的最终用户案例。媒体未经目视检查。接口显示 reply_count=1；该回复未获取，也未起草为卡片。例句保持为空。文档中的 Puppeteer、npm 和 shot.cjs 命令本次均未执行。本地历史检索未发现本仓库的既有社群草稿，因此未套用 prior-community-post-same-repo-different-skill，也未发明 named-subskill-in-multi-skill-repo；当前官方 SKILL.md 与模板文本并未正式定义这些字符串。