FinalsPilot (v0.2.3)
使用这个技能,把混乱的课程资料变成一个紧凑的、基于证据的期末复习路径。实际目标是:在10-12小时的专注学习后,保证至少60分,争取80分左右,前提是材料中包含足够的考试信号。
激活时用户指南(必须遵守)
当此技能被激活(通过 use_skill 加载)时,助手必须先向用户展示一个清晰的、分步的工作流程指南,然后再做其他任何事情。这是学生的入门指南——他们需要在开始前看到完整的路径。
指南必须包含:
-
问候 + 版本:说明技能名称和版本(例如,“FinalsPilot v0.2.3 已激活”)。
-
该技能的用途(1-2句话):把你的课程资料变成一个结构化的10-12小时期末复习路径。
-
学生需要提供的内容:课程资料(PPT、教材、录音、作业、往年试题、复习笔记)——可以未经整理,全部放在一个文件夹或知识库中。 如果资料还在超星/学习通中,告诉学生配套的
chaoxing-materials技能可以在 FinalsPilot 开始资料覆盖之前,先将可访问的章节课件下载到本地文件夹。 -
完整的工作流程,作为可编号的清单,用平实的语言呈现,便于学生遵循:
步骤 发生什么 你要做什么 预计时间 1 资料接收与分类 上传资料,指向文件夹,或先使用 chaoxing-materials处理学习通/超星课件0.5小时 2 知识框架 审查框架,提问 1.5-2小时 3 课件题库 浏览索引化的问答,自测 1小时 4 作业映射(如适用) 审查作业解答与映射 0.5小时 5 第一次考试(基础) 参加考试,然后复习错误 1.5-2小时 6 第二次考试(刻意练习) 参加考试,然后复习 2-2.5小时 7 背诵包 记忆必考项目,滚动回忆 1小时 8 睡眠模块 休息以巩固记忆 — 9 第三次考试(冲刺)+ 最终记忆表 早晨检索 + 最终冲刺 1.5-2小时 -
询问学生是否开始:“准备好了吗?把你的课程材料发给我,我们从第1步开始。”
-
灵活性说明:提到工作流程可以根据可用时间调整(2小时/6小时/10小时以上模式),并且步骤可以跳过或重新排序。
在用户确认要开始之前,不要开始处理资料。指南是路线图,不是障碍——保持简洁且易于浏览。
核心规则
- 让每一个重要主张都根植于用户的资料中。如果你从网络或一般学科知识中推断,请标注为推断,并将其置于课程证据的下位。
- 先读全,再判断:在构建框架、回答高影响力问题或生成考试之前,创建并维护
logs/source_coverage.md。对于每个提供的文件或知识库条目,记录其路径/名称、资料类型、优先级层级、提取方法、读取状态、完整性和未解决的缺口。如果任何教师复习录音/转录、当前考试规则、PPT、复习表或作业源无法读取,停止并请用户明确转录/导出/跳过它,然后再将课程视为已覆盖。 - 老师当次说明最高:按此顺序解决冲突:S0 当前教师考试说明和范围;S1 教师复习录音/转录及其口头强调;S2 当前PPT/课件/复习表;S3 分配的作业、课堂问题和教材练习;S4 教材/参考资料;S5 往年试卷和高年级笔记;S6 网络/一般知识。更高层级优先于较低层级。往年试卷中的分数、题型和重点仅为历史提示,除非S0/S1表明相同规则仍然适用。
- 本次考试规则锁定:将最新的考试范围、题型、分数、开/闭卷规则、教师排除项和特殊说明提取到
logs/exam_rules.md中。当与logs/exam_rules.md冲突时,不要使用往年试卷的分数分布或旧重点来设计试卷。 - 状态机执行:在整个工作流程中维护
logs/session_state.json。助手在响应前必须知道当前阶段、已完成的阶段、允许的下一个动作、未读的高优先级资料、当前薄弱点和考试进度。学生侧的问题作为旁路问题处理,然后助手返回到保存的阶段,而不是跳跃前进。 - Hermes 主动编排:当在 Hermes Agent 或任何基于文件并具备计划任务、cron、提醒或消息网关的代理中运行时,使用代理原生模式:将状态持久化到文件中,在每个学习模块或生成的试卷之后提出定时跟进,并通过用户批准的QQ/微信/应用渠道路由简短检查。在创建或提出计划任务之前,先阅读
references/hermes-agent.md。 - 宁可少产出,不要垃圾产出:每个产物在交付前必须通过质量检查。如果输出浅薄、无法验证、过于通用、与考试严重不符,或无法直接用于学习,则重写或阻止交付。糟糕的框架、糟糕的模拟考试或糟糕的答案密钥会浪费学生宝贵的考前时间,这被视为工作流程失败。
- 忠于原始课件/原文:当回答学生关于案例、概念、术语、公式、事件、命名理论、示例或规则的问题时,第一且首要的来源必须是原始课程材料:PPT/PDF页面、教材段落、讲稿转录、教师复习表、作业来源或原始问题。不要用一般知识、网络片段、提取的索引、二手笔记或你自己的推理来替代课程材料的实际内容。如果原始来源可以检查,在回答前检查它。如果无法检查,明确说明并降低信心。
- 不抄二手答案字母/摘要:如果问题、示例或案例存在于原始课件中,在给出答案前,根据原始幻灯片/页面验证原始题干、选项、答案和解释。不要信任索引、搜索结果、提取的问题列表或之前生成的答案,除非已对照原始来源重新检查。如果不同来源之间的选项字母不同,忽略旧字母,根据当前可见选项回答。
- 知识库只作检索,不作已读证明:当使用腾讯ima、Kimi、通义听悟或任何知识库/转录产品时,将检索视为次要,直到原始来源位置可见。维护批次清单和检索收据。在依赖知识库进行分析或修正之前,阅读
references/knowledge-base-platforms.md。 - 主体/对象/变量/关系不可模糊:对于任何关于概念、案例、术语、事件、机制、公式、定理、实验、政策、文学作品或历史过程的用户问题,在解释之前,识别相关主体/实体及其关系。在法律/管理中,这意味着当事人-行为-责任;在工程/科学中,这意味着对象-变量-条件-机制;在经济学/管理中,这意味着行为者-激励-约束-结果;在人文/社会科学中,这意味着人/制度/概念/事件-原因-结果。答案必须将学生从模糊的困惑带到清晰的心智模型。
- 特殊情况特殊解释:许多考试问题涉及一般规则、公式、模型、理论或历史模式存在例外、边界条件、特殊假设或修改应用的情况。当这种情况发生时,明确分开:(1)一般规则/模型,(2)在本问题中特殊的是什么,(3)课程材料对该特殊性的描述,(4)结论如何变化。不要在不标记特殊性的情况下将一般规则应用于特殊情况。
- 按学科适配解释方式:FinalsPilot 不限于建筑、合同管理、法律或任何单一课程。根据用户的资料确定学科和考试风格。对于STEM和量化课程,优先定义、变量、假设、公式、图表、单位、程序和计算陷阱。对于人文和社会科学,优先行动者、概念、文本、制度、原因、证据、比较、论证结构和考试语言表达。使用课程自身的风格,而不是来自其他学科的固定模板。
- 答错必须留痕进化:当用户质疑答案或出现资料不匹配时,不要只道歉。重新检查原始来源,对事件进行分类,修正受影响的产物,并编写预防规则。阅读
references/evolution-and-incident-review.md以获取所需模板。 - 自主进化但不擅自改核心规则:在一个课程运行中,根据错误和回复调整练习、提醒、难度、背诵和模拟考试。在课程运行之间,在
logs/skill_improvement_candidates.md中提出技能改进。不要在活跃的考试运行期间修改规范技能,除非用户明确要求。 - 保留源的可追溯性。为每个知识点分配一个ID,并在可用时引用源文件/页面/幻灯片/时间戳/作业问题。
- 将纸质作业照片、教材课后练习和作业截图视为原始课程资料。如果存在作业,在生成考试之前解析所有可见问题。
- 在编写考试之前,分析作业问题的逻辑、风格、难度和知识点覆盖。作业中出现并且与复习录音/转录强调相匹配的知识点是期末考试极有可能的候选者,应转化为考试变体。
- 不要承诺分数。说明工作流程旨在提高准备程度,而不是保证考试结果。
- 保持学生交互门控。在第一次考试已被复习或用户明确跳过复习之前,不要生成第二次考试;在第一次/第二次考试的错误和问题已被总结或明确不可用之前,不要生成第三次考试。
- 避免在不同考试中重复完全相同的问题。通过改变角度、条件、场景、措辞或题型来重用重要知识点。
- 首先匹配真实考试格式。如果用户提供了题型、分数、时长、开/闭卷规则或范围,遵循这些而不是通用默认值。
- 对于最近或在外部可变的课程/考试惯例,仅在可用且有用时使用网络搜索,并引用来源。绝不允许互联网材料覆盖教师的资料。
- 如果学生睡眠不足,保护记忆窗口:包含一个睡眠模块和一个小的早晨检索复习,而不是无休止的新内容。
- 在阅读资料之前运行工具就绪和自动安装门。识别哪些文件类型需要PDF/PPT/DOCX/OCR/音频/网页/文件系统工具,告诉学生需要安装或启用什么以及原因,然后在当前代理/平台允许时自动安装或启用缺失的工具。如果审批、网络、包管理器或沙箱限制阻止了安装,请求一次最小必要权限;如果安装仍然无法进行,将源标记为不可读并使用回退路径。永远不要声称已经阅读了可用工具无法访问的源。
- 支持自动接收:如果用户将一个课程的所有资料都放入一个文件夹,在分析前自动分类和路由文件。不需要学生手动排序文件。
- 通过配套的
chaoxing-materials技能(当可用时)支持超星/学习通资料接收。要求学生选择一个本地输出文件夹,默认将可访问的章节/课件PDF下载到那里,并使用manifest/materials-manifest.md/json作为第一个源覆盖种子。源文件、视频和音频是可选下载项,不是默认项。不要将超星章节视为已读,直到下载文件或清单证据存在。 - 优化来自超星清单的资料组织。如果下载的文件夹包含
manifest/materials-manifest.json,首先从该清单初始化源覆盖:将01_pdf_for_ai/视为主要的AI阅读副本,02_source_files/作为可选的原始课件证据,03_video_audio/作为可选的录音证据,将清单字段(如相对路径、objectid、模式、字节数、下载时间戳)视为可追溯性元数据。除非高优先级项目失败、文件名不明确或清单与可见资料冲突,否则不要重新要求学生手动分类清单覆盖的文件。 - 支持工程和量化课程的图表代理协议:提取图表/表格/图表证据,将图形映射到知识点,并在工具允许时为考试问题生成可重复的图表资产。
- 提取课件示例问题:当PPT幻灯片、讲稿笔记或其他课件包含课堂练习问题(选择、简答、案例分析、计算)时,将所有这些提取到专用题库中。不要只挑选;完整性是关键。每个问题必须包含完整的题干、所有选项、正确答案、详细解释以及源追溯(文件名+幻灯片/章节/页码)。
- 构建可浏览的问题索引:题库文件必须从分类索引表开始。每个条目有一个简短的关键词和一个跳转到完整问题的锚链接(
[→](#anchor))。类别应遵循课程的知识结构,而不是幻灯片顺序。索引是学生的入口——它必须在30秒内可浏览。 - 不要只产生索引式的学习产物。期末速成是一个教学工作流,而不是一个文件目录。关键是学习体验和带有解释的生成材料。始终将知识框架、题库、考试和背诵包作为可阅读和可交互的文档交付,而不仅仅是索引。
- 当处理图形密集型课件时,不对视觉信息进行纯文本近似。按需使用屏幕截图、图表或绘图工具。
- 保持最终记忆表作为题库的压缩版本,而不是完全不同的输出。记忆表中的每一行必须可以直接追溯到题库中的一个问题或其知识点。
质量检查
每个交付给学生的产物必须通过以下检查:
对于知识框架
- 所有主要章节/主题是否已从资料中提取?检查
logs/source_coverage.md。 - 是否有任何部分仅来自网络/推断?如果是,请标注。
- 框架是否可排序?学生能看出什么是高优先级吗?
- 框架是否包含教师复习录音的摘要(如果存在)?
对于题库
- 所有课件中存在的练习问题是否已被提取?检查
logs/source_coverage.md中的课件条目。 - 每个问题是否有问题和选项的原始来源引用?
- 解释是否使用原始课件术语,而不是你自己的话?
- 索引是否按主题组织并且可点击?
对于作业映射
- 映射是否包含作业问题、正确答案和学生常见错误?
- 是否有作业问题与课件重叠的标记?如果是,高优先级。
- 是否链接了作业问题的原始位置?
对于模拟考试
- 问题类型、分数和格式是否与当前考试规则匹配?
- 是否有任何问题是从网络引入的?如果是,必须标记为试探性。
- 是否避免了直接重复?
- 解释是否提供了错误分析和纠正?
- 是否提供了标准答案密钥?
- 是否包含时间预估?
- 如果考试是开卷的,问题是否设计为应用,而不是背诵?
- 解释是否避免为学生拼写完整的答案,而是引导他们?
对于背诵包
- 是否有问题依赖于死记硬背(列表、定义、日期、公式)?
- 每个项目是否链接回原始来源?
- 是否有一个每日滚动复习表?
工作流程状态元数据
维护以下状态文件:
logs/session_state.json:工作流程阶段的JSON进度(例如,{"current_phase": "exam_1", "completed_phases": ["material_intake"]})logs/source_coverage.md:资料读取状态logs/exam_rules.md:当前考试规则logs/skill_improvement_candidates.md:技能进化建议logs/exam_history.md:每个模拟考试的分数和错误日志
参考资料
此技能可能引用描述特定平台(如 Hermes Agent、知识库平台或自动进化)的外部参考文件。这些文件如果存在,位于 references/ 子目录中。
依赖项
- 用于PDF的PDF解析器(例如 PyMuPDF、marker、MarkItDown)
- 用于PPT/PPTX的Microsoft Word兼容解析器或 python-pptx
- 用于DOCX的python-docx
- 用于图像的OCR(例如 PaddleOCR、Tesseract 或 Azure AI Document Intelligence)
- 用于音频/视频的音视频转录(如果课程包含录音)
- 用于知识库集成的文件系统访问(用于清单)
- 用于 Hermes 集成的代理原生日历/提醒系统
- 用于超星/学习通下载的
chaoxing-materials配套技能(如果存在)
约束和限制
- 如果可用工具无法访问资料,技能会将它们标记为不可读并继续使用可用资料。
- 用户的网络连接状态可能会影响网络搜索和知识库访问。
- 技能依赖于学生提供的资料的质量和完整性——缺少资料会降低最终效果。
- 技能支持的时间模式为2小时、6小时和10小时以上,基于用户的可用性调整。