mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-05 01:50:27 +08:00
b22839c99f
- Fixed API endpoint mismatches in mcp-manager.js to ensure global install/update buttons function correctly. - Corrected undefined function references in mcp-manager.js for project installation. - Refactored event handling to eliminate global scope pollution in mcp-manager.js. - Added comprehensive debugging guide for MCP installation issues. - Implemented a session path resolver to infer content types from filenames and paths, improving usability. - Introduced tests for embeddings improvements in init and status commands to verify functionality.
2.0 KiB
2.0 KiB
File Modification
Before modifying files, always:
- Try built-in Edit tool first
- Escalate to MCP tools when built-ins fail
- Use write_file only as last resort
MCP Tools Usage
edit_file - Modify Files
When: Built-in Edit fails, need dry-run preview, or need line-based operations
How:
edit_file(path="/file.ts", oldText="old", newText="new") // Replace text
edit_file(path="/file.ts", oldText="old", newText="new", dryRun=true) // Preview diff
edit_file(path="/file.ts", oldText="old", newText="new", replaceAll=true) // Replace all
edit_file(path="/file.ts", mode="line", operation="insert_after", line=10, text="new line")
edit_file(path="/file.ts", mode="line", operation="delete", line=5, end_line=8)
Modes: update (replace text, default), line (line-based operations)
Operations (line mode): insert_before, insert_after, replace, delete
write_file - Create/Overwrite Files
When: Create new files, completely replace content, or edit_file still fails
How:
write_file(path="/new-file.ts", content="file content here")
write_file(path="/existing.ts", content="...", backup=true) // Create backup first
Priority Logic
File Reading:
- Known single file → Built-in Read
- Multiple files OR pattern matching → smart_search (MCP)
- Unknown location → smart_search then Read
- Large codebase + repeated access → smart_search (indexed)
File Editing:
- Always try built-in Edit first
- Fails 1+ times → edit_file (MCP)
- Still fails → write_file (MCP)
Search:
- External knowledge → Exa (MCP)
- Exact pattern in small codebase → Built-in Grep
- Semantic/unknown location → smart_search (MCP)
- Large codebase + repeated searches → smart_search (indexed)
Decision Triggers
Start with simplest tool (Read, Edit, Grep) Escalate to MCP tools when built-ins fail or inappropriate Use semantic search for exploratory tasks Use indexed search for large, stable codebases Use Exa for external/public knowledge