mirror of https://github.com/catlog22/Claude-Code-Workflow.git synced 2026-02-10 02:24:35 +08:00

Files

catlog22 675aff26ff feat(mcp): add read_file tool and simplify edit/write returns

- edit_file: truncate diff to 15 lines, compact result format
- write_file: return only path/bytes/message
- read_file: new tool with multi-file, directory, regex support
  - paths: single file, array, or directory
  - pattern: glob filter (*.ts)
  - contentPattern: regex content search
  - maxDepth, maxFiles, includeContent options
- Update tool-strategy.md documentation

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2025-12-13 17:28:03 +08:00

2.6 KiB

Raw Blame History

Tool Strategy

⚡ Exa Triggering Mechanisms

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

Manual Trigger:

Complex API research → Exa Code Context
Real-time information needs → Exa Web Search

⚡ CCW MCP Tools

edit_file

When to Use: Edit tool fails 1+ times on same file

mcp__ccw-tools__edit_file(path="file.py", oldText="old", newText="new")
mcp__ccw-tools__edit_file(path="file.py", oldText="old", newText="new", dryRun=true)
mcp__ccw-tools__edit_file(path="file.py", oldText="old", newText="new", replaceAll=true)
mcp__ccw-tools__edit_file(path="file.py", mode="line", operation="insert_after", line=10, text="new line")

Options: dryRun (preview diff), replaceAll, mode (update|line), operation, line, text

write_file

When to Use: Create new files or overwrite existing content

mcp__ccw-tools__write_file(path="file.txt", content="Hello")
mcp__ccw-tools__write_file(path="file.txt", content="code with `backticks` and ${vars}", backup=true)

Options: backup, createDirectories, encoding

read_file

When to Use: Read multiple files, directory traversal, content search

mcp__ccw-tools__read_file(paths="file.ts")                         # Single file
mcp__ccw-tools__read_file(paths=["a.ts", "b.ts"])                  # Multiple files
mcp__ccw-tools__read_file(paths="src/", pattern="*.ts")            # Directory + glob
mcp__ccw-tools__read_file(paths="src/", contentPattern="TODO")     # Regex search

Options: pattern, contentPattern, maxDepth (3), includeContent (true), maxFiles (50)

codex_lens

When to Use: Code indexing and semantic search

mcp__ccw-tools__codex_lens(action="init", path=".")
mcp__ccw-tools__codex_lens(action="search", query="function main", path=".")
mcp__ccw-tools__codex_lens(action="search_files", query="pattern", limit=20)
mcp__ccw-tools__codex_lens(action="symbol", file="src/main.py")

Actions: init, search, search_files, symbol, status, update

smart_search

When to Use: Quick search without indexing, natural language queries

mcp__ccw-tools__smart_search(query="function main", path=".")
mcp__ccw-tools__smart_search(query="def init", mode="exact")
mcp__ccw-tools__smart_search(query="authentication logic", mode="semantic")

Modes: auto (default), exact, fuzzy, semantic, graph

Fallback Strategy

Edit fails 1+ times → mcp__ccw-tools__edit_file
Still fails → mcp__ccw-tools__write_file

2.6 KiB Raw Blame History