@yottameta/yotta-lesson 0.1.0 → 0.1.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # 更新日志
 
+## v0.1.1 (2026-10-01)
+
+- 文档修正：家族协同 / 边界 / 版权说明中元题的引用改为已发布实际口径（元题 = 按双向细目表从学校自备题库组卷 + 试卷结构校验，不生成题面，题面由题库提供）；同步更新中英 README 与 `references/copyright.md`。
+- 行为零变更：内核 / CLI / 退出码 / 门禁契约不变。
+- 新增文档契约回归：家族引用不得回退为「规划中 / (planned)」。
+
 ## v0.1.0 (2026-09-24)
 
 初始发布：

package/README.md

@@ -141,7 +141,7 @@ bash install.sh --dir <skills-dir>
 ## Works with
 
 - **yotta-mirror** — feed learning diagnostics back into the next lesson's focus;
-- **yotta-item** (planned) — fill the example and practice slots with item content;
+- **yotta-item** — assemble papers from a local item bank and run deterministic paper-structure checks (no item-text generation);
 - **yotta-present** — render the skeleton in a consistent, copyable layout;
 - **yotta-humanize** — natural-language polish for teacher-facing narratives;
 - **yotta-memory** — store map versions and skeleton summaries on request.

package/README.zh-CN.md

@@ -133,7 +133,7 @@ bash install.sh --dir <技能目录>
 ## 与家族技能协同
 
 - **元镜 yotta-mirror**：用学情数据反哺下一轮备课的薄弱点；
-- **元题 yotta-item**（规划中）：在骨架的例题与练习位补入题目内容；
+- **元题 yotta-item**：按双向细目表从学校自备题库组卷、并做试卷结构校验（不生成题面）；
 - **元呈 yotta-present**：把教案骨架渲染成统一格式；
 - **元真 yotta-humanize**：教师-facing 叙述文字去 AI 味；
 - **元忆 yotta-memory**：按需保存映射包版本与骨架摘要。

package/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: yotta-lesson
-version: 0.1.0
+version: 0.1.1
 description: 元案 —— 本地、确定性的教案骨架与覆盖校验技能：按版本化课标映射包（课题 / 知识点 / 重难点 / 易错点 / 课标来源）生成教案骨架，环节时间按课时精确分配（合计 = 课时 × 每课时分钟），学习目标逐条标注课标来源；`check` 子命令对已有教案文本做确定性缺口检查（未覆盖知识点、缺必填环节、缺课标来源、未标时间、合计时间不一致），输出带证据的 Markdown / JSON 清单，支持 `--gate findings=<n>` CI 闸门；零依赖 Python 3.8+，核心不联网、不调用模型、不含教材与题目原文。触发：用户要写教案 / 学案骨架、按课标核对教案结构、检查教案是否覆盖知识点与环节、把教案结构检查接入自动化流程时。边界：只生成结构性骨架与缺口清单，不生成题目内容、不生成学生评语、不替代教师的教学设计判断；不联网、不上传教案与校本映射；不内置教材版权原文，课标引用以官方文本为准。
 license: MIT
 ---
@@ -26,7 +26,7 @@ license: MIT
 
 **Do NOT trigger**：
 
-- 不生成题目与学案题目内容（属元题），不生成学生评语；
+- 不生成题目与学案题目内容（组卷属元题，题面由学校题库提供），不生成学生评语；
 - 不替代教师的教学设计判断：骨架与清单是备课辅助，最终设计由教师定稿；
 - 不联网、不调用模型、不上传教案与校本映射；
 - 不内置教材与课标原文，只记录结构性元数据；引用请以官方文本为准。
@@ -73,7 +73,7 @@ python3 scripts/yotta_lesson.py map list --map lesson-map.json
 ## 家族协同
 
 - **元镜 yotta-mirror**：用学情数据反哺下一轮备课的薄弱点；
-- **元题 yotta-item**（规划中）：在骨架的例题与练习位补入题目内容；
+- **元题 yotta-item**：按双向细目表从学校自备题库组卷、并做试卷结构校验（不生成题面）；
 - **元呈 yotta-present**：把教案骨架渲染成统一格式；
 - **元真 yotta-humanize**：教师-facing 叙述文字去 AI 味；
 - **元忆 yotta-memory**：按需保存映射包版本与教案骨架摘要。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yottameta/yotta-lesson",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "YuanAn (yotta-lesson) — a local, deterministic lesson-plan skeleton and coverage checker for AI agents: reads a curriculum map (lesson id, knowledge points, key points, difficulties, misconceptions, standard reference) plus an optional structure config, builds a lesson skeleton whose stage minutes always sum to periods x minutes-per-period and whose objectives each carry a curriculum-standard source, and checks an existing lesson text for missing knowledge points, missing required stages, missing citations, missing time annotations and total-time mismatches. Markdown and JSON output, configurable stages, and a CI gate are included. Triggers: drafting a lesson or study-plan skeleton, verifying a lesson against a curriculum map, checking that knowledge points and stages are covered, or wiring lesson-structure checks into automation. Boundaries: structural skeleton and gap list only — no exercise content, no student comments, no replacement for the teacher's instructional design; no network access, no model calls, no upload of lesson plans or school maps; no textbook, curriculum or exam text is bundled, and citations must be verified against official sources. Fully local, zero-dependency (Python 3.8+ standard library).",
   "license": "MIT",
   "keywords": [

package/references/copyright.md

@@ -28,7 +28,7 @@
 
 ## 五、与其他技能的分工
 
-- 题目内容生成 / 组卷：属元题（规划中）；
+- 组卷与试卷结构校验：属元题 yotta-item（从题库选题，不生成题面）；
 - 学情数据分析：属元镜 yotta-mirror；
 - 含个人信息的材料合规审查：属元规 yotta-compliance；
 - 对外呈现与去 AI 味：属元呈 / 元真。

package/scripts/yotta_lesson.py

@@ -18,7 +18,7 @@ import sys
 from datetime import datetime, timezone
 from pathlib import Path
 
-VERSION = "0.1.0"
+VERSION = "0.1.1"
 SCHEMA_VERSION = "1.0"
 TOOL_NAME = "yotta-lesson"