关于 performance-expert
面向开发者的后端与交付层性能诊断技能,可分析缓慢的端点、查询、任务、构建产物或指标。它按优先级列出瓶颈并建议针对性修复,React 渲染问题则交由专门技能处理。
主要功能
- 01诊断后端和数据库瓶颈
- 02审查缓存与后台任务
- 03分析包体积和资源交付
- 04建议测量方法与针对性修复
- 05转交 React 渲染问题
适用场景
- 01排查缓慢的 API 端点或数据库查询
- 02查找 N+1 查询模式和索引机会
- 03评估缓存或后台任务方案
- 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、缓存标头或边缘缓存
项目上下文发现
- 检查
.agents/memory/中的性能架构上下文(例如任何*performance*或*architecture*文件) - 识别性能工具(APM、负载测试工具、分析器)
- 查看现有优化和缓存策略
- 检查是否存在
[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