ep-navigator

whtoo's avatarfrom whtoo

EP项目导航专家,提供21个EP的依赖关系路由、快速定位和跨EP对比分析。

⭐32stars🔀5forks📁View on GitHub🕐Updated Dec 28, 2025⬇️1downloads

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.
nameep-navigator
descriptionEP项目导航专家,提供21个EP的依赖路由、快速定位和跨EP对比。
versionv1.0
tags[navigation, routing, ep-relationship, cross-ep]
allowed-toolsmcp__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