accesslint-scan - SKILL

name: accesslint-scan
description: “审计实时页面的可访问性问题，精确定位每个 WCAG 违规，并返回基于选择器的修复工作清单，不进行编辑。”
risk: safe
source: “https://github.com/AccessLint/skills”
date_added: “2026-06-02”

审计实时页面并报告什么问题以及在哪里。定位；不修复。如果 $ARGUMENTS 中没有 URL，询问一个。

何时使用

• 当任务与此描述匹配时使用此技能：审计实时页面的可访问性问题，精确定位每个 WCAG 违规，并返回基于选择器的修复工作清单，不进行编辑。

1. 审计

PORT=$(npx -y @accesslint/chrome@latest ensure | node -e 'process.stdin.on("data",d=>process.stdout.write(""+JSON.parse(d).port))')
npx -y @accesslint/cli@latest "<url>" –port "$PORT" –format json

根据需要添加标志：–selector、–wait-for "<selector>"、–include-aaa、–disable <rules>。

2. 报告

按影响计数，然后每个违规一个条目：

• 位置 — 逐字选择器 + 如果存在 source 则 file:line (symbol) — 绝不编造。如果没有违规有 source，注明"源映射不可用——仅通过选择器定位"。
• 证据 — 对比度、缺失属性、空名称
• 修复 — 机械变更或 NEEDS HUMAN

不编辑。对于修复：应用机械修复，然后重新运行验证；对于批量工作，交给 accesslint:audit。

3. 拆除

npx -y @accesslint/chrome@latest stop –all # 如果 ensure 报告 "managed":false 则跳过

注意事项

• ensure 始终确定端口——绝不硬编码 9222。
• CLI 退出码 2 = 错误的 URL 或页面从未加载；检查开发服务器。

限制

• 仅当任务明确符合上述范围时使用此技能。
• 不要将输出视为环境特定验证、测试或专家审查的替代品。
• 如果缺少所需的输入、权限、安全边界或成功标准，请停止并请求澄清。