关于 cli-audit
cli-audit 是供 Claude CLI 使用的网页可访问性审计技能，针对在线 URL 调用检查命令并按仓库指南评估结果。它结合 axe 数据与可访问性树信息，并要求保留证据状态。
主要功能
- 01通过 npx 运行页面检查命令
- 02解析 axe 违规与待确认项
- 03检查可访问性树中的交互问题
- 04依据相关技能指南评估发现
- 05按来源、影响和严重度报告问题
- 06记录自动化指标及审查状态
适用场景
- 01检查在线页面的 WCAG 与最佳实践问题
- 02发现交互元素名称或角色不清
- 03评估地标、标题及状态传达问题
- 04为问题整理证据和修复建议
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/cli-audit确认已加载。
附带文件scripts/cli-inspect.mjs
详细介绍
CLI 审计技能
当有人要求通过 Claude CLI 审计一个线上 URL 时，使用此技能。
对于每项线上网站审计请求，都要遵守 robots 指令和网站服务条款。
必需的执行步骤
当用户要求审计某个页面 URL 时，运行：
npx --yes --package=github:mgifford/accessibility-skills cli-audit-inspect <URL>
Claude CLI 用户可以直接使用此调用，因为它会从此仓库包中获取检查命令，无需在目标项目中准备本地 scripts/ 文件。
礼貌地访问线上网站
审计线上 URL 时，请保持尊重并尽量减少影响：
- 优先进行单页或小批量检查。
- 避免快速重复扫描生产页面。
- 如果 Cloudflare/WAF 阻止请求，不要通过暴力重试绕过。
- 建议采用经网站所有者批准的替代方案：暂存 URL、加入允许列表或人工检查。
必需的解析
解析输出的 JSON 并评估：
axe.violations：自动化 WCAG 和最佳实践检查发现的问题。axe.incomplete：需要人工确认的潜在问题。accessibilityTree：自动化规则可能遗漏的行为问题，包括：- 交互元素缺少名称或名称不明确
- 角色异常或角色不匹配
- 地标和标题结构问题
- 状态信息传达不完整（
expanded、checked、selected、禁用状态） - 对话框和菜单语义可能指示存在焦点管理风险
必需的评估方法
报告前，先根据此仓库的指南对发现的问题进行归类：
- 从
skills/ACCESSIBILITY-general/SKILL.md开始。 - 然后根据观察到的问题应用相关主题技能（例如：
forms、keyboard、navigation、color-contrast、aria-live-regions、image-alt-text、tables、svg、touch-pointer、tooltips）。
报告要求
对于报告的每个问题：
- 指明来源：
axe或accessibilityTree。 - 尽可能提供 axe 节点中受影响的选择器/路径。
- 根据相关技能中的评级标准，说明影响并确定严重程度。
- 在可以确定时引用 WCAG 2.2 成功准则，并注明映射来源（axe 规则中记录的映射，或具体的技能规则）；不要根据本次审计的证据臆造 WCAG 映射。
- 提供与技能规则对应的具体修复建议。
- 保留工具的原始结果（
axe.violations与axe.incomplete，或无障碍树中的证据），不要将其合并为单一的通过/失败标签。 - 将本次审计中发现的每项
axe.violations和accessibilityTree问题报告为evidence_status: automated-indicator，并设为handling: review——仅凭本次审计不足以满足将其确认为confirmed-standards-failure、confirmed-user-facing-barrier，或将其设为handling: report/suppress所需的人工确认。请参阅 无障碍问题跟踪：政策分类。
如果未发现问题，请明确说明剩余风险：
- 自动化扫描可能遗漏交互、时序、焦点流转和辅助技术行为方面的问题。
- 建议按照
skills/manual-testing/SKILL.md使用键盘和屏幕阅读器进行人工验证。
评论
支持 Markdown