SuperAPI AI 工具集

educates-course-design

设计与创作

查看项目

更新于 10-15 21:37

技能介绍

用途:指导 Educates 课程的设计与规划。Educates 是交互式培训平台,课程是 workshop 的结构化集合。该技能从初始需求出发,逐步产出规划文档,作为后续用 educates-workshop-authoring 技能创建 workshop 的蓝图。

工作流共六步,每步在 planning/ 目录生成规划文档,并用 planning/tasks.md 集中跟踪待办。新课程通常按顺序执行;扩展现有课程可从任意步骤进入(如跳到第 3 步规划新 workshop,或第 4 步为单个 workshop 制定计划)。对已有 workshop 的项目,可参考 Retrofitting Existing Courses 审计现有工作并引导生成规划文档。小型课程会简化或跳过部分步骤,流程随第 1 步确定的课程规模调整。

第 1 步:确立课程需求。先判断规模:Focused(1–3 个 workshop)、Standard(4–10 个)、Comprehensive(10+ 且跨多个模块)。收集主题与范围、目标受众、导航模型(core/elective 或线性)。创建 planning/course-brief.md,包含课程愿景、目标受众、交付平台、课程结构、导航模型、设计原则、范围与成长路径。再创建 AI 助手指令文件(如 CLAUDE.md 或 AGENTS.md),指向 README.md、course-brief.md、resources.md,并说明各技能调用时机。最后创建 planning/resources.md,记录课程主题相关的外部文档与参考,供后续会话复用。

第 2 步:头脑风暴并组织主题。Focused 课程此步可选;Standard 覆盖计划范围并记录扩展想法;Comprehensive 力求完整。产出 planning/course-topics.md,按模块或编号列出主题,并附主题选择说明。

第 3 步:规划 workshop 拆分。每个模块一个文件 planning/course-module-X.md(X 为小写字母)。每个 workshop 条目包含覆盖主题、类型、前置条件、学习目标、叙事弧、代码练习、关键代码示例。命名格式为 lab-{code}-{descriptive-name},如 lab-a01-first-decorator。

第 4 步:创建逐 workshop 详细计划。写计划前先调用 educates-workshop-authoring 技能加载 workshop 结构知识,并查阅 planning/resources.md。顺序链中的 workshop 需先读前一个计划;选修 workshop 只读核心前置。计划文件放在 planning/workshop-plans/,采用标准 8 节结构,首节为 Workshop Metadata(名称、标题、描述、时长、难度、类型、前置条件),第二节为 Workshop Configuration(所需会话应用等)。

限制:资料仅覆盖到第 4 步开头,第 5、6 步及后续内容暂未提供。该技能本身不创建 workshop 文件,只产出规划文档。