核心工具速查
📁 文件操作
| Read | 读取文件 | “读取 src/App.js” |
| Write | 创建新文件 | “创建一个新的配置文件” |
| Edit | 修改文件 | “将函数名改为 newName” |
| Glob | 查找文件 | “找到所有 .tsx 文件” |
🔍 搜索工具
| Grep | 搜索内容 | “搜索所有 TODO 注释” |
| Glob | 文件名匹配 | “找到所有测试文件” |
💻 命令执行
| Bash | 执行命令 | “运行 npm test” |
| Git 操作 | “提交当前更改” | |
| 包管理 | “安装 axios” |
🤖 高级功能
| Task | 启动代理 | “探索认证相关代码” |
| LSP | 代码智能 | “跳转到定义” |
| TodoWrite | 任务管理 | 自动创建 |
常用命令模式
Git 工作流
"提交更改" → 自动分析 + 生成提交信息 + 提交
"创建 PR" → 分析分支 + 生成描述 + 创建 PR
"查看状态" → git status
"查看差异" → git diff
代码搜索
"搜索函数 X" → Grep 搜索
"找到所有 .js 文件" → Glob 查找
"显示 X 的使用" → Grep + content 模式
代码修改
"重命名 X 为 Y" → Grep 查找 + Edit 替换
"添加函数 X" → Read + Edit
"创建新文件 X" → Write
测试和构建
"运行测试" → npm test / pytest
"运行 lint" → npm run lint
"构建项目" → npm run build
文件操作模式
Read（读取）
✅ 用于：查看文件内容
✅ 何时：修改前、理解代码、调试
❌ 不用于：搜索多个文件（用 Grep）
Write（写入）
✅ 用于：创建新文件
❌ 不用于：修改现有文件（用 Edit）
⚠️ 注意：会覆盖现有文件
Edit（编辑）
✅ 用于：精确修改现有文件
✅ 特点：字符串替换、保持格式
⚠️ 注意：old_string 必须唯一
💡 技巧：提供更多上下文确保唯一
Grep 搜索模式
基础搜索
搜索文本：pattern="searchTerm"
忽略大小写：-i=true
文件类型：type="js" 或 glob="**/*.js"
输出模式
files_with_matches (默认) → 只显示文件名
content → 显示匹配行
count → 显示匹配数���
上下文显示
-A=3 → 显示后 3 行
-B=2 → 显示前 2 行
-C=5 → 显示前后各 5 行
正则表达式
函数定义：pattern="function\\\\s+\\\\w+"
类定义：pattern="class\\\\s+\\\\w+"
导入语句：pattern="import.*from"
Bash 命令模式
Git 命令
git status # 查看状态
git diff # 查看差异
git log –oneline -10 # 查看历史
git branch # 查看分支
git checkout <branch> # 切换分支
NPM 命令
npm install # 安装依赖
npm install <package> # 安装包
npm test # 运行测试
npm run build # 构建
npm run dev # 开发服务器
Python 命令
pip install <package> # 安装包
pytest # 运行测试
python script.py # 运行脚本
系统命令
ls -la # 列出文件
pwd # 当前目录
mkdir <dir> # 创建目录
rm <file> # 删除文件
任务复杂度指南
简单任务（直接执行）
- 单文件修改
- 简单搜索
- 运行单个命令
- 查看文件内容
中等任务（可能需要 TODO）
- 多文件修改
- 功能增强
- Bug 修复
- 3-5 个步骤
复杂任务（需要计划模式）
- 新功能实现
- 架构变更
- 大规模重构
- 多种实现方案
安全检查清单
Git 操作
- ✅ 提交前检查 git diff
- ✅ 不提交敏感文件（.env 等）
- ✅ 遵循项目提交风格
- ❌ 不强制推送到 main
- ❌ 不跳过 hooks
文件操作
- ✅ 修改前先读取
- ✅ 保持代码风格
- ✅ 验证重要更改
- ❌ 不盲目覆盖文件
命令执行
- ✅ 理解命令作用
- ✅ 路径有空格要引用
- ✅ 长命令设置超时
- ❌ 不执行危险命令
效率提升技巧
1. 并行操作
"同时运行测试和检查 git 状态"
→ Claude Code 并行执行
2. 清晰指令
好：在 src/App.js 的第 10 行添加 console.log
差：加个日志
3. 提供上下文
好：我在实现登录功能，需要保存 token 到 localStorage
差：保存 token
4. 分步骤
1. 先搜索相关代码
2. 理解现有实现
3. 再进行修改
5. 利用代理
"探索这个大型项目的架构"
→ 启动 Explore 代理系统性分析
常见错误和解决
Edit 失败
原因：old_string 不唯一或缩进不匹配
解决：提供更多上下文或使用 replace_all
找不到文件
原因：路径错误或文件不存在
解决：使用 Glob 搜索文件
命令超时
原因：命令运行时间过长
解决：增加 timeout 或后台运行
Git 冲突
原因：本地和远程有冲突
解决：先 pull，解决冲突，再 push
Glob 模式速查
**/*.js # 所有 JS 文件
**/*.{ts,tsx} # 所有 TS/TSX 文件
src/**/*.test.js # src 下的测试文件
**/config.* # 所有 config 文件
**/__tests__/** # 所有测试目录
components/**/*.jsx # components 下的 JSX
正则表达式速查
function\\\\s+\\\\w+ # 函数定义
class\\\\s+\\\\w+ # 类定义
import.*from # import 语句
export\\\\s+(default|const) # export 语句
console\\\\.log # console.log
TODO:|FIXME: # 注释标记
\\\\w+@\\\\w+\\\\.\\\\w+ # 邮箱地址
https?:// # URL
工作流程模板
功能开发流程
1. "探索相关代码" → 理解现有实现
2. "创建新分支" → git checkout -b
3. "实现功能" → 编写代码
4. "运行测试" → 验证功能
5. "提交更改" → git commit
6. "创建 PR" → gh pr create
Bug 修复流程
1. "搜索错误相关代码" → 定位问题
2. "读取相关文件" → 理解上下文
3. "修复 bug" → 修改代码
4. "运行测试" → 验证修复
5. "提交更改" → git commit
代码重构流程
1. "搜索需要重构的代码" → 找到所有位置
2. "分析影响范围" → 评估风险
3. "执行重构" → 修改代码
4. "运行测试" → 确保功能不变
5. "提交更改" → git commit
记住这些原则
快速命令参考
| 查看文件 | “读取 <文件路径>” |
| 搜索代码 | “搜索 <关键词>” |
| 修改代码 | “将 X 改为 Y” |
| 创建文件 | “创建 <文件名>” |
| 运行测试 | “运行测试” |
| 提交代码 | “提交更改” |
| 创建 PR | “创建 Pull Request” |
| 安装包 | “安装 <包名>” |
| 查看状态 | “git status” |
| 探索代码 | “探索 <功能> 相关代码” |
获取帮助
"如何使用 <功能>？"
"<工具> 的最佳实践是什么？"
"帮我理解这段代码"
"这个错误是什么意思？"
Claude Code 会根据上下文提供帮助和建议！
