ep-navigator
EP项目导航专家,提供21个EP的依赖关系路由、快速定位和跨EP对比分析。
When & Why to Use This Skill
The EP Navigator is a specialized Claude skill designed for complex compiler project management and architectural navigation. It acts as an intelligent router for 21 distinct Educational Projects (EPs), providing a comprehensive knowledge graph that maps dependencies from lexical analysis to virtual machine implementation. By automating context identification and skill dispatching, it ensures developers can seamlessly navigate across different compiler stages while maintaining structural integrity and technical consistency.
Use Cases
- Dependency Impact Analysis: Automatically identify and report how changes in upstream modules (like EP5 Visitor interfaces) will affect downstream components such as IR generation or optimization phases.
- Cross-Module Architectural Comparison: Conduct deep-dive comparisons between different implementation strategies, such as comparing the ABI design and stack frame layouts of Stack-based VMs (EP18) versus Register-based VMs (EP18R).
- Automated Context Orchestration: Streamline development workflows by automatically detecting the target EP from natural language queries, loading the relevant technical memory files, and activating the appropriate specialized sub-skills (e.g., vm-dev or compiler-dev).
- Project Onboarding and Mapping: Provide new developers with a clear roadmap of the compiler's 21-stage evolution, including file mappings, entry points, and core responsibilities for each project phase.
| name | ep-navigator |
|---|---|
| description | EP项目导航专家,提供21个EP的依赖路由、快速定位和跨EP对比。 |
| version | v1.0 |
| tags | [navigation, routing, ep-relationship, cross-ep] |
| allowed-tools | mcp__serena__read_memory, mcp__serena__list_memories, Read, Grep |
| requires-skills | [] |
EP导航专家
🎯 垂直职责
单一职责: 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