spiral-curriculum git:20260827.0462157A

Immutable. This exact content is served forever at /api/v1/blob/fe6fe978ab5ac583.

---
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 在它们之上增加螺旋架构、升阶操作符和假螺旋检查。

## 适用范围

用于以下请求：

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

不要用于：

- 单节独立课，此时使用 `/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` 是平行目标，只有服务当前概念重访时才嵌入，不另起课程主线。