准备手册和工具
本例使用 The Carpentries 的 Instructor Training:一份包含 25 个单元的讲师培训手册。可从完整手册页面阅读,并查看授权说明。正文采用 CC BY 4.0;转载或改编时需保留署名、来源、许可和改动说明,单独署名的素材需要另行核权。
本次参考 book-to-skill 的固定版本。它提供从文档中提取内容和组织 Skill 的方法;安装说明列出了不同智能体的安装方式。
本次把参考指引当作文件交给智能体读取,完整工具的安装另查官方说明。你可以下载与示范相同的指引和许可,解压后检查其中的 SKILL.md。
本次先使用已归档的手册网页文本。提取器第一次识别出 137 个章节,与原文的 25 个单元对不上;我们给每个原有单元补上编号标题后,再次提取到 25 个。补标题是作者的材料准备动作;数量对上只能说明结构被识别,还要检查正文与出处。
打开本次归档文本,保存为 instructor-training.md;此入口需连接本次使用的局域网资源服务。准备脚本需要本机可运行 Python 3。下载下面的脚本,与文本放在同一文件夹,再运行命令。脚本只适用于这份包含 25 个单元标记的归档,不适用于任意网页或 PDF。归档保留原文中的第三方来源标注,另行分享仍需核权。
python3 prepare-manual.py instructor-training.md instructor-training-numbered.md作者重新下载并执行后,确认得到 25 个单元、原文可还原;生成文件与智能体实际读取的版本逐字一致。
查看准备脚本的实际输出
单元:25;来源 SHA256:046bddf3b97e2672dbe0a23b7165b5c6fe60999186657c0f2eeb607626c7648c;准备版 SHA256:c08566b1af601b3387d9fa21ed633d4551fbf82093cef8abea52566090c123d3;原文可还原。
后续输入中的路径属于这次隔离环境,请替换为你实际保存的文件路径。无法访问归档时,可从官网当前版本准备自己的文本,但要重新核对结构与版本。
让智能体生成第一版
我们把 book-to-skill 的说明和准备后的完整手册交给智能体。这个环境允许它读取指定文件,但不能写文件,所以请求它在回复里直接给出文件内容。它分段读取手册后交付了单文件版本;这是根据 book-to-skill 指引整理,不能据此声称该技能的自动安装或全部脚本运行成功。
请把 The Carpentries 的讲师培训手册转换成一个可以以后反复使用的 Skill,帮助我设计面向初学者的短课。先阅读 /private/tmp/book-to-skill-retake-20261027/attempt-001/inputs/SKILL.md 中 book-to-skill 的方法,再阅读 /private/tmp/book-to-skill-retake-20261027/attempt-001/inputs/instructor-training-numbered.md 中的手册。手册共有 3333 行,请分段读取,不要把未读到的内容当成已读。 本次你只能读取文件、不能写入文件:请直接在回复里给出完整的 Skill 文件内容,我会另存。请保留原书作者、来源、CC BY 4.0 许可和章节来源,说明适用场景、工作步骤、输出格式及局限。请覆盖手册的 25 个单元,让我能从你的 Skill 找回对应原文;可把必要的章节提要放在同一个 SKILL.md 里。不要输出计划后等待确认,直接给出实际文件内容;如果无法完成,请说明实际读取范围和缺口,不要编造。
已完整读取两份文件:方法文件 SKILL.md(880 行,全文)和手册 instructor-training-numbered.md 的全部 3333 行(分 5 段读取:1–700、701–1500、1501–2300、2301–2900、2901–3333),无缺口。手册共 25 个单元(Chapter 1–25),其中 6 个是休息页(Ch 3、7、10、16、19、22),24 个实质教学单元全部覆盖。
以下是可以直接另存的完整 Skill 文件内容(单文件版,按要求把章节提要并入同一个 SKILL.md):
生成文件内容 · SKILL.md
Skill 配置
---
name: carpentries-short-course-design
description: "基于 The Carpentries 讲师培训手册(Instructor Training,CC BY 4.0)提炼的初学者短课设计技能。用于设计或改造面向初学者(novice)的短课/动手工作坊:确定可评估的学习目标、绘制概念图、设计有诊断力的形成性评估、规划参与式现场编程(participatory live coding)、管理认知负荷、设计开场与收尾、建立反馈闭环。当用户要设计编程/数据/技术类入门短课、把现有材料改造成初学者友好版本、或需要按证据本位教学法(evidence-based teaching)审查课程设计时使用。"
---
Carpentries 初学者短课设计技能(carpentries-short-course-design)
来源与许可(Attribution)
- 原作:The Carpentries Instructor Training(讲师培训课程),由 The Carpentries 社区编写与维护(源码仓库
carpentries/instructor-training,每页页首有 "Last updated" 与 "Edit this page" 记录)。 - 来源:All-in-One 页面 https://carpentries.github.io/instructor-training/aio.html;本地抓取文本
instructor-training-numbered.md(共 3333 行),抓取时间 2026-10-27,工具 firecrawl。 - 许可:CC BY 4.0(https://creativecommons.org/licenses/by/4.0/)。Carpentries 教材以宽松开放许可发布(手册第 15 单元明确:材料可在 Carpentries 工作坊之外使用,但须注明出处)。本 Skill 为综合性提炼而非原文复制;引用原文请回到各单元给出的 URL 与行号。
- 本 Skill 生成日期:2026-10-27。线上手册持续更新,时效性内容以官网为准。
何时使用这个 Skill(适用场景)
适用:
- 设计 1–3 小时到半天以内的初学者短课(Shell、Git、Python、R、SQL、OpenRefine、电子表格数据等,或其他领域的"零基础动手课")。
- 把大学讲义、文档或长课程裁剪成初学者友好的短课。
- 审查一份课程设计的教学法问题:节奏、评估、认知负荷、动机、包容性。
- 准备试讲、获取与给予教学反馈(2x2 反馈法)、以及课后复盘迭代。
不适用:
- 学科内容本身的教学(本 Skill 不教 Shell/R/Python 的具体知识)。
- 长学期课程的整体课程体系设计(手册明确不覆盖课程开发,参见 Carpentries 另设的 Collaborative Lesson Development Training,第 15 单元有链接)。
- 需要官方品牌(branded)Carpentries 工作坊的合规操作细节——相关组织信息只在第 14、15 单元提要中保留索引。
核心模型与决策规则(Core Frameworks & Decision Rules)
以下保留原书命名。每条注明出处单元,便于回溯。
1. 技能习得三阶段(Dreyfus model,经 Patricia Benner 应用)— 第 2 单元
- Novice(新手):不知道自己不知道什么,没有可用心智模型,提问可能跑题。
- Competent practitioner(胜任实践者):日常任务够用,理解不完全准确但足以正常工作。
- Expert(专家):能轻松应对非寻常情况;心智模型连接密集,能从问题 A 直接跳到解法 F。
- 决策规则:初学者短课的目标读者是 novice;教学目标不是传授语法事实,而是帮学员建立一个可用的心智模型(mental model)——让他们知道"该怎么想",之后才能自学。
2. 心智模型与概念图(concept map,Novak 1970s)— 第 2 单元
- 理解是内部表征,不是现实的镜像;"All models are wrong, but some are useful."(George Box)
- 备课时把主题画成概念图:3–6 个核心概念 + 有标注的关系箭头。作用是强迫你说出平时默认的连接、暴露缺口,并发现"一次想教的东西太多"。
- 类比(analogy)能加速学习但都会失真——只有当其收益大于其产生的误解风险时才用。
3. 三类误解(misconceptions)— 第 2 单元
- Factual errors(事实错误):孤立、易纠正。
- Broken models(破损模型):能自洽地预测但整体错了,需要学员经历矛盾才能拆掉重建——初学者课堂最需要盯防的一类。
- Fundamental beliefs(根本信念):与身份绑定,最难改变(如"我不是学计算机的料")。
- 旧模型用得越久、要"遗忘"(unlearn)的越多,新知识吸收越慢。
4. 形成性评估(formative assessment)— 第 2、5、18 单元
- 定义:在学习过程中实施、用于即时调整教学的评估(区别于总结性的 summative,如考试)。
- 频率决策规则:理想每 5 分钟一次,至少每 10–15 分钟一次;平均注意力跨度只有这么长。
- 有诊断力的选择题(MCQ with diagnostic power):每个错误选项对应一种可识别的误解。经典例:27+15=?,选项 42/32/312/33——答 32 = 完全丢掉进位;答 312 = 知道不能丢但不知道进位是"十",把各列当独立处理;答 33 = 把进位加回了原来的列。
- 结果三分支处理:多数选同一错项 → 全班性误解,停下来纠正;多数选对 → 简单讲解后继续(助教照看个别不确定者);各选项均匀分布 → 学员在瞎猜,说明没有心智模型,回退到全班上一次同步的点。
- 无效做法:问"大家听懂了吗?"(Do you understand?)——学员倾向承认听懂,且 Dunning-Kruger 效应使自我评估失真。
- 其他低成本形式:faded examples(挖空的完整示例,填空式编程块)、Parson's Problems(打乱代码行排序)、给图表/流程图贴标签。
- 警惕过于开放式的任务:让初学者同时记忆并综合推理极易引发过载(概念图适合教师备课用,不适合当 novice 课堂活动)。
5. 专家意识差距(expert awareness gap,即文献中的 expert blind spot)— 第 4 单元
- 专家从 A 直接跳到 F,忘记初学者需要经过 B、C;还会不自觉混用可互换的词与记号(如 Unix/Bash/shell,绝对/相对路径)。
- 决策规则:逐步显式化每一步;显式示范你如何读错误信息;请较少专家的同事帮你审教案;频繁的形成性评估会把你的意识差距暴露出来。
- 语言红线(dismissive language):不用 "just"("你只要……就行了");替代句式:"这个任务一旦学会会变得非常容易" "接下来只需学两个新命令"。不用"有没有问题?"(暗示你不期待问题),改问 "你们有什么问题?"(What questions do you have?)并留出停顿。
6. 记忆与认知负荷(Sweller 认知负荷理论)— 第 5 单元
- 长期记忆几乎无限但存取慢;短期/工作记忆约 7±2 项(Miller 1956),新研究认为更小,只维持几秒。
- Chunking(组块):建立连接让多项信息作为一个块被记住。
- 负荷三分:intrinsic(完成任务本身要想的)、germane(把任务与新旧知识连接的)、extraneous(干扰与无关负荷)。适度困难有益,extraneous 要尽量消减。
- Split-attention effect(分配注意效应):视觉呈现与口述应指向同一内容——所以现场编程时边敲边念命令;屏幕内容尽量与你说的完全一致;不要投屏教案页面。
- 决策规则:初学者用 guided practice(有引导的练习),不用 minimal guidance/discovery learning——后者要求学员同时掌握领域内容和搜索/解题策略,对 novice 经常失效(Kirshner et al.)。
- 支持记忆巩固的手段:高频形成性评估(超时未用,信息已从短期记忆掉出)、小组协作与出声解释(elaboration——教是最好的学)、留出反思时间、限制概念数量(备课概念图帮你发现贪多)、屏幕旁维护一份"命令术语流水表"(running glossary,可由助教负责)。
7. 动机与去动机(motivation & demotivation)— 第 8 单元
- 内容选择图:横轴"掌握所需平均时间"、纵轴"掌握后的用处"——先教"快学会 × 立刻有用"(左上角),放弃"难学 × 近期无用"(右下角)。优先选 authentic tasks(真实任务):从业者日常工作里真实做的事。
- 注意时间估计要计入失败频率(novice 找不到自己保存的文件是常态);新手讲师请有经验者帮你估时。
- 成长型思维(growth mindset,Carol Dweck)四个干预:
- Positive error framing:把错误当作学习机会来介绍("The typos are the pedagogy." — Emily Jane McTavish);
- 把讲师呈现为学习者:现场编程时拥抱自己的失误、分享自己的学习经历;
- 表扬努力或进步,而非表现或天赋("你试了两种策略" ✓;"你真是天才" ✗);
- "yet" 的力量:把"我不会 X"补成"我还不会 X"。
- 去动机行为禁令(First, do no harm):鄙视任何工具或其使用者;与个别超前学员深入技术讨论;不懂装懂;说 "just";接管学员键盘(剥夺肌肉记忆,暗示"你太慢了");对无知表示惊讶("你连 X 都没听说过?",参见 Recurse Center Social Rules)。
8. 公平、包容与无障碍(equity, inclusion, accessibility)— 第 9 单元
- 术语:Equity 指结果的公平分布(≠ equality 的同等对待);Inclusion 让被排斥的群体实质性参与并分享权力;Accessibility 从设计上让所有人以同等效力使用。
- Universal Design for Learning(UDL,CAST):责任在设计者而非学员——为学员提供多种方式来 接收、参与、分享 信息;为障碍设计会让所有人受益(curb-cut effect 路缘坡效应)。
- 优先做 universal design 而非事后"便利措施"(accommodations,Carpentries 现改称 accessibility support):后者把披露负担压给学员,而很多人不愿事先申请。
- 刻板印象与 stereotype threat:提醒某刻板印象本身就会增加认知负荷、干扰学习;避免以"夸奖"形式复述刻板印象。
- 倾听信号:负面反馈之外,沉默/收不到反馈也是警报;保留匿名反馈渠道;主动轻声check in你没听到的人。
- 开场明示 Code of Conduct(行为准则),建立明确包容的环境。
9. 教学是技能 + 2x2 反馈法 — 第 11、20 单元
- 教学不是天赋:通过 lesson study(课例研究,日语 jugyokenkyu)——互相观察、课后研讨——教师技能才能传播(读文献不足以改变教学行为)。
- 2x2 反馈范式:每人对 内容(content)/ 表达(delivery) 各维度,都给至少一条 正面 与一条 建设性(负面) 反馈,防止只评内容或只说好话。
- 反馈操作要点:主动索求;要具体(用你自己设计的聚焦问题,如"作为讲师我做哪一件事能让这课更有效?");正负平衡(compliment sandwich);负面反馈附明确的下一步;约定反馈方式;可请"反馈翻译者"汇总执行摘要;自我提醒——反馈不是人身攻击。
- Reflective practice(反思性练习)≠ 重复:反复做同一件事固化坏习惯;"练习"是做相似而不同的事、拿反馈、改行为。
10. 参与式现场编程(participatory live coding)— 第 17 单元
- 定义:讲师不用幻灯片,现场敲代码/命令,学员同步跟敲(code-along)。
- 为什么用:写程序比翻幻灯片有说服力;能响应"如果……呢?"的问题;传递隐性知识(lateral/tacit knowledge);把讲师压慢到学员两倍速以内(幻灯片会快十倍);学员看见错误并学会诊断修正。
- 挑战:需要即兴;学员边听边敲受分配注意效应影响——所以先说要做什么 → 边敲边念 → 敲完再解释;需要练习边想边说。
- Top Ten Tips(保留原文要点):
- 用多种方式让全员参与(麦克风、露脸摄像头、走动、手势);
- 慢:每敲一个命令/词/菜单都念出来,再指着屏幕复述一遍——绝不复制粘贴代码;
- 镜像学员的环境(少用键盘快捷键);
- 用好屏幕(大字号、窗口最大化、白底黑字、抬高窗口底边避免后排看不见);
- 用板书插图随进度生长;
- 关掉所有通知;
- 忠实于教材:别临时炫技;想加内容必须课前完整试跑;
- 不落下任何一个学员(配合便利贴);
- 拥抱错误(当作 error framing 素材);
- 玩得开心。
11. 课堂管理(团队、便利贴、混合水平)— 第 21 单元
- Never teach alone:每场至少 2 名讲师 + 助教(helper 建议比例 ≥1:10)。三种角色:host(后勤)、Instructors、helpers。助教也要提前接受教学法 brief。
- 共同教学模型:team teaching(两人接力如乐手轮奏solo)与 teach and assist(一人教、一人巡场,最常用)。非主讲者不打断、不纠偏、不插话;可约定手势("太快了""大点声""该休息了");每人连续教 10–15 分钟以上(过快轮换分散注意力),通常半天 2–3 小时一人。
- 便利贴(sticky notes):两种颜色贴在笔记本电脑上当"求助/完成"信号旗——比举手更隐蔽、可继续工作、讲台一目了然。用蓝/黄等颜色,不用红/绿(色盲友好);线上用 Zoom 的 ✓/✕ 反应。要主动频繁地请求学员使用。
- 混合水平策略:招生文案写明学习目标让水平匹配成为知情选择;练习设"基础版 + 进阶版";鼓励先完成的学员帮邻座(新手在敲键盘);别让 advanced 学员主导提问(留到休息/线上跟进);助教与轮休讲师盯防掉队者、尽早干预。
12. 开场与收尾(launches and landings)— 第 23 单元
- Primacy effect(首因效应):开场体验塑造整场印象。开场 8 项目标:留下正面第一印象;有效介绍讲师团队;澄清学习目标与期望;让学员互相认识;定调(含行为准则);采集学员基线数据;吊起内容胃口;交代后勤。附:讲师开场后学员应能预测教学方式、知道将学什么、明白被要求做什么、相信自己学得会、知道日程。
- 布景细节:着装、教室环境、开讲前几分钟的状态、自我介绍内容(经验/正式度/可接近性/热情/动机)、适度暴露疑虑但不动摇信心、轻量破冰(例:转身向邻座介绍名字 + 一个关于你研究的词 + 一件你做过的自豪的东西)。
- 收尾:宁可砍内容也要准点结束,把最后 15–20 分钟留给我收尾而非赶进度。可做的事:保存并指出文件位置、反思学到了什么、规划下一步、给出"几天内把技能用于自己工作"的具体建议、收集反馈、请 host 致结束语、庆祝并致谢。
设计工作流(Workflow:八步设计一门初学者短课)
按顺序执行。每步标注依据单元,需要细节时回读。
- 界定学员画像(第 18 单元):默想一位具体学员——背景、面对的问题、课后的收益;用课前调查数据(若有)校准。写下他们没有哪些心智模型。
- 选题与排序(第 8 单元):列出候选任务,摆在"掌握时间 × 掌握后用处"四象限图上;只保留左上象限与接近左上的项;每项尽量锚定一个 authentic task。右下象限的内容明确写进"本课不教"。
- 绘制概念图并限流(第 2、5 单元):为你自己(讲师)画 3–6 个核心概念的概念图;数一数每一步新引入的概念+关系数量,超过短期记忆容量的逐步拆开或删掉。写出本课要建立的心智模型一句话描述。
- 写可评估的学习目标(第 18 单元):2–4 条,用 novice 级动词(recognise / distinguish / use…),避免 design / evaluate / break down 等高阶动词,避免不可评估的 know / understand。为每条目标标注"学员应在哪个时间点达成"(checkpoint)。
- 布置形成性评估(第 2、5、18 单元):在每个 checkpoint 放一个窄焦点评估:优先带诊断力的 MCQ(为每个错误选项写出它诊断的误解)、faded example 或 Parson's problem;频率每 5–15 分钟一次;为三种投票结果各写一句应对方案(多数错/多数对/均匀分布)。删除开放式大任务。
- 编排参与式现场编程脚本(第 17、5 单元):把主体内容写成"先说→边敲边念→敲完再解释"的三段式;标注绝不复制粘贴;检查屏幕/环境清单(大字号、白底黑字、关通知、镜像学员环境);计划在哪用板书插图;预埋 1–2 个"故意犯错"的诊断演示。
- 设计开场与收尾(第 23 单元):对照开场 8 项目标写开场稿(含行为准则声明与破冰);写收尾清单(保存文件、指路材料、反思、下一步、反馈、致谢庆祝),并把它们排进时间表——先排收尾时间,再排内容。
- 布置反馈与迭代闭环(第 6、11、21、18 单元):排入 minute cards(每次长休前、匿名、正负各一问);结束时 one up one down 或课后调查;审一遍"去动机禁令"与无障碍清单(UDL 三通道);课后收进 prior feedback,下次开课前重读。
时间不够时的裁剪规则(第 18 单元):准点休息不动摇;跳步骤先查文件依赖;保住收尾时段;绝不加速赶课(内容学员可自学,掉队回不来);把砍掉的内容同步给团队与学员。
输出格式(Output Template)
使用本 Skill 设计时,按以下结构产出一份《短课设计稿》(Markdown):
# <短课标题> 设计稿
## 1. 学员画像
(背景 / 已有与缺失的心智模型 / 动机 / 预判的 broken models)
## 2. 真实任务与选题依据
(authentic task 描述;在"掌握时间 × 用处"图上的位置;明确不教的内容)
## 3. 概念图(讲师版)
(3–6 个概念 + 关系箭头;一句话心智模型)
## 4. 学习目标(可评估)
(2–4 条,novice 动词;每条附 checkpoint 时刻)
## 5. 流程表(run of show)
| 时间 | 讲师做什么 | 学员做什么 | 形成性评估 |
|------|------------|------------|------------|
## 6. 形成性评估设计
(每题:题面、选项、每个错误选项的诊断、三种结果分布的应对)
## 7. 现场编程脚本要点
(先说/边敲边念/再解释的切换点;插图计划;故意犯错的点位)
## 8. 开场稿(8 项检查)与收尾清单
## 9. 去动机与无障碍审计
(对照禁令清单逐条自查;UDL 接收/参与/分享三通道各列出做法)
## 10. 反馈计划
(minute card 提示语、结束时反馈方式、课后迭代记什么)
反模式清单(Anti-patterns)
- "空容器"式灌输:对没有心智模型的人堆事实,只会强化错误模型(第 2 单元)。
- minimal guidance 用于初学者:发现式/探究式学习对 novice 经常失效(第 5 单元)。
- 投屏教案/幻灯片教代码:制造分配注意负荷;屏幕应与口述一致(第 5、17 单元)。
- 复制粘贴代码:速度失控,学员跟不上(第 17 单元)。
- "just"、"你连这都不知道"、"有没有问题": dismissive / 封闭式语言(第 4、8 单元)。
- 替学员打字:剥夺练习与肌肉记忆(第 8 单元)。
- 问"听懂了吗"代替评估(第 18 单元)。
- 临场炫技偏离教材(第 17 单元)。
- 为赶进度加速、拖堂(第 18、23 单元)。
- 让 advanced 学员主导课堂(第 21 单元)。
- 表扬天赋而非努力(第 8 单元)。
- 只用红绿便利贴(色盲不友好,第 21 单元)。
25 单元章节提要(Chapter Index,可回溯原文)
每条给出:原文 URL(基址
https://carpentries.github.io/instructor-training/)与本地文件instructor-training-numbered.md的行号范围。行号即该单元在抓取文本中的起止位置。
| # | 单元 | 原文文件 | 本地行号 | 提要与关键框架 |
|---|---|---|---|---|
| 1 | Welcome | 01-welcome.html | 8–222 | 培训四目标(应用研究本位教学原则、包容环境、练习教学方法、了解组织);Carpentries 三大 Lesson Program(SWC 计算基础 / DC 数据全流程 / LC 图书馆场景);行为准则与举报渠道;称呼与代词礼仪;本培训不教具体课程内容、不教课程开发。Key points:社区实践共同体;学员动机与先备知识差异大。 |
| 2 | Building Skill With Practice | 02-practice-learning.html | 223–535 | 核心单元。技能习得三阶段(novice/competent/expert);心智模型与概念图(球-排水例);类比的力量与失真;三类误解(factual errors / broken models / fundamental beliefs);形成性评估 vs summative;27+15 诊断性 MCQ 与三种结果分布应对;"教慢点"——Shell 课 40 分钟只教 4 个命令,真正在教路径的心智模型;对 novice 过早堆事实会强化错误模型;"在学员所在之处相遇"。 |
| 3 | Part 1 Break | 03-coffee.html | 536–546 | 休息页,无内容。 |
| 4 | Expertise and Instruction | 04-expertise.html | 548–751 | 专家 = 连接更密的心智模型(A→F 直跳);expert awareness gap(Carpentries 对 expert blind spot 的包容性改称,含改名理由); interchangeable language 问题(Unix/Bash/shell);显式示范错误诊断;dismissive language 与 "just" 的替代句;"有没有问题" vs "你们有什么问题"+停顿;不要以自己的学艺经历推及学员(研究者的目标是做研究不是学编程);"Carpentries 不是计算机科学";专家依然可以是好老师——前提是识别并修正意识差距。 |
| 5 | Memory and Cognitive Load | 05-memory.html | 752–963 | 长期/短期记忆;Miller 7±2 与记忆小测试;chunking;形成性评估支持巩固(要趁信息还在短期记忆时用);小组协作(elaboration)与反思;限制概念数;Sweller 三类负荷(intrinsic/germane/extraneous);guided practice vs minimal guidance(Kirshner et al.,"hand-holding"质疑的回应);faded examples、Parson's Problems、图表标注;split-attention effect → 边敲边念、不投屏教案;running glossary。 |
| 6 | Building Skill With Feedback | 06-feedback.html | 965–1081 | 对讲师的反馈闭环:课前/课后调查(结果 dashboard 只给讲师);minute cards(长休前、匿名、正/负提示语示例);one up one down(一天结束、正负交替、不重复、讲师只记录不回应、事后讨论如何回应);把"根据反馈做了什么改变"明说出来。 |
| 7 | End Part 1 | 07-lunch.html | 1082–1092 | 休息页。 |
| 8 | Motivation and Demotivation | 08-motivation.html | 1094–1287 | "先教快学会×立刻有用"四象限图;authentic tasks(Think-Pair-Share 练习);时间估计要计入失败频率;邀请参与的三招(互动规范/结伴编程-新手握键盘/善意确认困惑);growth mindset 四干预(positive error framing、讲师呈现为学习者、表扬努力与进步、"yet");表扬分类练习;去动机禁令六条(鄙视工具/与超前者深聊/不懂装懂/"just"/接管键盘/对无知表示惊讶);讲师自身动机也重要("你为什么教学"写入教学哲学)。 |
| 9 | Equity, Inclusion, and Accessibility | 09-eia.html | 1289–1535 | equity/inclusion/accessibility 定义(Pitt DEI 词汇表改写);Carpentries 九条 Core Values;accessibility support(原 accommodations)与 universal design 的区别;UDL(CAST):接收/参与/分享多通道;"每次进步一点点、先做容易的事";刻板印象(外显/内隐)与 stereotype threat;沉默也是警报、保留匿名反馈、检视自己的差别对待;团队报名的价值;以行为准则设定期待。 |
| 10 | Part 2 Break | 10-coffee.html | 1537–1547 | 休息页。 |
| 11 | Teaching is a Skill | 11-practice-teaching.html | 1549–1713 | teaching is learned not innate(Elizabeth Green《Building a Better Teacher》);日本 lesson study(jugyokenkyu,Stigler 研究);仅靠阅读不会改变教学行为(三篇研究证据);2x2 反馈范式(正/负 × 内容/表达);反馈操作清单(主动索求、具体、平衡、明确下一步、约定方式、反馈翻译者);"Never teach alone";90 秒迷你试讲 + 反馈练习流程;把反馈转成一条具体改变。 |
| 12 | End Part 2 and Preparation | 12-homework.html | 1715–1808 | 半程总结;课后作业(读工作坊组织文档;选一个 lesson episode 备 3 分钟现场编程——附 SWC/DC/LC 推荐清单);日终反思练习(概念图/漫画/提纲/日志等入口建议)。 |
| 13 | Welcome Back | 13-second-welcome.html | 1810–1860 | 复习四目标与前半程要点;预告后半程:participatory live coding 是重点练习;Key points:教大图景而非细节、靠高频反馈监控、少量概念避免过载、用立刻有用的内容激励、教学是可学技能。 |
| 14 | Getting Started on Instructor Certification | 14-checkout.html | 1862–1939 | 认证 checkout 三步(Community Welcome session、Teaching Demonstration、Get Involved 提交 AMY);90 天期限与延期;badge 权益(教任何 Carpentries 工作坊、理事会选举投票、简历素材)。 |
| 15 | The Carpentries: How We Operate | 15-carpentries.html | 1941–2243 | 组织史(SWC 1998 / DC 2014 / LC 2014 / 2018 合并 / 2025 独立 501(c)(3));三 Program 异同(维恩图);名称与 logo 受商标保护,材料开放许可(CC);branded 工作坊要求 vs "Carpentries-based";mix-and-match 工作坊报备;centrally-organised vs self-organised;社区词汇表(Lesson/Episode/Workshop/Lesson Program/Instructor/Trainer);lesson incubation(Workbench 模板、Incubator、CC-BY/CC0);贡献文化;保持联络渠道。 |
| 16 | Part 3 Break | 16-coffee.html | 2245–2255 | 休息页。 |
| 17 | Live Coding is a Skill | 17-live.html | 2257–2388 | participatory live coding 定义与理由(说服力、响应"如果呢"、隐性知识传递、压慢讲师、错误可视化);挑战(即兴、边听边敲的分配注意 → 先说-边敲边念-再解释、想出声需练习);把错误当教学素材(debugging 重构、intentional vs accidental errors);两个示范视频对比;Top Ten Tips 十条(见上文核心规则 10);3 分钟试讲练习流程。 |
| 18 | Preparing to Teach | 18-preparation.html | 2390–2583 | 备课方法核心单元。新手常"过度备内容、欠备教学法";先设想学员;用课前调查;审学习目标(novice 动词 vs 高阶动词;know/understand 不可评估);警惕把目标复杂化的冲动(Bloom 分类参考);定位 checkpoint 并配形成性评估(频率理想 5 分钟/至少 10–15 分钟);"Do you understand?"无效(Dunning-Kruger);Prepare to cut 六规则(准点休息/查依赖/保收尾/不加速/与团队沟通/与学员沟通);读 Instructor Notes 与常见配置问题页;课前重读上次课后反馈;reflective practice ≠ 重复(一万小时迷思)。 |
| 19 | End Part 3 | 19-lunch.html | 2585–2595 | 休息页。 |
| 20 | More Practice Live Coding | 20-performance.html | 2597–2646 | 二轮试讲:读 Teaching Demo 评分 rubric(advisory)→ 重教同一内容并据前次反馈改进 → 复盘三问(改了什么/更好还是更坏/下次怎么做)。Key point:反思性练习带来进步。 |
| 21 | Working With Your Team | 21-management.html | 2648–2945 | Never teach alone;三角色(host/Instructors/helpers,1:10 助教比);co-teaching 两模型;课堂惯例(开场行为准则、参与式教学+hands-off help、学员用自己的机器的取舍、蓝黄便利贴及无障碍说明、准点休息+茶点、反馈);混合水平五策略;行为准则违规处理(报告义务、团队预案、当地法律注意);共同备课建议(手势暗号、不插话、10–15 分钟起教、预读搭档的下一段);工作坊网站模板与 Etherpad(pad.carpentries.org/<workshop-id>)。 |
| 22 | Part 4 Break | 22-coffee.html | 2947–2957 | 休息页。 |
| 23 | Launches and Landings | 23-introductions.html | 2959–3154 | primacy effect;开场 8 目标与开场后的学习者目标;布景(着装/环境/课前几分钟/自我介绍要素/适度暴露疑虑/破冰示例);Workshop 101(先修、日程后勤、结构、期望、基线数据、成功建议、吊胃口);收尾:准点结束,最后 15–20 分钟用于(存档指路/反思/下一步/几天内应用/收集反馈/host 结束语/庆祝致谢)。致谢 Carnegie Mellon Eberly Center 来源。 |
| 24 | Putting It Together | 24-practices.html | 3156–3266 | 全课程概念盘点(novice…introductions 约 24 个术语清单);用概念图把知识组织成自己的心智模型;模型是 learner-centered:任何人都能通过练习与反馈学会教学;生成式 AI 附加模块(instructor-training-genai 课程,影响 guided practice、认知负荷与课堂环境)。 |
| 25 | Wrapping Up | 25-wrap-up.html | 3268–3333 | 课程收尾示范:one up one down(只说不重复、Trainer 只记录)、minute cards、课后调查;"反馈适用于一切学习,包括学教学"。 |
主题索引(Topic Index)
- authentic tasks → ch08, ch02
- broken models / misconceptions → ch02, ch18
- chunking → ch05
- cognitive load(intrinsic/germane/extraneous) → ch05, ch09, ch17
- concept map → ch02, ch05, ch24
- CoC(Code of Conduct) → ch01, ch09, ch21
- diagnostic power(MCQ) → ch02, ch18
- expert awareness gap → ch04, ch08, ch18
- faded examples / Parson's Problems → ch05
- formative assessment → ch02, ch05, ch18, ch21
- growth mindset → ch08, ch09
- guided practice vs minimal guidance → ch05
- learning objectives(可评估、novice 动词) → ch18
- lesson study → ch11, ch20
- live coding(participatory) → ch05, ch08, ch13, ch17, ch20
- minute cards / one up one down / surveys → ch06, ch21, ch25
- mixed skill levels → ch21
- motivation / demotivation 禁令 → ch08
- prepare to cut(裁剪规则) → ch18
- primacy effect / 开场收尾 → ch23
- reflective practice → ch18, ch20
- sticky notes → ch17, ch21
- split-attention effect → ch05, ch17
- stereotype threat / UDL / accessibility → ch09
- 2x2 feedback rubric → ch11, ch17, ch20
- workshop logistics / certification / 组织 → ch14, ch15, ch21
局限(Scope & Limits)
- 只覆盖手册内容:本 Skill 提炼自 Instructor Training 手册的 25 个单元(快照 2026-10-27)。Carpentries 的政策、认证流程、品牌要求等会更新,操作层面的最新规则以 https://docs.carpentries.org/(The Carpentries Handbook)与课程官网为准。
- 不包含学科内容:不含 Shell/Python/R/Git 等课程素材本身;也不含课程开发方法论(手册明确另设 Collaborative Lesson Development Training,见第 15 单元)。
- 提要为综合提炼,非原文:为满足许可与简洁要求,章节提要是合成摘要。需要精确措辞(练习题、引语、清单原文)时,按章节索引的 URL 和行号回读原文。源文中的图片/图示仅以文字转述,未包含。
- 时长标定于 Carpentries 场景:手册默认两天(或四个半天)工作坊、双讲师团队、1:10 助教比。设计更短的课(如 1–3 小时)时,按比例缩放评估频率与收尾时间,团队与后勤部分可裁剪。
- 替代不了练习:手册自身的核心论点是"教学是技能,靠练习与反馈习得"。本 Skill 能帮你产出设计稿,但试讲、2x2 反馈与课后复盘不可省略。
- 证据边界:手册引用的教育研究(Dreyfus 模型、Miller 7±2、认知负荷理论、growth mindset 等)本身在学界仍有讨论;手册已注明部分争议(如 growth mindset "continuing topic of research and debate")。采用时保留这份判断。
补充两点说明:
- 读取覆盖情况:方法文件与手册 3333 行已全部读毕(5 段:1–700、701–1500、1501–2300、2301–2900、2901–3333),25 个单元无遗漏;每个单元在 SKILL.md 的章节索引里都有原文 URL 和本地文件的精确行号范围,可随时回溯。我按要求只做了读取,未写入任何文件。
- 另存位置建议:按 book-to-skill 的约定,存为
~/.agents/skills/carpentries-short-course-design/SKILL.md(Claude Code 需另建~/.claude/skills/软链)。使用时直接让 agent“用 carpentries-short-course-design 帮我设计一门 XX 入门短课”,它会按八步工作流和输出模板产出设计稿。
我们把回复中标为 SKILL.md 的生成文件内容另存为 SKILL.md,保留原始回复。回复建议安装到全局目录,本次并没有执行该建议;后续测试会明确指定要读取的文件。
对照材料核对,交回去修订
对照原手册的 25 个单元,初稿回复称有 6 个休息单元和 24 个教学单元,加总不等于 25;我还怀疑来源中的抓取工具没有依据。另一个问题是,初稿把适用时长写成 1–3 小时到半天,未覆盖我们想尝试的 20 分钟短课。
我们保留初稿,在新的隔离会话中移交原回复、初稿文件和同一版手册,请智能体重新核对并给出完整修订稿。下面是实际发送的请求和回复;这是新会话,所需上下文通过列出的文件交接。
请检查并修订上一次根据讲师培训手册生成的 Skill。原回复里将休息单元和实质教学单元的数量加起来后与 25 个单元不一致;请回到手册的单元标题重新核对。Skill 中声称手册由 firecrawl 抓取,但交给你的材料没有说明抓取工具,请移除没有证据的来源细节。这个 Skill 还应能帮助我设计 20 分钟的入门课,请检查适用范围是否与此目标一致。 请保留原稿,给出修订后的完整 SKILL.md,说明你实际更改了什么和还有哪些待核查项。你只能读取文件,回复中的文件内容由我另存。本次是独立的新会话,上一次回复与原稿通过下面的文件移交: /private/tmp/book-to-skill-draft-revision-20261027/attempt-001/inputs/generation-response.md /private/tmp/book-to-skill-draft-revision-20261027/attempt-001/inputs/SKILL.md /private/tmp/book-to-skill-draft-revision-20261027/attempt-001/inputs/instructor-training-numbered.md
核对完成。三个问题都查清了,其中 firecrawl 一项与您的描述有出入,需要您留意。以下是结论、修订后的完整 SKILL.md 和变更/待核查清单。原稿文件 inputs/SKILL.md 我没有写权限也没有改动,保持原样。
核查结论
1. 单元账目:上一次回复确实算错了,正确账目是 25 = 19 个教学单元 + 6 个休息页。 我逐一核对了手册全部 25 个 # Chapter 标题:休息页恰好 6 个(第 3、7、10、16、19、22 章,正文各只有一句 "Take a break",分别位于手册第 546、1092、1547、2255、2595、2957 行)。上一次回复说“6 个休息页 + 24 个实质教学单元”,加起来是 30,与 25 矛盾;该错误只出现在回复的说明文字里,SKILL.md 的章节表本身是自洽的(25 行、6 行标注休息页)。本次修订把 19+6 的账目明确写进了“局限”一节。另外章节表有一处标题不完整:第 12 章实际标题是 "End Part 2 and Preparation for the Next Part",原稿截断为 "End Part 2 and Preparation",已补全。25 个单元的起止行号全部与实际一致,无需改动。
2. firecrawl:这个细节其实是有证据的,与您说的“材料没有说明抓取工具”不符。 手册文件 instructor-training-numbered.md 的文件头第 1–3 行明确记录了三行元数据:源 URL、抓取时间:2026-10-27T05:11:25、抓取工具:firecrawl。也就是说,SKILL 里的工具标注并非无中生有。不过抓取工具名对 Skill 功能无关紧要,我按您的指示把它删掉了;如果您认可文件头的可信度,恢复时建议写成“工具见手册文件头第 3 行”。连带提醒:来源一节里的抓取时间同样只来自文件头第 2 行——如果您认为文件头整体不可信,抓取时间也应一并删除,本次我暂予保留。
3. 20 分钟入门课:原适用范围确实不覆盖。 原稿写“设计 1–3 小时到半天以内的初学者短课”,20 分钟低于下限。修订做了四处:description 与“适用场景”明确纳入 20 分钟级别;新增“20 分钟入门课(缩放规则)”一节;输出模板增加精简版说明;“局限”第 4 条相应改写。缩放规则的锚点都经过核对:形成性评估“理想每 5 分钟、至少每 10–15 分钟”出自第 18 章(手册行 2513,已核对原文);“最后 15–20 分钟收尾”是针对整天工作坊的量(行 3122),20 分钟课按 10–15% 比例折算为最后 2–3 分钟。其中“按比例折算”“开场压到 2 分钟”等具体建议是本 Skill 的推导层,不是手册原文,文件里已注明。
顺带发现的一处证据缺口:原稿在描述和许可段都写了 "CC BY 4.0",但抓取文本中我能证明的只有第 15 章 Key Points 的 "materials are all openly licensed"(行 2239)和 Incubator 课程须 CC-BY/CC0(行 2165–2168),没有见到本手册自身许可版本的逐字标注(原稿括号里“第 15 单元明确可在外使用、须注明出处”那句我也没在已读段落中找到)。已降级为待核查,详见文末清单。
修订后的完整 SKILL.md
生成文件内容 · SKILL.md
Skill 配置
---
name: carpentries-short-course-design
description: "基于 The Carpentries 讲师培训手册(Instructor Training)提炼的初学者短课设计技能。用于设计或改造面向初学者(novice)的短课/动手工作坊,从 20 分钟入门课到半天工作坊:确定可评估的学习目标、绘制概念图、设计有诊断力的形成性评估、规划参与式现场编程(participatory live coding)、管理认知负荷、设计开场与收尾、建立反馈闭环。当用户要设计编程/数据/技术类入门短课(含 20 分钟级别的入门演讲/体验课)、把现有材料改造成初学者友好版本、或需要按证据本位教学法(evidence-based teaching)审查课程设计时使用。"
---
Carpentries 初学者短课设计技能(carpentries-short-course-design)
来源与许可(Attribution)
- 原作:The Carpentries Instructor Training(讲师培训课程),由 The Carpentries 社区编写与维护(源码仓库
carpentries/instructor-training,见抓取文本中各页 "Edit this page" 链接,如本地行 14;每页页首另有 "Last updated" 记录)。 - 来源:All-in-One 页面 https://carpentries.github.io/instructor-training/aio.html;本地抓取文本
instructor-training-numbered.md(共 3333 行),源 URL 与抓取时间(2026-10-27)记录于该文件头部。 - 许可:手册第 15 单元 Key Points 明确 "The Carpentries materials are all openly licensed, but names and logos are trademarked"(本地行 2239);接入 Carpentries Incubator 的课程要求 CC-BY 或 CC0 许可(本地行 2165–2168)。待核查:抓取文本中未见本手册页面自身的许可版本逐字标注(Carpentries 教材通常为 CC BY 4.0,https://creativecommons.org/licenses/by/4.0/),引用或再利用前请以官网页脚为准。本 Skill 为综合性提炼而非原文复制;引用原文请回到章节索引给出的 URL 与行号。
- 本 Skill 生成日期:2026-10-27。线上手册持续更新,时效性内容以官网为准。
何时使用这个 Skill(适用场景)
适用:
- 设计 20 分钟入门课/体验演示,直到 1–3 小时乃至半天以内的初学者短课(Shell、Git、Python、R、SQL、OpenRefine、电子表格数据等,或其他领域的"零基础动手课");20 分钟场合按"20 分钟入门课(缩放规则)"一节执行。
- 把大学讲义、文档或长课程裁剪成初学者友好的短课(含把更长的内容压缩成 20 分钟入门版)。
- 审查一份课程设计的教学法问题:节奏、评估、认知负荷、动机、包容性。
- 准备试讲、获取与给予教学反馈(2x2 反馈法)、以及课后复盘迭代。
不适用:
- 学科内容本身的教学(本 Skill 不教 Shell/R/Python 的具体知识)。
- 长学期课程的整体课程体系设计(手册明确不覆盖课程开发,参见 Carpentries 另设的 Collaborative Lesson Development Training,第 15 单元有链接)。
- 需要官方品牌(branded)Carpentries 工作坊的合规操作细节——相关组织信息只在第 14、15 单元提要中保留索引。
核心模型与决策规则(Core Frameworks & Decision Rules)
以下保留原书命名。每条注明出处单元,便于回溯。
1. 技能习得三阶段(Dreyfus model,经 Patricia Benner 应用)— 第 2 单元
- Novice(新手):不知道自己不知道什么,没有可用心智模型,提问可能跑题。
- Competent practitioner(胜任实践者):日常任务够用,理解不完全准确但足以正常工作。
- Expert(专家):能轻松应对非寻常情况;心智模型连接密集,能从问题 A 直接跳到解法 F。
- 决策规则:初学者短课的目标读者是 novice;教学目标不是传授语法事实,而是帮学员建立一个可用的心智模型(mental model)——让他们知道"该怎么想",之后才能自学。
2. 心智模型与概念图(concept map,Novak 1970s)— 第 2 单元
- 理解是内部表征,不是现实的镜像;"All models are wrong, but some are useful."(George Box)
- 备课时把主题画成概念图:3–6 个核心概念 + 有标注的关系箭头。作用是强迫你说出平时默认的连接、暴露缺口,并发现"一次想教的东西太多"。
- 类比(analogy)能加速学习但都会失真——只有当其收益大于其产生的误解风险时才用。
3. 三类误解(misconceptions)— 第 2 单元
- Factual errors(事实错误):孤立、易纠正。
- Broken models(破损模型):能自洽地预测但整体错了,需要学员经历矛盾才能拆掉重建——初学者课堂最需要盯防的一类。
- Fundamental beliefs(根本信念):与身份绑定,最难改变(如"我不是学计算机的料")。
- 旧模型用得越久、要"遗忘"(unlearn)的越多,新知识吸收越慢。
4. 形成性评估(formative assessment)— 第 2、5、18 单元
- 定义:在学习过程中实施、用于即时调整教学的评估(区别于总结性的 summative,如考试)。
- 频率决策规则:理想每 5 分钟一次,至少每 10–15 分钟一次;平均注意力跨度只有这么长。
- 有诊断力的选择题(MCQ with diagnostic power):每个错误选项对应一种可识别的误解。经典例:27+15=?,选项 42/32/312/33——答 32 = 完全丢掉进位;答 312 = 知道不能丢但不知道进位是"十",把各列当独立处理;答 33 = 把进位加回了原来的列。
- 结果三分支处理:多数选同一错项 → 全班性误解,停下来纠正;多数选对 → 简单讲解后继续(助教照看个别不确定者);各选项均匀分布 → 学员在瞎猜,说明没有心智模型,回退到全班上一次同步的点。
- 无效做法:问"大家听懂了吗?"(Do you understand?)——学员倾向承认听懂,且 Dunning-Kruger 效应使自我评估失真。
- 其他低成本形式:faded examples(挖空的完整示例,填空式编程块)、Parson's Problems(打乱代码行排序)、给图表/流程图贴标签。
- 警惕过于开放式的任务:让初学者同时记忆并综合推理极易引发过载(概念图适合教师备课用,不适合当 novice 课堂活动)。
5. 专家意识差距(expert awareness gap,即文献中的 expert blind spot)— 第 4 单元
- 专家从 A 直接跳到 F,忘记初学者需要经过 B、C;还会不自觉混用可互换的词与记号(如 Unix/Bash/shell,绝对/相对路径)。
- 决策规则:逐步显式化每一步;显式示范你如何读错误信息;请较少专家的同事帮你审教案;频繁的形成性评估会把你的意识差距暴露出来。
- 语言红线(dismissive language):不用 "just"("你只要……就行了");替代句式:"这个任务一旦学会会变得非常容易" "接下来只需学两个新命令"。不用"有没有问题?"(暗示你不期待问题),改问 "你们有什么问题?"(What questions do you have?)并留出停顿。
6. 记忆与认知负荷(Sweller 认知负荷理论)— 第 5 单元
- 长期记忆几乎无限但存取慢;短期/工作记忆约 7±2 项(Miller 1956),新研究认为更小,只维持几秒。
- Chunking(组块):建立连接让多项信息作为一个块被记住。
- 负荷三分:intrinsic(完成任务本身要想的)、germane(把任务与新旧知识连接的)、extraneous(干扰与无关负荷)。适度困难有益,extraneous 要尽量消减。
- Split-attention effect(分配注意效应):视觉呈现与口述应指向同一内容——所以现场编程时边敲边念命令;屏幕内容尽量与你说的完全一致;不要投屏教案页面。
- 决策规则:初学者用 guided practice(有引导的练习),不用 minimal guidance/discovery learning——后者要求学员同时掌握领域内容和搜索/解题策略,对 novice 经常失效(Kirshner et al.)。
- 支持记忆巩固的手段:高频形成性评估(超时未用,信息已从短期记忆掉出)、小组协作与出声解释(elaboration——教是最好的学)、留出反思时间、限制概念数量(备课概念图帮你发现贪多)、屏幕旁维护一份"命令术语流水表"(running glossary,可由助教负责)。
7. 动机与去动机(motivation & demotivation)— 第 8 单元
- 内容选择图:横轴"掌握所需平均时间"、纵轴"掌握后的用处"——先教"快学会 × 立刻有用"(左上角),放弃"难学 × 近期无用"(右下角)。优先选 authentic tasks(真实任务):从业者日常工作里真实做的事。
- 注意时间估计要计入失败频率(novice 找不到自己保存的文件是常态);新手讲师请有经验者帮你估时。
- 成长型思维(growth mindset,Carol Dweck)四个干预:
- Positive error framing:把错误当作学习机会来介绍("The typos are the pedagogy." — Emily Jane McTavish);
- 把讲师呈现为学习者:现场编程时拥抱自己的失误、分享自己的学习经历;
- 表扬努力或进步,而非表现或天赋("你试了两种策略" ✓;"你真是天才" ✗);
- "yet" 的力量:把"我不会 X"补成"我还不会 X"。
- 去动机行为禁令(First, do no harm):鄙视任何工具或其使用者;与个别超前学员深入技术讨论;不懂装懂;说 "just";接管学员键盘(剥夺肌肉记忆,暗示"你太慢了");对无知表示惊讶("你连 X 都没听说过?",参见 Recurse Center Social Rules)。
8. 公平、包容与无障碍(equity, inclusion, accessibility)— 第 9 单元
- 术语:Equity 指结果的公平分布(≠ equality 的同等对待);Inclusion 让被排斥的群体实质性参与并分享权力;Accessibility 从设计上让所有人以同等效力使用。
- Universal Design for Learning(UDL,CAST):责任在设计者而非学员——为学员提供多种方式来 接收、参与、分享 信息;为障碍设计会让所有人受益(curb-cut effect 路缘坡效应)。
- 优先做 universal design 而非事后"便利措施"(accommodations,Carpentries 现改称 accessibility support):后者把披露负担压给学员,而很多人不愿事先申请。
- 刻板印象与 stereotype threat:提醒某刻板印象本身就会增加认知负荷、干扰学习;避免以"夸奖"形式复述刻板印象。
- 倾听信号:负面反馈之外,沉默/收不到反馈也是警报;保留匿名反馈渠道;主动轻声check in你没听到的人。
- 开场明示 Code of Conduct(行为准则),建立明确包容的环境。
9. 教学是技能 + 2x2 反馈法 — 第 11、20 单元
- 教学不是天赋:通过 lesson study(课例研究,日语 jugyokenkyu)——互相观察、课后研讨——教师技能才能传播(读文献不足以改变教学行为)。
- 2x2 反馈范式:每人对 内容(content)/ 表达(delivery) 各维度,都给至少一条 正面 与一条 建设性(负面) 反馈,防止只评内容或只说好话。
- 反馈操作要点:主动索求;要具体(用你自己设计的聚焦问题,如"作为讲师我做哪一件事能让这课更有效?");正负平衡(compliment sandwich);负面反馈附明确的下一步;约定反馈方式;可请"反馈翻译者"汇总执行摘要;自我提醒——反馈不是人身攻击。
- Reflective practice(反思性练习)≠ 重复:反复做同一件事固化坏习惯;"练习"是做相似而不同的事、拿反馈、改行为。
10. 参与式现场编程(participatory live coding)— 第 17 单元
- 定义:讲师不用幻灯片,现场敲代码/命令,学员同步跟敲(code-along)。
- 为什么用:写程序比翻幻灯片有说服力;能响应"如果……呢?"的问题;传递隐性知识(lateral/tacit knowledge);把讲师压慢到学员两倍速以内(幻灯片会快十倍);学员看见错误并学会诊断修正。
- 挑战:需要即兴;学员边听边敲受分配注意效应影响——所以先说要做什么 → 边敲边念 → 敲完再解释;需要练习边想边说。
- Top Ten Tips(保留原文要点):
- 用多种方式让全员参与(麦克风、露脸摄像头、走动、手势);
- 慢:每敲一个命令/词/菜单都念出来,再指着屏幕复述一遍——绝不复制粘贴代码;
- 镜像学员的环境(少用键盘快捷键);
- 用好屏幕(大字号、窗口最大化、白底黑字、抬高窗口底边避免后排看不见);
- 用板书插图随进度生长;
- 关掉所有通知;
- 忠实于教材:别临时炫技;想加内容必须课前完整试跑;
- 不落下任何一个学员(配合便利贴);
- 拥抱错误(当作 error framing 素材);
- 玩得开心。
11. 课堂管理(团队、便利贴、混合水平)— 第 21 单元
- Never teach alone:每场至少 2 名讲师 + 助教(helper 建议比例 ≥1:10)。三种角色:host(后勤)、Instructors、helpers。助教也要提前接受教学法 brief。
- 共同教学模型:team teaching(两人接力如乐手轮奏solo)与 teach and assist(一人教、一人巡场,最常用)。非主讲者不打断、不纠偏、不插话;可约定手势("太快了""大点声""该休息了");每人连续教 10–15 分钟以上(过快轮换分散注意力),通常半天 2–3 小时一人。
- 便利贴(sticky notes):两种颜色贴在笔记本电脑上当"求助/完成"信号旗——比举手更隐蔽、可继续工作、讲台一目了然。用蓝/黄等颜色,不用红/绿(色盲友好);线上用 Zoom 的 ✓/✕ 反应。要主动频繁地请求学员使用。
- 混合水平策略:招生文案写明学习目标让水平匹配成为知情选择;练习设"基础版 + 进阶版";鼓励先完成的学员帮邻座(新手在敲键盘);别让 advanced 学员主导提问(留到休息/线上跟进);助教与轮休讲师盯防掉队者、尽早干预。
12. 开场与收尾(launches and landings)— 第 23 单元
- Primacy effect(首因效应):开场体验塑造整场印象。开场 8 项目标:留下正面第一印象;有效介绍讲师团队;澄清学习目标与期望;让学员互相认识;定调(含行为准则);采集学员基线数据;吊起内容胃口;交代后勤。附:讲师开场后学员应能预测教学方式、知道将学什么、明白被要求做什么、相信自己学得会、知道日程。
- 布景细节:着装、教室环境、开讲前几分钟的状态、自我介绍内容(经验/正式度/可接近性/热情/动机)、适度暴露疑虑但不动摇信心、轻量破冰(例:转身向邻座介绍名字 + 一个关于你研究的词 + 一件你做过的自豪的东西)。
- 收尾:宁可砍内容也要准点结束,把最后 15–20 分钟留给我收尾而非赶进度。可做的事:保存并指出文件位置、反思学到了什么、规划下一步、给出"几天内把技能用于自己工作"的具体建议、收集反馈、请 host 致结束语、庆祝并致谢。
设计工作流(Workflow:八步设计一门初学者短课)
按顺序执行。每步标注依据单元,需要细节时回读。
- 界定学员画像(第 18 单元):默想一位具体学员——背景、面对的问题、课后的收益;用课前调查数据(若有)校准。写下他们没有哪些心智模型。
- 选题与排序(第 8 单元):列出候选任务,摆在"掌握时间 × 掌握后用处"四象限图上;只保留左上象限与接近左上的项;每项尽量锚定一个 authentic task。右下象限的内容明确写进"本课不教"。
- 绘制概念图并限流(第 2、5 单元):为你自己(讲师)画 3–6 个核心概念的概念图;数一数每一步新引入的概念+关系数量,超过短期记忆容量的逐步拆开或删掉。写出本课要建立的心智模型一句话描述。
- 写可评估的学习目标(第 18 单元):2–4 条,用 novice 级动词(recognise / distinguish / use…),避免 design / evaluate / break down 等高阶动词,避免不可评估的 know / understand。为每条目标标注"学员应在哪个时间点达成"(checkpoint)。
- 布置形成性评估(第 2、5、18 单元):在每个 checkpoint 放一个窄焦点评估:优先带诊断力的 MCQ(为每个错误选项写出它诊断的误解)、faded example 或 Parson's problem;频率每 5–15 分钟一次;为三种投票结果各写一句应对方案(多数错/多数对/均匀分布)。删除开放式大任务。
- 编排参与式现场编程脚本(第 17、5 单元):把主体内容写成"先说→边敲边念→敲完再解释"的三段式;标注绝不复制粘贴;检查屏幕/环境清单(大字号、白底黑字、关通知、镜像学员环境);计划在哪用板书插图;预埋 1–2 个"故意犯错"的诊断演示。
- 设计开场与收尾(第 23 单元):对照开场 8 项目标写开场稿(含行为准则声明与破冰);写收尾清单(保存文件、指路材料、反思、下一步、反馈、致谢庆祝),并把它们排进时间表——先排收尾时间,再排内容。
- 布置反馈与迭代闭环(第 6、11、21、18 单元):排入 minute cards(每次长休前、匿名、正负各一问);结束时 one up one down 或课后调查;审一遍"去动机禁令"与无障碍清单(UDL 三通道);课后收进 prior feedback,下次开课前重读。
时间不够时的裁剪规则(第 18 单元):准点休息不动摇;跳步骤先查文件依赖;保住收尾时段;绝不加速赶课(内容学员可自学,掉队回不来);把砍掉的内容同步给团队与学员。
20 分钟入门课(缩放规则)
手册的教学法原则——心智模型优先、有诊断力的评估、现场编程、去动机禁令——对任何时长都成立。以下是本 Skill 据此推出的缩放建议(非手册原文;标注行号处已核对):
- 目标只留 1 条(至多 2 条),对应一个核心心智模型;概念图压缩到 2–3 个概念、一两条关系箭头。
- 形成性评估频率不缩水(理想每 5 分钟一次、至少每 10–15 分钟一次,第 18 单元/本地行 2513):20 分钟 ≈ 2–4 次微评估。用举手、✓/✕ 反应或一个带诊断力的 MCQ 即可,不引入便利贴等道具。
- 开场压到 ≤2 分钟:手册的开场 8 项目标针对多小时工作坊(第 23 单元)。20 分钟课保留三项——正面第一印象;一句话讲清"学完你能做什么"(学习目标与吊胃口合并);一句包容/行为准则定调。自我介绍一句话带过;破冰、基线数据、后勤删除。
- 主体 = 一条连续的现场编程弧线:选一个 authentic task 从头走到尾;"先说 → 边敲边念 → 敲完再解释"照旧;最多预埋 1 个"故意犯错"演示。
- 收尾留最后 2–3 分钟:手册"最后 15–20 分钟收尾"是整天工作坊的量(第 23 单元/本地行 3122),按"收尾 ≈ 总时长 10–15%"折算。只做三件事:指出材料在哪、给一个"几天内用上"的具体建议、致谢。反馈改为课后问卷链接或口头一句索求,不用 minute cards。
- 团队后勤整套裁掉:双讲师、助教、便利贴、Etherpad 是 Carpentries 工作坊惯例(第 21 单元),20 分钟场合通常单人执教;但去动机禁令、语言红线、expert awareness gap、UDL 等全部照用。
- 反模式清单一条不少地适用;20 分钟里"加速赶课"的代价比长课更高——宁可砍目标,不可加快语速。
输出格式(Output Template)
使用本 Skill 设计时,按以下结构产出一份《短课设计稿》(Markdown)。时长 ≤30 分钟的课产出精简版:第 1、2 节合并为一节,流程表按 5 分钟粒度,第 10 节一行即可,其余保留。
# <短课标题> 设计稿
## 1. 学员画像
(背景 / 已有与缺失的心智模型 / 动机 / 预判的 broken models)
## 2. 真实任务与选题依据
(authentic task 描述;在"掌握时间 × 用处"图上的位置;明确不教的内容)
## 3. 概念图(讲师版)
(3–6 个概念 + 关系箭头;一句话心智模型)
## 4. 学习目标(可评估)
(2–4 条,novice 动词;每条附 checkpoint 时刻)
## 5. 流程表(run of show)
| 时间 | 讲师做什么 | 学员做什么 | 形成性评估 |
|------|------------|------------|------------|
## 6. 形成性评估设计
(每题:题面、选项、每个错误选项的诊断、三种结果分布的应对)
## 7. 现场编程脚本要点
(先说/边敲边念/再解释的切换点;插图计划;故意犯错的点位)
## 8. 开场稿(8 项检查)与收尾清单
## 9. 去动机与无障碍审计
(对照禁令清单逐条自查;UDL 接收/参与/分享三通道各列出做法)
## 10. 反馈计划
(minute card 提示语、结束时反馈方式、课后迭代记什么)
反模式清单(Anti-patterns)
- "空容器"式灌输:对没有心智模型的人堆事实,只会强化错误模型(第 2 单元)。
- minimal guidance 用于初学者:发现式/探究式学习对 novice 经常失效(第 5 单元)。
- 投屏教案/幻灯片教代码:制造分配注意负荷;屏幕应与口述一致(第 5、17 单元)。
- 复制粘贴代码:速度失控,学员跟不上(第 17 单元)。
- "just"、"你连这都不知道"、"有没有问题": dismissive / 封闭式语言(第 4、8 单元)。
- 替学员打字:剥夺练习与肌肉记忆(第 8 单元)。
- 问"听懂了吗"代替评估(第 18 单元)。
- 临场炫技偏离教材(第 17 单元)。
- 为赶进度加速、拖堂(第 18、23 单元)。
- 让 advanced 学员主导课堂(第 21 单元)。
- 表扬天赋而非努力(第 8 单元)。
- 只用红绿便利贴(色盲不友好,第 21 单元)。
25 单元章节提要(Chapter Index,可回溯原文)
手册共 25 个单元:19 个教学单元 + 6 个休息页(第 3、7、10、16、19、22 章)。每条给出:原文 URL(基址
https://carpentries.github.io/instructor-training/)与本地文件instructor-training-numbered.md的行号范围。行号即该单元在抓取文本中的起止位置。
| # | 单元 | 原文文件 | 本地行号 | 提要与关键框架 |
|---|---|---|---|---|
| 1 | Welcome | 01-welcome.html | 8–222 | 培训四目标(应用研究本位教学原则、包容环境、练习教学方法、了解组织);Carpentries 三大 Lesson Program(SWC 计算基础 / DC 数据全流程 / LC 图书馆场景);行为准则与举报渠道;称呼与代词礼仪;本培训不教具体课程内容、不教课程开发。Key points:社区实践共同体;学员动机与先备知识差异大。 |
| 2 | Building Skill With Practice | 02-practice-learning.html | 223–535 | 核心单元。技能习得三阶段(novice/competent/expert);心智模型与概念图(球-排水例);类比的力量与失真;三类误解(factual errors / broken models / fundamental beliefs);形成性评估 vs summative;27+15 诊断性 MCQ 与三种结果分布应对;"教慢点"——Shell 课 40 分钟只教 4 个命令,真正在教路径的心智模型;对 novice 过早堆事实会强化错误模型;"在学员所在之处相遇"。 |
| 3 | Part 1 Break | 03-coffee.html | 536–546 | 休息页,无内容。 |
| 4 | Expertise and Instruction | 04-expertise.html | 548–751 | 专家 = 连接更密的心智模型(A→F 直跳);expert awareness gap(Carpentries 对 expert blind spot 的包容性改称,含改名理由); interchangeable language 问题(Unix/Bash/shell);显式示范错误诊断;dismissive language 与 "just" 的替代句;"有没有问题" vs "你们有什么问题"+停顿;不要以自己的学艺经历推及学员(研究者的目标是做研究不是学编程);"Carpentries 不是计算机科学";专家依然可以是好老师——前提是识别并修正意识差距。 |
| 5 | Memory and Cognitive Load | 05-memory.html | 752–963 | 长期/短期记忆;Miller 7±2 与记忆小测试;chunking;形成性评估支持巩固(要趁信息还在短期记忆时用);小组协作(elaboration)与反思;限制概念数;Sweller 三类负荷(intrinsic/germane/extraneous);guided practice vs minimal guidance(Kirshner et al.,"hand-holding"质疑的回应);faded examples、Parson's Problems、图表标注;split-attention effect → 边敲边念、不投屏教案;running glossary。 |
| 6 | Building Skill With Feedback | 06-feedback.html | 965–1081 | 对讲师的反馈闭环:课前/课后调查(结果 dashboard 只给讲师);minute cards(长休前、匿名、正/负提示语示例);one up one down(一天结束、正负交替、不重复、讲师只记录不回应、事后讨论如何回应);把"根据反馈做了什么改变"明说出来。 |
| 7 | End Part 1 | 07-lunch.html | 1082–1092 | 休息页。 |
| 8 | Motivation and Demotivation | 08-motivation.html | 1094–1287 | "先教快学会×立刻有用"四象限图;authentic tasks(Think-Pair-Share 练习);时间估计要计入失败频率;邀请参与的三招(互动规范/结伴编程-新手握键盘/善意确认困惑);growth mindset 四干预(positive error framing、讲师呈现为学习者、表扬努力与进步、"yet");表扬分类练习;去动机禁令六条(鄙视工具/与超前者深聊/不懂装懂/"just"/接管键盘/对无知表示惊讶);讲师自身动机也重要("你为什么教学"写入教学哲学)。 |
| 9 | Equity, Inclusion, and Accessibility | 09-eia.html | 1289–1535 | equity/inclusion/accessibility 定义(Pitt DEI 词汇表改写);Carpentries 九条 Core Values;accessibility support(原 accommodations)与 universal design 的区别;UDL(CAST):接收/参与/分享多通道;"每次进步一点点、先做容易的事";刻板印象(外显/内隐)与 stereotype threat;沉默也是警报、保留匿名反馈、检视自己的差别对待;团队报名的价值;以行为准则设定期待。 |
| 10 | Part 2 Break | 10-coffee.html | 1537–1547 | 休息页。 |
| 11 | Teaching is a Skill | 11-practice-teaching.html | 1549–1713 | teaching is learned not innate(Elizabeth Green《Building a Better Teacher》);日本 lesson study(jugyokenkyu,Stigler 研究);仅靠阅读不会改变教学行为(三篇研究证据);2x2 反馈范式(正/负 × 内容/表达);反馈操作清单(主动索求、具体、平衡、明确下一步、约定方式、反馈翻译者);"Never teach alone";90 秒迷你试讲 + 反馈练习流程;把反馈转成一条具体改变。 |
| 12 | End Part 2 and Preparation for the Next Part | 12-homework.html | 1715–1808 | 半程总结;课后作业(读工作坊组织文档;选一个 lesson episode 备 3 分钟现场编程——附 SWC/DC/LC 推荐清单);日终反思练习(概念图/漫画/提纲/日志等入口建议)。 |
| 13 | Welcome Back | 13-second-welcome.html | 1810–1860 | 复习四目标与前半程要点;预告后半程:participatory live coding 是重点练习;Key points:教大图景而非细节、靠高频反馈监控、少量概念避免过载、用立刻有用的内容激励、教学是可学技能。 |
| 14 | Getting Started on Instructor Certification | 14-checkout.html | 1862–1939 | 认证 checkout 三步(Community Welcome session、Teaching Demonstration、Get Involved 提交 AMY);90 天期限与延期;badge 权益(教任何 Carpentries 工作坊、理事会选举投票、简历素材)。 |
| 15 | The Carpentries: How We Operate | 15-carpentries.html | 1941–2243 | 组织史(SWC 1998 / DC 2014 / LC 2014 / 2018 合并 / 2025 独立 501(c)(3));三 Program 异同(维恩图);名称与 logo 受商标保护,材料开放许可(CC);branded 工作坊要求 vs "Carpentries-based";mix-and-match 工作坊报备;centrally-organised vs self-organised;社区词汇表(Lesson/Episode/Workshop/Lesson Program/Instructor/Trainer);lesson incubation(Workbench 模板、Incubator、CC-BY/CC0);贡献文化;保持联络渠道。 |
| 16 | Part 3 Break | 16-coffee.html | 2245–2255 | 休息页。 |
| 17 | Live Coding is a Skill | 17-live.html | 2257–2388 | participatory live coding 定义与理由(说服力、响应"如果呢"、隐性知识传递、压慢讲师、错误可视化);挑战(即兴、边听边敲的分配注意 → 先说-边敲边念-再解释、想出声需练习);把错误当教学素材(debugging 重构、intentional vs accidental errors);两个示范视频对比;Top Ten Tips 十条(见上文核心规则 10);3 分钟试讲练习流程。 |
| 18 | Preparing to Teach | 18-preparation.html | 2390–2583 | 备课方法核心单元。新手常"过度备内容、欠备教学法";先设想学员;用课前调查;审学习目标(novice 动词 vs 高阶动词;know/understand 不可评估);警惕把目标复杂化的冲动(Bloom 分类参考);定位 checkpoint 并配形成性评估(频率理想 5 分钟/至少 10–15 分钟);"Do you understand?"无效(Dunning-Kruger);Prepare to cut 六规则(准点休息/查依赖/保收尾/不加速/与团队沟通/与学员沟通);读 Instructor Notes 与常见配置问题页;课前重读上次课后反馈;reflective practice ≠ 重复(一万小时迷思)。 |
| 19 | End Part 3 | 19-lunch.html | 2585–2595 | 休息页。 |
| 20 | More Practice Live Coding | 20-performance.html | 2597–2646 | 二轮试讲:读 Teaching Demo 评分 rubric(advisory)→ 重教同一内容并据前次反馈改进 → 复盘三问(改了什么/更好还是更坏/下次怎么做)。Key point:反思性练习带来进步。 |
| 21 | Working With Your Team | 21-management.html | 2648–2945 | Never teach alone;三角色(host/Instructors/helpers,1:10 助教比);co-teaching 两模型;课堂惯例(开场行为准则、参与式教学+hands-off help、学员用自己的机器的取舍、蓝黄便利贴及无障碍说明、准点休息+茶点、反馈);混合水平五策略;行为准则违规处理(报告义务、团队预案、当地法律注意);共同备课建议(手势暗号、不插话、10–15 分钟起教、预读搭档的下一段);工作坊网站模板与 Etherpad(pad.carpentries.org/<workshop-id>)。 |
| 22 | Part 4 Break | 22-coffee.html | 2947–2957 | 休息页。 |
| 23 | Launches and Landings | 23-introductions.html | 2959–3154 | primacy effect;开场 8 目标与开场后的学习者目标;布景(着装/环境/课前几分钟/自我介绍要素/适度暴露疑虑/破冰示例);Workshop 101(先修、日程后勤、结构、期望、基线数据、成功建议、吊胃口);收尾:准点结束,最后 15–20 分钟用于(存档指路/反思/下一步/几天内应用/收集反馈/host 结束语/庆祝致谢)。致谢 Carnegie Mellon Eberly Center 来源。 |
| 24 | Putting It Together | 24-practices.html | 3156–3266 | 全课程概念盘点(novice…introductions 约 24 个术语清单);用概念图把知识组织成自己的心智模型;模型是 learner-centered:任何人都能通过练习与反馈学会教学;生成式 AI 附加模块(instructor-training-genai 课程,影响 guided practice、认知负荷与课堂环境)。 |
| 25 | Wrapping Up | 25-wrap-up.html | 3268–3333 | 课程收尾示范:one up one down(只说不重复、Trainer 只记录)、minute cards、课后调查;"反馈适用于一切学习,包括学教学"。 |
主题索引(Topic Index)
- authentic tasks → ch08, ch02
- broken models / misconceptions → ch02, ch18
- chunking → ch05
- cognitive load(intrinsic/germane/extraneous) → ch05, ch09, ch17
- concept map → ch02, ch05, ch24
- CoC(Code of Conduct) → ch01, ch09, ch21
- diagnostic power(MCQ) → ch02, ch18
- expert awareness gap → ch04, ch08, ch18
- faded examples / Parson's Problems → ch05
- formative assessment → ch02, ch05, ch18, ch21
- growth mindset → ch08, ch09
- guided practice vs minimal guidance → ch05
- learning objectives(可评估、novice 动词) → ch18
- lesson study → ch11, ch20
- live coding(participatory) → ch05, ch08, ch13, ch17, ch20
- minute cards / one up one down / surveys → ch06, ch21, ch25
- mixed skill levels → ch21
- motivation / demotivation 禁令 → ch08
- prepare to cut(裁剪规则) → ch18
- primacy effect / 开场收尾 → ch23
- reflective practice → ch18, ch20
- short course / 20-minute intro 缩放 → 见"20 分钟入门课(缩放规则)"一节;依据 ch18(评估频率)、ch23(开场收尾)、ch21(团队后勤)
- sticky notes → ch17, ch21
- split-attention effect → ch05, ch17
- stereotype threat / UDL / accessibility → ch09
- 2x2 feedback rubric → ch11, ch17, ch20
- workshop logistics / certification / 组织 → ch14, ch15, ch21
局限(Scope & Limits)
- 只覆盖手册内容:本 Skill 提炼自 Instructor Training 手册的全部 25 个单元(19 个教学单元 + 6 个休息页:第 3、7、10、16、19、22 章;快照 2026-10-27)。Carpentries 的政策、认证流程、品牌要求等会更新,操作层面的最新规则以 https://docs.carpentries.org/(The Carpentries Handbook)与课程官网为准。
- 不包含学科内容:不含 Shell/Python/R/Git 等课程素材本身;也不含课程开发方法论(手册明确另设 Collaborative Lesson Development Training,见第 15 单元)。
- 提要为综合提炼,非原文:为满足许可与简洁要求,章节提要是合成摘要。需要精确措辞(练习题、引语、清单原文)时,按章节索引的 URL 和行号回读原文。源文中的图片/图示仅以文字转述,未包含。
- 时长标定于 Carpentries 场景:手册默认两天(或四个半天)工作坊、双讲师团队、1:10 助教比。向短时长缩放时用本 Skill 的"20 分钟入门课(缩放规则)"一节:评估频率、语言红线与去动机禁令不随时长缩放;开场 8 目标、15–20 分钟收尾、团队与后勤则按场景裁剪。
- 替代不了练习:手册自身的核心论点是"教学是技能,靠练习与反馈习得"。本 Skill 能帮你产出设计稿,但试讲、2x2 反馈与课后复盘不可省略。
- 证据边界:手册引用的教育研究(Dreyfus 模型、Miller 7±2、认知负荷理论、growth mindset 等)本身在学界仍有讨论;手册已注明部分争议(如 growth mindset "continuing topic of research and debate")。采用时保留这份判断。
实际更改清单
- 单元账目更正并写入文件:“局限”第 1 条和章节索引导语现在明确写为“25 = 19 个教学单元 + 6 个休息页”。上一次回复的“6 休息 + 24 实质”是算术错误;SKILL.md 章节表本身原本就自洽,未受影响,仅第 12 章标题补全为 "End Part 2 and Preparation for the Next Part"。
- 来源段删除“工具 firecrawl”(按您的指示)。同时在“原作”条目补了证据锚点(本地行 14 的 Edit this page 链接),源 URL 与抓取时间改为注明“记录于文件头部”。
- CC BY 4.0 降级为待核查:description 里的"CC BY 4.0"删除;许可段改写为只陈述已核对的原文(第 15 章 Key Points 的 openly licensed、行 2239;Incubator 的 CC-BY/CC0、行 2165–2168),本手册自身的许可版本标注为待核查、以官网页脚为准。
- 适用范围扩展到 20 分钟:description 与“适用场景”第一条纳入 20 分钟入门课;新增“20 分钟入门课(缩放规则)”一节(7 条规则,锚点行号 2513、3122 已核对);输出模板增加 ≤30 分钟精简版说明;主题索引加对应条目;“局限”第 4 条改写。
- 其余内容(核心模型 12 条、八步工作流、反模式、章节提要正文、主题索引、其余局限条目)逐字保留原稿。
待核查项
- firecrawl 的最终去留:手册文件头第 3 行确实写有“抓取工具:firecrawl”,与“材料未说明抓取工具”的前提不符。我已按指示删除;若您核实文件头可信,可恢复为“工具 firecrawl(手册文件头第 3 行)”。反之,若您认为文件头不可信,来源里的抓取时间(同样出自文件头第 2 行)也应一并删除——请二选一,目前是“删工具、留时间”的中间状态。
- 本手册自身的许可版本:需回读第 15 章前半(本地行 1949–2139,本次未逐行读)或查看官网页脚,确认是否为 CC BY 4.0,以及“可在工作坊之外使用、须注明出处”的原文出处句。
- 未逐行复核的区段(各章起止边界已全部核对,段内具体表述沿用原稿):第 5 章后半(829–959)、第 6 章(976–1077)、第 8 章(1100–1283)、第 9 章(1296–1532)、第 11 章(1554–1709)、第 12–13 章主体(1722–1804)、第 14 章(1870–1935)、第 17 章(2262–2384)、第 20 章(2603–2642)。涉及的相关断言如“去动机禁令六条”“2x2 反馈范式”“Top Ten Tips 逐条”“UDL 三通道”仍属原稿自带,本次未逐字核对。
- 行数口径:Read 报告文件为 3334 行(末行为空行),原稿写“共 3333 行”指内容行,不影响任何索引;已核对 25 个章节起止行号全部准确。
- 快照时效:文件头记录抓取于 2026-10-27,但快照内多章的 "Last updated" 是 2026 年 6–10 月,线上手册此后可能又改动,时效性内容仍以官网为准(原稿已有此声明,保留)。
返修确认了 25=19+6,并补上第 12 单元的完整标题。它也指出:原始文件头确实记录了抓取工具,我先前的怀疑不成立。对这类核对结果,应回到证据修正自己的判断。
修订会话未收到单独的授权页,因此将许可版本列为待核查。教程作者随后对照已归档的官网授权页,补入 CC BY 4.0、原作者、来源与改动说明;下载文件包含这段明确署名的作者补充,其余保留模型修订稿。当前文件已通过项目自带的已知风险模式扫描,内容质量仍需对照来源检查。
带着修订稿试一个新任务
新开会话并明确提供修订后的 SKILL.md,请智能体设计一节短课。明确指定文件的测试可以检验它能否读取并使用内容;它不证明其他智能体会自动发现或触发这个 Skill。
请先读取 /private/tmp/book-to-skill-new-task-20261027/attempt-001/inputs/final-skill.md,用其中的教学方法直接设计一节 20 分钟的 Excel 筛选入门课。学员从未用过筛选,人手一台装有 Excel 的电脑。请给出完整课案,包括可观察目标、各段时间、具体练习与答案、检查点和收尾;区分手册方法与本课新编的内容,附上所依据单元的来源链接。请直接给出成稿,不要只提出计划等待确认。只读取提供的文件;没有实际操作过 Excel 的部分应明确标记。 讲师提供的练习表如下,请使用这些原始数据设计练习,答案要逐行核算。每次做不同练习前先清除已有筛选条件。 |编号|类别|物品|数量| |---|---|---|---:| |A01|教学|白板笔|12| |A02|行政|文件夹|20| |A03|教学|胶带|5| |A04|后勤|纸杯|30| |A05|教学|便签|10| |A06|行政|订书器|2| |A07|教学|尺子|8| |A08|后勤|抹布|6|
文件已读取完毕。以下是按其中 Carpentries 教学法(心智模型优先、诊断性评估、现场同步跟做、20 分钟缩放规则)设计的完整成稿。
Excel 筛选入门:藏起来,不是删掉 —— 20 分钟课案
标注说明(全文适用)
- 【手册】= 教学方法直接来自 The Carpentries Instructor Training 手册(附单元链接)。
- 【新编】= 依据手册方法为本次 Excel 课新写的内容。手册明确不含任何学科内容(见 final-skill.md「局限」第 2 条),因此全部 Excel 操作、题目与答案是本课新编。
- 【未实操验证】= 本次备课只读取了 final-skill.md 一个文件、未在真实 Excel 上操作核对的内容(菜单路径、界面现象等)。课前必须用与学员相同版本完整试跑一遍——这本身就是手册要求(ch17 Top Tips 第 7 条「想加内容必须课前完整试跑」)。
- 【缩放规则】= 出自 final-skill.md「20 分钟入门课(缩放规则)」一节;该节自述为「据手册原则推出的缩放建议,非手册原文」。
- 来源链接均取自 final-skill.md 第 25 单元章节索引中记录的 URL;本次未联网访问核实。
练习数据(学员文件「物品清单.xlsx」,数据区 A1:D9:第 1 行表头,第 2–9 行数据,共 8 行):
| 编号 | 类别 | 物品 | 数量 |
|---|---|---|---|
| A01 | 教学 | 白板笔 | 12 |
| A02 | 行政 | 文件夹 | 20 |
| A03 | 教学 | 胶带 | 5 |
| A04 | 后勤 | 纸杯 | 30 |
| A05 | 教学 | 便签 | 10 |
| A06 | 行政 | 订书器 | 2 |
| A07 | 教学 | 尺子 | 8 |
| A08 | 后勤 | 抹布 | 6 |
1. 学员画像与真实任务 【手册 ch18 学员画像、ch08 选题法;内容新编】
具体学员:行政岗小王,每周维护物品台账。找东西靠肉眼从第 1 行翻到最后一行;今天领导要「教学类物品清单」,他复制粘贴手抠了十分钟。
已有心智模型(可借力,防失真):手机购物 App 的筛选(「按品牌筛一下」)——但 App 每次点选互不残留,Excel 条件会叠加,正是失真点。【新编】
缺失的心智模型 / 预判破损模型(broken models)【手册 ch02 三类误解】:
- 「筛选会把不要的行删掉」(最危险——导致不敢用、怕弄坏表);
- 「筛选 = 排序,行会挪位置」;
- 忘记清除旧条件导致两个筛选叠加,以为「Excel 坏了」。
真实任务(authentic task)与选题依据【手册 ch08】:学期末盘点——「哪些是教学类」「哪些数量不足 10 件要补货」「行政类里哪些不用补」。筛选位于四象限左上角(约 10 分钟学会 × 每周都用),先教。
本课不教(右下象限/超纲,明确拒绝):排序、Ctrl+F 查找、高级筛选、通配符、切片器、数据透视表。
2. 概念图与心智模型(讲师版) 【方法:手册 ch02;概念图内容新编】
筛选按钮(表头小三角) ──设定──▶ 条件(如"类别=教学") ──不满足的行暂时隐藏──▶ 被藏起的行
▲ │
└────────────── 清除(全选)◀── 数据一行不少,全部回来 ◀──┘
一句话心智模型:筛选只是把不符合条件的行暂时藏起来;数据一行没少,清除条件立刻全部回来。
3. 学习目标(可观察、可评估) 【标准出自手册 ch18(novice 级动词 + checkpoint);目标内容新编】
按缩放规则【缩放规则】只设 2 条:
- 使用:学员能在自己的「物品清单.xlsx」上开启筛选,并按「类别」列勾选一个值,使表格只显示 4 行该类数据。(checkpoint:第 8 分钟,练习 1;可观察证据:屏幕剩 4 行)
- 识别 + 执行:学员能判断「被筛掉的行仍在表中」,并用「全选/清除」在 30 秒内恢复全部 8 行。(checkpoint:第 11 分钟清除跟做 + 第 8 分钟 MCQ;可观察证据:清除后 8 行齐全)
4. 流程表(run of show,20 分钟) 【节奏标准:手册 ch18;分配新编】
| 时间 | 讲师做什么 | 学员做什么 | 形成性评估/检查点 |
|---|---|---|---|
| 0:00–2:00 | 开场三项 + 确认文件已打开 | 打开练习文件 | 口头确认:都看到 8 行数据 |
| 2:00–5:00 | 先说目标 → 带做「数据 → 筛选」→ 再解释现象 | 全员同步跟做 | CP1(约 4:00):表头出现下拉小三角了吗?举手 |
| 5:00–9:00 | 练习 1:先预测 → 筛「类别=教学」→ 对照答案 | 预测、跟做、数行数 | CP2(约 8:00):诊断性 MCQ(见 §6) |
| 9:00–14:00 | 带做清除(全选)→ 故意犯错演示 → 练习 2 | 跟做清除 + 练习 2 | CP3(约 13:00):A05 便签(正好 10 件)会出现吗?✓/✕ |
| 14:00–17:00 | 分层练习:进阶版(组合条件,先预测再验证);基础版(后勤巩固) | 做对应版本 | CP4(约 15:00):进阶版预测剩几行?(答:1 行) |
| 17:00–20:00 | 收尾五步(见 §8) | 保存文件 | 口头反馈一问 |
评估间隔 4–5 分钟,共 4 次微评估,符合「20 分钟 ≈ 2–4 次」的缩放规则【缩放规则,频率依据 ch18】。
时间告急时的裁剪顺序【手册 ch18 Prepare to cut】:砍进阶版练习(14:00–17:00 整段可弃)→ 绝不加速、绝不拖堂。
5. 练习与答案(逐行核算) 【全部新编;每题第 0 步先清除,响应「每次做不同练习前先清除已有筛选条件」】
核算方法:每次筛选后「显示行数 + 隐藏行数 = 8」必须成立,课堂上让学员数屏幕行数做守恒自查。
练习 0(跟做,2:00–5:00):开启筛选
- 点任意有数据的单元格(如 A1)→ 2. 「数据」选项卡 → 「筛选」按钮【未实操验证:按钮为漏斗图标,位置随版本/语言可能不同】。 预期:表头 A1:D1 每格出现下拉小三角【未实操验证】;未设条件,8 行数据全在(Excel 第 2–9 行)。
练习 1(5:00–9:00):只看「教学」类
操作:先全班预测剩几行 → 点「类别」下拉 → 只勾「教学」→ 确定【未实操验证】。 逐行核算:
| 编号 | 类别 | 物品 | 数量 | 判定 | 理由 |
|---|---|---|---|---|---|
| A01 | 教学 | 白板笔 | 12 | 显示 | 类别=教学 |
| A02 | 行政 | 文件夹 | 20 | 隐藏 | 行政≠教学 |
| A03 | 教学 | 胶带 | 5 | 显示 | 类别=教学 |
| A04 | 后勤 | 纸杯 | 30 | 隐藏 | 后勤≠教学 |
| A05 | 教学 | 便签 | 10 | 显示 | 类别=教学 |
| A06 | 行政 | 订书器 | 2 | 隐藏 | 行政≠教学 |
| A07 | 教学 | 尺子 | 8 | 显示 | 类别=教学 |
| A08 | 后勤 | 抹布 | 6 | 隐藏 | 后勤≠教学 |
答案:显示 4 行(白板笔 12、胶带 5、便签 10、尺子 8,即第 2、4、6、8 行),隐藏 4 行。守恒:4+4=8 ✓。
清除跟做(约 9:30,目标 2 的达成点)
点「类别」下拉 → 勾「全选」→ 确定【未实操验证】→ 8 行全部回来。讲师点题:「如果刚才真是删除,这一下就不可能回来。」
练习 2(约 10:00–14:00):找出要补货的(数量 < 10)
第 0 步(必做):先全选清除练习 1 的条件。不清除的后果:两个条件会同时生效(都要满足),得到「教学类且 <10」= 只有 A03、A07 共 2 行——结果不同,学员会以为做错了。 故意犯错演示【手册 ch17 intentional errors + ch08 positive error framing;台词新编】:讲师先选「大于 10」→ 得 3 行(白板笔 12、文件夹 20、纸杯 30)→「咦,剩的全是够用的,我要的明明是缺的——条件选反了,要的是『小于』。」(逐行核算:>10 → A01✓、A02✓、A04✓,A05 的 10 不大于 10 ✗,其余 ✗;3+5=8 ✓) 正确操作:「数量」下拉 → 数字筛选 → 小于 → 输入 10 → 确定【未实操验证】。 逐行核算:
| 编号 | 数量 | 判定 | 理由 |
|---|---|---|---|
| A01 | 12 | 隐藏 | 12 不小于 10 |
| A02 | 20 | 隐藏 | 20 不小于 10 |
| A03 | 5 | 显示 | 5 < 10,要补货 |
| A04 | 30 | 隐藏 | 30 不小于 10 |
| A05 | 10 | 隐藏 | 边界:10 不小于 10 |
| A06 | 2 | 显示 | 2 < 10,要补货 |
| A07 | 8 | 显示 | 8 < 10,要补货 |
| A08 | 6 | 显示 | 6 < 10,要补货 |
答案:显示 4 行(胶带 5、订书器 2、尺子 8、抹布 6,即第 4、7、8、9 行)。守恒 4+4=8 ✓。
分层练习(14:00–17:00) 【分层做法出自手册 ch21;题目新编】
- 基础版(需巩固者):清除后筛「类别 = 后勤」。逐行:仅 A04、A08 是后勤 → 显示 2 行(纸杯 30、抹布 6,即第 5、9 行),隐藏 6 行,守恒 2+6=8 ✓。
- 进阶版(先完成者,也是本课可裁剪项):清除后同时设「类别=行政」且「数量 ≥ 大于或等于 10」。逐行:行政类只有 A02(20)和 A06(2);A02 双条件均满足 → 显示;A06 数量不足 → 隐藏;其余 6 行类别不符 → 隐藏。答案:显示 1 行(文件夹 20,即第 3 行),守恒 1+7=8 ✓。讲师点题:两列同时设条件 = 「并且」。
6. 形成性评估设计 【方法出自手册 ch02/ch18(诊断力、三分支应对);全部题目新编】
CP1(口头 + 举手):「表头出现下拉小三角的请举手。」没举手的常见原因:点中的是空白单元格。巡场只指屏幕、不碰鼠标【手册 ch08 禁令】。
CP2(诊断性 MCQ,本课核心评估) 题面:现在屏幕只剩 4 行「教学」类。原来第 3 行的「行政 文件夹 20」这条数据现在在哪?
- A. 被删掉了,表里不再有它 → 诊断:破损模型「筛选 = 删除」
- B. 还在表里,只是暂时被藏起来 → 正确答案
- C. 被挪到表格最底部去了 → 诊断:破损模型「筛选 = 排序/移动」
- D. 被复制到了一张新表里 → 诊断:事实性误解「筛选 = 导出」
三分支应对【手册 ch02】:多数选 A → 全班性误解,立即带所有人清除筛选,亲眼看 8 行回来,点题「真删了就不可能回来」;多数选 B → 请一位学员说出理由(出声解释巩固记忆,ch05)后继续;四个选项差不多 → 说明在瞎猜、尚无心智模型,全班回退到 2:00 的步骤,放慢重做一遍「筛选 + 清除」。
CP3(✓/✕ 口头投票):「A05 便签正好 10 件,在『小于 10』里会出现吗?」答:不会(10 不小于 10)。多数答错 → 板书画数轴,标出 10 的位置,强调「小于 10 = 只有 1 到 9」。
CP4(预测—验证):进阶版动手前:「会剩几行?用手势比数字。」答:1 行。各答案分散属正常(此题较难),做完对照即可,不作为全班回退信号。
7. 现场演示脚本要点(现场编程的 Excel 变体) 【方法:手册 ch17;Excel 化与台词新编】
- 三段式切换:每步先说目标(「接下来让表只显示教学类」)→ 边点边念(「数据——筛选——漏斗按钮」)→ 做完再解释现象(「看行号:3、5、7、9 不见了;行号变成了蓝色【未实操验证:随版本而异】」)。
- 绝不复制粘贴、绝不替学员点鼠标【手册 ch17/ch08】;全用菜单点击、不用键盘快捷键(镜像学员环境;Ctrl+Shift+L 可切换筛选【未实操验证】,仅讲师自用)。
- 屏幕:Excel 缩放 ≥150%、窗口最大化、关掉所有通知、只开这一个工作簿【手册 ch17 Top Tips】。
- 板书:画 3 行小表 + 漏斗,被藏的行画灰色虚线标「没删,藏了」;旁挂术语流水表(全课只 3 个词):筛选 / 条件 / 清除【running glossary,手册 ch05】。
- 故意犯错点位:练习 2 的「大于/小于」选反,台词见 §5。
- 课前 10 分钟试跑清单【手册 ch17 Top Tips 7】:用学员同版本 Excel 完整跑一遍 §5 全部练习与答案;此项同时用于消除本文所有【未实操验证】标记。
8. 开场稿与收尾清单 【框架:手册 ch23 + 缩放规则;台词新编】
开场稿(0:00–2:00,按缩放规则只保留 3 项): 「大家好,我是XX。20 分钟后,你能在自己的任何一张 Excel 表里,几秒钟内只留下你要找的行——比如『哪些物品要补货』——而且原表一行都不会少。这里没有『太基础的问题』,卡住了就直接说出来,你不会是唯一的一个。都打开桌面上的『物品清单.xlsx』了吗?」 (按缩放规则删去:破冰、基线数据、后勤介绍;「确认文件已打开」是保留的最低限度动作,依据 ch08「时间估计要计入失败频率——新手找不到自己的文件是常态」。)
收尾清单(17:00–20:00,收尾 ≈ 总时长 15%):
- 确认保存(Ctrl+S 或「文件 → 保存」【未实操验证】),让大家记住文件位置;
- 发/展示步骤卡(三行):① 选中数据 → 数据 → 筛选;② 点列头小三角 → 选条件;③ 换题目前先「全选」清除;
- 「几天内用上」的具体建议【手册 ch23】:这两天找一张你自己的表——名单、报销、库存都行——花两分钟筛一次,真实数据练一次顶看十遍教程;
- 口头索求反馈一句:「今天哪一步最容易卡?课后随时告诉我。」
- 致谢 + 庆祝努力【手册 ch08 表扬进步而非天赋】:「20 分钟前没人用过筛选,现在你们已经完成了三次筛选加三次恢复。」
9. 去动机与无障碍审计 【手册 ch08/ch09,逐条自查;具体做法新编】
禁令自查:不说「just / 只要一点就行」(改说「这个动作练两次就顺手了」);不接管学员键盘鼠标;不对「不知道筛选」表示惊讶;不与超前学员深聊(「这个课后聊」);不懂装懂时改说「我课下查了再答你」;不鄙视工具。提问用「你们有什么问题?」+ 停顿 3 秒,不用「有没有问题」。
UDL 三通道【手册 ch09】:接收——同一信息出现在口述、大字号屏幕、板书步骤卡三处;参与——全员同步跟做、先预测再验证、举手投票;分享——口头说出答案即可,不强制展示屏幕;对全程没出声的学员主动轻声 check in;保留课后匿名反馈渠道。
10. 反馈计划 【手册 ch06/ch18,按缩放规则压缩为一行】
结束时口头一问(「哪一步最容易卡?」)+ 课后链接/二维码;课后把卡点记入下一轮教案(反思性练习 ≠ 重复,ch18/ch20),下次开课前重读。
11. 方法出处与新旧内容对照表
(手册总览页:https://carpentries.github.io/instructor-training/aio.html;材料按 CC BY 4.0 发布,改编需保留署名,见 final-skill.md「来源与许可」。)
这份课案可直接交付使用。两点诚实声明再强调一次:所有 Excel 界面步骤均未经本次实操核对(文中已逐一标注),执教前请按 §7 的试跑清单完整验证一遍;来源链接抄录自 final-skill.md 的章节索引,本次按你的要求只读取了该文件、未上网核实链接可达性。
逐行复算:教学类是 4 行;数量小于 10 是 4 行;行政类且数量不少于 10 是 1 行,时间表合计 20 分钟。它只读取了 Skill 提要,因此关于整本手册的判断应进一步核实;购物 App 的类比也不能概括不同产品。我们把原课案、原任务和同版 Skill 交给新的会话,针对这两处追加返修。
请核对上一版 Excel 课案中的两处判断:它把“本 Skill 不教授具体学科内容”写成了“原手册不含任何学科内容”,这两个对象是否被混淆?它还说购物 App 每次点选互不残留,但不同 App 的筛选行为并不一致,这个类比会不会带来误解?请回读实际材料,收窄没有依据的表述。 本次只需直接回复这两处可替换的段落及改动说明,不重写整篇课案;其余课案保留原稿。当前环境只读,不需要创建文件或等待写文件的批准。请不要只返回计划。 这是新会话,原任务、课案和实际使用的 Skill 在这里: /private/tmp/book-to-skill-lesson-revision-20261027/attempt-001/inputs/usage-prompt.txt /private/tmp/book-to-skill-lesson-revision-20261027/attempt-001/inputs/usage-response.md /private/tmp/book-to-skill-lesson-revision-20261027/attempt-001/inputs/final-skill.md
两处都核对完了:第一处确实发生了对象混淆(把 Skill 的边界写成了对手册的全称断言),第二处的类比建立在无依据的一刀切事实上,有反噬风险。以下是核对依据和两段可直接替换的文字。
第一处:「不含任何学科内容」
核对结果:混淆属实。 课案引用的出处是 final-skill.md「局限」第 2 条(final-skill.md:285),原文是「不包含学科内容:不含 Shell/Python/R/Git 等课程素材本身」——这条的主语是本 Skill(「不适用」一节同样写的是「本 Skill 不教 Shell/R/Python 的具体知识」,final-skill.md:26)。课案却把主语换成了手册,并把「不教/不含课程素材」放大成「手册明确不含任何学科内容」。后者被手册自带的零散学科性示例直接证伪:ch02 的 27+15 算术诊断题(final-skill.md:56)、ch02 的「Shell 课 40 分钟只教 4 个命令」案例(final-skill.md:223)。课案真正需要的推论——「Excel 内容全为新编」——只需要窄得多的前提:25 个单元全是教学法,手册和 Skill 都不提供 Excel 操作素材。
替换段落(usage-response.md:9,标注说明【新编】条):
原稿:
- 【新编】= 依据手册方法为本次 Excel 课新写的内容。手册明确不含任何学科内容(见 final-skill.md「局限」第 2 条),因此全部 Excel 操作、题目与答案是本课新编。
替换为:
- 【新编】= 依据手册方法为本次 Excel 课新写的内容。手册定位是教学法培训,不提供具体学科的课程素材(final-skill.md「局限」第 2 条「不含 Shell/Python/R/Git 等课程素材本身」说的是本 Skill 的范围;手册 ch01 提要为「本培训不教具体课程内容」——是「不教/不提供课程素材」,不等于手册中没有学科性内容,手册内即有 27+15 算术题等零散示例)。其中没有任何 Excel 操作内容,因此全部 Excel 操作、题目与答案是本课新编。
改动说明:① 主语归位——引用出处限定的是 Skill,不再冒充对手册的断言;② 收窄绝对化表述——「不含任何学科内容」改为「不提供具体学科的课程素材」,并主动承认手册有零散学科示例,避免被原文证伪;③ 推论保住——「Excel 部分无出处、全为新编」在收窄后的前提下依然成立。
另有一处呼应需同步(usage-response.md:190,§11 对照表末行):
原稿:
| 全部 Excel 菜单路径、界面现象、练习题面与逐行答案 | 无手册依据(手册不含学科内容) | **本课新编;UI 部分未实操验证,课前必须试跑** |替换为:
| 全部 Excel 菜单路径、界面现象、练习题面与逐行答案 | 无手册依据(手册不提供 Excel 等具体学科的课程素材) | **本课新编;UI 部分未实操验证,课前必须试跑** |
第二处:购物 App「每次点选互不残留」
核对结果:有误解风险。 「App 每次点选互不残留」是对购物 App 行为的全称事实断言,final-skill.md 中没有任何支撑,而且与许多 App 的实际行为相反——多数购物 App 支持品牌、价格、多属性条件叠加使用、会话内保留。学员拿出自己手机一对就能推翻讲师,类比反噬;更麻烦的是,如果学员的 App 恰好会叠加条件,这句「防失真」说明反而模糊了真正要建立的规则。手册自己的原则也支持收窄:类比都会失真,只有收益大于误解风险时才用(final-skill.md:45)。类比能承担的只有「筛选 = 只显示符合条件的行」这一层唤起作用,失真点应锚定在 Excel 侧可当堂验证的规则上。
替换段落(usage-response.md:33,§1「已有心智模型」行):
原稿: 已有心智模型(可借力,防失真):手机购物 App 的筛选(「按品牌筛一下」)——但 App 每次点选互不残留,Excel 条件会叠加,正是失真点。【新编】
替换为: 已有心智模型(可借力,防失真):手机购物 App 的筛选(「按品牌筛一下」)——只借用「筛选 = 只显示符合条件的行」这一层。App 侧不下统一断言(各 App 的条件是否保留、何时自动清空并不一致,有的 App 也会把多个条件叠着用);失真防护只锚定 Excel 的规则,且当堂可验证:Excel 的条件会保留并叠加,不清除就一直生效,换题目前必须手动「全选」清除(演示见练习 2 第 0 步;对应预判破损模型第 3 条)。【新编】
改动说明:① 删去无依据的全称断言,改为承认「各 App 不一致」,讲师不会被学员的个别手机经验当场拆穿;② 类比只承担唤起「筛选」概念的功能,差异点改述为 Excel 侧的规则——这恰是课案要教的心智模型,且由练习 2 第 0 步(不清除的后果)当堂演示,可验证;③ 显式挂接到预判破损模型第 3 条(忘记清除旧条件),课堂提问也应只问「Excel 清除后 8 行回不回来」这类可验证问题,不问「你们的 App 会不会自动清」。
其余课案内容一律不动;App 类比在全篇仅此一处,无其他呼应需要同步。
第一次返修收窄了部分表述,却仍写“其中没有任何 Excel 操作内容”,超出了已读材料。我们没有采用这句判断,补充原材料核对记录,再请它只陈述本次实际读取的范围。这条请求首次因服务额度上限中断,没有模型回复;额度恢复后,我们在新会话重新提交。
上一轮返修仍写了“其中没有任何 Excel 操作内容”。这次课案会话只读取了 Skill 摘要,没有读完整手册,仍不能作这种全书判断。原材料核对记录还显示,第 12 单元列有 Excel 外部课程链接;这也只能证明有链接,不能据此判断手册正文是否包含具体操作。 请重新核对这份返修,只回复最终可替换的【新编】标注说明和来源对照表的末行。交代本次只读了什么、本次课案的 Excel 示例是谁编写的,未逐句核实的来源判断不要写成已确认;不用再给计划或重写其余课案。 这是新会话,移交文件如下: /private/tmp/book-to-skill-scope-fix-20261027/attempt-002/inputs/usage-correction-response.md /private/tmp/book-to-skill-scope-fix-20261027/attempt-002/inputs/final-skill.md /private/tmp/book-to-skill-scope-fix-20261027/attempt-002/inputs/source-checks.md
核对确认:这份返修的两处替换文字仍各带一个全书判断——【新编】条结尾的「其中没有任何 Excel 操作内容」(usage-correction-response.md:13),和对照表末行的「手册不提供 Excel 等具体学科的课程素材」(usage-correction-response.md:21)。本次课案会话只读了 final-skill.md 提要,source-checks.md:47 也明确记录了这一点,且第 12 单元的 Excel 外部链接只能证明有链接,两者都支撑不了对手册正文的断言。以下为可直接替换的最终版,来源判断全部收窄为「未核实、不作断言」:
【新编】标注说明(整条替换):
- 【新编】= 依据本次所读 Skill 提要(final-skill.md)中的教学法方法、为本次 Excel 课新写的内容。本次设计只读取了该 Skill 提要,未读取手册全文,因此手册正文是否包含 Excel 操作内容未经核实,此处不作断言;全部 Excel 操作、题目与答案均由本次课案编写会话自行编写,未取用手册或其外部链接课程的任何材料。
来源对照表末行(整行替换):
| 全部 Excel 菜单路径、界面现象、练习题面与逐行答案 | 本次未核对手册全文,无法确认出处;编写时仅读取 Skill 提要(final-skill.md) | **本课新编;UI 部分未实操验证,课前必须试跑** |
改动要点只有两处:① 交代了本次实际读取范围(仅 Skill 提要,未读手册全文)和 Excel 示例的作者(本次课案编写会话新写,非取自手册);② 删掉「手册不含/不提供 Excel 内容」这类未逐句核实却写成已确认的全书判断,改为「未经核实、不作断言」,同时保留「本课新编、UI 未实操验证、课前必须试跑」这些本会话可自查的结论。其余课案内容不动。
完整原课案保留在上方;后续回复是实际请求的局部修订。作者已在采用稿中将学习目标限定为“教学类”,将检查点间隔更正为 2–5 分钟,并修正索引措辞与未经实测的采用承诺。采用稿末尾列出了执行者,原回复仍按原文保留。课案用于备课参考,Excel 界面与实际教学时长仍需在自己的环境中验证。
换成自己的书
先确定材料的使用权限和目标任务,再选择合适的文件格式;章节、图表或公式转换后都要回看原文。生成后保存原稿,对照来源检查关键建议,发现问题就带着原稿和依据返修。你使用的智能体如果支持自动发现 Skill,可按它的官方说明安装,再单独验证是否识别成功。
来源与授权
book-to-skill 固定版本采用 MIT 许可。The Carpentries and contributors 的 Instructor Training 正文采用 CC BY 4.0;本例补加编号标题并以中文整理,原文中的第三方素材另行核权。