用途:frontend-guardrails 是一套前端标准指令集,供 AI 在构建、脚手架、扩展现有 UI 或前端项目、以及审查前端代码时使用。其目标是让专业产出成为默认行为,减少逻辑重复、色彩字体不一致、后端职责渗入 UI、密钥与用户数据泄露到浏览器等问题。
主要能力:以通用原则治理前端质量,包括可复用与 DRY、组件架构与关注点分离、通过设计令牌保持一致性、响应式设计、专业打磨(标题、favicon、viewport、加载与空状态)、状态与导航纪律、前后端边界、安全(浏览器内容皆公开)、依赖保持当前稳定版本、性能、可访问性、错误处理与反馈、类型安全、SEO 与可发现性、文档与项目上下文、以及 AI 行为纪律。安全基础与“不交付无法构建的代码”属于硬性规则,样式与架构类多为可让步的合理默认。
使用方式:先检测技术栈(框架、样式方案、状态库),不强行套用项目未使用的栈。按框架阅读对应参考文件:React/Next.js 读 references/react.md,Vue/Nuxt 读 references/vue.md,Angular 读 references/angular.md,Svelte/SvelteKit 读 references/svelte.md,其他(纯 JS、SolidJS 等)套用通用原则。安全敏感、通知反馈、可访问性任务分别阅读 references/security.md、references/notifications.md、references/accessibility.md。完成任务前运行自审清单。
适用场景:新建或已有前端项目的开发与代码审查;按项目规模调整严格度,小项目与初学者项目优先给合理默认值。
限制:部署、CI/CD、服务器与数据库不在范围内,仅限客户端。用户明确指示与项目既有约定优先。资料未提供收费、价格、平台支持、效果数据等信息。