← Về thư mục
📄 / / projects / tech / OpenMAIC / app / skills / agent-runtime / spiral-curriculum / SKILL.md

name: spiral-curriculum title: "螺旋式课程设计" description: "Design a multi-stage OpenMAIC course series around a small concept spine whose ideas return repeatedly at higher levels of complexity, abstraction, relationship density, representation, transfer distance, or boundary awareness. Use when the user explicitly wants a Bruner-style spiral curriculum, progressive conceptual revisits, or a series organized by how understanding develops rather than by a linear topic list. Do not use for a single standalone stage or a series that only needs sequential coverage."


螺旋式课程设计

设计一组系列课,让少数核心概念在整个系列中反复回来,并且每次都发生结构性升阶。最小设计对象是“概念脊柱 + 每个概念的遭遇史”,不是某一节课的目录。

先加载 /stage-design 获取单节课堂的创建基线,并加载 /curriculum-planner 获取多课堂文件夹、跨课堂读取和批量交付规则。本 Skill 在它们之上增加螺旋架构、升阶操作符和假螺旋检查。

适用范围

用于以下请求:

不要用于:

第一原则:Revisit 不等于 Review

“第 1 课讲概念、第 3 课复习概念、第 6 课再复习”不是螺旋。每次重访必须明确回答:这一次比上一次多了什么?

每次重访至少在以下一个维度升级:

维度 初次接触 后续重访
复杂度 单一关系 多变量相互作用
抽象度 具体案例 一般模型
关系密度 孤立概念 与更多概念连接
表征方式 直观经验 图示、模型、符号
迁移距离 熟悉情境 陌生情境、跨领域
边界与反例 正例 反例、边界、局限

如果一次回来没有在任何维度更高,就只是重复,必须重写。

页面内容红线

Concept Spine、encounter、growth operator、Spiral Contract、revisit、概念脊柱、遭遇史、●/▲/◆ 等属于教师侧规划语言。它们可以出现在对话、架构和页面 brief 中,不得出现在学生可见的标题、标签或正文。

“本次比上次多了什么”写进 brief,不写成学生页面上的“复杂度升级”标签。老师与代理的口述走 narration / actions,不写成“老师说”“学生说”的静态正文。

概念脊柱

不要先排课时清单。先回答:整个系列结束后,学生真正应该建立哪几个能够反复使用和迁移的核心观念?

Spiral Map

为每个核心概念维护跨课遭遇史:直觉经验 → 机制解释 → 多变量关系 → 形式化模型 → 陌生情境迁移 → 与其他概念整合。

教师侧 Spiral Map 可以使用:

每个标记旁边还必须写明本次新增结构。只有符号、没有升阶说明的表格没有价值。

规划一次重访

对每个 concept + previous encounter + target growth 决定四件事:

  1. 保留什么:哪些已有理解不需要重新教学;
  2. 增加什么:本轮新增的内容或条件;
  3. 重组什么:哪些孤立知识需要组成机制或关系;
  4. 迁移到哪里:用哪个新情境检验概念结构。

升阶操作符

一次重访通常选择 1 个主操作符和少量辅助操作符。不要一次叠满所有操作符,那只会堆难度。

概念记忆

螺旋依赖跨 stage 的共享记忆。平台不会替本 Skill 自动维护概念模型,所以要在当前对话中保存教师侧运行记录,至少包含:

开始下一课前,使用 read_stage_outline 回读前面课堂的持久化页面列表;需要核对真实内容时继续用 read_stage。不要只相信原计划,要依据已经落进课堂的内容调整本轮“保留、增加、重组、迁移”。

每课的 Spiral Contract

每个 stage 在教师侧规划中必须有一份 contract:

future_hook 允许 productive incompleteness:早期先建立可用但不完整的模型,后续再重组,不要求每课把概念彻底讲完。

两层设计

第一层:Spiral Architecture

先在对话中产出并请用户确认:

  1. Concept Spine:每个核心概念的初始与最终理解目标;
  2. Course Timeline:各课的主题和任务;
  3. Concept Spiral Map:每个概念何时出现、何时回来、每次增加什么;
  4. Learner Progression:学生理解应怎样逐课变化;
  5. 每课的 Spiral Contract 和概念交叉点。

使用 ask_user 让用户能调整课时数、概念出现时机、深度与交叉关系。架构未确认前不要创建课堂。

第二层:Generate Lessons

架构确认后,默认把整个已批准系列持续建到完成,不在每课之间重复停下确认,除非用户明确要求分批验收:

  1. create_folder 创建系列文件夹;
  2. 每课调用 create_stage,传入该 folderId;
  3. 每课先 set_roster,再按批准计划逐页 generate_scene;
  4. 需要补写旁白时逐页 generate_actions,修改旁白后补 generate_tts;
  5. 使用 list_scenes、read_stage_outline 和 read_stage 验收持久化结果;
  6. 开始后续课堂前更新概念记忆。

架构本身只留在教师侧规划中,不生成成学生页面。

假螺旋检查

整套系列完成后逐概念检查:

命中任一项,回到对应 Spiral Contract 修改页面 brief 或课程安排,再重新验收。

完成标准

与其他教学法的关系