附录

A. 术语表

• 上下文窗口 📘 必学 （stage0-2 会用到）：大模型一次能"看到"的 token 上限（Claude ~1M），填满后性能下降——本教程一切用法的约束原点。
• Agent 📘 必学 （stage0-2 会用到）：大模型 + 工具的组装体，能感知和改变外界。
• REACT 📘 必学 （stage0-2 会用到）：Thought→Action→Observation 循环的 Agent 运行模式。
• RAG 📘 必学 （stage0-2 会用到）：检索增强生成，先检索知识库再喂模型，减少幻觉。
• 代码知识图谱 🔧 进阶 （stage3-6 / 大型团队）：把代码索引成节点+边的图，供 AI 确定性查询（替代盲读）。
• SDD 🔧 进阶 （stage3-6 / 大型团队）：规范驱动开发，spec/plan/tasks 三产物，纠错左移到 Markdown。
• Skill 📘 必学 （stage0-2 会用到）：可复用工作流/领域知识，两级加载（description 常驻 + 正文按需）。
• MCP 📘 必学 （stage0-2 会用到）：Model Context Protocol，AI 连接外部数据/能力的开放协议。
• OpenSpec / Superpowers 📘 必学 （stage0-2 会用到）：规范驱动框架 / 自动化执行框架，两者互补。
• Co-authored-by 📘 必学 （stage0-2 会用到）：Git commit trailer，AI 工具默认埋点，用于度量 AI 代码占比。
• HNSW / CrossEncoder 🔧 进阶 （stage3-6 / 大型团队）：向量库图索引算法 / RAG 重排序模型。
• TBCFlow 🔧 进阶 （stage3-6 / 大型团队）：tbc-skills 仓库内的编排型 Skill，把需求→交付拆成 6 阶段（OpenSpec + Superpowers 驱动）。GitLab →
• ai-code-ratio 📘 必学 （stage5 度量）：Go CLI，扫 Git Co-authored-by trailer 统计 AI 代码占比的工具，本教程所有占比口径的来源。GitLab →
• code-lens 🔧 进阶 （stage3-6 / 大型团队）：内部代码知识图谱服务，把代码索引成节点+边的图，提供 10 个 MCP 工具（context / impact / route_map 等）。GitLab →

B. 配套源码索引

本教程强绑定以下真实项目（均在企业内部 GitLab，章节对应）。代码工具链接 GitLab 原项目，教程独有资产（汇报 / 手册 / 模板）保留在 demos/：

• 业务 RAG 服务（阶段3）：向量库抽象 + Milvus + 两阶段检索重排（gpt-server，Dify/Milvus）。
• 代码图谱工具（阶段3·代码图谱）：内部 code-lens（Tree-sitter + 知识图谱 + 10 个 MCP 工具）。同类开源参考 codebase-memory-mcp。
• 团队 Skill 仓库（阶段3/6）：内部 tbc-skills（TBCFlow 编排型工作流 + 领域 Skill + 强制激活 hook）。开源平台参考 iflytek/skillhub（自托管私有 Skill 注册中心，Apache 2.0）。
• MCP 网关服务（阶段3）：内部 mcp-gateway（Spring AI Alibaba + Nacos 动态工具发现）。
• AI 代码占比工具（阶段5）：内部 ai-code-ratio（Go CLI，Co-authored-by + 风格学反伪造）。
• PPT 生成服务（AI 应用扩展）：内部 ppt-generate（Dify 编排 + FastAPI 渲染）。
• AI 自动化测试框架（测试）：内部 autotest（Playwright + Python + Flask，数据驱动 + 录制转生成）。详见 《AI 自动化测试：方法论与实践》。

C. 技术栈全景

大模型 / Agent：Claude Code（Opus/Sonnet/Haiku）、Codex、Spring AI / Spring AI Alibaba。

RAG / 向量：Milvus、Chroma、BGE-M3、DashScope Embedding、CrossEncoder。

代码图谱：Tree-sitter、LadybugDB、MCP TypeScript SDK。

编排：OpenSpec、Superpowers。

基础设施：Nacos、Dubbo、K8s、Docker、PostgreSQL、Redis。

测试 / 度量：Playwright、pytest、go-git、Cobra/Viper。

D. 延伸阅读

• 角色操作手册（本地，自包含）——4 份角色手册（开发/测试/组长/产品）
• 汇报材料 AI 生成指南（本地，自包含）——5 类汇报 prompt 模板包 + ppt-generate 生成可编辑 PPT
• AI 自动化测试：方法论与实践（本地，自包含）——录制转生成四段式 + 规范即 Prompt
• Claude Code 完全手册（本地，自包含）——15 章配置大全
• Claude Code 官方文档：code.claude.com/docs（Skills / Agents / Hooks / MCP）
• MCP 协议规范：modelcontextprotocol.io
• Spring AI Alibaba：java2ai.com
• OpenSpec：openspec.dev；Superpowers：github.com/obra/superpowers
• 微软 AI-For-Beginners（中文版）：github.com/microsoft/AI-For-Beginners/translations/zh-CN（12周24课，AI 基础原理 + 代码实践，MIT 开源）
• Milvus 混合检索、Tree-sitter、Playwright Best Practices

E. 关于

本教程由 时代光华（技术总监 / 首席架构师）整理，基于时代光华 ELS 企业学习平台 54→49 人研发团队、千万级用户平台的真实 AI 战略转型全过程。核心理念：AI 能提效、能大幅扩展人的能力边界，但 AI 不是万能的——最终依赖使用人的能力边界。先转变思想、拥抱 AI，再懂原理、精准交互。 人 + AI，人是根本。

本教程自包含（教程页面 + GitLab 真实项目 + 教程资产），整个目录可独立拷贝交付。