agentmentoragentmentor

第 04 节:在阅读站里看课程

本节 objectives:

  • 能启动 course-reader 并知道默认读取哪个目录。
  • 能用 COURSES_DIR 预览 examples 目录。
  • 能在阅读站里检查 README、课节、脚注和术语是否正常。

先修:知道课程文件会落在哪个目录 ｜ 上一节 << 03 ｜ 下一节 05 >>

Markdown 是交付物,阅读站是学习体验

generate-course-from-topic 只产 Markdown;渲染是后话。1 这个分离很关键:课程文件可以被 git 管理、被 guard 检查、被其他工具读取;course-reader 则负责把它变成连续阅读站,包括脚注、代码、数学、mermaid 和 CJK 排版。2

所以生成课程后,你要做两件事:先跑 guard,也要打开阅读站读一遍。guard 能抓机械红线;阅读能抓"这真的像一门课吗"。

讲解

course-reader 默认读取:

text
agent-mentor/skills/generate-course-from-topic/lessons/

也就是新生成课程的默认目录。想预览样例课程时,用 COURSES_DIR 指到 examples:

bash
COURSES_DIR=../agent-mentor/skills/generate-course-from-topic/examples npm run dev

course-reader/README.md 说明路由也很简单:/ 是课程索引,/[course] 是课程总览,/[course]/[lesson] 是单节阅读页。2

当你打开课程时,重点看四件事:

  • 首页是否能按 domain/tags 看到课程。
  • 课程 README 是否有 objectives、先修和课时表。
  • 单节脚注是否能跳到来源。
  • 术语 hover 或 glossary 数据是否能帮助初学者。

跟我做一遍(worked example)

目标:预览 examples 里的这门课程。

在仓根运行:

bash
cd course-readernpm installCOURSES_DIR=../agent-mentor/skills/generate-course-from-topic/examples npm run dev

打开终端给出的本地 URL。进入 learn-using-agent-mentor-skill,再打开第 01 节。你应该能看到标题、objectives、上一节/下一节链接、讲解、worked example、faded example、练习和小结。

如果页面没有课程,先检查 COURSES_DIR 是否相对 course-reader 目录。这里用的是 ../agent-mentor/...,因为命令在 course-reader 里运行。

换你补全(faded example)

你在仓根,想预览默认 lessons 目录里的新课程。请补全命令:

bash
cd ____________________

参考答案:

bash
cd course-readernpm run dev

如果你想预览 examples,再加:

bash
COURSES_DIR=../agent-mentor/skills/generate-course-from-topic/examples npm run dev

关键判断点是:默认读 lessons;看样例时才覆写 COURSES_DIR。

小结 + 通向下一节

course-reader 把 Markdown 课程变成可读网站,但它不替你判断课程是否有悬空引用、死链或缺 glossary。下一节用 course-guard 把机械红线跑一遍。

Footnotes

  1. generate-course-from-topic SKILL.md ↩

  2. course-reader README ↩ ↩2

练习

Level 1: 打开 examples 中任意一门课程。

提示 1

examples 是样例,lessons 是默认新课目录。

提示 2

预览要站在学习者视角读一节。

提示 3

页面正常不等于课程合格,下一节还要跑 guard。

自评