SuperAPI AI 工具集

content-semantics

前端与建站

查看项目

更新于 10-16 09:51

技能介绍

用途:该技能针对 IsAgentReady 扫描中“内容与语义”(Category 3,占总分 20%)的问题提供修复流程。AI 智能体依赖可访问性树而非视觉渲染来解析页面,因此语义化和标题结构直接影响 AI 理解效果。适用于站点在该类别或检查点 3.1–3.14 得分偏低时,或新建站点希望从一开始就具备 AI 智能体就绪性;不适用于其他类别问题(应改用 ai-content-discovery、structured-data、agent-protocols、security-trust)、纯视觉样式问题,或该类别已是 A+ 的站点。

主要能力:覆盖 14 个检查点,总分 160 分,包括服务端渲染内容(3.1,20 分,需原始 HTML 中 body 可见文本超过 200 字符,检测 SPA 空壳与 noscript 回退)、标题层级(3.2,恰一个 h1、层级不跳级)、语义 HTML 元素(3.3,header/nav/main/article 或 section/footer 各 4 分)、ARIA 地标(3.4)、图片替代文本(3.5)、语言属性(3.6,BCP 47)、描述性链接文本(3.7,避免 click here、read more 等)、问句式 H2 标题(3.8,资料称 78.4% 的 ChatGPT 引用来自含问句式 H2 的页面)、表单标签覆盖(3.9)、表单字段自动填充(3.10)、键盘可导航性(3.11)、文档标题(3.12)、按钮可访问名称(3.13)以及 aria-hidden 误用(3.14)。

使用方式:先用 curl 命令配合 sed、grep 提取原始 HTML 中的可见文本、标题、语义元素、缺失 alt 的图片和通用链接文本进行审计,再按检查点逐一修改,最后重新运行验证。

限制:资料未提供该 Skill 的安装命令、依赖或平台要求,也未提及收费信息;仅说明各检查点依据与修复步骤以及引用的参考文档路径(如 references/ssr-strategies.md、references/gotchas.md)。