mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-10 02:24:35 +08:00
refactor: remove MCP code-index dependency, replace with ripgrep/find
Replace all mcp__code-index__ calls with native ripgrep and find commands across workflow and command files for better performance and portability. Changes: - Remove 41 mcp__code-index__ function calls from 12 files - Replace with ripgrep (rg) for content search - Replace with find for file discovery - Remove index refresh dependencies (no longer needed) Modified files: - workflow/tools: context-gather, test-context-gather, task-generate-agent, task-generate, test-task-generate (core workflow tools) - workflow: review (security scanning) - memory: load, update-related, docs (memory management) - cli/mode: plan, bug-index, code-analysis (CLI modes) Documentation updates: - Simplify mcp-tool-strategy.md to only Exa usage (5 lines) - Streamline context-search-strategy.md to 69 lines - Standardize codebase-retrieval syntax per intelligent-tools-strategy.md Benefits: - Faster search with ripgrep (no index overhead) - Better cross-platform compatibility - Simpler configuration (fewer MCP dependencies) - -232 lines of code removed 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
catlog22
@@ -8,89 +8,61 @@ type: search-guideline
|
||||
|
||||
## ⚡ Execution Environment
|
||||
|
||||
**CRITICAL**: All commands execute in **Bash environment** (Git Bash on Windows, Bash on Linux/macOS)
|
||||
**CRITICAL**: All commands execute in **Bash environment** (Git Bash on Windows)
|
||||
|
||||
**❌ Forbidden**: Windows-specific commands (`findstr`, `dir`, `where`, `type`, `copy`, `del`) - Use Bash equivalents (`grep`, `find`, `which`, `cat`, `cp`, `rm`)
|
||||
**❌ Forbidden**: Windows commands (`findstr`, `dir`, `where`) - Use Bash (`grep`, `find`, `cat`)
|
||||
|
||||
## ⚡ Core Search Tools
|
||||
|
||||
**codebase-retrieval**: Semantic file discovery via Gemini CLI with all files analysis
|
||||
**rg (ripgrep)**: Fast content search with regex support
|
||||
**find**: File/directory location by name patterns
|
||||
**grep**: Built-in pattern matching in files
|
||||
**get_modules_by_depth.sh**: Program architecture analysis and structural discovery
|
||||
**grep**: Built-in pattern matching (fallback when rg unavailable)
|
||||
**get_modules_by_depth.sh**: Program architecture analysis (MANDATORY before planning)
|
||||
|
||||
### Decision Principles
|
||||
- **Use codebase-retrieval for semantic discovery** - Intelligent file discovery based on task context
|
||||
- **Use rg for content** - Fastest for searching within files
|
||||
- **Use find for files** - Locate files/directories by name
|
||||
- **Use grep sparingly** - Only when rg unavailable
|
||||
- **Use get_modules_by_depth.sh first** - MANDATORY for program architecture analysis before planning
|
||||
- **Always use Bash commands** - NEVER use Windows cmd/PowerShell commands
|
||||
|
||||
### Tool Selection Matrix
|
||||
## 📋 Tool Selection Matrix
|
||||
|
||||
| Need | Tool | Use Case |
|
||||
|------|------|----------|
|
||||
| **Semantic file discovery** | codebase-retrieval | Find files relevant to task/feature context |
|
||||
| **Semantic discovery** | codebase-retrieval | Find files relevant to task/feature context |
|
||||
| **Pattern matching** | rg | Search code content with regex |
|
||||
| **File name lookup** | find | Locate files by name patterns |
|
||||
| **Architecture analysis** | get_modules_by_depth.sh | Understand program structure |
|
||||
| **Architecture** | get_modules_by_depth.sh | Understand program structure |
|
||||
|
||||
## 🔧 Quick Command Reference
|
||||
|
||||
### Quick Command Reference
|
||||
```bash
|
||||
# Semantic File Discovery (codebase-retrieval)
|
||||
gemini "CONTEXT: @**/* List all files relevant to: [task/feature description]"
|
||||
bash(gemini "CONTEXT: @**/* List all files relevant to: [task/feature description]")
|
||||
cd [directory] && gemini -p "
|
||||
PURPOSE: Discover files relevant to task/feature
|
||||
TASK: List all files related to [task/feature description]
|
||||
MODE: analysis
|
||||
CONTEXT: @**/*
|
||||
EXPECTED: Relevant file paths with relevance explanation
|
||||
RULES: Focus on direct relevance to task requirements
|
||||
"
|
||||
|
||||
# Program Architecture Analysis (MANDATORY FIRST)
|
||||
~/.claude/scripts/get_modules_by_depth.sh # Discover program architecture
|
||||
bash(~/.claude/scripts/get_modules_by_depth.sh) # Analyze structural hierarchy
|
||||
# Program Architecture (MANDATORY FIRST)
|
||||
~/.claude/scripts/get_modules_by_depth.sh
|
||||
|
||||
# Content Search (rg preferred)
|
||||
rg "pattern" --type js # Search in JS files
|
||||
rg -i "case-insensitive" # Ignore case
|
||||
rg -n "show-line-numbers" # Show line numbers
|
||||
rg -A 3 -B 3 "context-lines" # Show 3 lines before/after
|
||||
rg "pattern" --type js -n # Search JS files with line numbers
|
||||
rg -i "case-insensitive" # Ignore case
|
||||
rg -C 3 "context" # Show 3 lines before/after
|
||||
|
||||
# File Search (find)
|
||||
find . -name "*.ts" -type f # Find TypeScript files
|
||||
# File Search
|
||||
find . -name "*.ts" -type f # Find TypeScript files
|
||||
find . -path "*/node_modules" -prune -o -name "*.js" -print
|
||||
|
||||
# Built-in alternatives
|
||||
grep -r "pattern" . # Recursive search (slower)
|
||||
grep -n -i "pattern" file.txt # Line numbers, case-insensitive
|
||||
# Workflow Examples
|
||||
rg "IMPL-\d+" .workflow/ --type json # Find task IDs
|
||||
find .workflow/ -name "*.json" -path "*/.task/*" # Locate task files
|
||||
rg "status.*pending" .workflow/.task/ # Find pending tasks
|
||||
```
|
||||
|
||||
### Workflow Integration Examples
|
||||
```bash
|
||||
# Semantic Discovery → Content Search → Analysis (Recommended Pattern)
|
||||
gemini "CONTEXT: @**/* List all files relevant to: [task/feature]" # Get relevant files
|
||||
rg "[pattern]" --type [filetype] # Then search within discovered files
|
||||
## ⚡ Performance Tips
|
||||
|
||||
# Program Architecture Analysis (MANDATORY BEFORE PLANNING)
|
||||
~/.claude/scripts/get_modules_by_depth.sh # Discover program architecture
|
||||
bash(~/.claude/scripts/get_modules_by_depth.sh) # Analyze structural hierarchy
|
||||
|
||||
# Search for task definitions
|
||||
rg "IMPL-\d+" .workflow/ --type json # Find task IDs
|
||||
find .workflow/ -name "*.json" -path "*/.task/*" # Locate task files
|
||||
|
||||
# Analyze workflow structure
|
||||
rg "status.*pending" .workflow/.task/ # Find pending tasks
|
||||
rg "depends_on" .workflow/.task/ -A 2 # Show dependencies
|
||||
|
||||
# Find workflow sessions
|
||||
find .workflow/ -name ".active-*" # Active sessions
|
||||
rg "WFS-" .workflow/ --type json # Session references
|
||||
|
||||
# Content analysis for planning
|
||||
rg "flow_control" .workflow/ -B 2 -A 5 # Flow control patterns
|
||||
find . -name "IMPL_PLAN.md" -exec grep -l "requirements" {} \;
|
||||
```
|
||||
|
||||
### Performance Tips
|
||||
- **rg > grep** for content search
|
||||
- **Use --type filters** to limit file types
|
||||
- **Exclude common dirs**: `--glob '!node_modules'`
|
||||
- **Use -F for literal** strings (no regex)
|
||||
- **Exclude dirs**: `--glob '!node_modules'`
|
||||
- **Use -F** for literal strings (no regex)
|
||||
|
||||
@@ -1,176 +1,11 @@
|
||||
# MCP Tool Strategy: Triggers & Workflows
|
||||
# MCP Tool Strategy: Exa Usage
|
||||
|
||||
## ⚡ Triggering Mechanisms
|
||||
## ⚡ Exa Triggering Mechanisms
|
||||
|
||||
**Auto-Trigger Scenarios**:
|
||||
**Auto-Trigger**:
|
||||
- User mentions "exa-code" or code-related queries → `mcp__exa__get_code_context_exa`
|
||||
- Need current web information → `mcp__exa__web_search_exa`
|
||||
- Finding code patterns/files → `mcp__code-index__search_code_advanced`
|
||||
- Locating specific files → `mcp__code-index__find_files`
|
||||
|
||||
**Manual Trigger Rules**:
|
||||
**Manual Trigger**:
|
||||
- Complex API research → Exa Code Context
|
||||
- Architecture pattern discovery → Exa Code Context + Gemini analysis
|
||||
- Real-time information needs → Exa Web Search
|
||||
- Codebase exploration → Code Index tools first, then Gemini analysis
|
||||
|
||||
## 🎯 Available MCP Tools
|
||||
|
||||
### Exa Code Context (mcp__exa__get_code_context_exa)
|
||||
**Purpose**: Search and get relevant context for programming tasks
|
||||
**Strengths**: Highest quality context for libraries, SDKs, and APIs
|
||||
**Best For**: Code examples, API patterns, learning frameworks
|
||||
|
||||
**Usage**:
|
||||
```bash
|
||||
mcp__exa__get_code_context_exa(
|
||||
query="React useState hook examples",
|
||||
tokensNum="dynamic" # or 1000-50000
|
||||
)
|
||||
```
|
||||
|
||||
**Examples**: "React useState", "Python pandas filtering", "Express.js middleware"
|
||||
|
||||
### Exa Web Search (mcp__exa__web_search_exa)
|
||||
**Purpose**: Real-time web searches with content scraping
|
||||
**Best For**: Current information, research, recent solutions
|
||||
|
||||
**Usage**:
|
||||
```bash
|
||||
mcp__exa__web_search_exa(
|
||||
query="latest React 18 features",
|
||||
numResults=5 # default: 5
|
||||
)
|
||||
```
|
||||
|
||||
|
||||
### Code Index Tools (mcp__code-index__)
|
||||
**核心方法**: `search_code_advanced`, `find_files`, `refresh_index`
|
||||
|
||||
**核心搜索**:
|
||||
```bash
|
||||
mcp__code-index__search_code_advanced(pattern="function.*auth", file_pattern="*.ts")
|
||||
mcp__code-index__find_files(pattern="*.test.js")
|
||||
mcp__code-index__refresh_index() # git操作后刷新
|
||||
```
|
||||
|
||||
**实用场景**:
|
||||
- **查找代码**: `search_code_advanced(pattern="old.*API")`
|
||||
- **定位文件**: `find_files(pattern="src/**/*.tsx")`
|
||||
- **更新索引**: `refresh_index()` (git操作后)
|
||||
|
||||
**文件搜索测试结果**:
|
||||
- ✅ `find_files(pattern="*.md")` - 搜索所有 Markdown 文件
|
||||
- ✅ `find_files(pattern="*complete*")` - 通配符匹配文件名
|
||||
- ❌ `find_files(pattern="complete.md")` - 精确匹配可能失败
|
||||
- 📝 建议使用通配符模式获得更好的搜索结果
|
||||
|
||||
## 📊 Tool Selection Matrix
|
||||
|
||||
| Task | MCP Tool | Use Case | Integration |
|
||||
|------|----------|----------|-------------|
|
||||
| **Code Context** | Exa Code | API examples, patterns | → Gemini analysis |
|
||||
| **Research** | Exa Web | Current info, trends | → Planning phase |
|
||||
| **Code Search** | Code Index | Pattern discovery, file location | → Gemini analysis |
|
||||
| **Navigation** | Code Index | File exploration, structure | → Architecture phase |
|
||||
|
||||
## 🚀 Integration Patterns
|
||||
|
||||
### Standard Workflow
|
||||
```bash
|
||||
# 1. Explore codebase structure
|
||||
mcp__code-index__find_files(pattern="*async*")
|
||||
mcp__code-index__search_code_advanced(pattern="async.*function", file_pattern="*.ts")
|
||||
|
||||
# 2. Get external context
|
||||
mcp__exa__get_code_context_exa(query="TypeScript async patterns", tokensNum="dynamic")
|
||||
|
||||
# 3. Analyze with Gemini
|
||||
cd "src/async" && gemini "
|
||||
PURPOSE: Understand async patterns
|
||||
CONTEXT: Code index results + Exa context + @src/async/**/*
|
||||
EXPECTED: Pattern analysis
|
||||
RULES: Focus on TypeScript best practices
|
||||
"
|
||||
|
||||
# 4. Implement with Codex
|
||||
codex -C src/async --full-auto exec "Apply modern async patterns" -s danger-full-access
|
||||
```
|
||||
|
||||
### Enhanced Planning
|
||||
1. **Explore codebase** with Code Index tools
|
||||
2. **Research** with Exa Web Search
|
||||
3. **Get code context** with Exa Code Context
|
||||
4. **Analyze** with Gemini
|
||||
5. **Architect** with Qwen
|
||||
6. **Implement** with Codex
|
||||
|
||||
## 🔧 Best Practices
|
||||
|
||||
### Code Index
|
||||
- **Search first** - Use before external tools for codebase exploration
|
||||
- **Refresh after git ops** - Keep index synchronized
|
||||
- **Pattern specificity** - Use precise regex patterns for better results
|
||||
- **File patterns** - Combine with glob patterns for targeted search
|
||||
- **Glob pattern matching** - Use `*.md`, `*complete*` patterns for file discovery
|
||||
- **Exact vs wildcard** - Exact names may fail, use wildcards for better results
|
||||
|
||||
### Exa Code Context
|
||||
- **Use "dynamic" tokens** for efficiency
|
||||
- **Be specific** - include technology stack
|
||||
- **MANDATORY** when user mentions exa-code or code queries
|
||||
|
||||
### Exa Web Search
|
||||
- **Default 5 results** usually sufficient
|
||||
- **Use for current info** - supplement knowledge cutoff
|
||||
|
||||
|
||||
|
||||
## 🎯 Common Scenarios
|
||||
|
||||
### Learning New Technology
|
||||
```bash
|
||||
# Explore existing patterns + get examples + research + analyze
|
||||
mcp__code-index__search_code_advanced(pattern="router|routing", file_pattern="*.ts")
|
||||
mcp__exa__get_code_context_exa(query="Next.js 14 app router", tokensNum="dynamic")
|
||||
mcp__exa__web_search_exa(query="Next.js 14 best practices 2024", numResults=3)
|
||||
cd "src/app" && gemini "Learn Next.js patterns"
|
||||
```
|
||||
|
||||
### Debugging
|
||||
```bash
|
||||
# Find similar patterns + solutions + fix
|
||||
mcp__code-index__search_code_advanced(pattern="similar.*error", file_pattern="*.ts")
|
||||
mcp__exa__get_code_context_exa(query="TypeScript generic constraints", tokensNum="dynamic")
|
||||
codex --full-auto exec "Fix TypeScript issues" -s danger-full-access
|
||||
```
|
||||
|
||||
### Codebase Exploration
|
||||
```bash
|
||||
# Comprehensive codebase understanding workflow
|
||||
mcp__code-index__set_project_path(path="/current/project") # 设置项目路径
|
||||
mcp__code-index__refresh_index() # 刷新索引
|
||||
mcp__code-index__find_files(pattern="*auth*") # Find auth-related files
|
||||
mcp__code-index__search_code_advanced(pattern="function.*auth", file_pattern="*.ts") # Find auth functions
|
||||
mcp__code-index__get_file_summary(file_path="src/auth/index.ts") # Understand structure
|
||||
cd "src/auth" && gemini "Analyze auth architecture"
|
||||
```
|
||||
|
||||
### Project Setup Workflow
|
||||
```bash
|
||||
# 新项目初始化流程
|
||||
mcp__code-index__set_project_path(path="/path/to/new/project")
|
||||
mcp__code-index__get_settings_info() # 确认设置
|
||||
mcp__code-index__refresh_index() # 建立索引
|
||||
mcp__code-index__configure_file_watcher(enabled=true) # 启用文件监控
|
||||
mcp__code-index__get_file_watcher_status() # 确认监控状态
|
||||
```
|
||||
|
||||
## ⚡ Performance Tips
|
||||
|
||||
- **Code Index first** → explore codebase before external tools
|
||||
- **Use "dynamic" tokens** for Exa Code Context
|
||||
- **MCP first** → gather context before analysis
|
||||
- **Focus queries** - avoid overly broad searches
|
||||
- **Integrate selectively** - use relevant context only
|
||||
- **Refresh index** after major git operations
|
||||
Reference in New Issue
Block a user