心理健康教育教案生成（中小学版）

运行环境（云可移植 · 禁止硬编码本机路径）

本技能的脚本位于 scripts/，模板位于 assets/，参考文档位于 references/，均用相对于本技能目录的路径引用。切勿在命令里写死 C:/Users/...、D:/WPS Office/... 等本机绝对路径，否则在云端沙箱或其他电脑上会报错。

调用约定（后续步骤用占位符表示）：
- <SKILL_DIR>：本技能目录，即本 SKILL.md 所在目录。
- <PYTHON>：解析到的 Python 解释器，按以下优先级确定：
1. 若当前环境已有 python / python3 且能 import 所需依赖，直接使用；
2. 否则使用 WorkBuddy 托管的 Python（跨平台查找）：
- Windows：~/.workbuddy/binaries/python/versions/*/python.exe
- macOS / Linux：~/.workbuddy/binaries/python/versions/*/bin/python
3. 若缺少依赖，在该环境执行 pip install -r <SKILL_DIR>/requirements.txt（或单独 pip install python-docx pypdf）。

依赖：python-docx（必选）；pypdf（仅 --check-pages 实测页数时需要，缺失时自动降级为字数估算提示）。

模式差异：
- 本机模式（桌面端 / 连接电脑）：可用 Word / WPS / LibreOffice 实测页数，并可自动用 WPS 打开产物。
- 云上模式（云端沙箱）：无 Office 软件，页数检测退化为字数估算；产物以 present_files 交付，不调用 WPS。
- 腾讯在线文档输出需已连接「腾讯文档」连接器；未连接时按「异常处理与反馈机制」处理。

Overview

将素材或教学目标转化为标准格式的心理健康教育教案。核心能力：

1. 需求确认问答（入口）：每次生成前，先通过问答确认三项——年级/学段（含校名）、生成依据、输出方式
2. 两种内容来源：
   - 素材驱动（Mode A）：从图片（OCR）、链接（公众号/小红书）、粘贴文本中提取内容，组织为教案
   - 教学目标驱动（Mode B）：用户给出教学目标 + 学段，AI 自主检索心理学知识、设计课堂活动、生成教案
3. 四环节教案组织：按「热身—转换—工作—总结」四个环节设计完整的教学过程
4. 模板可选：是否套用模板由用户确认——选「是」则上传自己的 docx 模板、按用户模板填充（需在模板相应位置放置 {{字段}} 标记，见 Step 0 问题 4「模板占位符清单」）；选「否」则用技能内置通用底版（仿宋、A4、校名可配）。原「内置固定模板」的强制设定已移除
5. 内容完整、不限页数：不限制页数与字数；明确保留过渡语（环节衔接语）与设计意图（说课要点），生成可直接用于课堂与教研的完整教案
6. 多种输出方式：docx / 腾讯在线文档 / WPS 自动打开（模板选择独立于输出方式）
7. 核对确认循环：生成后询问用户是否认同；不认同则按意见重新生成，直到认同
8. 异常反馈循环：任何环节无法处理时，先反馈问题 + 已尝试方案，再按用户回复决定下一步

工作模式

根据用户确认后的「生成依据」走对应模式：

两种模式在 Step 5（JSON 编写）汇合，之后统一走内容自检→生成→核对→交付。

Step 0：需求确认问答（入口，每次必做）

> 这是技能的固定入口。无论用户首条消息是否已包含部分信息，都必须先完成确认再进入内容生成。
> 分两轮提问（每轮用一次 AskUserQuestion），顺序即确认顺序；用户用「其他」可补充自由输入。

第一轮（3 问）

问题 1：年级 / 学段（每次必问）
选项（单选）：
- 小学低学段（一、二年级）
- 小学中学段（三、四年级）
- 小学高学段（五、六年级）
- 初中学段
- 高中学段

问题 2：校名（表头用，可选）
- 默认沿用内置通用底版校名「湖南师大附中双语幸福小学」；也可填写所在学校（高中用户建议填写）
- 选项：「沿用内置底版校名」/ 「填写所在学校（选其他并输入）」
- 注：若用户上传了自有模板，可在模板中放 {{学校}} 标记来填入校名；此项 --school 主要作用于通用底版（或模板中保留旧校名文本时替换）

问题 3：生成依据（输入来源）
选项（单选）：
- 链接（公众号 / 小红书等文章链接）
- 图片（上传图片，自动 OCR 识别文字）
- 教学目标 / 主题（如「提升班级凝聚力」）
- 直接粘贴文本
- 混合（素材 + 教学目标）

第二轮（2 问）

问题 4：是否按模板输出
选项（单选）：
- 是，我上传自己的模板（docx）→ 用户随后提供模板文件，技能按用户模板填充教案
- 否，用通用底版即可 → 使用技能内置「XX学校教师备课用纸」通用底版（仿宋、A4、校名可配）
- 说明：原「内置固定模板」的强制设定已移除；是否用模板、用谁的模板，现在完全由用户决定。

> 若问题 4 选「是」：在继续前，请用户上传 / 提供模板 docx 的路径（或直接在对话中附上文件）。收到后将其作为 --template 参数使用。
>
> 用户模板必须使用 {{字段}} 占位符标记，脚本才能知道把内容填到哪。请让用户在模板对应位置（表格单元格或正文段落均可）放入以下标记——缺哪个标记，哪个字段就保持模板原样不填；多行字段（如教学过程、学习目标）会自动换行展开：
>
> 模板占位符清单（中英文均可，不区分大小写、忽略花括号内空白）
>
> | 标记 | 对应内容 |
> |---|---|
> | {{课题}} | 课题名称（含学段括号） |
> | {{备课时间}} | 备课时间 |
> | {{课型}} | 课型 |
> | {{学校}} | 表头 / 落款学校名 |
| {{总课时}} | 总课时数 |
> | {{学习目标}} | 学习目标（三条，自动换行） |
> | {{学习重点}} | 学习重点 |
> | {{学习难点}} | 学习难点 |
> | {{教学准备}} | 教学准备 |
> | {{教学方法}} | 教学方法 |
> | {{教学过程}} | 四环节教学过程（含过渡语与设计意图，自动换行） |
> | {{作业设计}} | 作业设计 |
> | {{板书设计}} | 板书设计 |
> | {{教学后记}} | 教学后记 |
> | {{教学设计意图}} | 整体设计意图 / 说课要点 |
>
> 示例：用户模板里写「课题：{{课题}}」「教学过程：{{教学过程}}」即可。模板布局、字体、配色、行列数均不限，脚本只认标记。
> 若文件非 docx、无法读取，或模板未放置 {{字段}} 标记导致无内容填入，按文末「异常处理与反馈机制」反馈并协商（补标记 / 换模板 / 改用通用底版）。

问题 5：输出方式
选项（单选）：
- docx（Word 文档，含模板 / 底版内容）
- 腾讯在线文档（云端在线文档，需连接腾讯文档）
- WPS 自动打开（本机生成 docx 并自动用 WPS 打开）

确认完成后，将五项（年级/学段、校名、生成依据、是否按模板及模板路径、输出方式）写入本次会话上下文，进入对应 Mode 的内容生成。

Mode B：教学目标驱动模式

详细设计指南见 references/goal_driven_design_guide.md。

Step 1B：接收教学目标与学段

用户已在 Step 0 确认学段，此处直接使用；若用户额外描述更细（如"高一"），采用更细标注。

解析输入：
1. 教学目标：提取用户描述的核心目标（如"班级凝聚力提升"→ 主题"团队合作"）
2. 课时长度：默认 40 分钟（小学）/ 45 分钟（初中、高中），用户指定则采用

Step 2B：AI 检索思考（五步法）

按 goal_driven_design_guide.md 第一章的五步法进行：

1. 目标解析：将教学目标拆解为核心主题、目标能力、目标层次、延伸方向
2. 知识检索：
   - 查主题知识库（guide 第二章），提取核心概念、活动建议、学习目标模板
   - 调用 AI 内部心理学知识补充
   - 可选 WebSearch 增强：当知识库覆盖不足或需要新颖活动时，搜索关键词如"高中 班级凝聚力 心理课 活动"，提取活动灵感（不照搬网络教案）
3. 学段匹配：确认或判定学段（详见 stage_classification_guide.md，已含小学低/中/高、初中、高中）
4. 活动设计：设计四环节活动，每个环节必须服务教学目标；每个环节、每个活动都要写出「过渡语（衔接语）」与「设计意图」
   - 热身：破冰游戏，引出主题
   - 转换：故事/情境/案例，带入思考
   - 工作：2-3 个递进式核心活动，直接指向目标能力
   - 总结：学生分享 + 教师升华 + 作业延伸
5. 学习目标撰写：按"知识技能素养 / 心理能力素养 / 态度信念素养"三条撰写，动词层级匹配学段

思考过程向用户简要展示（让用户在生成前知道设计思路）：
- 课题名称与学段
- 三条学习目标
- 四环节活动概要（每个环节一句话 + 设计意图一句话）
- 如果做了 WebSearch，提及参考了网络活动灵感

Step 3B：学段标注与适切性检查

同 Mode A 的 Step 3。课题名后加括号标注学段，如「我们是一家人——班级凝聚力提升（高中学段）」。

→ 完成后直接进入 Step 5（JSON 编写），跳过 Step 1A-4A。

Mode A：素材驱动模式

Step 1A：接收素材并提取内容

根据用户确认的「生成依据」选择对应提取方式：

图片素材（OCR）

• 用户提供图片路径 → 使用 Read 工具读取图片，直接识别图中文字
• 识别要点：
• 提取图中所有文字，保留原文段落结构
• 注意识别标题、正文、图注等不同层级
• 如果图片模糊或文字不全，标注「[识别不确定]」并尝试上下文推断；若多张图都无法识别或识别结果明显不可信 → 触发异常处理（见文末）

微信公众号文章链接

• 用户提供 mp.weixin.qq.com 开头的链接 → 使用 WebFetch 工具提取
• 提取要点：
• 提取文章标题、正文内容
• 忽略关注提示、广告、推荐阅读等无关内容
• 保留核心观点、案例、活动方案等有用素材
• 若 WebFetch 报错/被拦截/为付费墙 → 触发异常处理

小红书博文链接

• 用户提供 xiaohongshu.com 开头的链接 → 使用 WebFetch 工具提取
• 提取要点同上；抓取失败同样触发异常处理

直接粘贴文本

• 用户直接粘贴文本 → 直接使用

Step 2A：分析素材并提炼主题

对提取的内容进行思考分析：

1. 判断素材类型：是情绪管理、人际关系、自我认知、挫折教育、生命教育还是其他主题？
2. 提炼核心主题：确定教案课题名称（简洁、有吸引力，如「我的情绪彩虹」「看见她的力量」）
3. 提取可用素材：
   - 游戏/互动环节 → 热身环节素材
   - 故事/案例/绘本内容 → 转换环节素材
   - 方法/技巧/练习步骤 → 工作环节素材
   - 金句/理念/总结语 → 总结环节素材
4. 学段对齐：以 Step 0 用户确认的学段为准，将素材改造为该学段的难度与活动形式

Step 3A：学段标注与目标适切性检查

详细判定标准见 references/stage_classification_guide.md（已含小学低/中/高、初中、高中）。

1. 学段分类：按认知抽象度、书写量、活动形式、讨论深度、时间结构 5 个维度，将素材归入用户确认的学段
2. 课题标注：topic 字段必须在课题名后加括号写明学段，格式：课题名（小学X学段） / （初中学段） / （高中学段），如需更细可写 （小学高学段·五、六年级） / （高中学段·高一）
3. 学习目标适切性检查：对照该学段心理特点，检查目标的动词层级、概念数量、元认知要求、书写量是否匹配
4. 按学段调整设计：四环节组织、语言风格、时长分配遵循对照表中该学段的做法
   - 时长参考：小学 40 分钟（低段 8/7/17/8；中段 5/7/23/5；高段 5/5/25/5）；初中/高中 45 分钟（热身 5 / 转换 5 / 工作 30 / 总结 5，均为 热身/转换/工作/总结）

Step 4A：组织四环节教学过程

按照标准心理课结构设计教学过程。详细指南见 references/lesson_plan_guide.md（已强化过渡语与设计意图写作规范）。

每个环节写作规范（务必保留过渡语与设计意图）：
- 热身：游戏名称 + 玩法（1-2 句）+ 与主题的关联；写明本环节设计意图
- 转换：媒介（故事/视频/情境）+ 核心内容（1-2 句）+ 引导问题；写明过渡语（从游戏到情境的自然衔接）
- 工作：2-3 个递进式活动，每个活动名称 + 步骤（2-3 句）+ 该活动设计意图；活动之间用过渡语串联
- 总结：学生分享 + 教师总结升华（1-2 句）+ 作业布置；写明设计意图（说课要点）

Step 5：编写教案内容（JSON）——两种模式汇合点

> Mode A 从 Step 1A-4A 进入此步；Mode B 从 Step 1B-3B 进入此步。

将全部内容整理为 JSON 格式，字段如下：

{
  "topic": "课题名称（学段）",
  "school_name": "湖南师大附中双语幸福小学",
  "date": "2025.9.15",
  "course_type": "新授",
  "total_hours": "1",
  "learning_objectives": "1.知识技能素养：…\n2.心理能力素养：…\n3.态度信念素养：…",
  "key_points": "学习重点",
  "difficulties": "学习难点",
  "preparation": "教学准备材料",
  "teaching_methods": "讲授法；讨论法；情境法；游戏法；实践法；其他",
  "warmup": "热身环节内容（含过渡语、设计意图）",
  "warmup_time": "5",
  "transition": "转换环节内容（含过渡语、设计意图）",
  "transition_time": "5",
  "work": "工作环节内容（含各活动设计意图、活动间过渡语）",
  "work_time": "25",
  "summary": "总结环节内容（含设计意图）",
  "summary_time": "10",
  "homework": "作业设计内容",
  "board_design": "板书设计内容",
  "design_intent": "整体设计意图（说课要点）：本节课以…为线索，通过…达成…目标；各环节层层递进，侧重培养…",
  "teaching_notes": "教学后记（可留空）"
}

注意：
- topic 必须带学段括号（Step 3 的判定结果），如「动力气球——探索我的学习动机（小学高学段）」
- school_name 取 Step 0 确认的校名；默认沿用模板校名
- 学习目标必须用 \n 分隔为 1、2、3 条，遵循「知识技能素养 / 心理能力素养 / 态度信念素养」格式
- 各环节内容中如需换行，用 \n 分隔（每段一个活动）
- 保留过渡语与设计意图：不要为了凑页数而删减衔接语和说课本意；本技能不限制页数与字数，内容可充分展开
- design_intent 为整体设计意图/说课要点，会单独渲染为「教学设计意图」章节

Step 6：内容完整性自检（非阻断）

本步骤只做提示，不做硬性字数/页数阻断。详细内容完整度指南见 references/page_control_guide.md。

1. 将 JSON 保存为 content.json（工作目录或临时目录）
2. 可选运行字数统计（仅作规模参考，不限制）：
   bash <PYTHON> <SKILL_DIR>/scripts/generate_lesson_plan.py --input content.json --estimate-only
3. 自检清单（✅ 通过即可生成，不达标也不强制截断）：
   - [ ] 四环节齐全，时间总和 = 课时长
   - [ ] 每个环节含过渡语（衔接自然）
   - [ ] 每个环节/活动含设计意图
   - [ ] 学习目标三条齐备且动词层级匹配学段
   - [ ] 环节目标、核心活动、时间分配是骨架，已保留

Step 7：生成教案文档

# 若用户在 Step 0 上传了自有模板，加 --template "<用户模板路径>"
# 否则脚本使用内置通用底版（默认）
<PYTHON> <SKILL_DIR>/scripts/generate_lesson_plan.py --input content.json --output 教案名称.docx --school "<Step0确认的校名>" [--template "<用户模板路径>"]

生成后脚本会自动：
- 输出各环节字数统计（规模参考，非上限）
- 将 design_intent 渲染为文末「教学设计意图」章节
- 通用底版下用 --school 替换表头校名；用户模板若含旧校名文本也可用 --school 替换，或在模板中放 {{学校}} 标记直接填入
- 若传了 --template，脚本扫描模板内 {{字段}} 标记并替换为对应内容（标记清单见 Step 0 问题 4）；无需与内置底版结构一致。未放标记的字段保持模板原样，多行字段自动换行展开
- 可选实测页数（--check-pages，仅本机有 Office 时；云上模式降级为字数估算提示）——页数仅供用户知悉，不再作为通过/不通过的门槛

如需单独复核已生成的 docx：

<PYTHON> <SKILL_DIR>/scripts/generate_lesson_plan.py --check-pages 教案名称.docx

Step 8：核对确认（用户审核）

生成教案后必须进入核对阶段，不能直接交付。具体做法：

1. 用 present_files 展示生成的 docx（或腾讯在线文档链接），并明确向用户提问：「这份教案您是否认同？」
2. 认同 → 进入 Step 9 交付
3. 不认同 → 请用户提出具体意见，然后：
   - 将意见按下表映射为修改指令
   - 只修改对应字段，保留模板结构和其他未涉及字段
   - 回到 Step 6（自检）→ Step 7（重新生成）→ 再次核对
   - 循环直到用户认同，或用户明确表示接受当前版本

意见 → 修改指令映射表：

实现要点：重新生成时，Mode A 把「原 JSON + 素材原文 + 用户意见」、Mode B 把「原 JSON + 教学目标 + 知识库参考 + 用户意见」一起作为上下文，只修订意见涉及的字段，不要推倒重来、不要改变模板结构。

Step 9：交付

根据用户在 Step 0 确认的「输出方式」分支交付：

分支 A：docx 文档

• 使用 present_files 展示最终确认的 .docx 文件（来自用户模板或通用底版）
• 简要说明教案的主题、学段判定、四环节设计、设计意图要点、所用模板来源

分支 B：WPS 自动打开（仅本机模式）

• 先按分支 A 生成 docx
• 定位 wps.exe：ls D:/WPS Office/ 取最新版本目录，拼接 /office6/wps.exe
• 打开命令（PowerShell）：Start-Process -FilePath "<wps.exe路径>" -ArgumentList '"<教案docx路径>"'
• 云上模式不调用 WPS，直接把 docx 交付给用户

分支 C：腾讯在线文档

• 调用 tencent-docs 技能，将完整教案内容（含四环节、设计意图）创建为在线文档
• 内容可先用 Markdown 组织（课题、学段、学习目标、四环节、设计意图等）
• 创建成功后返回文档链接并用 present_files 展示
• 若腾讯文档连接器未连接 → 触发异常处理（见文末），建议改用「docx（通用底版）」

异常处理与反馈机制（任意环节通用）

> 核心原则：遇到无法处理 / 不确定能否处理的问题，先向用户明确反馈，再根据用户回复决定下一步；绝不静默跳过或擅自臆造。

任何环节卡住时，按以下三步处理：
1. 反馈问题：说清「哪里卡住了、影响什么」
2. 说明已尝试：列已做的尝试（如已用 Read 识别图片、已用 WebFetch 抓取链接）
3. 给出选项 + 等回复：提供 2-3 个可行下一步，等用户选择后再继续

常见场景与处理：

严禁：编造不存在的心理学概念/理论、用臆测内容冒充素材原文、在用户未确认的情况下擅自更换输出方式或学段。

模板与脚本

assets/lesson_plan_template.docx

技能内置通用底版（空白版，仅在用户选「否，用通用底版」时使用，非强制设定），包含：
- A4 页面，页边距 2.54/2.54/3.17/3.17 cm
- 页眉「XX学校教师备课用纸」（方正大标宋_GBK 22pt，校名可由 --school 替换）
- 11 行 × 9 列合并单元格表格
- 全部文字预设仿宋 12pt 字体
- 用户亦可在 Step 0 选「是」上传自有模板，通过 --template 使用，完全替代本底版（自有模板需在对应位置放置 {{字段}} 标记，见 Step 0 问题 4 清单）

scripts/generate_lesson_plan.py

教案生成脚本，功能：
- --input content.json：读取教案内容（JSON 生成模式）
- --output 教案.docx：输出文件路径
- --school "校名"：替换表头校名（缺省沿用模板校名）
- --estimate-only：仅统计字数规模，作参考，不阻断生成
- --check-pages 教案.docx：对已有 docx 实测页数（仅本机 Office，可选诊断）
- --template 自定义.docx：使用自定义模板（可选；自定义模板需含 {{字段}} 标记，见 Step 0 问题 4）
- 自动将 design_intent 渲染为文末「教学设计意图」章节
- 不再强制 2 页上限，页数仅供知悉

references/lesson_plan_guide.md

四环节教学设计指南：字段说明、各环节写作规范（含过渡语与设计意图）、素材转化思路、示例。

references/stage_classification_guide.md

学段判定与目标适切性：小学低/中/高、初中、高中 五学段心理特点对照表、5 维度判定标准、目标检查清单、课题标注格式、按学段调整设计。

references/page_control_guide.md

内容完整度指南（原「页面控制」改造）：本技能不限制页数与字数；强调保留过渡语与设计意图；提供内容充实度自检清单与字数统计参考（非上限）。

references/goal_driven_design_guide.md

教学目标驱动设计指南：AI 检索思考五步法（目标解析→知识检索→学段匹配→活动设计→目标撰写）+ 常见心理教育主题知识库（班级凝聚力、情绪管理、学习动机、人际交往、自我认知、挫折教育、生命教育、入学适应、专注力、友谊、考试焦虑、感恩教育等，均含核心概念、适用学段、四环节活动建议、学习目标模板）。

注意事项

1. 图片 OCR：直接用 Read 工具读取图片识别文字，不要编写 OCR 代码，不要使用外部 OCR API
2. 链接提取：用 WebFetch 工具，忽略广告和无关内容；失败按异常处理反馈
3. 素材转化：不要照搬原文，要转化为课堂活动语言（指令清晰、步骤明确），并保留过渡语与设计意图
4. 教学目标驱动模式（Mode B）：
   - AI 思考过程必须参考 goal_driven_design_guide.md 的主题知识库
   - WebSearch 为可选增强，不是必须步骤；知识库和 AI 内部知识优先
   - 设计的活动要有名称、步骤、时间，可直接用于课堂
   - 不要编造不存在的心理学概念或理论
5. 内容不限页数：不强制 2 页；字数统计仅作规模参考，不阻断生成；核心是内容完整、过渡语与设计意图清晰
6. 仿宋字体：不要手动设置字体，脚本会自动处理（模板已内置）
7. 核对循环：生成后必须询问用户是否认同，不可默认交付；不认同必须按意见修订后再生成
8. 异常反馈：任何无法处理的问题先反馈、再按用户回复处理，严禁静默跳过或臆造
9. 隐私：生成的教案可能包含个人信息，提醒用户注意
10. 教学后记：默认留空，由教师课后填写