SuperAPI AI 工具集

frontend-architect

前端与建站

查看项目

更新于 10-15 23:47

技能介绍

用途:该技能面向生产级前端架构决策,适用于启动或评审前端项目架构、选择框架与渲染模式、状态策略、测试基线或设计系统,以及为性能、可访问性、安全性和 AI 智能体可维护性加固 UI 交付。不适用于通用解释、文案编辑或不影响架构的一次性代码改动。

主要能力与规则:先发现仓库内权威来源(如产品章程、需求、ADR、交付文档或既有架构记录),提取约束、质量属性、团队能力、运行时、数据归属、安全边界与验证路径;若约束不足,则把缺失决策作为问题返回并停止选型。渲染模式须由产品约束决定,而非框架宣传。服务端状态与客户端 UI 状态分离,不强制单一 store 同时承担两者。可访问性、Core Web Vitals 与安全响应头视为架构而非打磨。内容与核心交互先可用,再启用可选动画、锚点或过渡特性。语义、规范成熟度与目标浏览器支持合适时优先原生 HTML/CSS 原语。服务端渲染输出须确定性,不在服务端渲染或初次渲染求值中读取 window、document、navigator。优先本地、可检查的组件模式。主答案决策优先,深层理由放入本地参考。版本或 API 敏感声明须对照官方实时来源核实。

决策门:材料约束缺失时返回未决问题,不推荐技术栈;SEO/公开内容用 SSR、SSG 或 islands,避免纯 SPA;内部管理后台按启动延迟、JS 依赖、缓存、安全、托管与运维一致性比较 SPA、SSR 与混合方案;单一团队控制兼容 TypeScript 消费者时可评估 tRPC,异构或独立发布客户端用可版本化 schema 生成契约;设计系统按定制控制选 headless,按交付速度选有主张的库;非模态浮层在语义与浏览器支持合适时优先 Popover API,模态交互用 dialog;可选现代 CSS/API 先保证完整静态体验,再按特性支持与减少动效偏好做渐进增强;SSR、流式或 islands 要求确定性服务端输出,并把仅浏览器行为隔离在客户端生命周期边界内。

使用方式:按执行步骤发现并阅读仓库权威来源,提取约束;输入不足则返回问题并停止;选择满足已验证来源的最小架构;需要详细矩阵、原生平台模式、反模式、命令或来源链接时阅读 references/technical-reference.md;说明所选模式、被拒替代方案及选错时的运行时后果;版本敏感声明对照官方来源核实。输出须包含每条建议对应的来源约束或质量属性、被拒替代方案及具体权衡、运行时风险与失败触发条件及缓解、采用前所需验证步骤或证据,以及无法论证时的阻塞性问题。

限制:资料未提供具体框架、命令、价格、平台或效果信息;references/technical-reference.md 与 references/source-index.md 为本地参考文件,其内容未在资料中展开。