| name | physics-lecture |
| description | 高中物理讲义编写技能：专为40-50分学段学生设计，以费曼教学风格 将物理知识转化为易读、易懂、有吸引力的讲义文本。 当用户出现以下行为时自动触发： - 提供物理草稿/大纲并要求编写成讲义 - 说"写物理讲义"、"编写讲义"、"把草稿写成讲义"等 - 提供物理知识点并要求整理成适合学生阅读的材料 - 明确要求针对薄弱学生编写物理教学内容 - 用户直接发送一份物理讲义草稿（粘贴内容或提供文件路径），
即使未明确说明用途，也应自动识别并触发本技能
|
| argument-hint | ["草稿文件路径 或 知识点描述 或 直接粘贴草稿内容"] |
| allowed-tools | Read, WebFetch, Write, Edit, Bash |
高中物理讲义编写技能
核心目标
让高中物理成绩在 40-50分 区间的学生：
- 看得懂 — 消除认知障碍，理解知识本质
- 学得会 — 掌握解题思路与核心方法
- 想看下去 — 语言有趣，节奏有吸引力
输入处理
根据 $ARGUMENTS 或用户上下文判断输入类型：
- 本地草稿文件（
.md、.txt、.docx 路径）：使用 Read 工具读取草稿内容。
- 网页链接：使用
WebFetch 工具抓取内容。
- 直接粘贴内容：以用户粘贴的草稿/知识点作为来源。
- 仅描述知识点（如"牛顿第二定律"）：以该知识点为主题从零创作。
自动识别草稿触发
即使用户没有明确说"写讲义"，只要满足以下任一条件，也应自动触发本技能：
- 用户粘贴了含有物理教学内容的文字（包含物理术语、公式推导、例题、受力分析、知识点说明等特征词汇）
- 用户提供了文件路径，读取后判断为物理教学草稿或教案
- 用户在消息中提及"物理草稿"、"讲义草稿"、"教案"、"知识点整理"等关键词并附带内容
识别后的处理方式：先向用户确认意图，说：
"我看到你发送了一份物理草稿，是否需要我将它编写成适合40-50分学生阅读的讲义？"
用户确认后，立即进入编写工作流程。
若未提供任何输入，询问用户：
"请提供物理草稿文件路径、知识点描述，或直接粘贴草稿内容，我来帮你编写成讲义。"
编写工作流程
第零步 — 说明流程并确认
在执行任何操作之前，向用户说明本次任务的完整流程与目标，格式如下：
即将执行：高中物理讲义编写
输入来源： [本地草稿文件：路径 / 网页链接 / 直接粘贴内容 / 知识点描述：xxx]
执行步骤：
- 读取草稿内容，提取核心知识点、例题与风格特征
- 结合学生画像（40-50分学段），分析学习痛点、认知负荷、前置知识与常见错误
- 按费曼风格写作原则进行讲义创作
- 输出完整讲义（含章节标题、学习目标、概念讲解、例题、易错提醒等模块）
- 质量自检，确认无跳步、无拔高、无捏造
- 询问是否保存文件
目标： 让40-50分学生看得懂、学得会、想看下去。
请确认是否按此流程执行，或告知需要调整的地方。
等待用户确认后，方可进入第一步。
第一步 — 获取草稿内容
根据输入类型读取草稿，提取：
- 核心知识点列表
- 已有例题与解析
- 草稿的语言风格特征（用于后续保持风格一致性）
第二步 — 学生认知诊断
读取并应用 student-profile.md 中的学生画像，分析：
- 本章节的学习痛点 — 该知识点哪里最容易让40-50分学生卡住？
- 认知负荷评估 — 草稿中哪些概念对目标学生而言认知负荷过重？
- 前置知识检查 — 学生是否具备理解本章的先备知识？
- 常见错误模式 — 该分段学生最容易在哪里犯什么样的错误？
输出简要的认知诊断表（内部分析，不出现在讲义正文中）。
第三步 — 应用讲义写作原则
严格遵循 principles.md 中的写作原则进行创作：
- 费曼风格：用日常语言重新解释物理概念
- 层次结构：概念 → 直觉理解 → 公式推导 → 例题 → 变式练习
- 语言风格：与草稿保持一致，不做风格大幅偏移
- 节奏控制：设置悬念、制造好奇、给学生"啊，原来是这样"的感觉
若需统计草稿字数与结构，可运行：
python .claude/skills/physics-lecture/scripts/analyze_draft.py <文件路径>
第四步 — 编写讲义正文
按照 assets/lecture_template.md 的结构模板输出完整讲义，必须包含：
| 模块 | 说明 |
|---|
| 章节标题 | 有吸引力，点明学习价值 |
| 学习目标 | 用学生语言写，具体可检验 |
| 痛点引入 | 先戳痛点，再给解法 |
| 概念讲解 | 费曼风格，日常类比优先 |
| 公式解读 | 逐项拆解，说人话 |
| 例题精讲 | 分步骤，说出每步"为什么" |
| 易错提醒 | 针对40-50分学生的典型错误 |
| 小结回顾 | 用一句话或思维导图收束 |
第五步 — 质量自检
编写完成后，对照以下标准自我检查：
第六步 — 输出与保存
输出完整讲义后，在项目根目录下按以下结构创建文件：
[讲义标题]/
[讲义标题].md # 讲义正文
image/ # 该讲义依赖的所有图片（无图片时也须创建）
具体步骤：
- 以讲义标题为名，在项目根目录创建文件夹
- 在文件夹内创建
image/ 子文件夹
- 将讲义正文写入
[讲义标题]/[讲义标题].md
执行上述操作前，告知用户将创建的路径，确认后再写入文件。
执行约束
- 不拔高：不为40-50分学生引入超纲内容或竞赛技巧。
- 不简化过度：保持物理概念的准确性，不因"简单化"而引入错误认知。
- 保留草稿风格：语言风格与草稿保持一致，不做无必要的文风转变。
- 不捏造例题答案：所有例题解答须经过物理验算，数值正确。
- 标注不确定处：若草稿中有模糊表述，标注说明，而非擅自猜测改写。
- 层次清晰：每个知识点严格遵循"是什么 → 为什么 → 怎么用"三层逻辑。
- 终端命令须事先说明：每次执行 Bash 命令前，须向用户说明该命令的具体用途，不得静默执行。
- 不确定即暂停汇报：执行过程中若遇到任何不确定、没把握的情况，必须立即暂停并向用户汇报，等待指示后再继续。
长文档写入规范
适用场景：当编写的讲义预计超过 200 行时，必须遵循以下流程。
标准流程
-
第一步：编写框架
- 先构思完整的讲义框架（知识点结构、例题分布、练习题安排）
- 将框架写入文件，包含：
- 讲义标题
- 各知识点的二级标题（
##）
- 各知识点的核心要点（简要列出）
- 例题和练习题的占位符
- 告知用户："框架已完成，请审核。确认无误后将逐板块填充内容。"
- 等待用户确认
-
第二步：逐板块填充内容
- 按框架顺序，逐个知识点思考并填充内容
- 每完成一个知识点，立即使用
Edit 工具写入文件
- 不要一次性思考所有知识点，避免"手没跟上脑子"
- 每完成 2-3 个知识点，向用户汇报进度
-
第三步：全文检查
- 所有知识点填充完成后，必须通读全文
- 检查知识点之间的衔接是否自然
- 检查逻辑是否合理、前后是否一致
- 检查例题答案是否正确
- 检查是否有遗漏的练习题
- 发现问题立即修正
子代理并行处理
适用场景：当讲义中有多个独立知识点（知识点之间关联性不强）时，可使用子代理并行处理。
操作方法：
- 将独立知识点分配给不同的子代理
- 每个子代理独立完成自己的知识点内容
- 所有子代理完成后，主进程汇总结果
- 汇总后必须进行全文检查，确保知识点之间衔接合理
注意事项：
- 如果知识点之间有强逻辑关系（如递进、因果、前置依赖），不适合并行处理
- 例题和练习题的难度应保持一致，避免子代理之间难度差异过大
