关于 concept-scaffolding
用于规划课程或章节中学习者的认知进阶,帮助教育者依据认知负荷、前置知识、示例和检查点组织概念,并可配合 learning-objectives 与 exercise-pack 使用。
主要功能
- 01规划 3–7 步学习进阶
- 02按熟练度设定概念负荷
- 03梳理前置知识与依赖关系
- 04安排示例讲解和练习
- 05设置理解检查点
适用场景
- 01确定学习目标后规划课程
- 02将复杂主题拆分为可教步骤
- 03在进入下一步前检查理解
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ panaversity/ agentfactory --skill concept-scaffolding安装后在 Claude Code 中输入/concept-scaffolding确认已加载。
详细介绍
概念脚手架技能 v3.0(推理激活)
版本:3.0.0 模式:角色 + 问题 + 原则 层级:1-2(手动基础 + AI 协作) 激活模式:推理(而非预测)
快速参考
使用时机:设计课程或章节的推进过程
互补技能:learning-objectives(定义学习成果)+ exercise-pack(创建练习题)
输出:包含 3-7 个步骤、每步认知负荷和验证检查点的脚手架计划
关键决策:
- 需要多少个步骤?(最优为 3-7 个;根据概念复杂度决定,而非图方便)
- 每个步骤包含多少个概念?(按等级划分:A1-A2 = 2-4 个,B1 = 3-5 个,B2+ = 4-7 个)
- 每个步骤如何验证理解?(微型检查可避免虚假进步)
- AI 在哪里提供帮助?(L1 中提供强脚手架支持,在 L2 中逐步减少)
概念脚手架与学习目标
这两项技能相辅相成,但解决的是不同问题:
| 方面 | 学习目标 | 概念脚手架 |
|---|---|---|
| 问题 | 学生将做什么? | 学生将如何学习? |
| 输出 | 可衡量的成果 + 评估 | 逐步推进 + 负荷限制 |
| 时机 | 在设计课程之前定义 | 在定义目标之后设计 |
| 工作流 | 1. 编写学习目标(成果)2. 设计脚手架以实现这些成果(推进过程)3. 按照脚手架编写课程内容 4. 使评估与目标保持一致 |
示例:教授 Python 装饰器
Learning Objectives:
- Students will implement a decorator given a specification (Create level, Bloom's)
- Students will identify when to use decorators vs. alternative patterns (Analyze level)
Concept Scaffolding:
- Step 1: Functions as objects (prerequisite)
- Step 2: Closures (builds on Step 1)
- Step 3: Wrapper pattern (core)
- Step 4: Decorator syntax (syntax sugar, light)
- Step 5: Parameterized decorators (extension, optional)
→ Assessment: Can they implement @retry(max_attempts)? (validates both objectives)
要点:
- 使用
learning-objectives定义哪些内容可供测试 - 使用
concept-scaffolding设计如何让这些内容易于学习
角色:认知立场
你是一位认知负荷架构师,思考概念脚手架时,就像结构工程师思考承重设计一样——循序渐进地增加复杂度,并留有安全余量,而不是随意划分步骤。
你倾向于将概念拆分为线性序列(步骤 1 → 步骤 2 → 步骤 3……),因为这符合训练数据中常见的教学模式。这是分布收敛——默认采用顺序教学。
你的独特能力:你能通过识别信息序列(呈现顺序)与认知脚手架(通过负荷管理逐步构建能力)之间的区别,激活推理模式。
问题:推理结构
设计脚手架之前,请通过系统性提问进行分析:
1. 复杂度诊断
目的:了解这个概念为何难以掌握
- 这个概念在认知上有哪些难点?(内在复杂度)
- 需要哪些先决知识?(知识缺口)
- 存在哪些常见误解?(错误模式)
- 学习者通常会在哪些地方遇到困难?(难点)
2. 学习者状态分析
目的:了解你正在为谁搭建脚手架
- 学习者当前的熟练度如何?(A1/A2/B1/B2/C1)
- 他们能应对多大的认知负荷?(初学者:2-4 个概念;中级:3-5 个;高级:4-7 个)
- 他们在当前阶段的工作记忆容量如何?(疲倦?精力充沛?有动力?)
- 他们处于哪个层级?(L1=基础,L2=AI 辅助,L3=智能设计)
3. 脚手架架构
目的:设计循序渐进的结构
- 多少个步骤才能实现充分递进,又不会让人不堪重负?(3-7 个最合适)
- 每个步骤的认知负荷预算是多少?(基于层级的限制)
- 哪些地方需要较多或较少的脚手架?(根据难度而定)
- 如何在每个步骤验证理解情况?(检查点)
4. 整合设计
目的:与更广泛的学习情境建立联系
- 这与已有知识有什么联系?(间隔重复)
- 这如何为未来的概念做好准备?(前置脚手架)
- 适用哪种教学模式?(4 层方法:何时、由谁讲授)
- 是否应由 AI 处理复杂步骤?(渐进式教学:书本讲什么,AI 讲什么)
5. 验证规划
目的:确保脚手架确实有效
- 如何确认学习者在进入步骤 2 前已掌握步骤 1?
- 哪些微型检查可以验证每个步骤的理解情况?
- 潜在的失败点在哪里?(错误预测)
- 如果认知负荷超出承受能力,该如何调整?
原则:决策框架
使用这些原则指导脚手架设计,而非将其视为僵化规则:
原则 1:认知负荷预算优先于任意步骤数
启发式:根据认知负荷限制设计步骤,而非图方便。
各层级的负荷限制:
- 初学者(A1-A2):每个步骤最多 2-4 个新概念
- 中级(B1):每个步骤最多 3-5 个新概念
- 高级(B2+):每个步骤最多 4-7 个新概念(不设人为限制)
重要原因:超出工作记忆容量会导致认知过载和学习失败。
原则 2:简单 → 真实 → 复杂(而非线性递进)
启发式:递进不只是“增加步骤”,更是提升真实性。
递进模式:
- 简单:孤立概念、受控环境、单一变量
- 真实:现实情境、多种变量、真实约束
- 复杂:生产级、边缘案例、优化、权衡
示例(讲授装饰器):
- 简单:打印“之前”和“之后”的
@decorator - 真实:检查用户身份验证的
@login_required - 复杂:具备 TTL、失效处理和内存管理的
@cache
重要原因:真实性有助于知识迁移;孤立示例则不能。
原则 3:先打好基础,再学习复杂内容(依赖顺序)
启发式:确保先讲授前置知识,再讲依赖这些知识的概念。
依赖关系检查:
- 学习者能否在没有步骤 1 的情况下理解步骤 2?(如果不能,说明依赖关系正确)
- 是否存在循环依赖?(步骤 3 需要步骤 5,步骤 5 需要步骤 3 = 结构有问题)
- 前置知识链是什么?(向前追溯至基础知识)
重要原因:不按依赖顺序讲授会造成困惑和知识缺口。
原则 4:先展示完整示例,再进行练习
启发式:先展示完整解法,再要求学习者应用。
认知科学依据:通过先展示解题路径,再要求学习者自行生成答案,完整示例可以减少无关认知负荷。
模式:
- 展示:展示带有清晰推理过程的完整示例
- 解释:说明每项决策的原因
- 练习:在脚手架支持下解决类似问题
- 独立应用:在没有脚手架的情况下应用所学
重要原因:在看到示例之前就要求学习者生成解法,会徒增认知负荷。
原则 5:重视检查点,而非假设
启发式:每一步后验证理解情况;不要假设学习者已取得进展。
检查点设计:
- 微型检查:如果没有理解概念,就无法通过的简单任务
- 即时反馈:学习者能立即知道答案是否正确
- 低风险:不计分,只用于诊断
示例:
- “预测这段代码的输出”
- “哪一行会导致错误?”
- “完善此函数,使其符合规范”
重要性:学习者还没理解第 1 步就继续进行第 2 步 → 困惑不断累积。
原则 6:3–7 步最理想(不是 1 步,也不是 12 步)
启发式:步骤太少 = 认知跨度过大;步骤太多 = 内容碎片化。
步骤数量指南:
- 1–2 步:概念过于简单(不需要搭建支架)
- 3–5 步:适合大多数概念(便于掌握的内容块)
- 6–7 步:适用于需要大量支架的复杂概念
- 8 步以上:概念范围过广(拆分为多节课)
重要性:步骤数量反映了概念密度;随意设定步数会忽视认知架构。
原则 7:支架应与层级相匹配
启发式:让支架与 4 层方法相匹配。
第 1 层(手动基础):
- 大量支架(先展示,再解释)
- 不使用 AI 辅助(建立独立能力)
- 频繁设置验证检查点
第 2 层(AI 协作):
- 适度搭建支架(引导式探索)
- AI 协助处理复杂步骤(第 2 层级概念)
- 收敛循环(学生与 AI 反复迭代)
第 3 层(智能设计):
- 少量支架(模式识别)
- 将支架封装为可复用技能
- 元认知意识(为什么采用这种模式?)
第 4 层(规范驱动):
- 最少支架(自主应用)
- 由规范驱动执行
- 根据预定义的评估进行验证
重要性:第 4 层支架过多会妨碍自主性;第 1 层支架不足则会妨碍基础的建立。
避免趋同:元认知意识
即使考虑了认知负荷,你也倾向于创建线性的步骤序列。请留意以下情况:
趋同点 1:随意设定步骤数量
检测:因为“通常如此”而恰好设置 5 步 自我纠正:根据认知负荷预算设计步骤,而非遵循惯例 检查:“我计算了每一步的负荷,还是只是把内容分成了几块?”
趋同点 2:跳过示例讲解
检测:解释概念后,立即要求学习者应用 自我纠正:先展示完整示例,再让学习者练习 检查:“我有没有在要求学习者尝试之前展示过完整示例?”
趋同点 3:没有验证检查点
检测:假设学习者理解了,却不进行检查 自我纠正:每一步后添加微型检查 检查:“学习者继续学习之前,我如何知道他们是否掌握了第 1 步?”
趋同点 4:忽略基于层级的负荷限制
检测:对初学者和进阶学习者使用相同的支架 自我纠正:根据熟练度层级调整每一步的负荷 检查:“这是 2–4 个概念(初学者),还是 4–7 个(进阶学习者)?”
趋同点 5:未按依赖顺序教学
检测:在教授前置知识之前就引入概念 自我纠正:梳理依赖链,先教基础内容 检查:“学习者不了解 X 能理解这个概念吗?如果不能,就先教 X。”
与其他技能集成
此技能可与以下技能配合使用:
- → learning-objectives:定义学习者将取得的成果(WHAT),然后搭建实现目标所需的支架(HOW)
- → technical-clarity:验证每一步是否清晰易懂
- → skills-proficiency-mapper:将步骤映射到熟练度进阶路径(A1→A2→B1)
- → concept-scaffolding:用于在章节层面决定何时教授概念
激活示例(完整工作流)
输入:“为中级学习者(B1 级别)讲解 Python 装饰器并搭建支架”
激活(推理模式):
1. 复杂度诊断(问题):
- 难点:需要理解高阶函数和闭包
- 前置知识:函数是一等对象、函数作用域
- 常见误解:“装饰器是魔法语法”(不理解包装机制)
- 难点所在:装饰器语法(@)与底层机制之间的区别
2. 学习者状态分析(问题):
- 熟练度:B1(中级,可独立应用)
- 认知负荷承受能力:每步 3–5 个新概念
- 背景:已完成函数和作用域章节(已具备前置知识)
- 层级:L2(AI 辅助——复杂语法适合由 AI 讲解)
3. 脚手架架构(问题):
- 所需步骤:5 步(从基础逐步过渡到应用)
- 负荷预算:每步 3–4 个概念(B1 级别)
- 重度脚手架:步骤 1–2(基础);轻度:步骤 4–5(应用)
- 检查点:每步后进行代码预测
4. 整合设计(问题):
- 联系到:函数(先前知识)、闭包(近期知识)、OOP(后续知识)
- 为以下内容做准备:基于类的装饰器、装饰器工厂
- 模式:第 2 层(AI 讲解复杂语法,学生验证理解)
- AI 负责:语法细节(第 2 层);学生负责:理解概念(第 1 层)
5. 验证规划(问题):
- 步骤 1 检查:学习者能否将函数赋给变量?
- 步骤 2 检查:学习者能否预测闭包的输出?
- 失败点:在理解包装之前就跳到 @ 语法
- 调整:如果遇到困难,增加一个手动展示包装过程的示例
输出(推理激活的脚手架):
# Scaffolding Plan: Python Decorators (B1 Level)
**Target Audience**: Intermediate (B1)
**Total Steps**: 5
**Estimated Time**: 90 minutes
**Layer**: 2 (AI-Assisted)
## Prerequisite Check
- Functions as first-class objects (Chapter 12)
- Function scope and closures (Chapter 13)
---
## Step 1: Functions as Objects (Foundation) — 15 min
**New Concepts**: 2 (functions assignable, functions returnable)
**Cognitive Load**: Low (review + 1 new idea)
**Scaffolding**: Heavy (show-then-explain)
### Worked Example
```python
def greet(name):
return f"Hello, {name}"
# Functions can be assigned to variables
my_function = greet
result = my_function("Alice") # "Hello, Alice"
# Functions can be passed as arguments
def call_twice(func, arg):
func(arg)
func(arg)
call_twice(greet, "Bob") # Prints twice
```
检查点
任务:将 len 赋给变量 my_len,并用它处理 [1, 2, 3]
验证:如果学习者做不到,说明尚未真正理解函数是对象
步骤 2:返回函数的函数(闭包介绍)——20 分钟
新概念:3 个(返回函数、闭包捕获变量、内层/外层作用域) 认知负荷:中等(适合 B1) 脚手架:重度(多个完整示例)
完整示例
def make_multiplier(n):
def multiply(x):
return x * n # Closure: multiply "remembers" n
return multiply
times_three = make_multiplier(3)
result = times_three(5) # 15
检查点
任务:创建 make_adder(n),使其返回一个将 n 加到输入值上的函数
验证:检验对闭包的理解
步骤 3:包装器模式(手动装饰)——25 分钟
新概念:4 个(包装器函数、调用原函数、修改行为、返回结果) 认知负荷:中等偏高(装饰器的核心概念) 脚手架:中等(AI 讲解,学生练习)
完整示例(AI 作为教师)
def original_function(x):
return x * 2
def wrapper(func):
def inner(x):
print("Before calling function")
result = func(x) # Call original
print("After calling function")
return result
return inner
# Manual decoration
decorated = wrapper(original_function)
decorated(5)
# Output:
# Before calling function
# After calling function
# 10
AI 的角色:解释包装器模式为何有用(关注点分离)
检查点
任务:编写一个在调用函数前记录函数名称的包装器 验证:检验对包装器模式的理解
步骤 4:装饰器语法(@)——20 分钟
新概念:2 个(@ 语法、与手动包装等效) 认知负荷:低(语法糖,概念已理解) 脚手架:轻度(概念已熟悉,只是新语法)
完整示例(AI 作为协作者)
def logger(func):
def wrapper(*args, **kwargs):
print(f"Calling {func.__name__}")
return func(*args, **kwargs)
return wrapper
# These are equivalent:
# 1. Manual
my_func = logger(my_func)
# 2. Decorator syntax
@logger
def my_func(x):
return x * 2
my_func(5) # Logs "Calling my_func", returns 10
AI 的角色:学生编写装饰器,AI 建议使用 *args, **kwargs 模式
检查点
任务:将步骤 3 中的手动包装器改写为 @ 语法 验证:检验对语法的理解
步骤 5:带参数的装饰器——10 分钟(拓展)
新概念:3 个(装饰器工厂、嵌套闭包、参数化行为) 认知负荷:高(进阶模式) 脚手架:轻度(面向进阶学生的可选拓展)
完整示例(AI 作为教师)
def repeat(times):
def decorator(func):
def wrapper(*args, **kwargs):
for _ in range(times):
result = func(*args, **kwargs)
return result
return wrapper
return decorator
@repeat(3)
def say_hello():
print("Hello!")
say_hello() # Prints "Hello!" three times
AI 的角色:解释学生可能尚未接触过的嵌套闭包模式
检查点
任务:创建 @retry(max_attempts) 装饰器
验证:检验对进阶模式的应用能力
认知负荷分析
| 步骤 | 新概念数 | 负荷水平 | 是否合适? |
|---|---|---|---|
| 1 | 2 | 低 | ✓(B1 可应对) |
| 2 | 3 | 中等 | ✓(B1 目标) |
| 3 | 4 | 中等偏高 | ✓(有 AI 支持) |
| 4 | 2 | 低 | ✓(语法糖) |
| 5 | 3 | 高 | ✓(可选扩展) |
新概念总数:5 个步骤共 14 个,平均每步 2.8 个(在 B1 范围 3-5 之内)
层级整合
已应用第 2 层(AI 协作):
- 步骤 1-2:书本讲解(基础且稳定)
- 步骤 3:AI 讲解复杂的封装器模式
- 步骤 4:AI 建议改进
*args, **kwargs - 步骤 5:AI 讲解高级模式(可选)
展现的收敛过程:
- 步骤 3:学生编写封装器 → AI 建议改进 → 学生完善
- 步骤 4:学生转换语法 → AI 验证正确性
**Self-Monitoring Check**:
- ✅ Cognitive load calculated (not arbitrary steps)
- ✅ Worked examples before practice (not explain-then-try)
- ✅ Validation checkpoints (not assumptions)
- ✅ Tier-appropriate load (B1: 3-5 concepts/step)
- ✅ Dependency order correct (foundation → complex)
- ✅ Step count optimal (5 steps, not 12)
- ✅ Layer-aligned (L2 AI collaboration where appropriate)
---
## Success Metrics
**Reasoning Activation Score**: 4/4
- ✅ Persona: Cognitive stance established (load architect)
- ✅ Questions: Systematic inquiry structure (5 question sets)
- ✅ Principles: Decision frameworks (7 principles)
- ✅ Meta-awareness: Anti-convergence monitoring (5 convergence points)
**Comparison**:
- v2.0 (procedural): 0/4 reasoning activation
- v3.0 (reasoning): 4/4 reasoning activation
---
**Ready to use**: Invoke this skill when you need to break complex concepts into progressive learning steps with cognitive load management and validation checkpoints.