SuperAPI AI 工具集

office-scan-config

办公与效率

查看项目

更新于 10-15 20:14

技能介绍

用途:管理 Office 文档(.docx、.xlsx、.pptx)无障碍扫描的配置文件 .a11y-office-config.json。该文件由 scan_office_document MCP 工具在扫描时读取。

主要能力:创建带默认值的新配置文件;解释每条规则检查什么及其意义;按文件类型启用或禁用规则;管理严重级别过滤(error、warning、tip);提供 strict、moderate、minimal 预设配置;校验已有配置文件;记录配置变更。

配置文件格式:JSON,含 version(字符串,必填,当前为 1.0)、docx、xlsx、pptx(对象,可选)。每个文件类型对象含 enabled(布尔,默认 true)、disabledRules(字符串数组,默认空)、severityFilter(字符串数组,默认三者全部)。

使用方式:用户提出创建配置时,先确认所需预设或自定义,再在项目根目录创建文件并解释各设置;禁用某规则时,从规则参考表找到规则 ID 加入对应 disabledRules;仅显示错误时,把 severityFilter 设为 ["error"];禁用某文件类型扫描时,把该类型 enabled 设为 false;校验时读取文件,检查 version、规则 ID 与 severityFilter 取值是否有效。

集成方式:scan_office_document 工具自动读取该配置;可通过 configPath 参数指定自定义位置;未指定时在扫描文件同目录查找 .a11y-office-config.json,并向上搜索父目录;命令行参数 disabledRules 和 severityFilter 会覆盖配置文件。

限制与约定:禁用规则时必须说明影响,不得静默关闭无障碍检查;公开文档建议使用 strict 预设;不得将 severityFilter 设空或禁用全部错误规则;对存量文档多的情况建议从 minimal 起步逐步启用;完整规则参考与预设见 references/complete-rule-reference.md,按需读取。权威规范见 skills/a11y-core/references/sources.md。