Web 开发
第 1 层 — 领域基础（v2.0）
适用于每个 Web 项目的通用 Web 开发原则，无论使用何种框架。React、Vue、Svelte、原生 JavaScript——这些原则普遍适用。
理念
本包编码了代理在独立理解时往往正确，但在实践中易遗漏的 Web 平台基础知识。代理知道什么是 ARIA 标签，但它仍然会生成一个没有屏幕阅读器错误提示的表单。代理了解 Core Web Vitals，但它仍然渲染一个 2MB 且未指定尺寸的英雄图片。
差距不在于知识——而在于一致的应用。
包含内容
| 类型 | 数量 | 覆盖范围 |
|---|---|---|
| 模式 | 7 | 无障碍（WCAG 2.2）、性能（Core Web Vitals）、安全标头（OWASP）、SEO、响应式设计、错误用户体验、加载状态 |
| 反模式 | 6 | Div 嵌套、缺少替代文本、布局偏移、未受保护的表单、仅客户端关键路径、缺少安全标头 |
| 宪法 | 7 | 原则 |
基于：W3C WCAG 2.2（2023年10月）、Google Core Web Vitals（2025年）、OWASP 安全标头项目、OWASP CSP 备忘单、MDN Web 文档、Web Almanac 2025、欧洲无障碍法案（2025年6月）。
本包不涵盖的内容
- 框架特定模式（请参见
react、nextjs等） - CSS 方法论观点（BEM vs utility-first vs CSS-in-JS）
- 构建工具配置（Webpack、Vite、Turbopack）
- 后端/API 模式（请参见
api或baas）