A11y Audit Until Clean

精选按需触发

代码质量最多 8 轮

关于 A11y Audit Until Clean

这个循环用于清理改动界面中的无障碍问题。每一轮先运行无障碍审计，再根据报告修改代码，最多进行 8 轮。

主要功能

01手动触发，由使用者决定何时开始
02以 npm run test:a11y 的退出码作为判定依据
03最多 8 轮，避免无限重试
04目前支持 Cursor

适用场景

01提交含界面改动的 PR 之前
02新增表单或弹窗组件后
03排查审计报告中的严重违规项

目标: 改动的界面上严重无障碍违规为零，并可通过审计命令验证。
退出条件: npm run test:a11y 以退出码 0 结束时停止，达到 8 轮仍未通过也停止。
每轮之间运行: npm run test:a11y

启动提示词

在 Cursor 中粘贴运行，Agent 会按下面的步骤循环执行，直到满足退出条件。

prompt.md

开始运行“A11y Audit Until Clean”循环。
目标：改动的界面上严重无障碍违规为零，并可通过审计命令验证。
最大轮数：8。
第 1 步：运行无障碍审计 — 执行 npm run test:a11y，读取输出中的违规项。若命令退出码为 0，则视为通过，循环结束。 `npm run test:a11y`
第 2 步：定位严重违规 — 从报告中挑出与改动界面相关的严重问题，找到对应的组件和元素。
第 3 步：修改代码 — 针对每个问题做最小改动，例如补充标签、调整对比度或修正语义结构，然后进入下一轮重新审计。
每轮之间运行：`npm run test:a11y`
退出条件：npm run test:a11y 以退出码 0 结束时停止，达到 8 轮仍未通过也停止。

步骤

每一轮按顺序执行；未满足退出条件会进入下一轮，最多重复 8 轮。

运行无障碍审计

执行 npm run test:a11y，读取输出中的违规项。若命令退出码为 0，则视为通过，循环结束。

$npm run test:a11y

定位严重违规

从报告中挑出与改动界面相关的严重问题，找到对应的组件和元素。

修改代码

针对每个问题做最小改动，例如补充标签、调整对比度或修正语义结构，然后进入下一轮重新审计。

未通过 → 下一轮满足条件即退出

支持的 Agent

可以直接运行这个 Loop 的编码 Agent。

Cursor

Claude Code

支持 Markdown

登录后评论