第 1 课：课程的请求

本课目标：

• 说出从你发出请求到 agent 交回课程链接之间发生了什么。
• 判断一条课程请求会触发澄清提问，还是直接进入生成。
• 写出一条写明主题、起点、缺口和目标的课程请求。

先修条件：无 | 上一篇 << README | 下一篇 02 课节的阅读与练习 >>

skill 装好了，“开关”在哪里？

没有应用图标，没有仪表盘，没有登录页。这份“什么都没有”正是设计本身，也是第一件要理解的事。skill 是一组指令文件构成的文件夹，当请求匹配时，你的 coding agent 会去读它。日常的说法是“agent 照着执行的一本行动手册”。Agent Mentor 的这本手册在任何学习请求上激活：“我想学 X”“教我 X”“给我做一门 X 的课程”都会路由进来，不管你有没有提产品名¹。Agent Mentor Skill 这个名字只是方便你指代它，不是一句你必须记住的触发短语²。

所以“开关”就是一句话。这句话该包含什么，正是本课的主题，因为这句话决定了你得到的是为你构建的课程，还是为陌生人构建的课程。

讲解

先看你发出学习请求之后 agent 做了什么。它读取 skill 的指令，检查你的请求是否足够清晰，收集可以引用的来源，把课程写成你机器上的文件，对这些文件运行一次机械化的质量检查，启动一个本地课程站点，最后交给你一个以 /courses 结尾的链接²。整条链路如下：

这张图想让你看到的是课程住在哪里：不在某个网站上，而是作为文件放在你的 agent 旁边，由本地阅读站渲染，卡住时还有一条回到 agent 的路。指挥 agent 完成结构化工作，本身已经是一门被正式教授的学问，模型厂商自己就在开这类入门课³；而这个 skill 打包好了其中的一个回路：构建由 agent 完成，你提供它猜不到的两样东西⁴。

这两样东西是你的起点和你的目标。skill 把请求粗略分成几档²。只报主题的请求，比如“我想学 Next.js”，会迫使 agent 停下来问一到三个短问题，因为不知道你已经会什么，它就定不了课程的难度。写明主题、起点和缺口的请求会跳过提问，直接进入生成。你不需要写一份规格说明，四个短短的部分就够了：

1. 主题：你想学什么。
2. 起点：你已经会什么、平时用什么。
3. 缺口：你不会什么，直说。
4. 目标：课程结束时你想能做到的一件事。

缺口这一部分带着一条保证：凡是你标记为不会的内容，都不得被当作先修条件。skill 会把它记进课程的学习者档案，课程必须为它搭桥，而不是假设你已经会⁵。说“我不懂 X”不会让课程变差，只会让第一课落在你所在的位置²。

你的第一次请求还会多发生一件事：环境安装。skill 会把自己需要的工具装进你主目录下的一个文件夹，安装阅读站的依赖，然后启动阅读站，过程中随时汇报进度²。安全边界值得直说：一切都在你的用户空间里运行，不需要管理员密码；阅读站只监听你自己的机器；之后每次运行仅有的一次网络请求是版本检查，不携带任何用户数据²。删掉那一个文件夹，安装就撤销了。agent 把链接交给你时，请使用它给出的完整 /courses 地址：那一页才是你的课程列表，裸域名是一张产品页²。

完整示例（跟着做）

Rosa 做营销报表，想学数据透视表。看同一个愿望被写了两遍。

第一稿：“我想学数据透视表。”

只有主题。agent 必须回问，大致是：你现在用电子表格做什么、你用过任何数据透视表吗、你想产出什么？三条消息之后，课程才开始。没有出错，但这些问题本可预见，Rosa 完全可以提前答掉。

第二稿：“我想学 Google Sheets 里的数据透视表。我每个月靠手工来回复制汇总数做一份报表，从没插入过数据透视表。课程结束时我想自己把我们的销售表做成按地区汇总。”

对照四要素检查：主题（Google Sheets 里的数据透视表）、起点（手工做报表）、缺口（从没插入过）、目标（独立完成按地区汇总）。agent 什么都不问，构建课程，跑完质量检查，回复一个 /courses 链接。那句目标还悄悄做了第二件事：课程的最后一课现在有了靶子，是 Rosa 自己的销售表，而不是一份通用数据集。

你来试试（填空示例）

为你自己的主题补全这条请求。结构已经搭好，判断由你来下。

“我想学 ____。我已经 ____（你今天在用什么、在做什么），但我从没 ____（缺口，直说）。课程结束时我想 ____（一件你能独立完成的事）。”

答案： 怎么填都行，只要过得了两条检验：一个只读你这句话的陌生人，能猜出第 1 课该假设什么；目标写的是一个动作，一件你会去做的事，而不是一种理解的感觉。“课程结束时我想觉得有信心”过不了第二条；“课程结束时我想写出一条把逾期行标出来的公式”能过。

小结 + 下节课预告

你现在能说出从请求到本地链接的整条链路，也能写出跳过提问环节的四要素请求：主题、起点、缺口、目标。你写下的缺口会变成课程必须兑现的承诺。下一课：链接已经打开，页面看起来像一篇文章，而把它当文章读，会浪费页面上的大部分东西。