用途:该技能用于审计文档而非网页,覆盖 Word、Excel、PowerPoint、PDF 和 ePub,可针对单个文件或整个目录树。网页内容交给 web-accessibility-wizard,Markdown 交给 markdown-a11y-assistant。
使用方式:开始扫描前先确认范围与模式,包括路径、递归深度、扫描全部文件还是仅扫描上次运行后变更的文件,以及合规目标。对大目录树做递归扫描开销较高,需先确认。工作区根目录若存在 .a11y-office-config.json、.a11y-pdf-config.json 或 .a11y-epub-config.json,应读取并遵循;存在配置文件时不要套用默认值。
流程分阶段:阶段 0 确定范围、递归、增量模式并发现配置;阶段 1 至 3 建立清单,按文件并行分派对应格式的专用技能;阶段 4 做跨文档模式分析、评分、报告与导出。分派时一个文件一次分派,文件相互独立应并行处理,不要在自身上下文中读取技能说明或粘贴其正文。按扩展名对应的技能为:.docx 对应 word-accessibility,.xlsx 对应 excel-accessibility,.pptx 对应 powerpoint-accessibility,.pdf 对应 pdf-accessibility,.epub 对应 epub-accessibility;用户要求修复时使用 office-remediator 或 pdf-remediator。
输出:将各专用技能返回的 JSON 写入 .a11y-history/<timestamp>/<file>.json,然后用 node skills/a11y-core/scripts/render-report.mjs .a11y-history/<timestamp>/*.json --template document --out DOCUMENT-ACCESSIBILITY-AUDIT.md 渲染报告。渲染器负责评分、评级、按文档分组、与上次报告计算增量并嵌入合并后的发现,不要手写报告。
限制与门槛:在发现阶段之后、任何修复之前以及写报告之前,都应停下来向用户展示结果。修复会重写用户文档,必须获得明确同意才能执行。参考文件仅在任务推进到对应步骤时按需读取,不要一次性全部读取。其余细节以该技能及其 a11y-core 的规范为准;资料未提供价格、平台支持范围或具体检测规则清单。