serena-code

# Serena代码分析工具

## 🎯 垂直职责
**单一职责**: 符号级代码探索、搜索、编辑和重构

## 📦 核心能力

### 1. 代码探索
| 工具 | 用途 | 示例 |
|------|------|------|
| `list_dir` | 列出目录内容 | 列出`ep21/src/main/java` |
| `find_file` | 查找文件 | 查找`*Optimizer.java` |
| `get_symbols_overview` | 获取文件符号概览 | 查看类的所有方法 |
| `find_symbol` | 按名称查找符号 | 查找`SSAGraph`类 |
| `search_for_pattern` | 模式搜索 | 搜索`extends.*Optimizer` |

### 2. 代码编辑
| 工具 | 用途 | 示例 |
|------|------|------|
| `replace_symbol_body` | 替换符号体 | 重写整个方法 |
| `insert_after_symbol` | 符号后插入 | 添加新方法 |
| `insert_before_symbol` | 符号前插入 | 添加导入 |
| `rename_symbol` | 重命名符号 | 重命名类/方法/字段 |

### 3. 项目理解
| 工具 | 用途 | 示例 |
|------|------|------|
| `read_memory` | 读取项目记忆 | 读取`EP21_TECH_MEM.md` |
| `write_memory` | 写入项目记忆 | 更新技术文档 |
| `list_memories` | 列出所有记忆 | 查看可用记忆 |

### 4. 智能思考
| 工具 | 用途 | 触发时机 |
|------|------|----------|
| `think_about_collected_information` | 分析收集信息 | 搜索后 |
| `think_about_task_adherence` | 检查任务一致性 | 编辑前 |
| `think_about_whether_you_are_done` | 判断完成状态 | 任务结束 |

## 🔗 关系图
→ **无依赖** (独立工具集)
← **所有技能依赖** (被广泛使用)

## 🚀 使用流程

### 标准代码探索流程
```bash
# 1. 获取符号概览 (避免读取整个文件)
mcp__serena__get_symbols_overview("ep21/src/main/java/.../SSAGraph.java")

# 2. 查找特定符号
mcp__serena__find_symbol("SSAGraph", relative_path="ep21", depth=1)

# 3. 读取符号体 (仅读需要的部分)
mcp__serena__find_symbol("computeDominators", include_body=true)

# 4. 查找引用
mcp__serena__find_referencing_symbols("computeDominators", "SSAGraph.java")

# 5. 分析信息
mcp__serena__think_about_collected_information()
```

### 符号级编辑流程
```bash
# 1. 定位符号
mcp__serena__find_symbol("methodName", include_body=true)

# 2. 检查任务一致性
mcp__serena__think_about_task_adherence()

# 3. 替换符号体
mcp__serena__replace_symbol_body("methodName", newBody)

# 4. 验证完成
mcp__serena__think_about_whether_you_are_done()
```

### 项目记忆更新流程
```bash
# 1. 读取现有记忆
mcp__serena__read_memory("EP21_TECH_MEM.md")

# 2. 更新内容
mcp__serena__edit_memory("EP21_TECH_MEM.md", needle, repl, "literal")

# 3. 或完全重写
mcp__serena__write_memory("EP21_TECH_MEM.md", newContent)
```

## 📊 效率对比

| 操作 | 传统工具 | Serena工具 | 节省 |
|------|----------|------------|------|
| 查找方法 | grep + Read | `find_symbol` | 60% |
| 理解类结构 | Read (300行) | `get_symbols_overview` | 85% |
| 重构方法 | Edit (行号) | `replace_symbol_body` | 50% |
| 跨文件引用 | grep全局 | `find_referencing_symbols` | 70% |

## ⚠️ 最佳实践

### ✅ 使用符号级工具
```bash
# 推荐: 符号级操作
mcp__serena__find_symbol("computeDominators", include_body=true)
mcp__serena__replace_symbol_body("computeDominators", newBody)

# 避免: 读取整个文件
Read file_path="ep21/.../SSAGraph.java"
```

### ✅ 使用模式搜索
```bash
# 推荐: 搜索模式
mcp__serena__search_for_pattern("implements.*IFlowOptimizer", restrict_search_to_code_files=true)

# 避免: Grep搜索
Grep pattern="implements.*IFlowOptimizer"
```

### ✅ 使用思考工具
```bash
# 在关键节点使用思考工具
mcp__serena__think_about_collected_information()  # 搜索后
mcp__serena__think_about_task_adherence()        # 编辑前
mcp__serena__think_about_whether_you_are_done()  # 完成时
```

### ❌ 避免重复读取
```bash
# 错误: 多次读取同一文件
Read file_path="SSAGraph.java"  # 第1次
Read file_path="SSAGraph.java"  # 第2次 - 浪费

# 正确: 使用符号概览 + 选择性读取
mcp__serena__get_symbols_overview("SSAGraph.java")  # 1次
mcp__serena__find_symbol("specificMethod", include_body=true)  # 按需
```

---
*版本: v1.0 | 垂直职责: Serena代码分析工具 | 2025-12-23*