AgentSkillsCN

api-response-compressor

通过选择/分页、压缩与缓存头，减少API响应的负载大小。在响应较大（>100KB）或高流量时使用此功能。

SKILL.md
--- frontmatter
name: api-response-compressor
description: Reduces API payload size via select/pagination, compression, and caching headers. Use when responses are large (>100KB) or high-traffic.

API Response Compressor

When to Trigger

  • •Large API responses (>100 KB)
  • •High-traffic endpoints
  • •"Optimize API"

What to Do

  1. •Select: Return only needed fields (Prisma select); avoid deep include of unused relations.
  2. •Pagination: Enforce limit and offset/cursor; return meta (total, page, hasMore).
  3. •Compression: Enable gzip/brotli in Next.js or hosting; set Content-Encoding when applicable.
  4. •Headers: Cache-Control for cacheable responses (e.g. s-maxage, stale-while-revalidate).

Don’t break existing clients; add fields optionally (e.g. ?fields=) if needed. Measure response size before/after.