spiral-curriculum

螺旋式课程设计

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

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

适用范围

用于以下请求：

• 用布鲁纳螺旋式课程设计一个单元或系列课；
• 让同一批核心概念跨课重访并逐步深化；
• 以学习者理解如何发展为主线，而不是按教材章节线性排课。

不要用于：

• 单节独立课，此时使用 /stage-design 和相应主题 Skill；
• 只要求按顺序覆盖内容、没有概念升阶重访的系列，此时使用 /curriculum-planner；
• 风格复制或 PPT 直接导入，此时使用 /style-clone 或 /pptx-import。

第一原则：Revisit 不等于 Review

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

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

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

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

页面内容红线

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

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

概念脊柱

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

• 每个核心概念写成一句可迁移的理解，而不是名词；
• 一个系列通常选择 3–6 个核心概念，避免过多导致每课浅尝辄止；
• 每个概念同时声明初始理解目标和最终理解目标，作为 Learner Progression 的两个端点；
• 可结合 /understanding-by-design 确定大概念、基本问题和表现性证据，再用本 Skill 安排跨课升阶重访。

Spiral Map

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

教师侧 Spiral Map 可以使用：

• ●：首次接触；
• ▲：深化；
• ◆：综合与迁移。

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

规划一次重访

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

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

升阶操作符

• ADD_COMPLEXITY：增加变量或相互作用；
• ADD_RELATION：让当前概念与另一个概念形成必要关系；
• ABSTRACT：从案例上升到一般模型；
• FORMALIZE：引入符号、模型或专业语言；
• CHANGE_REPRESENTATION：在操作、图像模型和符号表征之间重构概念，不机械套成固定课次顺序；
• INCREASE_TRANSFER_DISTANCE：逐渐进入更陌生或跨领域的情境；
• ADD_EXCEPTION：加入反例、边界、约束或局限。

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

概念记忆

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

• concept id；
• encounter history；
• representation history；
• complexity level；
• known relations；
• misconceptions detected；
• examples used；
• transfer distance；
• mastery evidence；
• next revisit target。

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

每课的 Spiral Contract

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

• returning_concepts：哪些旧概念回来；
• new_concepts：哪些概念第一次出现；
• added_complexity：比之前复杂或抽象在哪里；
• new_relation：新增了什么概念关系；
• representation_shift：是否更换表征；
• transfer_target：进入哪个新情境；
• future_hook：故意留下什么，供后续重访。

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. 开始后续课堂前更新概念记忆。

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

假螺旋检查

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

• 同一概念多次出现但复杂度没有提升：Repeated, not spiraled；
• 后面只增加术语，没有增加结构理解：Vocabulary inflation；
• 每课都是新内容，旧概念不回来：Linear curriculum；
• 所谓回顾只发生在单元最后：Review curriculum；
• 概念回来时情境和表征完全相同：Context repetition；
• 后面只是题目更难，不是概念更深：Difficulty escalation without conceptual deepening。

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

完成标准

• 每个概念都有初始理解目标、最终理解目标和完整遭遇史；
• 每次重访都标明主升阶操作符及新增结构；
• 每课都有七字段 Spiral Contract；
• 架构先确认，确认后整个系列被持续持久化到文件夹中；
• 每课实际内容已回读，概念记忆不是只依赖原计划；
• 学生可见文字不包含螺旋元数据、规划黑话或角色台词；
• 每课仍满足 /stage-design 的页面、roster、持久化与音频完成标准；
• 系列通过假螺旋检查。

与其他教学法的关系

• /understanding-by-design 可先确定大概念、基本问题和表现性评估，本 Skill 负责让这些概念跨课升阶重访；
• /feynman-learning 在一节课堂内推动解释反复外化和重建，本 Skill 在整个系列中安排概念反复回来；
• /learning-to-learn 与 /social-emotional-learning 是平行目标，只有服务当前概念重访时才嵌入，不另起课程主线。