WCAG 无障碍审计规划

技能文档

---
name: masup9-planning-wcag-audit
title: WCAG 无障碍审计规划
description: 基于 WAIC 测试指南的 WCAG 无障碍审计规划工具。确定审计范围、选择测试方法、完成页面抽样并生成审计计划文档。当用户需要规划无障碍审计、WCAG 达成度检测、网站无障碍评估、抽样选择测试页面、编写无障碍测试计划时触发。
category: 开发工具
---

# WCAG 无障碍审计规划

以无障碍审计规划者的角色，基于 WAIC 测试指南梳理审计范围、页面抽样与测试环境，产出一份可执行的审计计划文档。

## 技能工作流

### 步骤1：收集站点信息

用简短直接的问题确认审计目标概况：

```
为制定审计计划，请提供：
1. 页面数量（约数）
2. 站点结构与主要页面类型
3. 目标达成等级（A / AA）
4. 审计目的（达标声明 / 部分达标 / 改进）
```

页面数未知时，请用户提供 sitemap、CMS 页面清单或访问统计中的主要页面。

### 步骤2：选择测试方法

从以下基于 WAIC 指南的方法中选择：

- 全页面测试
- 随机抽样
- 代表性页面
- 组合方法（推荐）

详见 [references/page-selection-guide.md](references/page-selection-guide.md)。

### 步骤3：确定目标页面

按 [references/page-selection-guide.md](references/page-selection-guide.md) 的步骤执行 URL 收集与抽样：

1. 通过 sitemap.xml 或浏览器自动化爬取收集 URL
2. 按用户指定的排除模式过滤
3. 识别代表性页面
4. 随机抽样（排除代表性页面避免重复）
5. 去重合并
6. 最终确认

**样本量基准（约 40 页，代表性页面占多数）**

| 排除后站点规模 | 目标页数 |
|---------------|---------|
| 约 40 页 | 全部页面 |
| 40 页以上 | 约 40 页（20–25 代表 + 15–20 随机） |
| 200 页以上 | 40–55 页（25–30 代表 + 15–25 随机） |

### 步骤4：确认测试环境

明确环境信息以保证可复现性：

```
请确认测试环境：
- 浏览器（如 Chrome / Firefox / Safari / Edge）
- 设备范围（桌面 / iOS / Android）
- 辅助技术（AT，可选）
- 工具（自动检查器、对比度检查工具等，可选）
```

### 步骤5：生成审计计划文档

使用 [references/audit-plan-template.md](references/audit-plan-template.md) 模板生成计划并保存为 Markdown。

- 包含审计概要、测试方法、目标页面清单
- 记录测试环境、工具、日程与角色分工
- 页面清单用表格呈现

生成前与用户确认输出路径（如 `./docs/wcag-audit-plan.md`）。

## 注意事项

- 未知信息标注「待定」，并明确向用户追补
- 代表性页面优先覆盖关键用户流程
- 随机抽样必须记录可复现的种子值与抽取步骤

使用说明

# WCAG 无障碍审计规划

基于 WAIC 测试指南规划 WCAG 无障碍审计：确定范围、选择测试方法、完成页面抽样，生成审计计划文档。

## 能做什么

- 收集站点信息，明确目标达成等级（A/AA）与审计目的
- 提供四种测试方法：全页面 / 随机抽样 / 代表性页面 / 组合方法
- 完整页面抽样流程：URL 收集 → 排除 → 代表页识别 → 带种子随机抽样 → 去重合并
- 按 40 页基准给出样本量建议（代表页占多数）
- 生成含测试环境、日程、角色分工的审计计划 Markdown 文档

## 何时使用

- 规划网站/Web 应用/组件库的无障碍审计
- 需要确定 WCAG 测试范围与抽样方案
- 编写可复现、可执行的审计计划文档

## 快速上手

```text
帮我规划这个站点的 WCAG AA 审计：https://example.com
```

按引导提供页面数量、站点结构、目标等级与审计目的，即可获得审计计划文档。

## 目录结构

- `SKILL.md`：审计规划工作流
- `references/page-selection-guide.md`：页面抽样指南
- `references/audit-plan-template.md`：审计计划模板

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。