AgentSkillsCN

searcher

当用户希望通过文本内容搜索文件、查找包含特定文本的文件，或获取与搜索词相关的文件路径列表时，可使用此技能。该技能将在代码库中进行搜索，并返回带有上下文信息的匹配文件路径。

SKILL.md
--- frontmatter
name: searcher
description: Use this skill when the user wants to search for files by text content, find files containing specific text, or get a list of file paths related to a search term. The skill searches the codebase and returns matching file paths with context.
version: 0.1.0

File Searcher Skill

This skill searches for files in the codebase based on text content and returns a list of matching file paths.

Core Principles

  1. •Use Grep tool: Always use the Grep tool for searching - never use bash grep/rg commands
  2. •Return file paths: Provide a clear list of file paths that match the search criteria
  3. •Include context: Show relevant context (line numbers, matching lines) to help users understand results
  4. •Flexible search: Support different search modes (content, files_only, count)

Search Workflow

Step 1: Understand the Search Request

Clarify what the user wants to find:

  • •Text/Pattern: The specific text or regex pattern to search for
  • •Scope: Entire codebase or specific directory
  • •File Type: Optional filter (e.g., only .py, .js files)

Step 2: Choose the Appropriate Search Mode

Use Grep with these parameters:

ParameterDescriptionCommon Values
patternThe search term or regexUser's search text
output_modeWhat to returnfiles_with_matches (default), content, count
pathDirectory to searchCurrent directory or specific path
globFilter by file pattern*.py, **/*.js, etc.
typeFilter by file typepy, js, ts, etc.
-iCase insensitive searchtrue or false
-CContext linesNumber of lines before/after match

Step 3: Execute the Search

markdown
Use Grep tool with:
- pattern: <search term>
- output_mode: "files_with_matches" for just file paths, "content" for lines with context

Step 4: Present Results

Format the output clearly:

  • •Matching files: List all file paths found
  • •Match count: Total number of files
  • •Excerpts (optional): Show relevant lines from matches
  • •Next steps: Suggest actions like "Read specific file", "Narrow search", etc.

Common Search Patterns

Find files containing specific text

code
Grep: pattern="search term", output_mode="files_with_matches"

Find text with context (showing matching lines)

code
Grep: pattern="search term", output_mode="content", -C=2

Case-insensitive search

code
Grep: pattern="search term", -i=true

Search specific file types

code
Grep: pattern="search term", type="py"
Grep: pattern="search term", glob="*.md"

Count matches per file

code
Grep: pattern="search term", output_mode="count"

Example Usage

User request: "Find all files that contain 'TODO' comments"

Skill response:

  1. •Search: Grep: pattern="TODO", output_mode="content", -C=1
  2. •Results: List file paths with TODO lines and line numbers
  3. •Summary: "Found 5 files with TODO comments"

User request: "Search for 'function' in Python files only"

Skill response:

  1. •Search: Grep: pattern="function", type="py", output_mode="files_with_matches"
  2. •Results: List matching .py files
  3. •Summary: "Found 3 Python files containing 'function'"

Tips for Better Searches

  • •Start broad: Use files_with_matches first, then drill down with content mode
  • •Use regex patterns: Grep supports full regex syntax for complex searches
  • •Filter by type: Use type or glob to narrow search scope
  • •Case sensitivity: Use -i=true when the exact case doesn't matter
  • •Context: Use -C to see lines around matches for better understanding