Community写作与编辑github.com

steffen74/假定知识

定义课程的前提知识边界——学习者在每个阶段可被假定知道、拥有和能够做的事情,以及如何区分知识差距与合理假设。在编写或审阅面向参与者的说明、任务、设置步骤或测验,以及当学习者遇到困难时使用。

假定知识 是什么?

该技能通过定义学习者在课程各阶段可被合理假设知道、拥有或完成的内容,帮助教育者和AI代理识别并避免“知识差距”。它支持所有主流AI编码工具,如Claude Code和Cursor。其核心机制是维护一个明确的“边界”,将学习者的前置知识、资源和操作能力与课程材料对应起来,任何超出该边界的步骤都被视为一个缺口,需补充材料或提示。该技能提供了详细规则,例如只有明确教授过的内容才能被假设已知,可选材料不扩展边界,且当多个用户角色条件不同时,以较弱者为准。最后,它还列出了典型的知识缺口模式及课堂警示信号,帮助用户快速诊断问题。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steffen74/agentic-course-creation/tree/HEAD/skills/assumed-knowledge

Installed? Explore more 写作与编辑 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

假定知识 是做什么的?

边界是指学习者在课程某个阶段可以被假定知道、拥有和能够做的事情。Canvas 模块 6 保存了课程开始时的边界;每个单元的材料会扩展它。要求学习者执行的每一步都必须处于该点边界内。超出边界的步骤就是缺口:学习者会卡住、猜测或询问。

边界涵盖的内容

不仅仅是概念。缺口通常来自:

  • 他们拥有的东西:账户、订阅、已安装的软件、管理员权限、自己的笔记本电脑、自己的仓库。
  • 他们做过的事情:克隆、分叉、uv sync、加入聊天室、接受邀请。
  • 事物所在的位置:哪个仓库、哪个文件夹、哪个链接。“你克隆的模板仓库”假定他们已经克隆了一个。
  • 约定:什么是命令提示符、在笔记本中“运行”是什么意思、/command 是输入到代理中的内容。

规则

  • 边界由讲师决定。当是否可假设某事不明确时,请询问;不要自行决定。
  • 只有当材料在使用之前已经教授了该内容,或者要求学习者按照可遵循的说明完成时,该内容才算已知。属于同一单元的视频中的内容仅当视频出现在任务之前才计入。
  • 工具(代理、安装脚本)为学习者完成操作,仅当学习者在那一刻被告知要使用该工具,并提供了确切的提示或命令时才计入。
  • 任何步骤所依赖的工件都需要一个源头:创建它的步骤,或者指向其位置的链接。
  • 可选材料绝不会扩展边界。
  • 当两个角色条件不同时,边界遵循较弱的一个,除非模块 6 明确排除了它们。

典型的缺口

  • 指令引用了一个对象(仓库、文件、房间、账户),但缺少创建步骤或只隐晦提及。
  • 两个页面为同一步骤命名了不同的仓库或文件夹。
  • 命令只能在特定文件夹中运行,但页面未说明是哪个。
  • 步骤依赖的工具在一个计划中免费,在另一个计划中收费;页面假设使用了付费计划。
  • 任务需要某个概念,但该概念被安排在后面单元中。

课堂中的危险信号

多名学习者提出相同的问题;学习者在能开始前等待讲师;整个小组缺少交付物。将每个情况视为边界违规,直到证明不是,然后加载 course-checks 将其转化为检查项。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

相关技能