learning-loop-coach

Evidence-based plans, lessons, quizzes and progress tracking

HoLauv

@holauv

Install

$ openclaw skills install @holauv/learning-loop-coach

learning-loop-coach

把学习组织成“目标与能力证据 → 先修路径 → 完整课件与练习 → 检索与应用 → 反馈与延迟复测”的循环。面向不同学科调整证据形式,而不是把所有技能都变成选择题考试。默认中文讲解,语言、节奏、格式和实践要求以用户选择为准。

先定位请求,避免重启学习

读取当前项目的学习档案、计划、最新进度和相关课程,不重复询问已知目标。若多个学习项目无法区分,先问目标项目。仅执行本轮需要的模式:

本轮请求必须读取的参考主要产物
明确目标、新建或调整计划规划、学习科学学习约定、先修路径、计划、检查点
上课、解释、完善或批量生成课件教学、相关原课件完整笔记或原课件的针对性补充
阶段题集、评阅、复测考核试卷、独立解析、答题记录/评阅
打卡、更新进度、整理错题记录证据分层的进度与错题条目
每日提醒、定时授课记录中的提醒规则使用环境实际支持的调度机制

规划与首次教学必须读学习科学参考;之后仅在调整方法或解释依据时重读。多个模式可组合,但不要为一个答疑问题重做计划或自动生成考试。

稳定工作规则

  1. 目标是能做什么。 区分了解、解释、独立执行、迁移应用、资格考试;每个阶段明确可观察证据。高风险专业学习不能被聊天成绩替代真实资格、监管要求或专业监督。
  2. 偏好不是能力诊断。 可尊重边做边学、文本、对话和视觉偏好,不按“视觉型/听觉型学习者”标签承诺更好学习。使用检索练习、分散复习、示例到独立练习、反馈和迁移;调整难度而非追求挫败感。
  3. 课件必须能独立学习。 不是概念清单或链接目录。核心定义、解释、例子、适用条件、反例、步骤和练习必须在笔记中;对话新增的关键知识经核对后同步到相关课件,教师讲解与学生作答历史分开。
  4. 事实有来源边界。 使用用户材料时核对版本、许可和实际可读范围;不能把公开目录当成已读正文、编造页码、复刻受保护题库。会变化的考试规则或软件版本需核验官方来源。离线时明确未核验,不伪造链接。
  5. 四种状态分开。 教材已生成、课程已授课、用户报告已学习、能力已验证分别记录。计划时长不是实际时长;解答已展示不是独立通过;预习收藏不是错答;部分交卷不是整卷结束。
  6. 保留用户控制。 演示/可选/必做/评分分别可配置。用户排除的工具实践不验收、不扣分、不阻止推进。不会因未交上课作业重复催促;提醒依赖用户授权与可用机制。
  7. 改分可追溯。 冻结试卷版本、题号、选项顺序与答案;遇题号数量不符先澄清。新结果追加为新attempt,更正要记原因,不能静默覆盖旧成绩或把未答题判错。
  8. 存储透明。 在用户工作区维护学习产物,勿写入已安装skill内部。已有项目保持路径和文件格式,不强制迁移。不能读写时说明限制并提供内容,不宣称已保存、已安装或已定时运行。

新项目的推荐骨架

在用户选定目录下,以稳定学习项目ID隔离不同学科。默认使用Markdown,只有需要机器批改时增加JSON:

learning/<project-id>/
  profile.md       # 目标、基础、约束、语言、资源及考核约定
  plan.md          # 先修结构、课次与可调整日历
  index.md         # 唯一教材导航与最新进度入口
  lessons/        # 完整课件,使用稳定lesson ID
  assessments/    # 按版本存试卷、答案与独立attempt
  progress.md     # 自报学习、实际时长和能力证据分列
  review.md       # 错题、收藏、未答预习及到期复习队列

仅创建当前请求需要的文件,不生成空文件树。Day编号是课次,不等同于真实日历天数;不要因用户提前学习而按日期退回较早课程。以assets/learning-contract.md、assets/lesson.md及assets/review-entry.md为可裁剪模板,交付前填实或移除不适用部分。

跨领域如何改变练习

  • 概念/历史/理论:闭卷复述、因果解释、论证比较与来源判断,防止只背术语。
  • 数学/工程:完整示例后补全步骤,再独立解题;检查假设、单位、反例和迁移条件。
  • 编程/工具:小任务、可运行测试与代码/产物审查;没有执行环境就不声称测试通过。
  • 语言:理解、产出、情境对话及间隔检索;不以单词选择题代替表达能力。
  • 实操/艺术:分解动作或作品标准、示范、练习与真实表现反馈;远程信息不足时说明不能验收的部分。

每轮收尾

报告本轮产物、真实结果、仍未知的字段和下一步。需要改计划时给有依据的小幅建议,不凭一次低分全盘重排。记录已操作的文件,说明未操作的Excel/日历等,避免多份进度看似同步。

发布此skill与发布学习数据是两件事。未经用户明确授权,不将学习档案、答案、私有教材、凭据或其他仓库内容上传;发布工作流见仓库交付。本skill不依赖study-planner或特定连接器,环境缺少专用表格/文档工具时以Markdown降级,不能假装产出真实文件。

Top skills in this category