使用 Agent Mentor Skill 生成第一门课 · 第 2 / 3 节

第 02 节:阅读站就是你的学习环境

本节目标:

  • 说清本地课程网站的角色:学习环境,不是展示页。
  • 用术语释义卡、划选提问和「卡住怎么办」模板各动手一次。
  • 在一个真实的 live 编辑器里把一段文字改成一张卡片,看到达成状态。

先修:上一节的产课链路与划选功能 | 上一节 << 01 | 下一节 03 >>

课程网站不是给你看的,是给你用的

上一节你写出了一条产课请求,agent 把它变成了课程文件,课程文件又变成了你现在看到的这个页面。到这一步,这个页面看起来和一份普通的技术文档没什么区别:标题、段落、代码块。区别在于它能不能被动手用。

多数说明书只能读。这个页面的每一节都嵌了几个可以直接操作的入口:生词点开就有解释,看不懂的句子选中就能问,卡住了有现成的求助模板,你做过的每一次尝试都会被记下来。这一节把这几件事各做一遍,而不是先读一段介绍再去别处摸索。

讲解

本地课程网站的角色是学习环境,不是展示品。四件事在页面本身就能完成,不需要先离开去开一个新的对话窗口。

第一件事是术语。课节正文第一次出现的生词下面会带一条虚线。

把鼠标停在带下划虚线的术语上。释义卡底部的「还是不懂?让 agent 补一课」会让 agent 换一种方式讲,讲不清就长出一节补课。

第二件事是划选,你在上一节已经用过一次:选中任意一句话,会出现「问 agent 这段」按钮,把这句话连同课程位置一起交给你的 agent。术语卡回答“这个词是什么”,划选回答“这句话我没懂”,两件事分工不同,别混着用。

第三件事是卡住时的求助模板。描述卡点最常见的浪费,是只发一句模糊的“我不懂”,agent 只能反问你到底卡在哪一步。阅读站把这一步预先做好了。

课程介绍页顶部有一张「卡住怎么办」卡片,三类求助模板,复制时自动带上课程位置和给 agent 的引导规则。先自己试十分钟,然后放心用它。

第四件事是记录。你在这个页面上做过的每一次尝试,无论对错,都会被留下来,成为这门课的一部分证据,不是关掉页面就消失。记录的边界要说清楚:练习尝试存在这台电脑的这个浏览器里,课节完成状态和复习记录存在课程文件旁边;换浏览器或清掉浏览器数据,前者不会跟着走。下一节会用到这些记录。

跟我做一遍

下面这个块是真的编辑器。改右边的 CSS,预览立即变。

达成目标时状态点会变。你在这个块里的每次尝试都会进入这门课的学习档案,下一节会用到它。

换你补全

不要新开一个块,在上面同一个编辑器里继续改:把 .card 的背景换成一种暖纸色,比如浅米色或浅棕调,只要不是纯白就算改对了方向。

参考做法:

状态点不会因为背景色变化就重新判定,因为这个块的 checks 只盯着内边距和圆角两条断言。这也是本节要说的一件事:达成状态看的是写进块里的具体断言,不是整体好不好看。

小结 + 通向下一节

这一节你动手做了四件事:把鼠标停在术语上看释义、选中正文问一句、在真实编辑器里把样式改到达成、准备好在卡住时用哪类模板求助。没有一件是表演,reader 记下的每一次尝试都会留在这门课的学习档案里。下一节看这些记录怎么被用起来:档案怎么读,复习怎么被考,想深入的地方怎么长出一节新内容。

Exercises

Exercise 1 · Level 1

在本节正文里选中一句你没完全弄懂的话,点「问 agent 这段」把它发给你的 agent。等它回答后,用你自己的话把这句话的意思复述给 agent,请它确认你有没有说对。

Done criteria · checked locally
Exercise 2 · Level 2

打开课程介绍页,找到顶部「卡住怎么办」卡片,切到「概念不懂」模板,填入本节出现的一个术语,比如“划选”或“学习档案”,复制发给你的 agent。

Done criteria · checked locally