SuperAPI AI 工具集

web-issue-fixer

前端与建站

查看项目

更新于 10-15 20:24

技能介绍

用途:web-issue-fixer 是一个内部辅助技能,接收一份带位置信息的网页无障碍问题列表,并将修复应用到源代码。

主要能力:分为两类修复。可自动修复(无需询问)包括:为 <html> 补 lang、补 viewport meta、为 <img> 补 alt=""(装饰性图片)、把正 tabindex 改为 tabindex="0" 或移除、为 outline: none 补 :focus-visible 替代、为 input 补 <label>、为无名称按钮补 aria-label 或文本、为身份字段补 autocomplete、为新标签页链接补 sr-only 提示、为 <th> 补 scope、为 <button> 补 type="button"。需人工判断(展示修复并请求批准)包括:有意义图片的 alt 文本内容、标题层级重构、链接文本改写、自定义组件的 ARIA role 分配、ARIA role 变更、移除或修改 aria-keyshortcuts/title 等属性、live region 的位置与礼貌级别、颜色/对比度调整。

使用方式:读取问题详情(文件路径、行号、描述),读取源文件理解上下文,判断框架语法,用 Edit 工具应用修复,并报告前后变化。输出格式为每条修复列出编号、文件路径与行号、修改前、修改后、状态(已应用/跳过原因/需批准)。框架语法:React/Next.js 用 htmlFor、onClick/onKeyDown;Vue 用 for、@click/@keydown;Angular 用 for、(click)/(keydown);Svelte 用 for、on:click/on:keydown;原生 HTML 用 for、onclick/onkeydown。

限制:ARIA role 变更永不自动修复,需先搜索工作区中引用该 role 的选择器,列出需同步更新的文件与行,评估对辅助技术的影响,并在同一次操作中同步更新 HTML、JavaScript 与 CSS。参考文件按需读取,不要预先全部读取。共享规则与调度契约见 skills/a11y-core/SKILL.md,权威规范见 skills/a11y-core/references/sources.md。