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

第 01 节:一句话不是课程,它是入口

本节目标:

  • 说清 Agent Mentor Skill 的触发方式。
  • 看懂一次产课从用户请求到本地网页的路径。
  • 分辨公开产品页、 skill 指令和生成出的课程文件。

先修:知道自己在和一个本地 agent 对话 | 下一节 02 >>

你说的不是命令行参数

先想一个真实场景:你在 Codex 或另一个本地 agent 里说,“使用 Agent Mentor Skill 帮我做一门 SQL 入门课。我会 Excel,但不会写查询。”这就是入口。你不用背目录名,也不用知道内部 workflow 怎么叫。

用户可见产品名是 Agent Mentor Skill;generate-course-from-topic 只是内部 workflow id,用于路径和排错,不该变成用户必须背的触发词1

这句话本身还不是课程。它只是把任务交给 agent:先判断请求是否足够清楚,再决定是追问还是进入产课。好课从这里开始,因为错误的起点会让后面的 sources、练习和网页都错位。

讲解

一次完整流程可以看成五个对象依次接力。用户给目标;Agent Mentor Skill 给 agent 执行规则;agent 产出课程文件;本地课程网站把文件变成可读可练的页面;卡住时再把当前状态交回你的 agent。

这张图要看的不是“网页好看”,而是谁负责哪一步。 skill 不直接等于网页;网页也不负责开放聊天。真正的产品是让 agent 按稳定教学流程备课、写文件、检查质量,再交给本地课程网站渲染2

这条执行规则里,最先起作用的是一条判断:请求是否说清四件事,主题、基础(已经会什么)、未知项(还不会什么)、目标动作(学完要能做什么)。只有主题名的请求,比如“我想学 Next.js”,这四件事只占了一件,agent 该在缺的那几件上补一句追问,不该套一个默认画像往下写;把缺失的先修当成已知,课程会在第一节就滑坡3。四件事都说清楚,agent 才有理由直接展开,不追问1

选中上面任意一句话。出现的「问 agent 这段」按钮会把这句话连同课程位置一起交给你的 agent。这个动作在任何课程的任何正文上都有效,看不懂哪句就问哪句。

跟我做一遍

先看一个合格起手式:

使用 Agent Mentor Skill 帮我做一门“看懂 Git diff”的入门课。我会用 Git 提交,但经常看不懂 diff 里哪一行真的改变了行为。

这句话有三件有用信息:主题是 Git diff;起点是会提交但读 diff 弱;目标是判断行为变化。 agent 可以据此扩成 learner model,再去找资料和设计练习。它不需要用户填写复杂表单,但也不是什么都不问就产课。

换你补全

把下面这句补成更适合交给 Agent Mentor Skill 的请求:

使用 Agent Mentor Skill 帮我做一门 ______ 的入门课。我已经会 ______,但还不会 ______。学完后我想能 ______。

参考答案:

使用 Agent Mentor Skill 帮我做一门 React state 的入门课。我已经会看简单 HTML,但还不会理解按钮点击后页面为什么更新。学完后我想能自己解释一个计数器的状态变化。

关键不是写得正式,而是把“现在会什么 / 不会什么 / 想做到什么”说出来。

小结 + 通向下一节

Agent Mentor Skill 的入口是自然语言,但它不是让 agent 直接吐一篇长回答,也不是把你交给一张只能看的网页。下一节说清一件事:这个课程网站不是给你看的,是给你用的,术语、正文、卡住的时候都能在上面直接动手。

另外一件安静发生的事:skill 每次被调起都会自查一次新版本,有更新会先问你,不会自作主张。

Footnotes

  1. Agent Mentor Skill 当前入口契约 2

  2. Agent Mentor 公开工作流页

  3. Carnegie Mellon Eberly Center: Learning Principles — https://www.cmu.edu/teaching/principles/learning.html

Exercises

Exercise 1 · Level 1

给自己的 agent 写一条产课请求,主题任选。

Done criteria · checked locally
Exercise 2 · Level 2

把同一条请求改成太模糊的版本,再写一句为什么它会降低课的质量。

Done criteria · checked locally