SuperAPI AI 工具集

course-guide

通用与其它

查看项目

更新于 10-16 10:10

技能介绍

Course Guide 是「AI Engineering from Scratch」课程体系的寻路层(wayfinding layer)。该课程体系包含 523 课、20 个阶段。学习者的诉求会以六种形式出现,Course Guide 据此进行路由。

用途

学习者的目标是弄清自己想要理解、构建或修复的内容位于课程的哪个位置,以及下一步应运行哪条命令。Course Guide 就是回答这一问题的工具,并可与任意智能体(agent)配合使用。

路由逻辑

它接收六种形态的请求:主题(如“attention”“how do diffusion models work”)、困境(如“my agent loops forever”“loss goes to NaN”)、元问题(如“what should I do next”“am I ready for phase 7”)、认证(如“prepare me for CCDV-F”“Claude architect mock”)、Model Context Protocol(MCP)(如“teach me MCP”“build a production MCP server”)、Agent Skills(如“teach me skills”“how does a skill run in a sandbox”)。

对于主题类请求,它扫描课程 Contents 表中的课节标题与阶段主题进行匹配。对于困境类请求,仅凭标题不足以作为证据,它会抓取入围课节的 docs/en.md(本地优先,raw 回退)确认其确实覆盖了出错的概念后再推荐;它把 bug 路由到其背后的概念,而非仅仅是工具 FAQ,例如 NaN 损失指向损失函数与数值稳定性相关课节,而非单纯的框架 FAQ。对于元问题,若当前目录存在 LEARNING.md 则据此按真实进度作答,否则建议使用 start-learning。认证、MCP、Agent Skills 三类请求会被直接路由到各自的专属路径,而不进入通用阶段序列。

推荐精度

优先精确,推荐 1-3 课,而非倾倒一整个阶段。对 Model Context Protocol(MCP)与 Agent Skills 这两条聚焦路线跳过 Contents 扫描,改用其 manifest。

来源与事实

课程的单一事实来源是仓库 README 的 Contents 部分:每个阶段都有一张表,列出每课编号、标题、类型(Build/Learn)、语言与目录路径。仓库已克隆时本地读取 README.md,否则抓取 https://raw.githubusercontent.com/rohitg00/ai-engineering-from-scratch/main/README.md。术语定义位于 glossary/terms.md。

专属路径

Claude 认证路线是独立且 AI 原生的课程,来源为 certifications/claude/program.json、certifications/claude/tracks/*.json 与 certifications/claude/GETTING_STARTED.md,状态记录在 CLAUDE-CERTIFICATION.md。

Model Context Protocol(MCP)路线针对 MCP 客户端、服务器、JSON-RPC、无状态请求、传输、MRTR、任务、授权、网关、注册表、可靠性与一致性等,来源为 learning-paths/model-context-protocol.json,顺序为 manifest 顺序而非数字顺序,状态记录在 MCP-LEARNING.md,共 17 课。

Agent Skills 路线针对 Agent Skills、SKILL.md、技能发现、调用、人类或模型可调用性、权限边界、沙箱、技能评估、打包与可移植性等,来源为 learning-paths/agent-skills.json,状态记录在 AGENT-SKILLS-LEARNING.md,按 manifest 顺序为 22、24、25、26、27 五课,是通常 1-3 课限制的例外。

逆向工程路线针对文件格式、ELF 或 Mach-O、反汇编、控制流图、反编译、提升与二进制证据等,来源为 learning-paths/reverse-engineering.json,状态记录在 REVERSE-ENGINEERING-LEARNING.md,每个目标都是学习者自己构建的程序。

输出格式

回答保持约 12 行以内:给出 1-3 课(阶段、编号、标题、推荐理由一行,以及直链 https://aiengineeringfromscratch.com/lesson?path=phases/<phase-dir>/<lesson-dir>);仅在确实需要时给出先修课;用宿主调用契约渲染下一步动作(learn 立即讲授该课、check-understanding <phase> 测查、或 start-learning)。若无所匹配,则如实说明并给出最接近的阶段,绝不虚构不存在的课程。

宿主调用契约

技能名称可移植,但调用语法属于宿主。Codex 使用 learn、start-learning、course-guide 等技能名形式,或让学习者从 /skills 中选择;Claude Code 使用 /learn、/start-learning、/course-guide 等 /skill-name 形式;其他兼容宿主使用自然语言,如“Use learn to teach this lesson”。绝不将斜杠命令当作通用语法;若宿主未知,使用自然语言。

课程自身的命令集

start-learning(构建计划)、learn(下一课,交互式讲授)、check-understanding <phase>(阶段测验)、find-your-level(仅做分级)、course-guide(本工具)。