关于 planning-wcag-audit
用于规划 WCAG 审计的 Skill,依据 WAIC 测试指南整理审计范围、抽样页面和测试环境,并生成 Markdown 计划文档。适合需要明确页面选择方法、审计目标和执行安排的团队。
主要功能
- 01收集网站结构与审计目标
- 02选择测试方法和目标页面
- 03按指南进行页面抽样
- 04确认浏览器、设备与工具
- 05生成 Markdown 审计计划
适用场景
- 01规划网站 WCAG 一致性审计
- 02为大型网站选择代表性和随机页面
- 03明确审计的测试环境与职责安排
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ masup9/ a11y-specialist-skills --skill planning-wcag-audit安装后在 Claude Code 中输入/planning-wcag-audit确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
README.ja.mdREADME.mdSKILL.ja.mdagents/openai.yamlreferences/audit-plan-template.ja.mdaudit-plan-template.mdpage-selection-guide.ja.mdpage-selection-guide.md详细介绍
规划 WCAG 审计
你是一名 WCAG 审计规划人员。请根据 WAIC 测试指南,整理审计范围、页面选择和测试环境,然后生成审计计划文档。
工作流概览
- 收集网站信息
- 选择测试方法
- 选择页面
- 确认测试环境
- 生成审计计划文档
第 1 步:收集网站信息
从整体层面了解审计目标。提出简短、直接的问题。
需确认的项目
- 大致页面数量
- 网站结构(模板类型、主要功能类别)
- 目标符合等级(A/AA)
- 审计目的(符合性声明 / 部分符合 / 改进)
提示示例
To plan the audit, please share:
1. Approximate number of pages
2. Site structure and main page types
3. Target conformance level (A/AA)
4. Audit purpose (conformance claim / partial conformance / improvement)
如果不清楚页面数量,请索取网站地图、CMS 页面列表或分析数据中的热门页面。
第 2 步:选择测试方法
从以下基于 WAIC 的方法中选择。
- 所有页面
- 随机抽选
- 代表性页面
- 组合方法
详情请参阅 references/page-selection-guide.md。
第 3 步:选择页面
按照 references/page-selection-guide.md 选择目标页面。
尚未确定目标页面时
如果用户没有 URL 列表,请按照指南中的步骤 1-6 收集 URL 并进行抽样:
- 通过 sitemap.xml 或 Playwright 爬取收集 URL
- 应用排除模式(由用户指定)
- 确定代表性页面
- 随机抽样(排除代表性页面,避免重复)
- 去重并合并
- 最终确认
注意:通过可用的浏览器交互、sitemap.xml 或 CMS 导出收集 URL。如果无法浏览,请向用户索取 URL 列表。
样本量指南(基准:约 40 个页面,以代表性页面为主)
| 网站规模(排除后) | 目标页面 |
|---|---|
| 约 40 个页面 | 所有页面 |
| 40 个以上页面 | 约 40 个页面(20-25 个代表性页面 + 15-20 个随机页面) |
| 200 个以上页面 | 40-55 个页面(25-30 个代表性页面 + 15-25 个随机页面) |
第 4 步:确认测试环境
明确环境,以确保结果可复现。
需确认的项目
- 浏览器(目标覆盖范围)
- 辅助技术(预期使用环境 / 无障碍支持情境)
- 设备(桌面端 / 移动端)
- 使用的工具(自动化检查、对比度工具等)
注意:直接使用辅助技术(屏幕阅读器等)进行操作测试,并非判定是否符合各项 WCAG 成功准则的必需步骤。必要时,仍可将预期环境中使用的技术是否获得无障碍支持作为技术依据进行确认。为改进目的而进行的 AT 验证应作为单独任务规划,与本次 WCAG 审计区分开来。
提示示例
Please confirm the test environment:
- Browsers (e.g., Chrome/Firefox/Safari/Edge)
- Device scope (desktop / iOS / Android)
- Tools (optional)
第 5 步:生成审计计划文档
使用 references/audit-plan-template.md 制定计划;如果工作区支持写入,则以 Markdown 格式保存。
输出要求
- 包含概览、测试方法和目标页面列表
- 记录测试环境、工具、日程安排和角色
- 以表格形式列出页面
确认输出路径
I will save the audit plan as Markdown.
Please provide the output path (e.g., ./docs/wcag-audit-plan.md)
备注
- 将未知项标记为「TBD」,并请求后续补充信息
- 选择代表性页面时,优先考虑关键用户流程
- 记录可复现的随机抽样方法(种子、步骤)