成为赞助商——支持中文 Agent 生态

了解赞助
库Agent场景库
← 返回用例列表

GitHub 无障碍 Agent:审 PR 与克制改码实践

对照 GitHub 工程实践:用评审/实现双子代理+模板 schema 审前端 PR,复杂与高风险模式只给建议不改码;不宣称已达 WCAG 全覆盖。

飞书DeepSeekClaudeChatGPT🛠️ 开发者工具🏢 企业协作

场景说明

面向前端与平台团队:把「无障碍 Agent 试点」写成可对账的范围与闸门,区别于通用安全预审与单次 CR。

案例叙事

01他们做了什么

GitHub Blog《Building a general-purpose accessibility agent—and what we learned in the process》(Eric Bailey,datePublished 可核)写明:正在试点通用无障碍 Agent,目标有二——在 Copilot CLI/VS Code 里即时答无障碍问题;以及在前端变更上自动评估并修复「简单、客观」的问题。截至发文已审 3535 个 PR,解决率约 68%;高频问题类型包括结构关系、控件名称、重要通知、非文本替代文本、键盘焦点顺序等。

关键做法:不把 Agent 当银弹,而是增强既有无障碍流程。历史投入的结构化缺陷模板(复现步骤、严重级别、WCAG 条款、关联 PR)成为最强语料,用来对抗「训练数据里充斥不可访问代码」的偏见。架构上从单体改为双子代理:被动评审/调研 vs 主动实现,彼此沙箱、经父代理用模板 schema 传递,保留升级点与审计轨迹;指令按线性阶段执行(对齐人工审计习惯)。复杂度脚本超阈值或命中拖拽、toast、富文本、树视图、数据网格等高风险模式时,禁止自动改码,改为指引联系无障碍团队,并加反「想方设法仍去改码」指令。同时承认约 36% 的 A/AA 成功标准无法纯自动发现,设计阶段人工仍关键。本场景据此输出「范围、语料、双子代理、停手条件」提纲。禁止声称「已通过全部 WCAG」。

02实际效果

  • 源披露已审 3535 PR、约 68% 解决率及 Top 问题类型;未承诺可迁移到任意产品的同等数字。
  • 能把「让模型随便改前端」与「评审/实现分离 + 高风险停手」拆开。
  • 为缺陷语料、schema、升级路径提供提问清单。

03值得知道

  • Agent 仍在试点,开源计划未兑现前只能学方法。
  • 自动化测不到的成功标准仍依赖设计/人工;法律合规以法务与专业审计为准。
  • 上面写的是 GitHub 公开实验叙事,不是你产品的无障碍认证。

04可复制提示词

无障碍 Agent 范围与闸门简报

你是无障碍 Agent 设计助手。只给范围与停手闸门简报,不要编造已审 PR 数。

是否已有结构化缺陷库:{{issue_corpus}}
前端栈:{{frontend_stack}}
允许自动改码的级别:{{autofix_level}}

输出 Markdown:
1. 适合自动修 vs 只建议的问题类型
2. 双子代理(评审/实现)与模板字段
3. 复杂度/高风险模式停手列表草案
4. 人工抽检与情感信号如何回灌
禁止声称已达 WCAG AA;禁止代合 PR。

PR 无障碍评审升级提纲

某前端 PR 触发无障碍检查,请写升级提纲。

变更摘要:{{diff_summary}}
Agent 初判:{{agent_findings}}
是否含树视图/富文本等:{{risky_patterns}}

输出:
1. 可自动修项 vs 须人审项
2. 是否应转无障碍同学结对
3. 设计阶段是否可能已埋雷
4. 合并前人工验证步骤
不要伪造「用户已可依赖读屏」。

怎么做

  1. 粘贴是否已有结构化无障碍缺陷库、前端变更是否自动抽检、以及对「自动改码」的风险容忍
  2. Agent 按公开实践输出:双子代理沙箱→线性阶段→复杂度/高风险停手→人工升级提问清单
  3. 人工在仓库配置规则与抽检;Agent 不代合 PR、不声称站点已完全无障碍

实用提示

  • 源帖强调:先有人工登记/修复的结构化缺陷语料,再喂给 Agent;空喊「遵循无障碍最佳实践」几乎无效
  • 与 code-review-pr-agent / github-pr-security-prescreen-agent 不同:本条是无障碍专用评审+克制实现闸门,不是通用 CR 或安全预审
#无障碍#GitHub#子代理#PR 审查#前端