Skill 安装
多 Agent 安装npx skills add https://github.com/anthropics/knowledge-work-plugins --skill accessibility-review
使用 npx skills 快速安装,支持将 Skill 添加到多个兼容的 AI Agent。
Skill 调研报告
Skill 详细介绍
anthropics/knowledge-work-plugins#accessibility-review 是什么?
这是 Anthropic 官方知识工作插件仓库(knowledge-work-plugins)中的一个无障碍审查(Accessibility Review)Skill。它属于 Anthropic 面向知识工作场景提供的技能集合,而不是独立运行的软件、CLI 工具或服务。
它的核心任务是对界面、网页、文档或内容进行无障碍(Accessibility / a11y)方面的审查,帮助发现可能影响残障用户使用的问题,并给出可执行的改进建议。
它不是什么
– 不是自动化测试工具(如 axe、Lighthouse、Pa11y 那样真正运行浏览器扫描)
– 不是无障碍合规认证工具
– 不是独立程序,不需要单独安装运行时
– 不替代人工无障碍测试和真实用户测试
核心用途
– 审查 HTML / 前端代码中的无障碍问题
– 检查语义化标签、ARIA 属性、键盘可达性、对比度等常见问题
– 对文案、界面结构、表单可访问性给出改进建议
– 以 WCAG(Web Content Accessibility Guidelines)等通行规则为参考给出审查意见
它解决了什么问题
团队在做前端或内容时,无障碍问题常常在开发后期甚至上线后才被发现,修复成本高。这个 Skill 让 Agent 在开发或评审阶段直接介入,帮助提前暴露诸如缺少 alt 文本、标题层级混乱、表单缺少 label、对比度不足、可聚焦元素缺失等问题。
安装后 Agent 增加的能力
安装后,Agent 在处理无障碍相关请求时,会调用该 Skill 的审查流程,而不是用通用常识零散回答。用户可以直接让 Agent 审查代码、页面结构或内容,并获得较系统的无障碍反馈。
工作方式与技术路线
从 Skill 的通用工作方式看,它本质上是一套面向无障碍审查的任务指令与方法论:给出审查维度、判断标准、常见问题清单和输出建议。它依赖 Agent 自身的推理与阅读能力,不额外捆绑专用扫描引擎。因此它的输出质量取决于 Agent 对无障碍规范和代码的理解程度。
适合的用户
– 前端开发者、设计系统维护者
– 关注 WCAG、EN 301 549、Section 508 等无障碍要求的团队
– 需要快速做一次无障碍初筛的内容或产品人员
不适合的需求
– 需要出具正式无障碍合规报告的场景
– 需要替代真实屏幕阅读器(NVDA、JAWS、VoiceOver)测试的场景
– 需要 100% 覆盖自动化规则扫描的场景
Skill 安全评估
整体判断:这是一个以文本审查为主的 Skill,风险较低,但具体风险取决于你让它审查的内容和授予 Agent 的权限。
来源可信度
它来自 Anthropic 官方 knowledge-work-plugins 仓库,来源可信。但这指的是仓库本身,不代表该 Skill 会对你的代码做任何自动修复或外部请求。
文件读取
审查代码或文档时,Agent 需要读取相关文件。这是该 Skill 的正常用途。建议只在你知道 Agent 有权访问的目录范围内使用,避免让它读取敏感配置、凭证文件。
文件写入 / 代码修改
审查类 Skill 通常以给出建议为主。如果 Agent 在实际使用中执行了自动改写,请留意这会修改你的项目代码。建议在应用任何自动修改前先做版本控制(如 Git 提交),便于回退。
Shell 与网络
该 Skill 本身不要求你提供 API Key 或 Token。但如果 Agent 为了运行 Lighthouse、axe 等外部扫描工具而调用 Shell 或网络,就属于 Agent 侧的行为,与本 Skill 无关。如果你只需要文本层的审查建议,可以关闭 Agent 的自动执行 Shell 权限,改为手动运行命令。
Prompt Injection 风险
如果被审查的内容里含有引导性文本(例如恶意注释),理论上可能干扰 Agent 输出。建议不要让 Agent 直接执行被审查页面中的脚本或指令。
凭证泄露
不要把含真实密钥、Token、Cookie 的文件交给它审查。如果必须审查,请先做脱敏。
降低风险的做法
– 使用版本控制,任何自动改动都可回退
– 只开放必要目录给 Agent
– 审查期间关闭不必要的 Shell / 网络权限
– 对含敏感信息的文件先脱敏
Skill 使用要求
一、Agent / 客户端
该 Skill 来自 Anthropic 官方仓库,与 Claude Code 的 Skill 加载机制最为契合,建议优先在 Claude Code 中使用。
官方没有公布完整的第三方 Agent 兼容列表。不过从 Agent Skill 的通用工作方式看,在支持 Skills、自定义 Skill 或类似指令加载机制的环境中,通常也可以尝试在 Codex、Cursor、Trae、OpenClaw、WorkBuddy 等主流 AI Agent 中使用。不同 Agent 的 Skill 加载方式和兼容程度不同,具体以对应 Agent 当前版本为准。
二、运行环境 / 依赖
| 项目 | 要求 |
|—|—|
| Agent | Claude Code 优先,其他兼容 Agent 可尝试 |
| Shell | 非必需(仅在你希望自动运行扫描工具时相关) |
| Node.js / Python | 非本 Skill 必需;如用外部扫描工具,按该工具要求 |
| 网络 | 非必需(除非调用外部服务) |
| 浏览器 | 非必需(纯文本审查不需要) |
官方资料未把上述任何运行时列为该 Skill 的硬性依赖。
三、权限
– 文件读取:必需(读取被审查的代码 / 文档)
– 文件写入:可选(若允许自动修改代码)
– Shell:可选(若让 Agent 运行外部扫描工具)
– 网络:可选
– 浏览器:可选
四、账号 / API Key
该 Skill 本身不需要额外的账号、API Key 或 Token。是否需要凭证,取决于你让它后续操作的第三方服务,例如你让它调用的某个无障碍扫描服务。这两者要分开看待。
最小使用条件
1. 一个能加载该 Skill 的 AI Agent
2. 待审查的代码、页面结构或内容
3. 能读取目标文件的权限
Skill 安装、使用与卸载教程
一、安装
直接复制本页面提供的 Skill 安装指令,粘贴到对应 Agent 或终端执行即可。
如果你不确定自己的 Agent 怎么安装,可以直接问它:
如何安装 anthropics/knowledge-work-plugins#accessibility-review?
如何在 Claude Code 中安装 anthropics/knowledge-work-plugins#accessibility-review?
如何在 Cursor 中安装 anthropics/knowledge-work-plugins#accessibility-review?
让当前 Agent 根据自己的 Skill 加载 / 管理机制来指导安装,比手动猜测目录更稳妥。
二、安装后如何使用
安装后,当你的请求涉及无障碍审查时,Agent 就会调用它。适合交给它的任务:
– 审查一段 HTML / JSX / Vue 模板的无障碍问题
– 检查表单、按钮、图片、标题结构的可访问性
– 对某个界面或内容给出一份无障碍改进清单
用自然语言直接描述需求即可:
使用 accessibility-review,帮我审查这个登录页 HTML 的无障碍问题。
使用 accessibility-review,检查这份表单是否满足 WCAG 2.1 AA 的基本要求。
使用 accessibility-review,列出我这个组件在键盘可达性上的问题。
三、卸载
不同 Agent 的 Skill 安装位置和管理方式不同。通常可以:
– 使用对应 Agent / Skill 管理器提供的删除方式
– 删除对应的 Skill 目录或条目
– 直接问当前 Agent:
如何卸载 anthropics/knowledge-work-plugins#accessibility-review?
如果没有统一卸载命令,交给 Agent 处理通常最稳妥。
常见问题
1. 这个 Skill 会自己运行 axe 或 Lighthouse 吗?
从 Skill 的常见形态看,它偏向文本层的审查与方法论指导,不捆绑专用扫描引擎。若要真正跑自动扫描工具,需要 Agent 或你手动调用这些工具,这属于 Agent 侧行为。
2. 它能给出符合 WCAG 的正式合规结论吗?
不能替代正式合规评估。它适合做初筛和改进建议,正式合规仍需专业工具和人工测试。
3. 安装后 Agent 没识别这个 Skill 怎么办?
先确认安装是否成功、Skill 是否落在该 Agent 实际加载的目录里;再确认你的请求是否触发到无障碍审查场景。可以直接问 Agent:“你现在能用 accessibility-review 吗?”
4. 可以在多个 Agent 里同时安装吗?
可以。只要各 Agent 支持 Skills 机制,分别安装即可,互不冲突。
5. Skill 更新后需要重新安装吗?
取决于所使用 Agent 的更新机制。有些会跟随仓库更新,有些需要手动重新拉取,具体问你的 Agent 更准确。
6. 中国大陆使用有网络要求吗?
该 Skill 以文本审查为主,本身不依赖特定网络服务。能否访问仓库、如何拉取安装,取决于你的网络和 Agent 的安装方式。
7. 它会修改我已有的项目代码吗?
默认以给出建议为主。如果 Agent 执行了自动改写,请确保项目已有版本控制,便于回退。你可以限制它的文件写入权限来避免意外修改。