mcpField
P
performance-expert

performance-expert

github.com/shipshitdev开发38208 次安装2 天前更新
代码仓库

关于 performance-expert

面向开发者的后端与交付层性能诊断技能,可分析缓慢的端点、查询、任务、构建产物或指标。它按优先级列出瓶颈并建议针对性修复,React 渲染问题则交由专门技能处理。

主要功能

  1. 01诊断后端和数据库瓶颈
  2. 02审查缓存与后台任务
  3. 03分析包体积和资源交付
  4. 04建议测量方法与针对性修复
  5. 05转交 React 渲染问题

适用场景

  1. 01排查缓慢的 API 端点或数据库查询
  2. 02查找 N+1 查询模式和索引机会
  3. 03评估缓存或后台任务方案
  4. 04分析包体积和资源交付

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/shipshitdev/skills --skill performance-expert

安装后在 Claude Code 中输入/performance-expert确认已加载。

附带文件plugin.jsonreferences/full-guide.md

详细介绍

性能专家技能

后端、数据库和基础设施性能。此技能负责技术栈的服务端和交付层:请求延迟、数据访问、缓存、后台工作,以及通过网络传输的内容。

React 组件内部的渲染时工作——重新渲染、记忆化、虚拟列表、Profiler 跟踪——需要不同的诊断方式和工具。请将这类问题交给 react-component-performance,而不是在此重复处理。

约定

输入:

  • 带有作用范围的性能问题:端点、查询、作业、构建产物,或发生退化的指标。

输出:

  • 按优先级排列的瓶颈列表,列出证明每个瓶颈的测量数据,并为每个瓶颈提供有针对性的修复方案。

创建/修改:

  • 无。此技能只负责诊断和提出方案;编辑工作在调用方的工作流中进行。

外部副作用:

  • 无。提供分析和负载测试命令,但不会在无人监督的情况下执行。

委派给:

  • React 渲染热点、重新渲染频繁、记忆化和由 Profiler 驱动的组件优化,交给 react-component-performance。
  • 目标是整个 monorepo,而非单个作用范围时,交给 workspace-performance-audit。

适用场景

  • 提升 API 响应速度
  • 优化数据库查询、索引和聚合
  • 诊断 N+1 查询模式
  • 实现缓存策略和失效机制
  • 将繁重工作移至后台作业或队列
  • 分析服务器进程,或跟踪缓慢请求
  • 分析已交付的 Bundle 大小和资源交付情况
  • 配置 CDN、缓存标头或边缘缓存

项目上下文发现

  1. 检查 .agents/memory/ 中的性能架构上下文(例如任何 *performance* 或 *architecture* 文件)
  2. 识别性能工具(APM、负载测试工具、分析器)
  3. 查看现有优化和缓存策略
  4. 检查是否存在 [project]-performance-expert 技能

核心性能原则

后端

**API 响应时间:**目标 < 200ms(p95),使用缓存、后台作业和连接池

**查询优化:**索引、投影(select)、分页、数据库端聚合

**后台处理:**繁重操作使用队列,非关键任务使用异步处理,请求处理程序中不执行阻塞工作

数据库

**索引:**为频繁查询的字段创建索引,使用复合索引,并监控索引使用情况

**查询:**在 where 中筛选,只 select 所需列,使用索引排序,避免顺序扫描

基础设施

**CDN:**边缘缓存、正确的缓存标头、静态资源不从源站提供

**无服务器:**优化冷启动、内存分配和预置并发

交付层

**Bundle:**按路由拆分代码,为大型模块使用动态导入,进行 Tree Shaking,移除未使用的依赖项

**资源:**使用 WebP 图片、子集化字体、压缩 CSS/JS、使用 Gzip/Brotli 压缩

**服务器端渲染:**静态内容使用静态生成、增量重新验证、使用框架的图像和字体处理管线

性能指标

后端
  • API p50:< 100ms
  • API p95:< 200ms
  • DB 查询 p95:< 50ms
  • 错误率:< 0.1%
交付
  • LCP:< 2.5s
  • TTFB:< 800ms
  • 初始 Bundle:< 200KB

快速检查清单

后端
  • 已优化数据库查询
  • 已创建并使用索引
  • 已实现缓存
  • 繁重操作已使用后台作业
  • 已配置连接池
交付
  • 初始 Bundle 大小 < 200KB
  • 已实现代码拆分
  • 图片已优化并延迟加载
  • 已配置压缩和缓存标头

在报告测得的提速或性能退化之前,请使用 pstack 技能的基准测试检查清单参考来核实数据:指出限制因素,确认每一侧都已调优,统计错误,并重复运行测试。


有关数据库查询优化代码、缓存策略实现、N+1 查询解决方案、后台作业模式、基础设施调优、性能测试命令和详细检查清单,请参阅: references/full-guide.md

评论

支持 Markdown