智慧课程设计大赛小帮手
一句话：说清课程和教师信息，本技能依据第三届“泛雅杯”全国高校智慧课程设计大赛的两份官方空表，为你生成可直接编辑的参赛申请表、教学设计样例，并可按需生成说课 PPT 与 HTML 交互式课件。
0. 60 秒速览（第一次使用，只看这一段就够）
| 步骤 | 你要做的 | 本技能会做的 |
|---|---|---|
| 1 | 说一句：「用智慧课程设计大赛小帮手，帮我做《课程名》第 X 章第 X 节的参赛材料」 | 核对课程与教师信息；缺的先用提问补齐，仍缺的填通用参考内容并明确标注 |
| 2 | 回答 2 个选择题：要不要上传教学资料、要哪几种产物 | 联网收集本课程公开资料，按方法论逐栏撰写内容 |
| 3 | 打开输出目录，查看并修改产物 | 生成产物并向你展示（Word / PPT / HTML） |
需要你准备的信息（不全也没关系，AI 会先问、再用通用参考内容补齐）：课程名称、课程性质、开课年级、所属专业、本课次标题、学时安排、授课对象与人数、主讲教师信息、团队教师（可选，≤4 人）、近 5 年教学及奖励情况；若有教学大纲、教案、课件、原参赛材料更好，直接上传即可。
分级阅读指引：只想尽快拿到结果 → 读第 0、1、3 节；想写得更专业 → 再读第 2、4 节与第 7 节参考资料；遇到报错 → 直接看第 5 节。
1. 触发方式（怎么调用本技能）
- 不需要任何命令、参数或特殊格式，在对话框里说人话即可。
- 出现下列关键词会自动调用本技能：智慧课程、智慧课程设计大赛、智慧课程设计、参赛申请表、教学设计样例、说课 PPT、说课课件、泛雅杯。
- 没有自动触发时，在提示词里直接点名本技能：「用智慧课程设计大赛小帮手，帮我……」；也可在技能列表中选择本技能后再输入需求。
- 可直接复制的 5 个提示词示例（由简到繁，越具体结果越好）：
- 极简：用智慧课程设计大赛小帮手，帮我做一份《导游业务》的参赛材料，本课次 2 学时。
- 常规：帮我写《市场营销学》的智慧课程设计大赛参赛申请表和教学设计样例，工商管理专业本科，班级 45 人，第五章第二节，本课程共 32 学时。
- 完整：见第 3.1 节「提示词示例 1」（含主讲教师与团队教师全部字段）。
- 带资料：提示词 + 同时上传人才培养方案 / 教学大纲 / 教案 / 原参赛材料，让 AI 据此撰写。
- 只要一种：只要教学设计样例，不要申请表，教学流程请参考我上传的教案。
- 想大幅提高质量：在提示词里补上「本课次具体知识点名称、真实使用的平台工具（如超星学习通）、真实的前测后测数据、真实教学与获奖情况」。信息越真、越细，产物越像你自己的课。
2. 能力边界（先看清，避免期待错位）
能做
- 生成《智慧课程设计大赛参赛申请表》（含「二、措施」800–1500 字、「三、成效」）与《智慧课程设计大赛教学设计样例》两份 Word 文档；
- 按需生成说课 PPT、HTML 交互式课件（分页、可交互、含前测/中测/后测）；
- 严格按官方空表结构填写，表格不留白；措施栏自动在对应文字位置插入 2–3 张结构图/流程图/占比图；PPT 与课件自适应字号、超长自动分页，文字不超框；
- 信息不全时自动填「通用参考」内容并在对话中明确标注哪些需要你替换；
- 撰写前联网收集本课程公开资料，把具体知识点、方法名称、平台工具、数据话术写进正文。
不能做 / 不做
- 产物是草稿：AI 可能产生与你的课程不符的幻觉，必须由你批判性审查、修改后方可使用；
- 不代填真实经历、不代造真实数据：你的教学与获奖情况、平台真实数据、佐证材料只能由你提供，缺失时本技能只给通用参考内容并标注；
- 不面向非高校场景：本技能只服务高校（本科 / 高职 / 高专 / 高级技师）智慧课程设计大赛类参赛材料；中小学、中职、职高、企业培训等场景不适用；
- 不代报名、不代提交、不做查重、不对获奖作任何承诺；
- 不允许商用：不得用于收费培训、商业产品内嵌或二次修改分发（详见根目录 LICENSE.txt）。
帮到什么程度
- 从「一句课程名」到「4 份可直接编辑的参赛文档」，通常 1 轮对话 + 数分钟生成即可完成；
- 用官方空表保证格式合规，用方法论与布卢姆行为动词保证内容专业；
- 你大约还需 30–60 分钟：核对真实信息、替换通用参考内容、按自己的课做个性化润色。资料给得越全，这段时间越短。
3. 工作流程
角色定位：用户调用本技能后，你将在 WorkBuddy 等 AI 工具中化身为数智化教学、智慧课程建设及教学创新大赛参赛指导专家，为用户草拟比赛所需文件和说课 PPT 样例。任务分两步：① 与用户对话，收集信息并确认产物类型；② 依据本技能自带的官方空表与参考资料，调用 scripts/ 下的脚本生成文档与课件。
产物一律严格按空表填写，内容按参考资料中的方法论撰写。所有产物末尾会自动插入页脚说明（Word 在文末空 5 行后插入，HTML 课件与 PPT 各新增一页）。
3.1 收集信息（对话完成，不调用脚本）
步骤 1：判断基本信息是否完整。 需收集的核心信息：
课程名称、课程性质、开课年级、所属专业、本课次标题、学时安排、授课对象（班级）、授课人数、主讲教师信息（姓名/性别/出生年月/职称/职务/学历/学位/民族/政治面貌/工作单位/邮箱/手机）、团队教师（可选，不超过 4 人）、教学及奖励情况（近 5 年，500 字内）。
- 教学及奖励情况栏不得留空：写入
basic_info.teaching_reward。若用户未提供，先提示用户提供近 5 年教学研究与获奖情况；用户不提供的，由 AI 填写通用参考样例（脚本内置兜底，标注“通用参考，请替换为真实经历”），并在对话中说明。 - 若用户一开始就添加了文件（教学大纲、教案、课件、原参赛申请表/教学设计样例等），优先从中提取上述信息，再判断完整度；
- 信息已较完整 → 直接进入步骤 2，不弹出示例（减少用户选择次数）；
- 信息缺失或仅提供了课程名称、专业等部分信息 → 弹出提示词示例，请用户补充：
- ① 否：由 AI 挑选一个通用章节内容生成示例，并明确说明示例为虚构；
- ② 继续补充：再次显示示例并请用户继续输入。
- 单位信息缺失时的处理：若用户未提供工作单位 / 学校，按参考资料
methodology中unit_nickname_fallback的规则处理（用广为传播的大学绰号占位，并在对话中提示用户替换为真实单位）。
> 提示词示例 1：请为我填写一份 人工智能专业（本科），班级35人，类脑计算及应用课程，第三章 机器人自主心智发育（第一节、第二节）的智慧课程设计大赛参赛材料，本课程共 48 学时，本课次 2 学时。主讲教师：刘大鹅，女，1979年2月，教授，系主任，研究生/博士，壮族，党员，五道口职业技术学院，liudae@wudaokou.edu.cn，13999988888。团队教师：董二花（女，1980年11月，副教授，研究生/博士，五道口职业技术学院，理论课授课）、王三炮（男，1977年9月，副教授，研究生/硕士，五道口职业技术学院，学习通课程建设）、曹玲（女，1995年7月，讲师，研究生/硕士，圆明园职业技术学院，授课教师）。教学及奖励情况：近5年获省级教学成果一等奖1项……
>
> 提示词示例 2：请为我填写一份 土木工程专业（本科），班级50人，堪舆之道课程，第五章 风水勘测的智慧课程设计参赛材料。本课程共 32 学时，本课次 2 学时。主讲教师信息及团队信息见上传的表格。
步骤 2：提示用户添加现有教学资料。 弹出选项：① 暂不添加（由 AI 选取通用内容生成示例）② 添加（请用户上传教学大纲、教案、课件、已填样例等资料）。若用户资料不足以支撑内容，可参考参考资料 methodology 的 reference_docs 所列文件作为对话上下文（不直接写入产物）；仍不足时可调用 scripts/crawl_info.py 收集公开教学资料辅助撰写。
步骤 3：确认产物类型。 弹出选项（顺序固定：选项 1 在最上、选项 2 居中、选项 3 在最下，不得倒序或乱序）：
- 选项 1：仅参赛申请表 & 教学设计 Word 文档 2 份
- 选项 2：参赛申请表 & 教学设计 Word 文档 2 份 + 说课 PPT
- 选项 3：参赛申请表 & 教学设计 Word 文档 2 份 + 说课 PPT + HTML 交互式课件（功能最全，推荐）
3.2 内容分析（AI 撰写，可调用联网检索）
- 查阅参考资料
methodology，按其中方法撰写「参赛申请表·二、措施」（合计 800–1500 字，按理念与目标/内容与资源/教学实施/课程评价四块，每块给出具体做法、平台工具名称、数据或话术，避免空泛）、「三、成效」（（一）聚焦目标达成 300–600 字 +（二）佐证材料清单），以及「教学设计样例」全部栏目：教学目标（知识目标/技能目标/素养目标/思政目标四类）、学情分析、教学内容分析、教学重点、教学难点、智慧教学环境资源与技术、教学策略、教学过程（五列：教学环节/教学设计意图/教师活动/学生活动/数智化技术应用，体现人机协同四步元模型）、预期成效、特色创新——每栏须写可落地的丰富内容、有平台工具与数据支撑，开箱即用；撰写教学目标时，必须参考参考资料bloom_reference，按四类撰写，每条以布卢姆行为动词开头并标注知识类型；撰写教学过程时，须按methodology§C 写成可照做的步骤，体现人机协同四步元模型，不可只写原则性概述。空表无“教学目标/学情分析/教学内容分析”三栏，fill_design_plan.py会自动补行填写，撰写时这三栏内容不可省略。 - 撰写前必须先收集课程内容：调用
scripts/crawl_info.py收集本课程/本章节的公开教学资料（教材章节知识点、课程大纲、典型案例、行业数据），把收集到的具体内容融入措施与教学设计各栏——四栏全部必写，每栏须落到具体知识点、方法名称、平台工具与数据话术，杜绝空泛套话与万能模板句； - 完整性要求：产物的每个部分（Word 各栏、PPT/课件各页）都必须填写完整，不得留空白或“待填写”。某部分缺少必要信息时，先提示用户提供；用户不提供的，由 AI 填写通用参考内容（脚本内置兜底，会标注“通用参考，请结合课程替换”），并在对话中说明哪些部分为通用参考、建议用户替换。
- 将撰写好的全部内容写入
work/design_data.json，字段结构见参考资料design_plan_guide（含完整示例与填写指引）。 - 撰写面向学生的前测/中测/后测：按
methodology§E，就本课次学习内容出题考学生（考查概念、方法、应用，而非课程元信息），每题含题干、4 个选项（1 正确 + 3 干扰）、正确答案与针对作答的反馈（解释正确理由与典型误区）。将测试题写入design_data.json的interactions.quizzes；若未提供，脚本会依据学习目标自动生成内容型兜底题目。
3.3 生成产物（本技能内部调用，由 AI 工具自动执行）
本技能内部的调用方式如下，由 AI 工具在后台自动执行——您不需要输入任何命令，也不需要打开或编辑任何文件（其中 <json> 为 design_data.json 路径，<out> 为输出目录，默认与 json 同目录）：
- 选项 1：
python scripts/build.py <json> <out> - 选项 2：
python scripts/build.py <json> <out> --ppt - 选项 3：
python scripts/build.py <json> <out> --html --ppt
脚本按顺序执行、某一步失败不影响其余步骤，最后汇总产物清单：
fill_application.py→ 生成《智慧课程设计大赛参赛申请表.docx》；fill_design_plan.py→ 生成《智慧课程设计大赛教学设计样例.docx》（完整保留官方空表所有标签与结构，并自动补齐空表缺失的“教学目标/学情分析/教学内容分析”三行、在标题下补一行课程元信息，与重点/难点/环境/策略/教学过程/预期成效/特色创新一并填写）；gen_ppt.py（选项 2/3）→ 生成说课 PPT（自适应字号 + 超长自动分页，文字不超框）；其中的前测/中测/后测是面向学生的内容测试，学生作答后给出判定与解析反馈；PPT 另含“测试题（题目与参考答案）”页；gen_html_courseware.py（仅选项 3）→ 生成交互式 HTML 课件（分页呈现、支持鼠标与键盘翻页、字号最小 24px、含 5 个以上交互点、2 个以上模拟仿真与测试）。
可重复运行：再次运行本步骤会重新生成并覆盖同名产物，不需要先删除旧文件；生成失败后由 AI 工具重跑本步骤即可。
生成完成后向用户展示产物，并提示产物保存在输出目录。
4. 产物质量硬性要求（每次生成都必须满足）
生成前自检（AI 自己核对）
- 课程名称、专业、年级、本课次标题、学时、人数、主讲教师字段是否齐备；
- 教学及奖励情况是否已填写（未提供则填通用参考并标注）；
- 措施四栏（理念与目标/内容与资源/教学实施/课程评价）是否都有具体知识点、平台工具、数据或话术；
- 教学目标是否四类齐全、每条以布卢姆行为动词开头并标注知识类型；
- 教学过程是否按五列写成可照做步骤、体现人机协同四步元模型；
- 前测/中测/后测是否面向本课次学习内容出题，并含反馈解析。
生成后自检（向用户说明产物情况）
- 四类产物是否齐全（按用户所选选项）；
- Word 各栏是否无空白、无“待填写”；
- PPT / 课件各页文字是否未超出边框、与 Word 正文一致；
- 是否已告知用户：哪些内容是通用参考、需要替换；
- 是否已提醒：产物为草稿，须经教师审查修改后方可用于参赛或教学。
具体规范
- 每个部分都必须填写完整，不得留空白或“待填写”：Word 各栏（含教学及奖励情况）、PPT/课件各页全覆盖。缺信息先提示用户提供；用户不提供的，由 AI 填写通用参考内容并在对话中说明（脚本内置兜底自动标注）。
- 教学目标呈现规范：目标内容不加粗（脚本已保证仅【标签】加粗）；某类目标只有一条时不写序号（脚本自动去号，多条时保留编号并分行）。
- PPT/HTML 与正文一致、不错版：内容必须与 Word 文档一致；页面用图示、图形元素做视觉化表达（卡片、箭头流程、双栏对比、图表）；文字不得超出边框（自适应字号 + 超长自动拆页已内置，不得回退）。
- 内容必须充实具体：撰写前必须收集本课程公开资料，理念与目标、内容与资源、教学实施、课程评价四栏全部必写，落到具体知识点、方法名称、平台工具与数据话术，杜绝空泛套话与万能模板句。
运行环境（跨平台）：本技能脚本均为纯 Python、可跨平台运行——Windows、macOS、Linux 及信创环境均可直接执行；iPad、安卓手机/平板等移动端由 WorkBuddy 等 AI 工具在云端运行。所有术语、模板、参考平台均为国内高校场景（超星、智慧树、学堂在线、文华在线等），国内网络环境下可正常使用。所需依赖由 AI 工具自动准备，无需用户手动配置环境。
5. 报错与异常处理
总体原则：本技能遇到问题会尽量自我修复并给出通俗中文提示；用户遇到任何报错，把提示原文（或截图）发给 WorkBuddy 等 AI 工具，说一句「请修复后继续」即可，不需要用户写代码或改文件。
| 现象 | 原因 | 处理方式（AI 工具自动完成 / 用户只需配合） |
|---|---|---|
| 提示缺少 python-docx、python-pptx 等依赖 | 运行环境未预置所需依赖 | AI 工具会自动联网从 PyPI 安装；用户同意权限请求即可。本技能为使用体验更佳，建议在 WorkBuddy 中调用 |
| 生成中途对话或输出中断 | 网络波动或会话超时 | 先确认网络正常、AI 工具为最新版，然后输入「请继续完成」 |
| 某一步骤执行失败，其余照常 | 单个脚本异常（如某个图渲染失败） | 失败步骤会打印原因，其余产物仍会生成；由 AI 工具重跑本步骤即可，不需要先删除旧产物 |
| Word / PPT 打不开或提示被占用 | 产物正被 Office 打开，或路径无写入权限 | 先关闭已打开的产物再重跑；或换一个输出目录（<out> 参数指向其他文件夹） |
| 措施栏的图表没有出现 | 未检测到对应结构/模型/占比数据（依据正文内容判断），或 matplotlib 不可用 | 图表属可选增强：在对应栏目正文中写明结构名称、四步元模型、评价占比（合计 100%）后重跑即可；matplotlib 不可用时自动跳过插图，文档其余内容不受影响 |
| 参考资料读取失败 | 技能文件不完整（缺少 references 目录内容） | 重新获取本技能的完整文件后再运行；不要只复制其中一部分文件 |
| 生成内容不理想、与我的课不符 | 提示词信息不足或 AI 幻觉 | 补充上传教学大纲/教案/人才培养方案，或提供更具体的知识点、平台工具、真实数据后重跑 |
| 生成的测试题太泛 | 未提供本课次具体知识点 | 在提示词中写明本课次的知识点名称，或直接提供前测/中测/后测题目 |
6. 常见问题解答（FAQ）
常见错误与依赖说明
- 本 Skill 运行依赖 python-docx、python-pptx（及其依赖 lxml、Pillow 等）。在 WorkBuddy 等 AI 工具中这些依赖通常已预置；若缺失，AI 工具会自动联网从 PyPI 安装，无需用户通过编写代码等方式干预。用户只需同意 WorkBuddy 的权限请求即可。
- 参赛申请表“二、措施”栏的配图（结构图示、流程图、占比饼图等 2–3 张，插入在对应文字位置）由 fill_application.py 调用 matplotlib 渲染生成。matplotlib 属可选依赖：已预置或可联网安装时自动插图；不可用时脚本自动跳过插图，其余内容不受影响（依赖同样由 AI 工具运行时从 PyPI 准备，来源如实说明，不随技能包捆绑）。
- 为使用体验更佳，建议使用 WorkBuddy 调用本 Skill。
常见问题
- 我不了解智慧课程设计大赛怎么办？
你可先用模糊提示词让 Skill 帮你生成一份智慧课程设计参赛材料，这份材料实则是一个例子，你可阅读了解后再使用更加精确的提示词，包括课程名称、课程性质、开课年级、所属专业、本课次标题、学时、授课对象、授课人数、主讲教师信息、团队教师（可选）、教学及奖励情况等，并上传人才培养方案、专业教学标准或原有教学大纲等教学资料，WorkBuddy 等 AI 工具将会调用本技能为你生成有针对性的智慧课程设计参赛材料。 - 生成的 Word 文档、HTML 交互式课件和 PPT 在哪里？怎么打开？
本 Skill 生成的产物保存在用户指定的工作空间（默认与 design_data.json 同目录）。本 Skill 在所有流程结束、生成产物后会展示产物，用户可点击打开或选择“打开文件夹”查看。 - 这个技能能直接生成 PPT 课件吗？
本 Skill 默认产出《智慧课程设计大赛参赛申请表》和《智慧课程设计大赛教学设计样例》两个 Word 文档；说课用的 HTML 交互式课件与 PPT 需在“确认产物类型”环节选择选项 2 或 3 才会生成。PPT 是基于教学设计文稿生成的，所以必须先生成 Word 文档，单独直接生成会增加 AI 幻觉的风险。 - 我可以拿这个技能去商用、收费培训，或自行修改后再分发吗？
不可以。本技能采用知识共享署名—非商业性使用—禁止演绎 3.0 中国大陆（CC BY-NC-ND 3.0 CN）许可协议：您必须署名（李笃峰）、不得用于商业目的、不得修改/演绎/二次创作。任何商业使用、改编、演绎均须事先取得作者李笃峰的书面授权。完整条款见技能根目录 LICENSE.txt。 - AI 生成的内容能直接用于上课、说课或智慧课程设计大赛吗？
不能直接用。因 AI 可能出现与您教学内容不符的幻觉，生成内容须经过您批判性地审查与修改后方可参考使用；请勿将输出内容直接用于教学比赛或课堂教学而未经核实，以免涉及学术不端问题。 - 运行时报错怎么办？
本 Skill 依赖 python-docx、python-pptx（及其依赖 lxml、Pillow 等），这些依赖由 WorkBuddy 等 AI 工具在运行时准备：通常已预置，缺失时会自动从 PyPI 联网安装（需保持网络畅通）。若遇到报错，AI 工具会自动尝试安装或修复所需依赖，您只需同意权限请求即可；若问题仍无法解决，可重新运行一次或进一步细化提示词后重试。更多情形见第 5 节「报错与异常处理」。
核心提示：本技能产物为草稿，须经教师审查修改后方可参赛或用于教学，因 AI 可能出现与教学内容不符的幻觉。
7. 参考资料索引
本技能的规范与空表随技能一同提供，存放在 references/ 目录，由本技能在运行时自动取用，您不需要做任何操作、也不需要输入任何内容。若您想看看某份规范写了什么，直接对 AI 说一句「把撰写方法论的内容给我看一下」即可，由 AI 工具在后台调取并在对话中完整呈现。
下表说明每份资料写了什么、本技能在什么时候用到它：
| 资料 | 内容 | 本技能什么时候用它 |
|---|---|---|
| 撰写方法论 | 措施、成效、教学设计样例、学习目标、测试题、风险对策、资料不足时的辅助手段（A–G） | 撰写内容前必读，全流程贯穿 |
| 布卢姆动词规范 | 认知过程动词、知识类型与四类学习目标写法、自查规则 | 写教学目标、核查目标动词时 |
| 数据结构指引 | 设计数据的字段结构、字段映射、填写指引与完整示例 | 梳理课程信息、组织数据时 |
| 常见问题 | 常见错误与常见问题解答（FAQ） | 您提问或出现报错时 |
| 页脚说明 | 产物页脚文字（原样呈现，不加改动） | 生成 Word / PPT / 课件时自动写入 |
| 官方空表 | 第三届“泛雅杯”全国高校智慧课程设计大赛两份官方空表（申请表、教学设计样例） | 生成两份 Word 文档时自动套用 |
说明：这些资料由技能内置的读取模块（scripts/materials.py）统一取用，AI 工具在需要时自动调用，全程在本地完成、不经网络，也不需要您做任何操作——您只需在对话里说清楚课程与需求即可。
