SuperAPI AI 工具集

performance

通用与其它

查看项目

更新于 10-16 06:09

技能介绍

该技能用于在 Plate 方案声称速度、响应性、大文档就绪或生产性能时进行审查。其职责范围包括:围绕队列(cohorts)、重复单元预算、p95/p99 交互、内存与 DOM 标记、降级契约、原生编辑器行为证明、追踪证明和 RUM 缺口确定审查形态。React/Next 微策略、effect 法则和复杂度分析被委派给已有专门技能,不在此重复处理。

职责边界通过“负责人地图”界定:vercel-react-best-practices 负责 React/Next 瀑布、打包、服务端/客户端获取、重渲染、渲染、JS 微优化和 React 运行时原语;react-useeffect 负责 effect 法则、订阅、事件/effect 替代方案;performance-oracle 负责 Big-O、缓存形态、内存压力和 10x/100x/1000x 外推;Chrome DevTools、Lighthouse、web.dev 文档负责浏览器追踪、Core Web Vitals、网络链、布局偏移和长任务;performance 自身负责队列、重复单元预算、p95/p99 交互、内存标记、降级、原生行为证明和 RUM/仪表盘缺口,并记录最终性能审查结论。规则要求:如果方案只说“使用 React 最佳实践”“避免 O(n)”或“本地看起来很快”,则不算完成。

必须记录的输出字段包括:适用性(applied 或 skipped)、使用的 Vercel 规则、使用的额外规则、重复单元、队列、预算、React/运行时原语、交互指标、追踪/CWV 证明、内存标记、降级契约、仪表盘/RUM 缺口和方案变更。若本次审查无法改变方案,需写出无变更辩护及证据。

快速审查流程:将工作负载分为正常、大、压力和病态队列;命名重复单元(块、行、单元格、叶子、装饰、覆盖层、岛、监听器或订阅);为每个重复单元的 DOM 节点、组件、处理器、effect、订阅、分配、布局读写和内存设置当前与目标预算;在增加特殊模式前先简化正常路径;将罕见状态(评论、菜单、悬停装饰、选择工具、调试面板、上下文操作)移出重复单元;仅在热路径证明存在重复扫描时添加 O(1) 索引或缓存查找;为激进模式选择降级契约(原生、DOM 存在分阶段、壳岛、虚拟化或模型支持);按队列和模式插装 p50/p75/p95/p99 交互行;当声明涉及实验室外场景时记录浏览器追踪证明和生产/RUM 标记。完成后审查应具备工作负载、单元预算、交互矩阵和证明路径。

阻止项:缺少队列时“大文档”无可测试含义;缺少重复单元预算时方案可能让一个块变便宜却让 1 万个块不可行;缺少 p95/p99 交互行时平均值会掩盖输入卡顿;缺少内存/DOM/组件标记时延迟优势可能使堆、订阅或已挂载 DOM 爆炸;缺少降级契约时更快的模式可能静默破坏浏览器原生编辑行为;缺少原生行为证明时若查找、复制、粘贴、选择、IME、撤销或协作退化则编辑器性能不算好;缺少追踪或 RUM 证明时面向生产的声明需要浏览器证据或仪表盘标记。若某阻止项不适用,需用一行说明原因,沉默不算通过。

Vercel 规则选择按症状加载:顺序获取、路由阻塞、服务端设置慢对应 async-、server-;客户端包中沉重的可选 UI 或包桶对应 bundle-;重复浏览器监听器、存储读取、重复客户端获取对应 client-;热编辑器行因宽泛订阅或不稳定 props 重渲染对应 rerender-;长 DOM 列表、水合闪烁、隐藏面板、资源提示对应 rendering-;重复扫描、链式数组遍历、成员检查、可缓存纯工作对应 js-;稳定回调、应用级初始化、effect 事件依赖法则对应 advanced-。仅在代码或方案需要时加载精确的 Vercel 规则文件,在“使用的 Vercel 规则”中写规则名,除非方案需要具体引用级约束,否则不复制其解释。

本技能独有的额外规则按条件加载:cohort-segmentation 用于方案声称“大文档”“大列表”“压力场景”或“性能模式”但未分队列;repeated-unit-budget 用于块、行、叶子、组、装饰或岛在大规模下重复;rare-state-isolation 用于罕见 UI 状态被每个重复单元携带;event-delegation-budget 用于数千重复单元附加指针、悬停、键盘、拖拽、调整大小、选择或滚动处理器;effect-subscription-budget 用于重复单元运行 effect、订阅运行时存储或因不稳定回调重新订阅;css-layout-hotpath 用于选择器、布局读写、拖拽/调整大小、覆盖层或几何可能造成交互延迟;interaction-inp-matrix 用于方案从平均值、启动时间或一次冒烟基准声称响应性;memory-dom-tagging 用于某模式可能通过增加堆、DOM 节点、组件、监听器、订阅、缓存或已挂载组而改善延迟;degradation-contract 用于性能需要虚拟化、壳岛、模型支持选择、分阶段挂载或任何较不原生模式;staged-readiness 用于启动、水合、全文档替换、插入片段或分阶段 DOM 存在挂载属于方案一部分;react-19-runtime-proof 用于为编辑器/应用性能提议 React 19.2 原语;browser-trace-cwv-proof 用于声明涉及加载、水合、网络链、布局偏移、长任务、LCP/FCP/TBT/CLS 或追踪证据;production-rum-dashboard 用于声明超出本地基准并需要发布/浏览器/移动/IME/文档大小标记;editor-native-behavior-proof 用于编辑器性能改动涉及 DOM 存在、选择映射、物化、壳、隐藏内容或模型支持行为。

该技能提供了一个巨大文档 10k 块的 Plate 示例审查形态,涵盖适用性、Vercel 规则、额外规则、重复单元(块)、队列(正常 100 块、大 1000 块、压力 10000 块、病态 50000 嵌套/混合块)、预算、React/运行时原语、交互指标、追踪/CWV 证明、内存标记、降级契约、仪表盘/RUM 缺口和方案变更。在 slate-plan 内使用时,需在实现审查矩阵中记录该视角,并回答一系列必答问题。若无变更,需写出适用性 skipped、原因、证据和残余风险,原因必须引用当前方案证据,“无明显性能问题”不算证据。