SuperAPI AI 工具集

vanilla-web

前端与建站

查看项目

更新于 10-15 15:14

技能介绍

Vanilla Web(HTML/CSS/JS)是一个用于构建或修改纯 HTML/CSS/JavaScript 项目的 Cursor 技能,核心目标是在不引入任何框架的前提下,产出结构清晰、可运行、可验证的前端代码。

用途

该技能适用于以下情形:用户要求使用 vanilla JS、纯 HTML/CSS/JS 或静态页面;明确声明“不使用框架”“不要 React/Vue/Angular”;需要用 DOM 直接构建小型 UI 组件(如弹窗、标签页、下拉菜单、表单校验);或需要重构以移除框架依赖、降低 JavaScript 复杂度。

基线约束与主要能力

其基线约束被定义为不可妥协项:仅使用 HTML/CSS/JS,不使用框架;JavaScript 保持模块化(ESM)并拆分职责(SRP);优先使用小而专注的函数与纯工具函数,避免全局状态;在标记完成前交付完整可运行的文件与最小测试。

在输出预期上,要求交付完整可运行的文件(不缺少导入或路径、不保留 TODO 占位),变更保持小步、可测试、可增量,并提供简短的运行手册,说明如何在本地运行与验证,以及在 DevTools 中需要检查什么。

实现工作流

1)只澄清影响正确性的问题:仅当需求存在会改变实现的歧义时,最多提出 3 个问题;否则以显式假设继续推进。

2)结构与职责:推荐拆分为 index.html(语义化标记)、styles.css(或 css/ 目录)、js/main.js 作为 ESM 入口,以及 js/modules/*.js 存放组件与工具。SRP 要求每个模块只做一件事(DOM 绑定、状态、渲染、API、工具等)。避免全局可变状态;如需状态,则封装在模块内并暴露最小函数集。

3)HTML 指南:使用语义化标签(header、main、nav、button,适用时使用 dialog)。可访问性基线包括键盘导航与焦点状态,仅在必要时使用 ARIA,避免过度使用 ARIA。

4)CSS 指南:倾向简单、可预测的命名(BEM 风格为可选),使用 CSS 变量表达主题基础值,默认保持布局响应式(flex/grid 加相对单位)。

5)JavaScript 指南(ESM):使用 type="module" 与显式 import/export;优先纯工具函数与小函数;对列表和动态 UI 使用事件委托;显式处理错误(网络失败、缺失 DOM 节点、非法输入)。

验证与渐进披露

验证清单存放在 references/checklist.md。完成工作时需确保:变更未引入控制台错误或警告;所有引用的资源可解析(路径与导入);功能在键盘下可用,且不依赖框架运行时。技能建议保持 SKILL.md 精简,将更深入的示例与清单放在 references/ 下,不要把大型风格指南直接粘贴进 SKILL.md,而是链接到仓库示例。

可选配套脚本

资料提到可选的 scripts/serve.sh,用于快速静态服务以进行人工验证,具体安装与运行方式暂未提供。