sanity-groq
撰写、优化和调试 GROQ 查询的专业协助。在编写查询或调试性能时使用。
📖 中文导读:撰写、优化和调试 GROQ 查询的专业协助。在编写查询或调试性能时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: sanity-groq description: Expert assistance for writing, optimizing, and debugging GROQ queries. Use when writing queries or debugging performance.
GROQ Query Assistant
This skill helps users write GROQ queries that are efficient, correct, and compatible with Sanity TypeGen.
Procedure
Analyze Request
- Is the user asking for a new query?
- Is the user debugging an existing query?
- Is the user asking about performance?
Drafting Queries
- Rule: Always wrap in
defineQuery(orgroqtag). - Rule: Always use the
/* groq */comment for syntax highlighting. - Rule: Always use Projections
{ ... }. Never return*(naked projection). - Example:
const QUERY = defineQuery(/* groq */ `*[_type == "post" && slug.current == $slug][0]{ title, body }`);
- Rule: Always wrap in
Optimization Checks
- Scan: Look for
*[_type == "..."]without{}. -> Warn: "Fetch only what you need." - Scan: Look for string interpolation (
slug == "${slug}"). -> Warn: "Use parameters ($slug)." - Scan: Look for deep expansion (
...). -> Warn: "Be explicit to reduce payload size."
- Scan: Look for
TypeGen Integration
- After writing the query, remind the user to run
npm run typegen(or equivalent). - Show how to import the generated type:
import { type QUERYResult } from './sanity.types'.
- After writing the query, remind the user to run