Glossary
65 terms from "Agent Mentor:从请求课程到导出." Look them up when you get stuck; the first mention in the text carries a hover definition.
| Term | Definition | Source |
|---|---|---|
| 一组指令文件构成的文件夹 | skill 的真实形态:磁盘上一个装着指令文件的文件夹,请求匹配时被 coding agent 读取。没有应用图标、没有仪表盘、没有登录页,这份「什么都没有」就是设计本身。 | Agent Mentor Skill package entrypoint (intent router) |
| coding agent | 读取 skill 指令并执行的那个编程助手。课程由它构建、由它维护、由它出题,你的角色是给目标和验收,而不是亲手执行步骤。 | Anthropic: Building Effective AI Agents |
| 学习请求 | 任何表达想学某个主题的句子。skill 在每一条学习请求上激活——「我想学 X」「教我 X」「给我做一门 X 的课程」都会路由进来,不必提到产品名。 | Agent Mentor Skill package entrypoint (intent router) |
| 触发短语 | 本 skill 并不要求的东西。「Agent Mentor Skill」只是方便你指代它的名字,不是你必须记住、必须逐字说出的口令。 | Course-generation workflow contract |
| 澄清提问 | 请求信息不足时 agent 先停下来问的一到三个短问题。它不是刁难,而是因为不知道你的起点,就定不了课程的难度。 | Course-generation workflow contract |
| 只报主题的请求 | 像「我想学 Next.js」这种只给出一个主题名的请求。它必然触发澄清提问,因为缺起点、缺缺口、缺目标。 | Course-generation workflow contract |
| 四个短短的部分 | 一条能直接进入生成的请求所需的全部内容:主题、起点、缺口、目标。不需要写规格说明,四句话就够。 | Course-generation workflow contract |
| 你的起点 | 四要素之一:你今天在用什么工具、在做什么事。它是 agent 唯一的难度标尺,只写与本主题相关的那一个工具或习惯即可。 | Course-generation workflow contract |
| 目标写的是一个动作 | 合格目标的检验标准:别人能看着你做完并说一句「完成了」。「想觉得有信心」不合格,「想写出一条把逾期行标出来的公式」合格。 | Course-generation workflow contract |
| 学习者档案 | 课程里记录你已知与未知概念的那一份档案。你自称不会的概念进入其中的未知项,课程必须为它搭桥。 | Learner model contract |
| 不得被当作先修条件 | 缺口附带的保证:凡是你标记为不会的概念,都不能被拿来当第一步的先修条件。第一个独立动作只能用你已知的东西加同一课里刚讲的内容完成。 | Learner model contract |
| 用户空间 | 首次运行时环境安装的落点:你主目录下的一个文件夹。全程不需要管理员密码,不收集任何用户数据,删掉那个文件夹安装就撤销了。 | Course-generation workflow contract |
| /courses | 阅读站课程列表页的路径。agent 交给你的链接必须以它结尾——那一页才是你机器上的课程清单。 | Course-generation workflow contract |
| 裸域名 | 去掉路径后剩下的那个地址。它对应的是一张产品页,不是你的课程列表;要看课程必须用 agent 给出的完整地址。 | Course-generation workflow contract |
| 本地课程阅读站 | 在你自己电脑上运行、渲染课程文件的那个站点。它只监听你的机器;阅读进度和练习尝试存在课程旁边的本地文件里,什么都不上传。 | Course-generation workflow contract |
| 编号脚注 | 课节讲解里挂在事实性断言后面的编号引用,指向本课自己的来源清单。它是你追问「谁说的?」的通道,不是排版装饰。 | Course authoring guide (course shape and quality gate) |
| 每门课自己的来源清单 | 随课附带的来源文件,脚注编号指向它。生成的课程被禁止陈述一条它无法引用的关键事实。 | Course authoring guide (course shape and quality gate) |
| 交互块 | 课节正文里就地自评的小检查(选一个判断、排一组步骤)。答错时它必须解释你漏掉的机制,而不是只报「不正确」。 | Course authoring guide (course shape and quality gate) |
| 完成标准 | 列在每道练习下面的清单,具体到你不需要评分人就能判定通过或不通过。它替代的是「我看着算完成了」这种自我放水。 | Course authoring guide (course shape and quality gate) |
| 解释你漏掉的机制 | 交互块反馈的硬性要求:错误反馈必须说清机制为什么不成立,永远不能只说「错了」。 | Course authoring guide (course shape and quality gate) |
| 复制给 agent | 阅读站上把你的确切处境连同课程和课节一并复制走的那组入口,让 agent 从上下文开始,而不是从一句冷冰冰的「我没看懂」开始。 | Reader drill-down design: three copy-to-agent entry points |
| 卡住卡片 | 课程页上按情境分模板的求助卡片(概念不明白、报错、练习无从下手)。模板自动填入你的位置,要求你写清卡在哪里、试过什么,并指示 agent 先给提示而不是直接给完整答案。 | When-stuck help card design |
| 就这段问 agent | 选中课节里的一句话时出现的浮条动作。它复制课节路径加上被选中的那句话,一字不差。 | Reader drill-down design: three copy-to-agent entry points |
| 术语释义浮窗 | 把鼠标挂到术语上弹出的释义卡片,里面带一个把术语、释义和课节路径一起交给 agent 的动作。 | Reader drill-down design: three copy-to-agent entry points |
| 就本课深入 | 课节末尾的入口,复制课节路径加一条深入请求。另一端有分诊规则:两轮对话能说清的就在聊天里答,只有真正的缺口才长成扩展课节。 | Reader drill-down design: three copy-to-agent entry points |
| 勾选框 | 练习旁边由你自己勾的框。勾上记录的是你本人的通过/不通过判断,存进本机文件供你和 agent 之后使用;没有服务器在评分。 | Course-generation workflow contract |
| 唯一可用的评分人 | 你的 agent,而且只在你主动把练习复制给它时。阅读站从不给练习评分,完成标准的存在是为了让你评判自己这次尝试。 | Course authoring guide (course shape and quality gate) |
| 考考我 | 启动复习会话的那句大白话,等价说法是「今天我该复习什么」。agent 读取本机学习记录、算出到期条目、开始提问,不需要抽认卡应用,也不需要单独账号。 | Agent Mentor Skill package entrypoint (intent router) |
| 复习池 | 可被抽来提问的条目集合,只含两类:你完成过至少一节课的那门课的词汇表术语,以及你在课节里真正作答过的交互块。 | Review-course workflow contract |
| 关键术语的词汇表 | 随每门生成课程附带的术语表,每条释义都有来源。完成一节课之后,其中的术语开始进入复习池。 | Course authoring guide (course shape and quality gate) |
| 本地学习记录 | 阅读站一直在维护、存在课程旁边的记录文件。复习会话读的就是它,所以进度和作答从不离开你的机器。 | Review-course workflow contract |
| Leitner 系统 | 复习时间表背后的机制:按熟悉程度把条目分进若干盒子,答对的升入间隔更长的盒子,答错的回到频繁复习端。 | Wikipedia: Leitner system |
| 盒子的等待时间 | 五个盒子各自的间隔:1、3、7、14、30 天。自你上次作答起,所在盒子的等待时间一过,条目就到期。 | Review-course workflow contract |
| 向慢端移动 | 答对之后条目的去向:进入等待时间更长的盒子,你见到它的频率随之下降。 | Wikipedia: Leitner system |
| 回到快端 | 答错之后条目的去向:从任意盒子退回第 1 盒接受频繁复习。在这台机器里,遗忘是信号而不是惩罚。 | Wikipedia: Leitner system |
| 之前答错过的条目先问 | 会话内的排序规则:上次答错的条目排在最前面,先消化欠账再看新到期的。 | Review-course workflow contract |
| 回忆尝试 | 术语提问的强制第一步:你先用自己的话解释,标准释义才出现。提取本身就是巩固记忆的动作,顺序永远不翻转。 | Review-course workflow contract |
| 我忘了 | 允许直接说出的一句话,会被记为答错,语气保持就事论事。答错在这里是排期信息,不是裁决。 | Review-course workflow contract |
| 每次会话至多十条 | 单次复习的上限,用来防止积压变成一小时。数量上限是设计,不是当天条目不够。 | Review-course workflow contract |
| 收尾报告 | 会话结束时的固定清点:今天复习了几条、答对几条、答错几条、明天有几条到期。它是时间表的读数,不是成绩单。 | Review-course workflow contract |
| 没有到期条目 | 零到期分支:agent 会说你已跟上进度并告诉你明天的数字,绝不会为了填补沉默而临时编造题目。 | Review-course workflow contract |
| 更新我的课程 | 维护类请求的典型说法之一,同族还有「修一下过时的部分」「这节课太难了,简化它」「加一节讲 X 的课」。想学一个新主题不属于维护,会路由回课程生成。 | Maintain-course workflow contract |
| 体检我的课程库 | 最宽的一类维护请求:agent 只读扫描全部课程并汇报——哪些通过质量检查、哪些存在孤儿记录、哪些干净。它自己什么都不改。 | Maintain-course workflow contract |
| 预告步骤 | 编辑顺序的第一步:agent 用一句话说清将要改什么,包括对键的承诺。它和末尾的回报一样,你能在 agent 的回复里亲眼盯到。 | Maintain-course workflow contract |
| 课程的自动备份 | 任何文件被碰之前保存的隐藏快照。正因为它先发生,之后的「撤销」才是一句真话。 | Maintain-course workflow contract |
| 一句话就能撤销 | 说「撤销」即恢复最近一次快照,恢复之后质量检查再跑一遍。整条维护流程里没有任何环节会永久删除东西。 | Maintain-course workflow contract |
| 质量永不倒退 | 维护的硬规则:修改完成后必须通过与新课程同一道机械闸门(结构、引用、来源、词汇表),过不了就修好或回滚。 | Maintain-course workflow contract |
| 课节的文件名 | 复习记录的三个键之一。改名或删除它,指向它的每条记录都会失去目标,你复习时间表的那一片随之死去。 | Maintain-course workflow contract |
| 交互块的 id | 复习记录的第二个键:每个交互块的唯一标识。记录靠它找到那道题,所以它的稳定性比它的可读性重要。 | Maintain-course workflow contract |
| 词汇表术语的原文 | 复习记录的第三个键:术语的逐字文本本身。把「staging area」全局改名成「index」,旧记录就指向空无。 | Maintain-course workflow contract |
| 孤儿记录 | 键被改名或删除后,指向空无的那些复习记录。agent 只能事先警告(「这会孤儿化大约 N 条复习记录」)并优先选择保持键稳定的改法,无法消除这一风险。 | Maintain-course workflow contract |
| 扩展课节 | 深挖需求超过两轮对话时,挂在父课节下面新长出的一节课。深度封顶一层,每节课至多三节扩展。 | Maintain-course workflow contract |
| 至多三节扩展 | 每个父课节的扩展上限。理由直白:需要打第四个补丁的课节,是一节应该重写的课节。 | Maintain-course workflow contract |
| 导出这门课程 | 不指定格式的导出说法,同时产出两种格式:可打印页面和卡片文件。指定 PDF 或打印只出前者,指定抽认卡只出后者。 | Export-course workflow contract |
| 可打印页面 | 一个 HTML 文件,整门课程渲染成一张长页。双击就在浏览器里打开,不需要阅读站在运行。 | Export-course workflow contract |
| HTML 文件 | 可打印页面的实际格式:存成文件的网页。它既是离线副本,也是可以直接发给别人的单文件版本——对方只需要浏览器。 | Export-course workflow contract |
| 存储为 PDF | PDF 的实际来源:在浏览器里打开可打印页面,按打印,选择存储为 PDF。PDF 不是导出直接产出的格式。 | Export-course workflow contract |
| 卡片文件 | 抽认卡导出的产物:一个装着课程词汇表的 CSV,正面术语、背面释义,随时可导入抽认卡应用。 | Export-course workflow contract |
| 纯文本表格文件 | CSV 的白话解释:用纯文本存的一张表。正因为它是通用格式,抽认卡应用才能直接读它。 | Export-course workflow contract |
| Anki 导入 | 把卡片文件变成卡组的路径:打开 Anki,File,然后 Import,选中卡片文件,把正反面字段对应好。 | Export-course workflow contract |
| 正反面字段 | 导入时必须由你指定的对应关系:哪一列是正面、哪一列是背面。术语在正面,释义在背面。 | Export-course workflow contract |
| Anki 卡组 | 导入之后得到的可携带术语副本,用在 agent 不在的地方:手机上、离线时、你已有的习惯里。它和第 3 课的复习会话是两个互不混淆的世界。 | Export-course workflow contract |
| exports 文件夹 | 导出文件的落点:课程旁边的 exports 文件夹,按课程分放。agent 会告诉你确切路径,什么都不上传。 | Export-course workflow contract |
| 导出是快照 | 导出的核心性质:它记录课程在你运行那一刻的内容,此后不看管课程。改完课程,导出的页面仍显示旧文本。 | Export-course workflow contract |
| 过期副本 | 课程改过、导出没重跑之后留下的那一份。它和现役副本看起来一模一样,直到你对比一句改过的话——所以改完就重新导出。 | Export-course workflow contract |