安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install yotta-lesson
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 yotta-lesson。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Yotta Lesson 是一个本地运行、结果确定的教案规划 CLI，可将学校的课程映射 JSON 转换为结构化教案框架。它会整理学习目标及其课程标准来源、重点和难点、常见误解、五个可配置的课程阶段、精确到分钟的时间安排、板书计划和评估清单。相同的映射和配置会生成相同的框架，因此它适合使用 Openclaw Skills 的教学团队进行一致的教案规划。
它的 check 命令会审核现有教案，并报告具体的覆盖缺口，包括缺失的知识点、必需阶段、来源或时间，以及总分钟数不匹配的问题。核心工作流程无需外部依赖、网络访问或模型调用。它存储的是结构性元数据，而非教材或题目文本；其输出用于辅助教师规划，而不是取代专业判断。

应用场景

根据学校维护的课程或单元映射包创建完整的教案框架。
使用相同的映射和结构配置，统一教研组内的教案结构。
审核现有教案，检查是否存在未覆盖的知识点、缺失的必需阶段、缺少的来源或未分配的时间。
检查各阶段时长相加后是否等于课程分钟数。
在批处理工作流或 CI 中运行可重复的教案检查，并设置可使任务失败的问题数量阈值。
处理敏感学校资料时，将课程映射和教案数据保存在本地。

工作原理

准备一个 JSON 课程映射包，其中包含课程标识符、标题、课时数、知识点、重点、难点、常见误解和必需的课程标准来源。
可选配置每课时分钟数、课程阶段及其比例、必需阶段，以及检查时使用的关键词。
对某节课运行 plan。Yotta Lesson 会生成可重复的框架，其中包含带来源的目标和精确到分钟的阶段时间分配；可选择 Markdown 或 JSON 输出。
对照映射审核现有教案并运行 check，以识别知识覆盖、阶段、来源或时间缺失，以及总分钟数不匹配的问题。
查看检查结果并根据需要修改教案。添加 --gate findings= 可设置阈值；当问题数量达到配置值时，将触发相应的非零退出码。

配置指南

使用此技能附带的 Python 3 脚本。文档所述工作流程不需要单独安装软件包或访问网络。首先生成映射和结构配置模板，然后根据课程内容编辑生成的文件。

生成课程映射和结构配置模板

python3 scripts/yotta_lesson.py template --output-dir ./lesson-template

为课程 L1 生成 Markdown 框架

python3 scripts/yotta_lesson.py plan --map lesson-map.json --lesson L1

以 JSON 格式生成双课时框架

python3 scripts/yotta_lesson.py plan --map lesson-map.json --lesson L1 --periods 2 --format json

检查教案，并在至少报告一项问题时使 CI 任务失败

python3 scripts/yotta_lesson.py check --plan plan.md --map lesson-map.json --lesson L1 --gate findings=1

验证映射包并列出其中的课程

python3 scripts/yotta_lesson.py map validate --map lesson-map.json
python3 scripts/yotta_lesson.py map list --map lesson-map.json
退出码：0 表示成功，1 表示触发了 --gate 阈值，2 表示输入无效，3 表示映射或配置错误，4 表示运行时错误。有关完整字段和报告规范，请参阅 references/map-format.md 和 references/plan-format.md。

数据架构

课程映射包： JSON，其中包含每节课的字段 id、title、periods、knowledge、key_points、difficulties、misconceptions 和 standard。standard 字段记录课程来源。
可选结构配置： minutes_per_period、stages 及其比例、required_stages 和 check_keywords。
输出和检查结果
输出或检查结果 用途
Markdown 教案 便于阅读的教案框架
JSON 教案（schema_version 1.0） 结构化输出，包含 objectives、stages、checklist、findings、sources 和 disclaimer
knowledge_missing 报告教案未覆盖的知识点
stage_missing 报告缺失的必需课程阶段
source_missing 报告没有来源引用的目标或内容
time_missing 报告未指定时间安排的阶段
minutes_mismatch 报告分配的分钟数与课程时长不匹配的情况
映射包存储结构性元数据，而非教材段落或原始题目内容。生成的教案和映射均在本地处理。其他格式和使用限制详见 references/copyright.md。

高级特性

确定性生成：除生成时间外，相同的映射和结构配置会生成相同的框架。
精确到分钟的阶段时间分配，并检查总时长是否等于课时数乘以每课时分钟数。
可配置课程阶段、必需阶段规则和教案检查关键词。
适用于 CI 自动化的 --gate findings= 阈值以及文档化的退出码。
提供独立的映射验证和课程列表操作。
提供 Markdown 和带版本号的 JSON 输出格式，便于人工审核和下游处理。
仅在本地处理：不会联网、调用模型，也不会上传映射和教案。
设计用途是辅助规划；它不会生成练习或学生评语，也不会取代教师的教学决策。

name: yotta-lesson slug: yotta-lesson version: 0.1.0 displayName: 教案设计·元案 summary: 本地、确定性的教案骨架与覆盖校验：课标映射包 → 教案骨架（学习目标带来源、环节时间精确到分钟），并对已有教案做缺口检查（知识点 / 环节 / 来源 / 时间）；零依赖，不联网、不内置教材原文。 description: 教案设计（元案）—— 把课标映射包变成可复算的教案骨架：学习目标逐条带课标来源、重难点与易错点、五环节 + 分钟级时间分配（合计恒等于课时 × 每课时分钟）、板书与评价清单；check 子命令对已有教案做确定性缺口检查（未覆盖知识点 / 缺必填环节 / 缺来源 / 未标时间 / 合计时间不一致），支持 --gate findings=n 接入 CI；零依赖本地运行，不联网、不调用模型、不内置教材与题目原文。 tags: [教案, 学案, 教学设计, 课标对标, 备课, 环节校验, 教学教研, education, lesson plan, 本地化] license: MIT homepage: https://github.com/YottaMeta/yotta-lesson 元案（yotta-lesson）

本地、确定性的教案骨架与覆盖校验技能。元案把「课标映射包」变成可复算的教案骨架， 并把「这节课的知识点、环节、来源、时间齐了吗」变成一份确定性缺口清单。

可信契约：

教案骨架来自映射包与结构配置，同一输入得到同一结果（仅生成时间不同）；
时间分配精确到分钟且合计可校验（课时 × 每课时分钟）；
每条学习目标都带课标来源；缺口清单给出具体原因与关键词；
核心路径不联网、不调用模型，教案与映射包只在本机流转。
何时使用
按学校自备的课标 / 单元映射，快速起一份结构完整的教案骨架；
用 check 核对已有教案：知识点是否都覆盖、必填环节是否齐全、是否标了来源与时间；
教研组统一教案结构（同一映射包 + 同一结构配置 = 同一套骨架口径）；
把教案结构检查接入批处理或 CI（--gate findings=）。

Do NOT trigger：

不生成题目与学案题目内容（属元题），不生成学生评语；
不替代教师的教学设计判断：骨架与清单是备课辅助，最终设计由教师定稿；
不联网、不调用模型、不上传教案与校本映射；
不内置教材与课标原文，只记录结构性元数据；引用请以官方文本为准。
快速使用

# 生成映射包与结构配置模板
python3 scripts/yotta_lesson.py template --output-dir ./lesson-template

# 生成教案骨架（Markdown）
python3 scripts/yotta_lesson.py plan --map lesson-map.json --lesson L1

# 两课时版本 + JSON 输出
python3 scripts/yotta_lesson.py plan --map lesson-map.json --lesson L1 --periods 2 --format json

# 检查已有教案的覆盖缺口，并在缺口 ≥ 1 时让 CI 失败
python3 scripts/yotta_lesson.py check --plan plan.md --map lesson-map.json --lesson L1 --gate findings=1

# 映射包操作
python3 scripts/yotta_lesson.py map validate --map lesson-map.json
python3 scripts/yotta_lesson.py map list --map lesson-map.json

退出码：0 正常 ｜ 1 触发 --gate ｜ 2 输入错误 ｜ 3 映射或配置错误 ｜ 4 运行时错误。

输入与输出
课标映射包：JSON，逐课题声明 id / title / periods / knowledge / key_points / difficulties / misconceptions / standard（课标来源，必填）；
结构配置（可选）：minutes_per_period、stages（环节与比例）、required_stages、check_keywords；
输出：教案骨架 Markdown + JSON（schema_version 1.0，含 objectives / stages / checklist / findings / sources / disclaimer）；
缺口检查：knowledge_missing / stage_missing / source_missing / time_missing / minutes_mismatch。

字段规范见 references/map-format.md；报告契约见 references/plan-format.md。

版权与边界
映射包只存结构性元数据（课题 / 知识点 / 课标条目标识），不存教材正文与题目原文；
课标引用以官方文本为准，本技能不做课标解读；
输出为备课辅助，不用于教学评价结论。

详见 references/copyright.md。

家族协同
元镜 yotta-mirror：用学情数据反哺下一轮备课的薄弱点；
元题 yotta-item（规划中）：在骨架的例题与练习位补入题目内容；
元呈 yotta-present：把教案骨架渲染成统一格式；
元真 yotta-humanize：教师-facing 叙述文字去 AI 味；
元忆 yotta-memory：按需保存映射包版本与教案骨架摘要。
渐进披露
映射包与结构配置：references/map-format.md
骨架 / 检查报告契约与退出码：references/plan-format.md
版权与使用边界：references/copyright.md

按需读取，不必每次全读。

AUTO.Prompt
Yotta Mirror 学习分析