code-search

分类: 工具与效率 | 上传者: sumisingh10 | 下载: 0 | 版本: v1.0（最新）

当用户要求“搜索代码”、“在文件中查找”、“grep for”、“查找模式”、“搜索代码库”、“查找引用”、“查找用法”、“搜索函数”、“查找定义 X 的位置”或需要在目录树中搜索文件内容时，应使用此技能。提供有关使用 search_code MCP 工具进行快速索引代码搜索的指南。

更新日志: Source: GitHub https://github.com/sumisingh10/qgrep-mcp

目录结构

当前层级: tree/main/skills/code-search/

📄 SKILL.md 3.3 KB

SKILL.md

---
name: code-search
description: This skill should be used when the user asks to "search code", "find in files", "grep for", "look for pattern", "search the codebase", "find references to", "find usages of", "search for function", "find where X is defined", or needs to search file contents across a directory tree. Provides guidance on using the search_code MCP tool for fast indexed code search.
version: 0.1.0
---

# Indexed Code Search

This skill provides fast indexed code search via the `search_code` MCP tool, which is up to 300x faster than standard grep on large codebases.

## When to Use search_code

Prefer the `search_code` MCP tool over the built-in Grep tool when searching file contents across a directory tree. The `search_code` tool automatically selects the fastest backend:

- On large repos (15k+ files), it builds and uses a qgrep index. Searches complete in ~10ms instead of ~3-25s
- On small repos (< 5k files), it transparently falls back to ripgrep
- In the gray zone (5k-15k files), it measures ripgrep latency and indexes if beneficial

## Available MCP Tools

### search_code

Primary search tool. Supports regex patterns, glob filters, case-insensitive search, and context lines.

```
search_code(pattern="impl Iterator for", path="/path/to/repo")
search_code(pattern="TODO|FIXME", path="/path/to/repo", case_insensitive=True)
search_code(pattern="class.*Handler", path="/path/to/repo", glob="*.py")
search_code(pattern="fn main", path="/path/to/repo", output_mode="files_with_matches")
```

Parameters:
- `pattern` (required): Regex pattern to search for
- `path` (required): Absolute directory path to search in
- `glob`: Filter files (e.g. `"*.py"`, `"*.{ts,tsx}"`)
- `case_insensitive`: Case-insensitive search (default: false)
- `output_mode`: `"content"` (default), `"files_with_matches"`, or `"count"`
- `context_lines`: Lines of context around matches
- `max_results`: Maximum result lines (default: 200)

### build_search_index

Manage the search index lifecycle. Build an index before searching to get maximum speed.

```
build_search_index(action="build", path="/path/to/repo")
build_search_index(action="status", path="/path/to/repo")
build_search_index(action="rebuild", path="/path/to/repo")
build_search_index(action="delete", path="/path/to/repo")
```

### search_estimate

Analyze a directory and get an indexing recommendation with stats.

```
search_estimate(path="/path/to/repo")
```

Returns file count, current search latency stats, and whether building an index is worthwhile.

## Performance Characteristics

Based on benchmarks against rust-lang/rust (58,534 files):

| Backend | Avg latency | When used |
|---------|-------------|-----------|
| qgrep (indexed) | ~12ms | Index exists or auto-built for large repos |
| ripgrep (fallback) | ~2.9s | Small repos, glob filters, context lines |

Index build is a one-time cost (~7s for 58k files) that pays for itself after ~3 searches.

## Automatic Behavior

The `search_code` tool handles backend selection automatically:

1. If an index exists for the target path, use qgrep
2. If the repo has 15k+ files and no index, build one automatically
3. For glob filters or context lines, use ripgrep (qgrep limitation)
4. For small repos, use ripgrep directly (fast enough)

No manual index management is needed for typical usage. Just call `search_code` and it handles the rest.

登录后下载/点赞/收藏 ❤ 5 | ★ 0

code-search

目录结构

SKILL.md

举报内容

提示