Auto-sync: 2026-04-21 17:12

wiki/sources/testing-accessibility-auditor.md

@@ -1,73 +0,0 @@
----
-title: "Accessibility Auditor"
-type: source
-tags: [accessibility, testing, agent, the-agency]
-date: 2026-04-21
----
-
-## Source File
-- [[raw/Agent/agency-agents/testing/testing-accessibility-auditor.md]]
-
-## Summary
-- 核心主题：The Agency 项目中的无障碍审计专家智能体，基于 WCAG 2.2 标准进行界面审计
-- 问题域：无障碍合规测试、辅助技术验证、包容性设计评估
-- 方法/机制：WCAG POUR 原则测试、屏幕阅读器测试（VoiceOver/NVDA/JAWS）、键盘导航测试、自动化扫描 + 手动测试结合
-- 结论/价值：自动化工具仅能捕获约 30% 的无障碍问题，剩余 70% 需人工辅助技术测试发现
-
-## Key Claims
-- 自动化工具仅能检测约 30% 的无障碍问题，70% 需人工测试发现
-- 绿 Lighthouse 分数不代表真正的无障碍达标
-- 自定义组件（tabs、modals、carousels、date pickers）默认有罪直至证明无罪
-- "能用鼠标操作"不是测试——每个流程都必须能仅用键盘完成
-- 语义 HTML 优先于 ARIA——最好的 ARIA 是不需要用的 ARIA
-
-## Key Quotes
-> "A green Lighthouse score does not mean accessible — say so when it applies" — AccessibilityAuditor 核心原则
-> "Custom components (tabs, modals, carousels, date pickers) are guilty until proven innocent" — 组件测试原则
-> "If it's not tested with a screen reader, it's not accessible" — 核心使命宣言
-
-## Key Concepts
-- [[WCAG 2.2]]：Web Content Accessibility Guidelines 2.2，网页内容无障碍指南标准
-- [[POUR Principles]]：Perceivable、Operable、Understandable、Robust 四大无障碍设计原则
-- [[Screen Reader Testing]]：使用屏幕阅读器（VoiceOver、NVDA、JAWS）验证内容可访问性
-- [[Keyboard Navigation Audit]]：纯键盘导航测试，验证所有交互元素可及性
-- [[ARIA Patterns]]：Accessible Rich Internet Applications 模式，自定义组件的无障碍实现规范
-- [[axe-core]]：自动化无障碍扫描工具，可集成到 CI/CD 流程
-- [[Lighthouse Accessibility]]：Chrome 开发者工具内置的无障碍审计功能
-
-## Key Entities
-- [[The Agency]]：开源 AI 智能体集合项目，Accessibility Auditor 是其测试类智能体之一
-- [[WAI-ARIA]]：Web Accessibility Initiative 制定的 ARIA 规范
-- [[WCAG 2.2]]：W3C 发布的网页内容无障碍指南 2.2 版本
-
-## Connections
-- [[Testing Reality Checker]] ← collaborates_with ← [[Accessibility Auditor]]
-- [[Evidence Collector]] ← provides_evidence_to ← [[Accessibility Auditor]]
-- [[Frontend Developer]] ← receives_audit_from ← [[Accessibility Auditor]]
-- [[UI Designer]] ← receives_feedback_from ← [[Accessibility Auditor]]
-
-## Contradictions
-- 暂无已知冲突
-
-## Testing Methodology
-### Automated Scanning
-- axe-core CLI: `npx @axe-core/cli http://localhost:8000 --tags wcag2a,wcag2aa,wcag22aa`
-- Lighthouse: `npx lighthouse http://localhost:8000 --only-categories=accessibility --output=json`
-
-### Manual Testing Protocol
-1. **Screen Reader Testing**: VoiceOver (macOS)、NVDA (Windows)、JAWS 各平台完整流程测试
-2. **Keyboard Navigation**: 纯键盘完成所有关键用户旅程
-3. **Visual Testing**: 200%/400% 缩放、高对比度模式、减少动画模式
-4. **Component Deep Dive**: 自定义组件 WAI-ARIA Authoring Practices 对标审查
-
-### Severity Classification
-- **Critical**: 完全阻断部分用户访问
-- **Serious**: 需要变通方案的主要障碍
-- **Moderate**: 造成困难但有变通方案
-- **Minor**: 降低可用性的烦扰问题
-
-## Audit Deliverables
-- Accessibility Audit Report（含问题详情、WCAG 条款引用、修复建议）
-- Screen Reader Testing Protocol（按组件的 PASS/FAIL 表格）
-- Keyboard Navigation Audit（全局导航 + 组件特定模式检查清单）
-- Remediation Priority（Immediate/Short-term/Ongoing 三级优先级）