Agent Mentor:从请求课程到导出 · Lesson 2 of 5

第 2 课:课节的阅读与练习

本课目标:

  • 说出每节生成课节共有的固定部分,以及各部分的用途。
  • 用完成标准评判自己的练习尝试,而不是靠感觉猜。
  • 在卡壳、术语不明白、想深入提问这三种时刻,选对“复制给 agent”的入口。

先修条件:一条来自第 1 课的课程链接(用本课程也行) | 上一篇 << 01 课程的请求 | 下一篇 03 复习会话 >>

页面看起来像文章,照文章的读法会浪费它的大半

你打开链接,看到标题和段落,十年的阅读习惯随即接管:滚到底,点点头,关掉标签页。在这个页面上,这个习惯会把专为你的双手准备的部分全部丢掉。每门生成的课程都有同样的作业面:让你给自己打分的清单、课内的小检查,以及把你的确切处境带回 agent 的按钮。本课就在这一页上,把它们逐个走一遍。

讲解

先看地图。阅读站的 /courses 页列出你机器上的每一门课程;每门课程在自己的短名下有独立页面1。阅读站只在你的电脑上运行:阅读进度和练习尝试存在课程旁边的本地文件里,什么都不会被提交到任何地方1。这意味着勾选一个勾选框,记录的是你自己的判断,供你自己以后使用。没有服务器,没有评分,没有正在围观的作者。

每节课的结构相同,由 skill 的写作规则固定:顶部是目标,然后是讲解(其中的事实性断言带编号脚注,指向每门课自己的来源清单)、作者完整走一遍的示例、留给你的半成品示例、练习,以及小结2。脚注不是装饰。生成的课程被禁止陈述一条它无法引用的关键事实,那个编号就是你追问“谁说的?”的通道2

课节正文里住着两种练习。交互块是就地自评的小检查(选一个判断、排一组步骤),答错时必须解释你漏掉的机制,而不是报告“不正确”2。你在第 1 课已经遇到过一个。完成标准列在每道练习下面:一张足够具体的清单,让你不需要评分人也能判定通过或不通过2。它们替代的纪律是“我看着算完成了”,那正是练习版的对着文章点头。

然后是出口,也就是“复制给 agent”的入口。阅读站有四个,各对应一种麻烦,做的都是同一件好事:把你的确切处境连同课程和课节一起复制走,让 agent 从上下文里开始,而不是从一句冷冰冰的“我没看懂”开始。

麻烦入口复制走的内容
卡在概念、报错或练习上课程页上的“卡住时”卡片,按情境分模板3课节路径、你填好的空,以及要求 agent 给提示而非给答案的规则3
有一句话读不懂选中那句话,出现“就这段问 agent”的浮条4课节路径加上被选中的那句话,一字不差4
一个术语记不住术语释义浮窗里的“让 agent 教我这个”入口4术语、它的释义和课节路径4
想要比课节更多的内容课节末尾的“就本课深入”链接4课节路径加上一条深入请求4

卡住模板值得多说一句,因为它们内置了一种学习技能:每个模板都要求你填上卡在哪里、已经试过什么,并且都指示 agent 先给提示,而不是直接给完整答案3。深入提问的入口在另一端有一条分诊规则:两轮对话能说清的,agent 就在聊天里答;只有真正的缺口才会长成挂在主课之下的扩展课节4

完整示例(跟着做)

拿第 1 课的第 1 级练习(四要素课程请求)来看,看完成标准在一次真实尝试上怎样工作。

这次尝试:“我想学照片编辑。我拍很多照片。课程结束时我想把照片修得更好。”

  • 四要素俱全:不通过。主题有了,起点算有一点,目标算有一点;缺口完全缺席。
  • 缺口写得像“我从没 X 过”一样直白:不通过。没有可查的内容。
  • 目标写明一个动作和真实材料:不通过。“修得更好”是感觉;没有照片,没有动作。

三条标准,两条干脆的不通过,一条缺失,而且全程不需要评分人。修改稿一部分一部分自己长出来:写明工具,写明从没做过的事,写明一张照片和一处修复。这就是标准的用途:把“这样算好吗?”变成你能亲手跑的检查。

你来试试(填空示例)

你卡在一道练习上,准备用卡住卡片的模板。把空填好,让 agent 第一遍读完就能行动:

我在 ____ 课程的第 ____ 课。练习要求我 。我目前的尝试:。我过不了的那条完成标准:____。

答案: 一份填好的示例:“我在数据透视表课程的第 2 课。练习要求我做一份按地区汇总。我目前的尝试:我插入了数据透视表,但每个地区显示的都是同一个总数。我过不了的那条完成标准:每个地区行显示自己的小计。”注意两个尝试空格逼你做的事:你写出了试过什么、在哪里偏离,这已经是诊断的大半,也是模板不许你只带一句“它不工作”就来的原因。

小结 + 下节课预告

你现在能把生成的课节当设备来读:脚注查断言,交互块查判断,完成标准查你自己的作业,四个复制入口把你的确切处境带给 agent。页面上没有任何东西向除你之外的人汇报。那些本地记录的去向是下一课的主题:说一句“考考我”,它们就会变成题目回来,时间安排恰好赶在你快要遗忘之前。

Footnotes

  1. Course-generation workflow contract 2

  2. Course authoring guide (course shape and quality gate) 2 3 4

  3. When-stuck help card design 2 3

  4. Reader drill-down design: three copy-to-agent entry points 2 3 4 5 6 7

Exercises

01

打开你在第 1 课生成的课程(留在本课程里也行)。在那里做一道第 1 级练习,然后对照它的完成标准给自己的尝试打分,每条标准都出声说通过还是不通过。

第 1 级(热身)
Done criteria · checked locally
02

制造一次卡壳:挑你没通过的那条标准(或本课里你觉得最不显然的一句话),用对应的入口(练习用卡住卡片,句子用文本选中),发给你的 agent。把它的第一条回复,与一句在全新聊天里的“我没看懂”能换来的东西对比。

第 2 级(进阶)
Done criteria · checked locally