ep-navigator

🎯 垂直职责

单一职责: EP项目知识图谱导航和路由决策

📊 EP依赖关系图

graph TD
    %% 基础层
    EP1[EP1: Lexer] --> EP2[EP2: Parser]
    EP2 --> EP3[EP3: AST]
    EP3 --> EP4[EP4: Listener]
    EP4 --> EP5[EP5: Visitor]
    EP5 --> EP6[EP6: Symbol Table]
    EP6 --> EP7[EP7: Types]
    EP7 --> EP8[EP8: Type Checking]
    EP8 --> EP9[EP9: Scopes]
    EP9 --> EP10[EP10: Interpreter]

    %% 编译器层
    EP10 --> EP11[EP11: IR Design]
    EP11 --> EP12[EP12: IR Gen]
    EP12 --> EP13[EP13: Bytecode]
    EP13 --> EP14[EP14: VM Entry]
    EP14 --> EP15[EP15: Function Call]
    EP15 --> EP16[EP16: Control Flow]
    EP16 --> EP17[EP17: Arrays]

    %% 后端分支
    EP17 --> EP18[EP18: Stack VM]
    EP17 --> EP18R[EP18R: Register VM]
    EP17 --> EP19[EP19: Compiler Interpreter]
    EP17 --> EP20[EP20: Full Compiler]

    %% 优化层
    EP20 --> EP21[EP21: Optimization]

    %% 虚拟机分支
    EP18 -.-> EP18R
    EP19 -.-> EP20

🚀 快速路由表

| 用户意图 | 目标EP | 加载记忆 | 加载技能 | |----------|--------|----------|----------| | "词法/语法问题" | EP1-EP5 | 无需 | antlr4-dev | | "符号表/类型检查" | EP6-EP10 | EP{编号}.md | compiler-dev | | "IR/代码生成" | EP11-EP17 | EP{编号}.md | compiler-dev | | "虚拟机" | EP18, EP18R | EP18.md | vm-dev | | "编译器完整流程" | EP19, EP20 | EP19.md, EP20.md | compiler-dev | | "优化/SSA" | EP21 | EP21_TECH_MEM.md | compiler-dev | | "文档编写" | - | - | doc-dev | | "测试开发" | - | - | test-dev |

📦 核心能力

1. EP识别

从用户输入自动识别目标EP：

输入: "在ep18中添加垃圾回收"
→ 识别: EP18
→ 加载: docs/ep-memory/EP18.md
→ 加载技能: vm-dev

2. 跨EP对比

输入: "对比ep18和ep18r的ABI设计"
→ 加载: EP18.md + EP18R.md
→ 对比维度: 调用约定、栈帧布局、参数传递
→ 输出: 标准化对比表

3. 依赖分析

输入: "修改EP5的Visitor接口"
→ 分析: 影响EP6-EP21所有使用Visitor的模块
→ 报告: 受影响EP列表 + 风险评估

🔗 关系图

→ 被所有技能依赖 (优先加载) ← 无依赖

📂 关键文件映射

| EP | 核心目录 | 入口文件 | 关键记忆 | |----|----------|----------|----------| | EP1-5 | ep20/src/main/antlr4/ | Cymbol.g4 | 无 | | EP6-10 | ep20/src/main/java/org/teachfx/antlr4/ep20/symtab/ | Symbol.java | EP{编号}.md | | EP11-17 | ep20/src/main/java/org/teachfx/antlr4/ep20/ | Compiler.java | EP{编号}.md | | EP18 | ep18/src/main/java/org/teachfx/antlr4/ep18/stackvm/ | CymbolStackVM.java | EP18.md | | EP18R | ep18r/src/main/java/org/teachfx/antlr4/ep18r/regvm/ | CymbolRegisterVM.java | EP18R.md | | EP19 | ep19/src/main/java/org/teachfx/antlr4/ep19/ | Compiler.java | EP19.md | | EP20 | ep20/src/main/java/org/teachfx/antlr4/ep20/ | Compiler.java | EP20.md | | EP21 | ep21/src/main/java/org/teachfx/antlr4/ep21/ | Optimizer.java | EP21_TECH_MEM.md |

✅ 使用流程

# 1. 识别EP
用户输入包含 "ep{数字}" 或特定关键词

# 2. 加载记忆
mcp__serena__read_memory("EP{编号}.md")

# 3. 加载技能
根据上表加载对应的垂直技能

# 4. 执行任务
使用垂直技能的专业知识执行

# 5. 更新记忆
任务完成后更新对应的EP记忆

---

版本: v1.0 | 垂直职责: EP路由导航 | 2025-12-23