SuperAPI AI 工具集

generic-static-feature-developer

前端与建站

查看项目

更新于 10-16 10:39

技能介绍

用途

该技能用于指导极简静态站点的功能开发。它扩展自 Generic Feature Developer 技能,后者提供开发工作流、范围评估以及“自建还是集成”决策的基础内容,本技能在其之上补充静态站点相关的架构与实现约定。

静态站点架构

典型项目结构为:

project/
├── index.html          # Main page
├── style.css           # All styles
├── script.js           # All interactions
├── assets/             # Images, icons
├── .github/workflows/  # Automation (optional)
└── docs/               # Documentation

其核心理念是无构建工具:编辑 → 保存 → 部署。使用纯 HTML(无模板引擎)、纯 CSS(无 Sass/Less/PostCSS)、纯 JS(无打包、无转译),生产环境不包含 node_modules。

开发工作流

本地测试可使用以下命令:

# Start local server (cross-platform options)
python -m http.server 8000   # Windows
python3 -m http.server 8000  # macOS/Linux
npx serve .                  # Node.js (recommended - all platforms)
# Visit http://localhost:8000

提交前的检查包括:审查标记与 CSS 在 Chrome、Firefox 和 Safari 中的支持情况;在 375px、768px 和 1024px 断点下检查布局;仅在用户要求时运行浏览器、Lighthouse 或截图检查。

渐进增强

其哲学为:内容优先(无 CSS/JS 也能工作)、用 CSS 增强(为支持的浏览器提供更好样式)、用 JS 增强(为启用 JS 的浏览器提供交互)。

示例模式使用原生 details/summary 元素实现无 JS 可用的菜单,并在支持 IntersectionObserver 时进行自定义动画增强。

原生 JavaScript 模式

涵盖以下常用模式:

  • 事件委托:用单个监听器处理多个元素,通过 e.target.matches 判断目标。
  • DOM Ready:使用 DOMContentLoaded 事件,或将脚本放在 body 末尾。
  • 类切换:使用 classList.toggle、add、remove 控制可见性与状态。

自动化(GitHub Actions)

提供简单的部署工作流示例,在推送到 main 分支时通过 peaceiris/actions-gh-pages 部署到 GitHub Pages。

图片优化方面,建议提交前使用 pngquant 压缩 PNG、jpegoptim 优化 JPEG、cwebp 转换为 WebP。

功能检查清单

开始前:阅读 CLAUDE.md 了解项目约束、检查可复用的现有模式、理解性能预算。

开发中:每次只做一个更改、在多个浏览器中测试、测试响应式、保持页面体积在预算内。

完成前:Lighthouse 性能达到 95 以上、测试所有断点、提供截图用于对比、更新文档。

性能目标

Metric Target
Total weight < 50KB
First Contentful Paint < 1s
Lighthouse Performance 95+

参见

  • Generic Feature Developer:工作流与决策
  • Code Review Standards:质量要求
  • Design Patterns:UI 模式