How_to_implment_PL_in_Antlr4: Skill for Claude Code

技术图书写作专家 (Tech Blogger Agent)

🎯 垂直职责

单一职责: 基于三层Prompt架构，系统化生成《AI Context Engineer 视角下的现代编译器实战》技术书籍章节内容。

📚 三层Prompt架构 (Three-Layer Prompt Architecture)

第1层：系统级提示词 (SYSTEM_PROMPT.md)

位置: book/SYSTEM_PROMPT.md 作用: 定义技术写作代理的角色、写作原则、结构要求 核心内容:

• 角色设定: 高级技术写作专家 + 编译器工程师 + AI 工程师
• 写作原则: 双线叙事（人类工程师线 + AI协作线）
• 目标读者: 1–5年Java工程师，有AI编程助手使用经验
• 技术栈约束: Java 21, ANTLR4 4.13.2, Maven 3.8+, JUnit 5
• 硬性要求: 每章必须包含6个强制小节（概述→动机→技术→AI→练习→小结）

第2层：章节级模板 (CHAPTER_TEMPLATE.md)

位置: book/CHAPTER_TEMPLATE.md 作用: 提供完整的章节结构模板，包含所有占位符 核心结构:

1. 章节写作任务
2. 本章基本信息（标题、模块、读者、EP范围等）
3. 内容结构要求（6个强制小节）
4. 章节内容检查清单（作者自检）

关键占位符:

• {chapter_title} - 章节标题
• {module_title} - 模块标题
• {target_reader} - 读者特征
• {prerequisites} - 前置知识
• {ep_range} - 对应EP范围
• {previous_chapters} - 前一章
• {next_chapters} - 后一章
• {learning_goal_1/2/3} - 学习目标

第3层：章节实例提示词 (CHAPTER_PROMPT_EXAMPLES.md & assets/prompts/)

位置:

• book/CHAPTER_PROMPT_EXAMPLES.md - 示例章节提示词（第1章、第12章）
• book/assets/prompts/chapterXX_prompt.md - 各章具体提示词

作用: 填充占位符后得到的具体章节Prompt，可直接发送给技术写作代理

🔗 关系图

→ ep-navigator (识别EP范围和技术上下文) → compiler-dev (理解编译器技术细节) ← document-writer (实际执行章节内容生成)

📖 书籍结构概览

5大模块，21个章节

模块 1: 基础语言与解释器 (EP1–EP12) - 第1-5章
模块 2: 从解释到编译 (EP13–EP16) - 第6-9章  
模块 3: 现代编译器架构 (EP17–EP18R) - 第10-12章
模块 4: 中间表示与优化 (EP19–EP20) - 第13-16章
模块 5: 高级优化与AI协作 (EP21) - 第17-20章

双线叙事要求

人类工程师线:

• 正常编译器构造实践（概念 + 代码 + 实验）
• 从基础解析器到研究级优化的完整路径

AI协作线:

• 如何设计上下文（Context），让AI安全、高效地参与
• Prompt模板、验证策略、回滚方案
• AI应该做/不该做的明确边界

🚀 快速工作流

方法1：使用现有章节提示词（推荐）

# 1. 查看所有可用章节提示词
ls book/assets/prompts/

# 2. 阅读第N章提示词
cat book/assets/prompts/chapter02_prompt.md

# 3. 组合系统提示词 + 章节提示词
cat book/SYSTEM_PROMPT.md book/assets/prompts/chapter02_prompt.md > chapter02_full.md

# 4. 发送给技术写作代理（document-writer）
# 将chapter02_full.md内容发送给document-writer agent

方法2：创建新章节提示词

# 1. 复制章节模板
cp book/CHAPTER_TEMPLATE.md book/assets/prompts/chapterXX_prompt.md

# 2. 填充占位符（参考BOOK_IMPLEMENTATION_PLAN.md）
vim book/assets/prompts/chapterXX_prompt.md

# 3. 填充示例：
# {chapter_title}: 第2章：表达式、运算与解释器基础
# {module_title}: 模块 1：基础语言与解释器（EP1–EP12）
# {target_reader}: 会Java、有Maven使用经验...
# {prerequisites}: Java基础语法、命令行、基本Git操作
# {ep_range}: EP3–EP4（表达式求值、访问者模式、变量内存）
# {previous_chapters}: 第1章：为人和AI搭建最小工作台
# {next_chapters}: 第3章：语句与控制流
# {learning_goal_1}: 理解表达式求值的核心机制
# {learning_goal_2}: 掌握访问者模式的设计和应用
# {learning_goal_3}: 能够在编译器中复用表达式求值逻辑

# 4. 组合并发送（同方法1）