Communitygithub.com

教材升级

重构现有教科书、讲义和课程材料。可用于诊断章节、组织课程、编辑学生资料、设计活动或根据教师素材准备可录制的脚本。

教材升级 是什么?

该技能旨在帮助开发者或教师系统性地升级和重构现有的教育材料。它适用于Claude Code、Cursor、Codex等AI代理平台,能够处理从教材诊断、课程组织、材料编辑到活动设计和录制脚本编写的全流程任务。技能的核心流程包括:通过结构化面试明确受众和交付需求,对PDF图像材料进行OCR文本提取和视觉核查,诊断学习难点并提出具体修改建议,按“目标-前置条件-实践-证据”框架组织课程,以及采用问题驱动的章节编辑法。该技能还提供了详细的布局校对流程,确保多页PDF的格式一致性,并支持基于视觉指南的脚本编写和包含错误分析的评估活动设计。特别地,它强调通过版本化样稿和审批流程来管理大规模排版任务,确保最终交付物符合技术规格和学习目标。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/j-c-fstk-dev/TextbookUpgradeSkill/tree/main/skills/textbook-upgrade

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

教材升级 是做什么的?

确定受众、要求的交付物以及可用的材料。使用课程的语言。仅执行必要的步骤。如果要求是编辑某个章节或为已确定的课程编写脚本,请从该章节或课程开始。当受众不确定时,明确说明假设,并推进可逆的决策。

对于像“改进此材料”这样宽泛的要求,假定需要生产直至交付。从面试和方向选择开始。使用附件中已有的回复。当存在歧义时确认稿件类型:讲义、脚本或两者。未来录制课程的意图提供了上下文。当要求时则生成脚本。对于临时性的小要求,将面试限制在会影响该交付物的决策上。

对于讲义,在排版前应用视觉方向和图像指南。当有脚本要求时,应用录制指南。在交付任何稿件之前,执行审查与反馈。将面试记录和决策保存在私有项目中以便后续恢复。

当PDF由图像组成时

在私有副本上工作。逐页测试文本提取,并视觉检查代表性页面,包括一个密集页面和一个包含图像或图例的页面。对于扫描页面,使用材料语言(如果可用)进行OCR,或对可读片段进行视觉转录。DOCX、PPTX或原始项目文件可以节省工作量,但非必需。如果缺少阅读工具,请确定具体障碍并要求提供必要页面的可读截图。

在收到保留内容的格式化要求时,保持措辞、顺序、表格、图例以及图形与文字之间的关系不变。即使PDF包含OCR图层,仍然需要排版才能更改布局。重建可编辑块,并将结果与原始图像进行比对,包括数字、技术术语、重音符号和阅读顺序。记录不确定的片段及其源页面以便确认。按最终尺寸评估每个图形。仅在分辨率影响必要细节时要求提供更好的图像。对于视频课程,分别评估文本对于脚本的实用性以及图像用于展示的质量。

使用一个样本来估算恢复效果并为初始面试提供依据。对于大规模材料的排版,在复制布局之前,先按照以下流程交付一个样稿。仅在获批范围内继续进行,并记录哪些页面已恢复、已核对,或仍需要更好的原始文件。

诊断

将每个发现与页面、章节、图像或录制分钟数关联起来。对于每个影响学习的问题,解释学生在哪个环节卡住,并提出具体的修改建议。区分编辑性更正与技术性疑问。保留教师自己的术语、示例和叙述。当来源之间存在冲突时,记录双方并制定能够解决冲突的问题。

组织课程

定义学生最终应能完成的任务。按完成下一个任务所需的知识顺序排列课程。如果一节课有两个独立的目标,考虑将其拆分。对于每节课,记录可观察的目标、前置条件、来源、教师示例、实践和学习证据。当有多个交付物或用户要求规划时,使用课程表。

编辑讲义

用一个学生能识别的问题来开启章节。按照使用顺序呈现概念。在要求学生独立应用之前,先开发一个示例。明确指出图像中可观察的内容,并在有图像时编写可访问的图例和描述。对于操作步骤列表使用列表,对于实际比较使用表格。对于局部调整,保留其他部分不变。

排版样稿

选择能够练习材料中不同决策的页面(例如,密集解释、表格和插图序列)。接受用户的选择,用一句话说明样本的理由,并阅读相邻页面以恢复引用和后续内容。对于仅限于某一部分的要求,以约定的格式交付该部分本身。

导出一个版本化的样稿,打开文件并浏览所有页面。对于移动端,根据PDF为每张页面生成约定阅读宽度下的图像。如果宽度未指定,选择一个代表性的宽度并告知。在不放大的情况下检查每张图像。确认学生能够追踪表格中的一行到其来源、阅读图例、区分细节以及识别替代项的开始位置。如果空间不足,重新分配内容。在更正后再次检查导出结果。

交付样稿、预览和实际未完成项。将样稿页面与原始页面关联起来,保留之前的版本,并说明如何回复:“批准,应用于其余部分”或“修订第X页”。等待视觉批准后再扩展排版。跟踪技术疑问直至负责人在发布前确认。

创建活动

选择一项能产生目标证据的任务。如果目标是观察,提供可供检查的东西;如果是决策,提供足够的上下文来证明选择的合理性。交付题目、期望答案、验收标准以及关于一个可能出现的错误的评论。当答案依赖于缺失信息时,向教师发出信号。

编写录制脚本

确定哪些内容需要演示以及有哪些资源可用。从指定的课程表或章节入手。使用脚本模板。编写自然的对话,将每个解释与可见的细节同步,并包含学生观察或回答的机会。识别可以一起录制的镜头。指出缺失的资源,并在可能时提出可行的替代方案。

核对交付物

检查每个宣称的目标是否出现在活动中,以及学生是否有足够的信息来解决它。对照可用来源核对数字、术语和条件。将对作者的疑问与供学生阅读的文本分开。在审查一个具有多个输出形式的课程时,跟踪讲义、脚本和答案中的每个事实性更改。如果进行了导出,检查最终文件中图形的裁切、图例的阅读和标题的顺序。仅交付所要求的格式。

相关技能