grepai-search-tips by yoanbernabeu/grepai-skills
npx skills add https://github.com/yoanbernabeu/grepai-skills --skill grepai-search-tips此技能提供编写有效语义搜索查询的提示和最佳实践。
与文本搜索的思维方式不同:
| 文本搜索 (grep) | 语义搜索 (GrepAI) |
|---|---|
| 搜索确切的文本 | 搜索含义/意图 |
| "getUserById" | "retrieve user from database by ID" |
| 字面匹配 | 概念匹配 |
❌ 不佳: getUserById ✅ 良好: fetch user record from database using ID
❌ 不佳: handleError ✅
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
error handling and response to client❌ 不佳: validateInput ✅ 良好: check if user input is valid and safe
❌ 不佳: auth ✅ 良好: user authentication and authorization
❌ 不佳: db ✅ 良好: database connection and queries
❌ 不佳: config ✅ 良好: application configuration loading
❌ 不佳: validation ✅ 良好: validate email address format
❌ 不佳: parse ✅ 良好: parse JSON request body
❌ 不佳: send ✅ 良好: send email notification to user
| 长度 | 示例 | 质量 |
|---|---|---|
| 太短 | "auth" | ⚠️ 模糊 |
| 良好 | "user authentication middleware" | ✅ 具体 |
| 太长 | "the code that handles user authentication and validates JWT tokens in the middleware layer" | ⚠️ 冗长 |
嵌入模型主要使用英语训练:
❌ authentification utilisateur (法语) ✅ user authentication
即使您的代码注释是其他语言,英语查询效果最佳。
grepai search "validate user credentials before login"
grepai search "send notification when order is placed"
grepai search "calculate total price with discounts"
grepai search "retry failed HTTP requests"
grepai search "middleware that checks authentication"
grepai search "function that formats dates"
grepai search "service that sends emails"
grepai search "handler for payment processing"
grepai search "handle errors from API calls"
grepai search "catch and log exceptions"
grepai search "error response to client"
grepai search "validation error messages"
grepai search "save user to database"
grepai search "query products by category"
grepai search "cache frequently accessed data"
grepai search "transform data before storage"
grepai search "load configuration from environment"
grepai search "database connection settings"
grepai search "API keys and secrets management"
grepai search "feature flags and toggles"
grepai search "password hashing and verification"
grepai search "input sanitization to prevent injection"
grepai search "rate limiting for API endpoints"
grepai search "CORS configuration"
如果结果不理想,请迭代优化:
grepai search "authentication"
# 结果过于多样
grepai search "JWT authentication"
# 更好,但仍然宽泛
grepai search "JWT token validation middleware"
# 精确的结果
语义搜索理解同义词。尝试不同的表达方式:
# 这些可能返回相似的结果:
grepai search "user authentication"
grepai search "user login verification"
grepai search "credential validation"
grepai search "identity verification"
使用您的领域词汇:
# 电子商务
grepai search "shopping cart checkout process"
grepai search "inventory stock management"
# 金融
grepai search "transaction processing"
grepai search "payment reconciliation"
# 医疗保健
grepai search "patient record retrieval"
grepai search "appointment scheduling"
自然的问题效果很好:
grepai search "how are users authenticated"
grepai search "where is the database connection configured"
grepai search "what happens when a request fails"
grepai search "how are errors logged"
如果您知道确切名称,请使用 grep:
grep -r "getUserById" . # 文本搜索
GrepAI 适用于您不知道确切名称的情况:
grepai search "retrieve user from database" # 语义搜索
# 太抽象
grepai search "business logic"
# 更具体
grepai search "calculate order total with tax"
# 不要这样做
grepai search "function() { return }"
# 这样做
grepai search "function that returns early"
# 过度指定(提及无关细节)
grepai search "async function in TypeScript file that uses axios to fetch"
# 更好
grepai search "fetch data from external API"
强匹配。代码很可能执行了您描述的操作。
相关代码。可能是您想要的,或是相邻的功能。
松散相关。考虑优化您的查询。
弱匹配。概念可能不存在于代码库中,或者查询需要重写。
grepai status| 场景 | 查询风格 |
|---|---|
| 知道行为 | "validates email format" |
| 知道领域 | "payment processing flow" |
| 探索 | "how errors are handled" |
| 查找入口点 | "main application startup" |
| 查找依赖项 | "where database is connected" |
技巧摘要:
📝 GrepAI 搜索技巧
✅ 应该做:
- 描述意图,而非实现
- 使用 3-7 个描述性词语
- 使用英语查询
- 迭代和优化
❌ 不应该做:
- 使用确切的函数名(使用 grep)
- 写太短的查询("auth")
- 写太长的查询
- 在查询中使用代码语法
示例转换:
"auth" → "user authentication and login"
"getUserById" → "fetch user by ID from database"
"handleError" → "error handling and logging"
每周安装量
312
代码仓库
GitHub 星标数
15
首次出现
Jan 28, 2026
安全审计
安装于
opencode252
codex244
gemini-cli228
github-copilot226
kimi-cli211
amp209
This skill provides tips and best practices for writing effective semantic search queries.
Think differently from text search:
| Text Search (grep) | Semantic Search (GrepAI) |
|---|---|
| Search for exact text | Search for meaning/intent |
| "getUserById" | "retrieve user from database by ID" |
| Literal match | Conceptual match |
❌ Bad: getUserById ✅ Good: fetch user record from database using ID
❌ Bad: handleError ✅ Good: error handling and response to client
❌ Bad: validateInput ✅ Good: check if user input is valid and safe
❌ Bad: auth ✅ Good: user authentication and authorization
❌ Bad: db ✅ Good: database connection and queries
❌ Bad: config ✅ Good: application configuration loading
❌ Bad: validation ✅ Good: validate email address format
❌ Bad: parse ✅ Good: parse JSON request body
❌ Bad: send ✅ Good: send email notification to user
| Length | Example | Quality |
|---|---|---|
| Too short | "auth" | ⚠️ Vague |
| Good | "user authentication middleware" | ✅ Specific |
| Too long | "the code that handles user authentication and validates JWT tokens in the middleware layer" | ⚠️ Verbose |
Embedding models are trained primarily on English:
❌ authentification utilisateur (French) ✅ user authentication
Even if your code comments are in another language, English queries work best.
grepai search "validate user credentials before login"
grepai search "send notification when order is placed"
grepai search "calculate total price with discounts"
grepai search "retry failed HTTP requests"
grepai search "middleware that checks authentication"
grepai search "function that formats dates"
grepai search "service that sends emails"
grepai search "handler for payment processing"
grepai search "handle errors from API calls"
grepai search "catch and log exceptions"
grepai search "error response to client"
grepai search "validation error messages"
grepai search "save user to database"
grepai search "query products by category"
grepai search "cache frequently accessed data"
grepai search "transform data before storage"
grepai search "load configuration from environment"
grepai search "database connection settings"
grepai search "API keys and secrets management"
grepai search "feature flags and toggles"
grepai search "password hashing and verification"
grepai search "input sanitization to prevent injection"
grepai search "rate limiting for API endpoints"
grepai search "CORS configuration"
If results aren't good, iterate:
grepai search "authentication"
# Results too varied
grepai search "JWT authentication"
# Better, but still broad
grepai search "JWT token validation middleware"
# Precise results
Semantic search understands synonyms. Try different phrasings:
# These may return similar results:
grepai search "user authentication"
grepai search "user login verification"
grepai search "credential validation"
grepai search "identity verification"
Use your domain vocabulary:
# E-commerce
grepai search "shopping cart checkout process"
grepai search "inventory stock management"
# Finance
grepai search "transaction processing"
grepai search "payment reconciliation"
# Healthcare
grepai search "patient record retrieval"
grepai search "appointment scheduling"
Natural questions work well:
grepai search "how are users authenticated"
grepai search "where is the database connection configured"
grepai search "what happens when a request fails"
grepai search "how are errors logged"
If you know the exact name, use grep:
grep -r "getUserById" . # Text search
GrepAI is for when you don't know the exact name:
grepai search "retrieve user from database" # Semantic search
# Too abstract
grepai search "business logic"
# More concrete
grepai search "calculate order total with tax"
# Don't do this
grepai search "function() { return }"
# Do this
grepai search "function that returns early"
# Over-specified (mentions irrelevant details)
grepai search "async function in TypeScript file that uses axios to fetch"
# Better
grepai search "fetch data from external API"
Strong match. The code likely does what you described.
Related code. May be what you want, or adjacent functionality.
Loosely related. Consider refining your query.
Weak match. The concept may not exist in the codebase, or query needs rework.
grepai status| Situation | Query Style |
|---|---|
| Know the behavior | "validates email format" |
| Know the domain | "payment processing flow" |
| Exploring | "how errors are handled" |
| Finding entry points | "main application startup" |
| Finding dependencies | "where database is connected" |
Tips summary:
📝 GrepAI Search Tips
✅ DO:
- Describe intent, not implementation
- Use 3-7 descriptive words
- Use English queries
- Iterate and refine
❌ DON'T:
- Use exact function names (use grep)
- Write too short queries ("auth")
- Write too long queries
- Use code syntax in queries
Example transformations:
"auth" → "user authentication and login"
"getUserById" → "fetch user by ID from database"
"handleError" → "error handling and logging"
Weekly Installs
312
Repository
GitHub Stars
15
First Seen
Jan 28, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykPass
Installed on
opencode252
codex244
gemini-cli228
github-copilot226
kimi-cli211
amp209
React 组合模式指南:Vercel 组件架构最佳实践,提升代码可维护性
105,000 周安装