起草一个单元
起草单个单元的资源。读取 COURSE-CANVAS.md、PLAN.md、PERSONAS.md、RESOURCES.md、DECISIONS.md 以及前一单元的资料。使用课程文件现有的结构(标题、表格、语气);如果课程尚无结构,则提出一个并等待确认。
1. 先编写路径
在任何内容之前,在会话文件的讲师笔记中为单元编写 学习者路径,作为编号列表:学员从打开学员页面到提交成果的每一步,每一步需包含
- 他们需要什么(概念、工具、文件、链接、账户)以及该需求来自何处(边界、前一单元、本页面),
- 他们可以看到的预期结果。
加载 assumed-knowledge。如果某步的需求没有来源,则存在缺口:立即通过添加步骤、链接或解释来解决,或者将其交给讲师。展示路径并等待确认;这是检查材料所依据的规格。
2. 起草
根据 RESOURCES.md 起草单元所需的内容,每个部分放在各自位置:
- 讲师:包含时间安排、输入、小组作业、示例答案和讨论要点的授课计划。将输入块写为内容(主张、数字、示例),并考虑讲师笔记;幻灯片之后由
/to-slides据此构建。 - 学员:目标、任务、交付物、附带长度的材料。加载
learner-instructions。 - 模板或代码:任务所依赖的笔记本、数据、配置。
通过运行课程数据上的代码来计算示例答案,绝不能凭记忆。引用数字时应说明其计算方式。
3. 停止点
展示草稿,并附上你做出的选择(任务措辞、使用哪个视频、有多少是可选的)以及你感到不确定的内容。讲师编辑或批准。将影响其他单元的选择记录在 DECISIONS.md 中。
当讲师批准草稿且 RESOURCES.md 将该单元列为 draft 时完成。如果会话包含输入块,建议使用 /to-slides <unit>,然后使用 /walk-through <unit>;在此技能中,永远不要将单元标记为 released。