SuperAPI AI 工具集

a11y-tool-builder

通用与其它

查看项目

更新于 10-15 20:14

技能介绍

用途:该技能面向无障碍审计工具的开发,帮助设计并实现扫描器、规则引擎、解析器与报告生成器,可对标 axe-core、pa11y、Accessibility Insights 等工具的架构,并扩展到桌面应用、文档和自定义领域。

主要能力:规则以 YAML/JSON 数据形式存储,包含 id、名称、描述、WCAG 映射、严重度、适用对象、检查逻辑、修复模板与 auto_fixable 标记,新增规则无需改代码;引擎从目录加载规则、对解析后的元素求值并产出 Finding 对象,Finding 含 rule_id、severity、wcag_criteria、element、location、description、fix_suggestion、auto_fixable、confidence。严重度采用 critical/serious/moderate/minor 四级,评分公式为 impact × frequency × confidence,报告评分按 100 × (1 - weighted_issues / max_penalty) 计算,等级为 A(90+)、B(80+)、C(70+)、D(60+)、F(60 以下)。输出支持 Markdown 报告、CSV 导出与 SARIF(用于 GitHub Code Scanning),报告含元数据、执行摘要、发现项、严重度分布、修复优先级、后续步骤与增量跟踪。解析器覆盖 DOCX(python-docx 处理标题层级、替代文本、表头、超链接文本)、PDF(pikepdf/pdfplumber 处理标签结构、语言、书签)与 UIA 树(comtypes/pywinauto 遍历桌面应用无障碍树)。

使用方式:规则引擎从 YAML/JSON 目录加载规则,对解析元素求值生成 Finding,再按统一评分生成多格式报告;每条规则必须带 WCAG 映射,每个发现项需标注 auto_fixable,并为规则引擎与解析器编写 pytest 测试。Python 实现交由 python-specialist,GUI 交由 wxpython-specialist,Web 规则问题交由 web-accessibility-wizard,文档规则问题交由 document-accessibility-wizard。

适用场景:构建 Web、文档、桌面应用的无障碍扫描与审计工具,需要跨团队对齐规则 ID 与评分口径(Web 用 web-accessibility-wizard 规则 ID,文档用 DOCX-、XLSX-、PDFUA.* 规则 ID,桌面定义 DESK-* 并映射 WCAG)。

限制:资料未提供具体安装命令、依赖版本、收费或平台信息;输出契约要求只回答所问内容,不追加未请求的清单。