SuperAPI AI 工具集

html

前端与建站

查看项目

更新于 10-16 02:28

技能介绍

用途:编写和审查语义化、可访问、易维护、易扫读的 HTML 与模板标记,追求简单结构和最少包裹噪音;核心原则是为内容与交互选择最合适的元素,而非机械套用最佳实践。

适用场景:编写原始 HTML 或模板标记;重构冗杂、包裹层过多的标记;改进语义、地标和标题结构;修复表单标注与控件选择;在 div、section、article、ul 等结构元素间抉择;用更好的原生 HTML 替代自定义交互;在不改变行为的前提下清理 Svelte 组件标记。不适用于纯 CSS 架构决策、无关标记结构的 JavaScript 行为设计、营销文案与内容策略、以及框架特有的深层状态或响应式改动。

主要规则:优先使用语义元素(header、main、section、article、nav、aside、footer、button、form、label);按含义而非外观组织内容;保持嵌套浅;标题层级合理,一个页面一个 h1,不跳级;表单控件必须有明确 label,用 button 表示动作、a 表示导航,图片按用途写 alt,仅在原生 HTML 无法表达时才用 ARIA;优先原生行为(button、details、summary、dialog、input、select、fieldset、table);标记保持可读;仅在需要时加类名,避免 div 汤;列表标记只用于真正是列表的内容,独立重复项用 article,主题分组用 section,纯布局用普通容器;结构与表现、行为分离;链接与按钮不可互换;图片需有意处理并尽量提供宽高;完整文档需含 <!doctype html>、lang、meta charset="utf-8"、viewport 与有意义的 title;避免语义过度拟合,地标要有意义,保持最小而诚实的标记。

模板安全:在 Svelte 等模板语言中,应视文件为模板标记而非独立文档,保留 {#if}、{#each}、{:else}、{@html}、bind:、class、style:、事件属性及 svelte:head 等特殊元素;不擅自将组件或大写标签替换为原生元素;只在文件确为文档外壳时使用 html、head、body 规则;把编译器的可访问性警告当作护栏,不随意添加 svelte-ignore。反模式包括:用 div 做按钮或链接、原生可用时加 ARIA、输入缺 label、用标题做样式、深层嵌套、用表格做布局、内联 onclick、把有效 Svelte 指令当坏 HTML 重写、组件内加 html/head/body、无意义类名、默认把卡片包成 ul/li、仅因内容重复就加语义元素、用占位符代替标签。输出时先搭语义结构,保持标记最小,偏好原生元素,优化可读性与可维护性,去掉多余包裹,不给 ARIA、类或属性安排含糊职责,在模板文件中保留指令、块语法、绑定与特殊元素。其余如收费、平台与效果等事实,资料暂未提供。