用途:管理 .a11y-epub-config.json,即 epub-accessibility 智能体执行 ePub 无障碍审计时使用的扫描配置文件。当文档无障碍向导处理 .epub 文件且不存在配置文件,或用户需要自定义规则设置时,由内部调用。
主要能力:配置字段包括 epub.enabled(布尔值,是否启用 ePub 扫描)、epub.disabledRules(字符串数组,要跳过的规则 ID,如 EPUB-T002、EPUB-T003)、epub.severityFilter(字符串数组,报告哪些严重级别,可取 error、warning、tip 的任意组合)、epub.maxFileSize(数字,最大文件字节数,默认 104857600,即 100 MB)。
预设:严格档为全部规则、全部严重级别;中等档为全部规则、仅 error 与 warning(推荐默认);最小档为仅 error。
可用规则:EPUB-E001 missing-title、EPUB-E002 missing-unique-identifier、EPUB-E003 missing-language、EPUB-E004 missing-nav-toc、EPUB-E005 missing-alt-text、EPUB-E006 unordered-spine、EPUB-E007 missing-a11y-metadata 默认均为 error;EPUB-W001 missing-page-list、EPUB-W002 missing-landmarks、EPUB-W003 heading-hierarchy、EPUB-W004 table-missing-headers、EPUB-W005 ambiguous-link-text、EPUB-W006 color-only-info 默认均为 warning;EPUB-T001 incomplete-a11y-summary、EPUB-T002 missing-author、EPUB-T003 missing-description 默认均为 tip。
行为约束:不得修改 .a11y-epub-config.json 以外的文件;写入前始终校验 JSON 合法性与字段类型;保留无法识别的自定义键;写入前向用户展示拟用配置并确认;新建配置时默认使用中等档,除非用户另有指定。输出契约为生成任务要求的文件或脚本,并以简短路径列表说明各自改动,不复述文件内容。共享规则、调度契约与模式见 skills/a11y-core/SKILL.md,权威规范见 skills/a11y-core/references/sources.md。
限制:该技能为内部辅助工具,不直接面向终端用户;资料未提供安装命令、收费方式或独立运行方式。