跳转到使用指南
web-design-reviewer作者 GitHub

Web Design Reviewer Skill.

一个用于设计审查的 Claude Code 和 Codex skill:对运行中的网站进行视觉检查,定位并修复布局问题。

  • Design Review & Accessibility
  • 审查报告
github/awesome-copilot · skills/web-design-reviewer/SKILL.mdSKILL.md
--- name: web-design-reviewer description: This skill enables visual inspection of websites running locally or remotely to identify and fix design issues. Triggers on requests like "review website design", "check the UI", "fix the layout", "find design problems". Detects issues with responsive design, accessibility, visual consistency, and layout breakage, then performs fixes at the source code level. --- ## Scope of Application ## Prerequisites ## Step 1: Information Gathering Phase ## Step 2: Visual Inspection Phase ## Step 3: Issue Fixing Phase ## Step 4: Re-verification Phase
从 2026-09-14 上游文件中读取的前言和章节标题 · 完整长度 10,577 字符

01 功能说明

web-design-reviewer Skill 在 Claude Code 和 Codex 中的作用

摘要、工作流与产物,均读自该 skill 的 SKILL.md。

来自 SKILL.md读取于 2026-09-14 · 非实际运行记录

以 skill 自身的术语

Web Design Reviewer 通过浏览器自动化工具驱动运行中的网站,对其进行视觉检查,并在源代码中修复发现的问题。它覆盖静态网站、基于 React、Vue、Angular 或 Svelte 的 SPA、Next.js 和 Nuxt 等全栈框架、WordPress 和 Drupal 等 CMS 平台,以及其他任何 Web 应用。

该工作流分为四个阶段:收集上下文并自动检测框架与样式方案,依照视觉检查清单检查页面,按 P1 到 P3 的优先级修复问题,然后重新验证并循环。发现的问题按布局、响应式、可访问性和视觉一致性分组,每项均标有严重程度。修复遵循最小改动原则,并以一份 markdown 审查报告结束。

它产出什么

  • 一份题为 Web Design Review Results 的 markdown 审查结果报告。
  • 一张汇总表,涵盖目标 URL、检测到的框架、样式方案、测试的视口、检测到的问题和已修复的问题。
  • 逐项问题记录,包含优先级、页面、元素、描述、修复文件路径、修复详情以及修复前后截图。
  • 未修复问题部分,说明每个问题未处理的原因,并给出用户建议采取的行动,此外还包含总体建议。
查看示例提示词 ↗

工作方式

  1. 01
    收集上下文并检测技术栈

    如果未提供 URL,它会询问 URL,然后尝试从 package.json、tsconfig.json、tailwind.config、next.config、vite.config 和 nuxt.config 等工作区文件中自动检测,并询问哪些页面属于此次检查范围。

  2. 02
    导航并抓取

    它打开目标 URL,拍摄截图,尽可能获取 DOM 结构或快照,并通过网站导航遍历更多页面。

  3. 03
    依照视觉检查清单进行检查

    通过参考检查清单逐项排查布局、响应式、无障碍和视觉一致性问题,修复后再次使用该清单进行复核。

  4. 04
    定位每个问题的来源

    通过在代码库中搜索类名或 ID、根据元素文本或结构查找对应组件,并按样式、组件和页面文件的模式进行过滤,将问题元素追溯到源头。

  5. 05
    修复,然后重新验证

    依据框架特定的指导应用修复,然后重新加载浏览器或等待开发服务器的 HMR 生效,对修复区域重新截图,并对比修复前后的效果。

02 找到适合场景

何时使用 web-design-reviewer Skill

当任务是此类设计审查时,在 Claude Code 或 Codex 中使用 web-design-reviewer skill。以下适用范围和限制取自该 skill 的文件。

适合场景

  • 审查使用纯 HTML、CSS 和 JS 构建的静态网站。
  • 审查基于 React、Vue、Angular 或 Svelte 的单页应用。
  • 审查全栈框架应用,例如 Next.js、Nuxt 或 SvelteKit。
  • 审查由 CMS 驱动的网站,例如 WordPress 或 Drupal 站点。
  • 在开发过程中检查运行于类似 http://localhost:3000 的本地开发服务器。

了解边界

  • 生产环境仅支持只读审查,因此无法在其中应用更改。
  • 修复要求项目源代码存在于工作区中,因此没有本地代码的远程站点无法修复。
  • 未经用户确认的大规模重构被明确列为不应做的事。
  • 忽视性能的修复被列为反模式。

需要提供的信息

  • 待审查网站的 URL导航时需要提供该地址;若用户未提供,skill 会主动询问,并以 http://localhost:3000 作为示例格式。
  • 框架与样式位置skill 会询问使用的框架和样式方案,以及样式文件和组件所在的位置,以便找到正确的编辑目标。
  • 审查范围用户需说明本次审查仅涉及特定页面,还是整个网站。

03 Skill 内部

web-design-reviewer Skill 为 Claude Code 和 Codex 设定的规则

SKILL.md 为 Agent 设定的 8 条具体指令、默认值与限制——文件中真正改变结果的部分。

  1. 三次尝试后停止

    该 skill 设定了迭代上限:若某个具体问题的修复尝试超过 3 次仍未解决,必须咨询用户而不是继续尝试。

  2. 一次只处理一个问题

    每个问题都单独修复并验证后才继续下一个,而不是批量修改。

  3. 修改代码前先截图

    必须始终在修复前保存故障状态的截图,以便对比修复前后的效果。

  4. 仅做最小改动

    修复原则是只做解决问题所必需的最小改动,尊重现有代码风格,并避免破坏其他地方的功能。

  5. 按优先级矩阵处理

    影响功能的布局问题为 P1,立即修复;降低体验的视觉问题为 P2,其次修复;细微的视觉不一致为 P3,视情况修复。

  6. 测试四种视口

    响应式检查在 375px(Mobile,iPhone SE/12 mini)、768px(Tablet,iPad)、1280px(Desktop)和 1920px(Wide)下进行。

  7. 遵循现有模式

    修复必须遵循项目中已使用的现有代码风格,而不是引入新的约定。

  8. 重大改动前先确认

    不会单方面进行大规模重构:在做重大改动前会请用户确认,也不会一次性修复多个问题,因为那样难以验证。

04 投入使用

在 Claude Code 或 Codex 中安装 web-design-reviewer

一条 npx skills add 命令,然后在你的 Agent 中执行第一个任务和对结果的清单检查。

将 web-design-reviewer 添加到 Claude Code、Codex 或你的 Agent

在你的项目中运行;安装程序会询问要把它添加到哪个 Agent。

Terminal
npx skills add https://github.com/github/awesome-copilot --skill web-design-reviewer

针对 skills/web-design-reviewer/SKILL.md 的通用 skills CLI 形式;该仓库可能会记录自己的路径。

为 Skill 提供第一个设计审查任务

按 skill 自身的术语撰写;把括号中的部分换成你的内容。

Starter prompt
Review the design of the website running at http://localhost:3000. It is a [Next.js] app styled with [Tailwind CSS], please check the [home and pricing] pages at mobile and desktop widths. Find the layout, responsive and accessibility problems like element overflow, weak contrast or tiny touch targets, then fix them in the source and verify the fixes.

来源:依据 SKILL.md,按 skill 自身的术语撰写。

检查首次结果

SKILL.md 本身如何描述正确的结果:

  • 重新加载浏览器或等待开发服务器 HMR 完成,然后对已修复区域截图。
  • 对每个已修复元素比较修复前后的截图。
  • 运行回归测试,确认修复没有影响其他区域。
  • 确认改动后响应式显示仍然完好。
  • 通过 Playwright 参考配置中的 browser_console_messages 工具,读取浏览器控制台消息以捕获 JavaScript 错误。

在 OpenDesign 中通过其 SKILL.md 链接导入 web-design-reviewer:Plugins → Add → Skill → Import from link,然后在顶部栏中选择它。

05 开源、可追溯

来源、许可与验证

本页面事实的来源,以及最后检查时间。

Author
GitHub
Repository
github.com/github/awesome-copilot 分支 main
Skill 文件
skills/web-design-reviewer/SKILL.md 验证时记录的内容校验和;commit 1899b18
License
MIT 来自 LICENSE。
仓库星标数
38,981 GitHub 快照取自 2026-09-14,针对包含此目录中 6 个 skill 的整个 github/awesome-copilot 仓库。不代表 web-design-reviewer 的评分或使用量。
已由 OpenDesign 验证
2026-09-14 已检查源文件、路径、许可文本和 star 数量。未内置在 OpenDesign 主程序(检查日期 2026-08-28);本页面未记录实际运行。

SKILL.md 内部

  1. 适用范围列出其覆盖的静态网站、SPA 与全栈框架、CMS 平台及其他 Web 应用。
  2. 前置条件一个正在运行的目标站点、具备截图与 DOM 访问能力的浏览器自动化,以及可用于修复的源代码。
  3. 步骤一:信息收集阶段确认 URL,询问框架、样式方案与范围,自动检测配置文件与样式方法。
  4. 步骤二:视觉检查阶段遍历页面并截图,在四种视口下检查布局、响应式、无障碍及一致性问题。
  5. 步骤三:问题修复阶段按 P1 到 P3 排定优先级,通过选择器、组件或模式定位源文件,应用针对具体框架的最小化修复。
  6. 步骤四:复核阶段重新加载并重新截图,对比修复前后,进行回归测试,若仍有问题则循环处理。
  7. 输出格式定义 Markdown 审查报告模板,包含汇总表、问题列表、未修复项与建议。
  8. 必备能力以表格列出页面导航、截图、图像分析、DOM 获取、文件读写与代码搜索。
  9. 参考实现将各项能力映射到 Playwright MCP 工具,提供 MCP 服务器配置,并列出其他兼容工具。
  10. 最佳实践该做和不该做的事项清单:保存截图、逐一修复、未经确认不进行大规模重构。
  11. 故障排查涵盖样式文件找不到、修复未生效、以及修复影响到其他区域等情况。
Skill 自身的描述
"此 skill 可对本地或远程运行的网站进行视觉检查,识别并修复设计问题。触发条件包括「审查网站设计」、「检查 UI」、「修复布局」、「查找设计问题」等请求。可检测响应式设计、无障碍性、视觉一致性和布局错误等问题,然后在源代码层面执行修复。"

来自 SKILL.md 的 front-matter 描述。完整文件约 10,577 个字符。在 GitHub 上阅读完整文件。

06 安装之前

关于 web-design-reviewer Skill 的常见问题

以下回答来自 2026-09-14 读取到的 SKILL.md,而非某次实际运行的记录。

开始之前网站必须处于运行状态吗?

是的。第一个必要前提是有一个正在运行的目标,无论是本地开发服务器、预发布环境,还是仅用于只读审查的生产环境。

还需要具备截图捕获、页面导航和 DOM 获取能力的浏览器自动化工具,并且要进行修复的话项目必须存在于工作区中。

它会修改我的代码,还是只报告问题?

它会在源代码层面执行修复,编辑与项目样式方案相匹配的那一层:Tailwind 对应组件中的 className,CSS Modules 对应模块化 CSS 文件,也支持普通 CSS 或 SCSS 文件,以及 styled-components 和 Emotion 对应的 JS/TS 文件。如果无法修复某个问题,报告中会列出原因和建议的处理方式。

它需要哪种浏览器自动化工具?

推荐使用 Playwright MCP 作为参考实现,它提供导航、快照、截图、点击、调整大小和控制台消息等工具。只要具备导航、截图和 DOM 获取功能,该工作流也可以配合 Selenium、Puppeteer、Cypress 或 WebDriver BiDi 使用。

Web Design Reviewer

在真实设计审查任务上运行 web-design-reviewer。

下载 OpenDesign,从其 SKILL.md 链接导入 web-design-reviewer,粘贴上面的提示词,并在查看结果之前先阅读计划。

终端
npx skills add https://github.com/github/awesome-copilot --skill web-design-reviewer

OpenDesign 桌面客户端

一套设计系统,让每一次创作都保持品牌一致

在完整的 Vibe Design Workspace 中,用同一套品牌规则生成网页、PPT、可交互原型、数据看板、图像与 HTML 视频。连接本地 Codex、Claude Code、Cursor 等编程助手,即可免费创作。

  • 覆盖网页、PPT、原型、数据看板、图像与视频
  • 140+ 设计系统,以及完整模板与技能库
  • 连接本地 Codex 与 21+ 款编程助手 · 免费使用
免费下载

支持 macOS 与 Windows