设计创作 33.3k 仓库 Star
Web Design Guidelines
检查页面是否清楚、好用
Web Design Guidelines 是 Vercel 的界面源码审查流程,读取当前规范后检查指定文件,按文件和行号列出问题。它关注按钮、表单、键盘操作、焦点和内容溢出等细节,适合在页面实现后补一轮有依据的规范检查。
你需要准备:需要检查的页面源码或文件范围,以及目标使用场景
一桉AI 整理 · 更新 · 查看 GitHub 来源
粘贴到 Codex,它会先检查安装条件,再引导你使用。
Web Design Guidelines 能帮你做什么?
读取当前规则
从上游获取最新界面规范,说明无法联网或未核到的部分,不把过期记忆当本轮结果。
逐项检查代码
围绕可访问性、表单、交互、主题和内容处理查找具体实现问题。
定位并归纳发现
按文件与行号给出简短问题和必要修正方向,便于开发者逐项验证。
什么时候适合用?
下面是用法示例,可换成你的材料和目标。
检查登录表单
示例场景:查看标签、输入类型、错误反馈、粘贴和键盘焦点,定位源码中的具体问题。
审核目录与列表页
示例场景:检查长标题、筛选状态、图片尺寸和大量条目处理,整理需要进一步验证的位置。
怎么开始使用?
指定页面与源码
准备这些材料网页界面规范检查
需要检查的页面源码或文件范围,以及目标使用场景
界面规范审查流程
- 01
获取规范并读取页面
- 02
检查界面和交互规则
- 03
定位问题并给出建议
准备什么,会得到什么?
- 准备的材料
- 需要检查的页面源码或文件范围,以及目标使用场景
- 交付的结果
- 带文件位置和依据的界面问题清单。
- 需要修改或浏览器复核的具体条目。
使用前要知道
需要源码和联网读取规则,不能代替真实键盘、触屏和浏览器验收。检查发现仍要结合项目验证,本站未运行审查实测。
常见问题
给截图可以完成这一项检查吗?
核心流程检查源码并输出行号,截图只能辅助理解外观,无法确认标签、键盘行为和实际元素语义。
它会自动修改所有问题吗?
本项主要交付审查发现。实施修改应按项目约束进行,再用适合的代码和浏览器检查验证。
GitHub 与官方参考
依据项目说明与参考文档整理。页面中的任务与流程示例用于说明用法。
- Web Design Guidelines · Skill 源文件 ↗2026-10-31 核对
- Vercel · 当前 Web Interface Guidelines ↗2026-10-31 核对
来源与使用条件
- 原始项目
- vercel-labs/agent-skills ↗
- Skill 名称
web-design-guidelines- Skill 目录
skills/web-design-guidelines- 仓库 Star
- 33,285 · 2026-10-31 核对,仅代表仓库关注度。
- 许可说明
- MIT(上游 README 声明)
- 使用条件
- 需要项目源码和联网读取 Vercel 界面规范。上游以 WebFetch 获取最新规则,在 Codex 中需映射到当前可用的联网工具。
- 注意事项
- Vercel 安装器支持 Codex。此项是源码规范审查,不能代替真实浏览器验收;规则从网络动态读取,离线时需说明未核部分,本站未运行实测。
查看安装与使用提示词
请帮我准备并使用 Web Design Guidelines Skill,完成下面的任务。请实际执行当前环境允许的安装与检查,不要只返回一份安装教程。 【来源与目标】 原始仓库:https://github.com/vercel-labs/agent-skills 所选目录:skills/web-design-guidelines 参考分支:main 原始目录 frontmatter name:web-design-guidelines 安装后的目标调用名:web-design-guidelines 来源页面:https://github.com/vercel-labs/agent-skills/tree/main/skills/web-design-guidelines 安装路线核对日期:2026-11-01 当前 SKILL.md(已重新核对名称与资源引用):https://github.com/vercel-labs/agent-skills/blob/main/skills/web-design-guidelines/SKILL.md 上游安装说明:https://github.com/vercel-labs/agent-skills/blob/main/README.md Codex 官方 Skill 目录与自动发现规则:https://learn.chatgpt.com/docs/build-skills 每次评审需读取的当前官方规则:https://raw.githubusercontent.com/vercel-labs/web-interface-guidelines/main/command.md 【先检查环境,再安装】 先识别操作系统、当前 shell、工作目录、同名 Skill 和已有工具;命令须适配实际平台并正确处理带空格的路径。默认安装到当前项目的 .agents/skills;如果没有可用项目目录,再使用用户目录的 .agents/skills。遵循当前 Codex 实际支持的位置;上游 CLI 或插件有专用目录时使用其正式方案。检查现有安装来源与完整性,能复用就复用,不重复注册相同来源、不覆盖用户修改。系统内置与所选第三方来源同名时保留系统版,明确区分来源和实际目录,不能只凭名称认定装过或选对了。 下文 ~/.agents/skills 是用户级路径示例;已选项目范围时,使用项目的 .agents/skills 并保持相同子目录层级。<SKILL_DIR>、<项目根目录> 等占位符须先换成核对过的真实路径再执行。依赖仓库的存放目录与 Codex 发现入口分别处理,不把缓存目录当作已注册入口。 这是完整目录安装路线。优先使用当前 Codex 自带的 $skill-installer,明确传入仓库 vercel-labs/agent-skills、目录 skills/web-design-guidelines、分支 main、安装名 web-design-guidelines,并把 --dest 设为已解析的目标 .agents/skills 绝对路径。目录为“.”时表示仓库根目录,仍要传入安装名。不要猜测安装器在本机的固定路径。如果没有内置安装器,按下列项目说明从原仓库获取完整目录,保留全部配套文件。 所选 Skill 的具体安装步骤: 1. 先解析当前项目根目录,以该项目的 .agents/skills 为本次目标;查找已有 web-design-guidelines,已有本地修改时保留,避免覆盖或在用户目录重复安装。 2. 使用 Codex 自带 skill-installer 的 install-skill-from-github.py;参数明确为 --repo vercel-labs/agent-skills --path skills/web-design-guidelines --ref main --name web-design-guidelines --dest <project>/.agents/skills;<project> 要先解析为当前项目绝对路径。完整保留所选目录,不只下载 SKILL.md。 3. 这个 Skill 只包含指导文件,没有内置浏览器或框架。确认 Codex 能用当前网页读取工具获取官方 command.md;源码写的 WebFetch 应映射真实工具,不安装一个假定同名服务。 4. 确认目标目录 web-design-guidelines/SKILL.md 的 frontmatter name 为 web-design-guidelines,并按 resources 保留引用资源和许可文件。 5. Codex 会自动发现项目 .agents/skills;在当前项目查看 Skill 列表。只有未出现时才新建聊天或重载,不把强制重启写成每次安装步骤。 必须保留的资源: - skills/web-design-guidelines/SKILL.md 已知依赖:需要项目源码和联网读取 Vercel 界面规范。上游以 WebFetch 获取最新规则,在 Codex 中需映射到当前可用的联网工具。 原项目许可:MIT(上游 README 声明) 特别条件:Vercel 安装器支持 Codex。此项是源码规范审查,不能代替真实浏览器验收;规则从网络动态读取,离线时需说明未核部分,本站未运行实测。 需要账号、密钥或服务时先检查现有可用连接;让用户在官方授权或本地配置入口完成,不要求把密钥粘贴到聊天。缺少付费服务或不支持的客户端能力时,明确剩余条件与可完成的范围。 【安装后验收】 读取实际安装位置的 SKILL.md,核对真实 name,并检查它引用的脚本、模板、共享文件与工具是否存在。若上游已迁移路径或更名,先核对正式说明再调整;找不到则报告实际错误,不猜路径或宣称成功。 1. 只读确认能获取官方规则 https://raw.githubusercontent.com/vercel-labs/web-interface-guidelines/main/command.md,并确认要审查的本地文件范围;不修改页面作安装验证。 2. 只读检查已安装 SKILL.md 的 name、所列引用文件与目录存在,元数据调用名使用 web-design-guidelines。 Codex 通常自动发现变更;只有未出现时才引导新建聊天或重载。若本轮尚未出现在可用列表,可在允许的范围内读取已安装的完整文件继续准备任务,同时说明自动识别尚待确认。插件依赖的工具未连接时,不能用读取文件代替连接成功。 分别报告“文件已安装”“Codex 已识别”“任务所需能力已就绪”的实际状态和证据;失败时给出卡住的步骤、错误与下一步,不反复执行相同的失败命令。 【接着引导我使用】 请使用实际可用的 $web-design-guidelines;若实际名称发生变化,以刚核对的本地 name 为准。存在不同来源同名项时,明确选择所选来源与实际文件路径,避免调用成系统版或另一版本。对于必须由用户显式调用的 Skill,直接给我下一条可复制的调用语句。 - 首次明确文件或匹配范围,先获取最新规则,再读真实源码并按 file:line 给出问题;没有代码时不能编造行号。 - 源码审查与浏览器视觉验证是两回事;只有实际运行了对应检查才能报告通过,Skill 本身不提供浏览器。 我想完成的任务: 按 Vercel 当前界面规范检查我指定的页面源码,重点查看键盘可用性、焦点、表单、动画、图片、排版和移动端交互。用文件位置说明具体问题、原因和建议;区分源码可判断的问题与仍需浏览器验证的项目。 需要我提供的材料: 需要检查的页面源码或文件范围,以及目标使用场景 期望得到: 一份带文件位置的界面问题清单,以及建议修改和待验证项。 先查看我在当前聊天中已经提供的目标与材料,只问缺少的关键内容;没有材料时,告诉我第一步提供什么,可给一个简短示例。条件满足后从一个小任务开始,检查输出,再说明怎样继续使用。示例仅用于演示,不充当我的真实数据;没有执行过的步骤、测试或交付物不要写成已经完成。需要发送、发布或修改外部账号内容时,先让我核对具体对象和内容。