已有可访问性问题清单或明确目标且只需修复时…

适用于拿到 a11y 发现工作清单或明确目标（URL、文件、目录）后，按 WCAG 2.2 修复 Web 可访问性违规并验证，而不是用于发现问题或回归检查。

适用场景

解决思路

1. 只做修复：按 baseline、edit、verify 循环修复可访问性违规；若任务是发现问题，改用 `accesslint:accessibility-scan`、`accesslint:accessibility-inspect` 或 `accesslint:accessibility-audit`，若检查回归改用 `accesslint:accessibility-diff`。
2. 大型修复通过 `Task` 运行以隔离上下文；步骤保持不变。
3. 遵循共享约定（grounding，绝不编造内容）。
4. 如果输入是 findings worklist（来自 `accessibility-scan`、`accessibility-inspect`、`accessibility-audit` 或粘贴的内容），直接应用它；baseline 已经完成。
5. 如果输入是 target（URL、config target name、文件或目录），先审计它得到 baseline，然后修复。
6. 如果既没有 worklist 也没有 target，询问要修复什么；不要未经提示扫描整个代码库。
7. 选择 baseline 和 verify 流程时：对任何 URL 使用 `audit_live`；它会确保有可调试的 Chrome（若无可达的则自动启动一个 headless），并审计 live DOM；用 `selector` 限定范围，用 `wait_for` 等待异步内容；live DOM 能捕获源码无法捕获的内容。
8. 选择 baseline 和 verify 流程时：对 raw HTML 字符串、文件（先 `Read`）或渲染成字符串的 JSX 使用 `audit_html`。
9. 对认证会话，让用户启动 headed 的可调试 Chrome（`npx @accesslint/chrome ensure --headed`），登录，然后调用 `audit_live({ url, port })` 附加到它。
10. Baseline：用 `format: "compact"` 审计并记录违规集合（每条记录 rule ID 和 selector）；如果已拿到 worklist，则跳过此步。
11. Apply：对每条违规，如果有 `Source:` 行，打开该文件的该行；如果列出多个（用 `←` 分隔），第一个是 JSX 字面量，其余是外层组件；用 `Symbol` 消歧。
12. Apply：如果没有 `Source:` 行，依次 grep 稳定钩子（`data-testid`、`id`、`aria-label`）、可见文本、树位置。
13. Apply：使用 `Fixability:` 和 `Fix:` 字段；按给定应用 `mechanical` 修复；对 `contextual` 或 `visual` 留一个带规则 ID 的 `TODO`；不要编造内容（alt text、labels、link text）。
14. Apply：将同一文件的编辑合并为一次操作。
15. Apply：在编辑明显目标之外的文件前，或在超过约 10 个 mechanical 修复前，确认范围。
16. Verify：重新运行同一审计并与 baseline 比较：每个目标违规都消失，且没有新违规。
17. Verify：对 URL 做精确的 new/fixed/pre-existing 比较时，使用 `accesslint:accessibility-diff`，不要肉眼检查。
18. `Source:` 行来自 React DevTools fibers，只出现在针对 React dev builds 的 live-DOM 审计中；静态审计不会有它们，回退到 selector。
19. 当不确定某条规则时，使用 `explain_rule({ id })`。
20. 停止条件：如果违规没有 `Fix:` 指令，留一个 `TODO`，不要猜。
21. 停止条件：如果验证失败（出现新违规，或目标违规仍存在），报告并停止；不要静默迭代。
22. 输出：每轮输出使用的 flow、按 impact 分组的违规、已应用内容（文件和规则）、已推迟内容（TODO 及原因）、前后计数。

适用边界 · 注意事项

• 需要发现问题而不是修复时：使用 `accessibility-scan`、`accessibility-inspect` 或 `accessibility-audit`。
• 需要检查回归时：使用 `accessibility-diff`。
• 没有明确 target 或 findings worklist 时：不要用它擅自扫全代码库，先询问要修复什么。