SuperAPI AI 工具集

grasp

写作与研究

查看项目

更新于 11-16 16:09

技能介绍

grasp 是一个面向深度学习的技能,用于为某个主题生成一份“讲解 + 测验”的走查材料,帮助读者逐步理解,直到能够通过测验。

用途

当用户需要深入理解某个内容,并希望被测验时,可以使用 grasp。它强调先阅读主题周边的背景,再进入主题本身。

主要能力

  • 生成四个部分的内容,按顺序为:背景、直觉、逐步讲解、测验。
  • 背景部分:说明读者需要预先掌握的内容,包括标记为可跳过的深层背景,以及主题所触及的具体切片。例如,对于某个变更,需要说明变更之前的世界是什么样;作业队列整体如何工作属于可跳过的层次,而该变更所修改的重试分支则属于切片。
  • 直觉部分:在进入主题本身之前,先说明目标和核心想法。使用玩具数据(例如三行数据和一个重复项,而不是生产表)和手绘图示,且不使用 ASCII 图,这些材料会在整个走查中复用。
  • 逐步讲解部分:以概念顺序而非源码顺序,用散文式文字承载关键段落。例如,先讲设置标志的写入,再讲信任该标志的读取,最后讲固定顺序的测试,而不必按文件排序;或者先讲主张,再讲证据,最后讲例外,而不必按照论文的章节顺序。
  • 测验部分:使用多项选择题检验实质理解,不设陷阱题。例如,“在关闭期间到达的重试会发生什么”是合适的题目,而“哪个文件被修改了”则不合适。每个选项都带有反馈,说明为什么正确或错误,反馈在读者提交前隐藏;答错时会指出应重新阅读的章节,而不是给出分数、连续答对次数或等级。
  • 讲解风格参考 Martin Kleppmann,要求过渡自然流畅,在关键概念和边界情况处给出标注。每个部分只讲一个想法,删除与测验问题无关的内容(可跳过的层次除外)。
  • 如果主题或其历史中没有说明某个原因,必须明确写明“原因未记录”,绝不猜测。
  • 默认生成一个位于仓库之外的 HTML 页面,文件名为 YYYY-MM-DD-<slug>.html,以长滚动形式呈现,测验直接嵌入页面,并自动打开(open <path>)。

使用方式

用户提出需要深入理解某个内容并接受测验时,技能会按照上述结构生成材料。读者被邀请在根据材料行动之前先通过测验。通过测验是读者自行报告的结果,技能不会代为声称通过。如果读者答错或带来错误解释,技能会找到误导他们的句子,在页面中重写该句子,然后让读者重新回答该问题。

适用场景

适用于用户需要深入理解某个主题、并希望被测验以检验掌握程度的场景。

限制

  • 如果读者缺乏的是“它如何表现”而非“它是什么”,应使用 toy 技能。
  • 如果读者是受众,应使用 land 技能。
  • 如果一张视图或一行普通说明就能说明白,则不适合使用 grasp,应直接说明并停止。
  • 关于收费、价格、平台等具体信息,资料中暂未提供。