mcpField
C
concept-scaffolding

concept-scaffolding

github.com/panaversity其他46 次安装
代码仓库

关于 concept-scaffolding

用于规划课程或章节中学习者的认知进阶,帮助教育者依据认知负荷、前置知识、示例和检查点组织概念,并可配合 learning-objectives 与 exercise-pack 使用。

主要功能

  1. 01规划 3–7 步学习进阶
  2. 02按熟练度设定概念负荷
  3. 03梳理前置知识与依赖关系
  4. 04安排示例讲解和练习
  5. 05设置理解检查点

适用场景

  1. 01确定学习目标后规划课程
  2. 02将复杂主题拆分为可教步骤
  3. 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 个步骤、每步认知负荷和验证检查点的脚手架计划

关键决策:

  1. 需要多少个步骤?(最优为 3-7 个;根据概念复杂度决定,而非图方便)
  2. 每个步骤包含多少个概念?(按等级划分:A1-A2 = 2-4 个,B1 = 3-5 个,B2+ = 4-7 个)
  3. 每个步骤如何验证理解?(微型检查可避免虚假进步)
  4. 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:先展示完整示例,再进行练习

启发式:先展示完整解法,再要求学习者应用。

认知科学依据:通过先展示解题路径,再要求学习者自行生成答案,完整示例可以减少无关认知负荷。

模式:

  1. 展示:展示带有清晰推理过程的完整示例
  2. 解释:说明每项决策的原因
  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) 装饰器 验证:检验对进阶模式的应用能力


认知负荷分析

步骤新概念数负荷水平是否合适?
12低✓(B1 可应对)
23中等✓(B1 目标)
34中等偏高✓(有 AI 支持)
42低✓(语法糖)
53高✓(可选扩展)

新概念总数: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.

评论

支持 Markdown