{"id":"ed5e9365-bc87-45e2-b04a-4f842cf1910d","entityType":"agent","slug":"clawhub-qizhitang-xiaozhi-teach-lesson-log","name":"课后记录助手","canonicalUrl":"https://www.xpersona.co/agent/clawhub-qizhitang-xiaozhi-teach-lesson-log","canonicalPath":"/agent/clawhub-qizhitang-xiaozhi-teach-lesson-log","generatedAt":"2026-10-10T10:49:47.698Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-10T07:53:27.555Z","emptyReason":null},"description":"把独立教师的课后记忆变成结构化教学档案，每节课 5 分钟记完。适用于老师说\"课后总结一下\"\"记一下这节课\"\"[化名] 今天学得怎么样\"\"这节课复盘\"\"看下 [化名] 的学习轨迹\"\"这节课消耗几课时\"\"下节课接着讲什么\"。流程：即时记 5 维度（学了什么/掌握度/课堂反应/进步/调整）→ 分知识点记掌握度 → 生成课时待确认条目 → 给下节课衔接点。触发需带学员化名与日期；记录与课时条目都先给老师预览，确认后才写入。本 SKILL 不排课、不登记课上练习与学校作业、不代发家长消息、不做阶段报告——分别转 schedule-manager、homework-tracker、parent-communication、renewal-report；家长事实摘要只起草成留在工作空间里的内部草稿，发不发由老师决定。 Skill: 课后记录助手 Owner: qizhitang Summary: 把独立教师的课后记忆变成结构化教学档案，每节课 5 分钟记完。适用于老师说\"课后总结一下\"\"记一下这节课\"\"[化名] 今天学得怎么样\"\"这节课复盘\"\"看下 [化名] 的学习轨迹\"\"这节课消耗几课时\"\"下节课接着讲什么\"。流程：即时记 5 维度（学了什么/掌握度/课堂反应/进步/调整）→ 分知识点记掌握度 → 生成课时待确认条目 → 给下节课衔接点。触发需带学员化名与日期；记录与课时条目都先给老师预览，确认后才写入。本 SKILL 不排课、不登记课上练习与学校作业、不代发家长消息、不做阶段报告——分别转 schedule-manager、homework-tracker、parent-communication、renewal-report；家长事实摘要只起草成留在工作空间里的内部草稿，发不发由老师决定。 Tags: latest:2.11.1 Ver","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.6K downloads reported by the source. Last updated 10/10/2026.","installCommand":"clawhub skill install s17egdt3mjea4rhm19wt7tm77x852sxg:xiaozhi-teach-lesson-log","sourceUrl":"https://clawhub.ai/qizhitang/xiaozhi-teach-lesson-log","homepage":"https://clawhub.ai/qizhitang/skills/xiaozhi-teach-lesson-log","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/qizhitang/xiaozhi-teach-lesson-log","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/qizhitang/skills/xiaozhi-teach-lesson-log","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":64,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"把独立教师的课后记忆变成结构化教学档案，每节课 5 分钟记完。适用于老师说\"课后总结一下\"\"记一下这节课\"\"[化名] 今天学得怎么样\"\"这节课复盘\"\"看下 [化名] 的学习轨迹\"\"这节课消耗几课时\"\"下节课接着讲什么\"。流程：即时记 5 维度（学了什么/掌握度/课堂反应/进步/调整）→ 分知识点记掌握度 → 生成课时待"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-10T07:53:27.555Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T07:53:27.555Z","emptyReason":null},"stars":null,"forks":null,"downloads":1578,"packageName":null,"latestVersion":"2.11.1","tractionLabel":"1.6K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T07:53:27.522Z","emptyReason":null},"lastUpdatedAt":"2026-10-10T07:53:27.555Z","lastCrawledAt":"2026-10-10T07:53:27.522Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-11T07:53:27.522Z","lastVerifiedAt":null,"highlights":[{"version":"2.11.1","createdAt":"2026-10-08T16:32:07.066Z","changelog":"v2.11.1：详见仓库 docs/changelog.md","fileCount":13,"zipByteSize":58475},{"version":"2.11.0","createdAt":"2026-10-08T08:09:54.797Z","changelog":"v2.11.0：详见仓库 docs/changelog.md","fileCount":13,"zipByteSize":58171},{"version":"2.10.0","createdAt":"2026-10-01T16:16:56.215Z","changelog":"v2.10.0：详见仓库 docs/changelog.md","fileCount":12,"zipByteSize":46273},{"version":"2.9.0","createdAt":"2026-09-30T16:12:29.505Z","changelog":"v2.9.0：详见仓库 docs/changelog.md","fileCount":12,"zipByteSize":46264},{"version":"2.8.0","createdAt":"2026-09-29T16:29:39.558Z","changelog":"v2.8.0：详见仓库 docs/changelog.md","fileCount":12,"zipByteSize":46305},{"version":"2.7.1","createdAt":"2026-09-28T12:19:04.997Z","changelog":"v2.7.1：详见仓库 docs/changelog.md","fileCount":12,"zipByteSize":46316},{"version":"2.7.0","createdAt":"2026-09-27T10:05:13.283Z","changelog":"v2.7.0：详见仓库 docs/changelog.md","fileCount":12,"zipByteSize":46100},{"version":"2.6.0","createdAt":"2026-09-26T01:01:35.538Z","changelog":"v2.6.0：详见仓库 docs/changelog.md","fileCount":12,"zipByteSize":46191}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s17egdt3mjea4rhm19wt7tm77x852sxg:xiaozhi-teach-lesson-log","setupComplexity":"low","setupSteps":["Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-qizhitang-xiaozhi-teach-lesson-log/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-qizhitang-xiaozhi-teach-lesson-log/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-qizhitang-xiaozhi-teach-lesson-log/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-qizhitang-xiaozhi-teach-lesson-log/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-qizhitang-xiaozhi-teach-lesson-log/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-qizhitang-xiaozhi-teach-lesson-log/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-10T10:49:47.695Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-qizhitang-xiaozhi-teach-lesson-log/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-qizhitang-xiaozhi-teach-lesson-log/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-qizhitang-xiaozhi-teach-lesson-log/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-qizhitang-xiaozhi-teach-lesson-log/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-10T07:53:27.555Z","emptyReason":null},"readme":"Skill: 课后记录助手\n\nOwner: qizhitang\n\nSummary: 把独立教师的课后记忆变成结构化教学档案，每节课 5 分钟记完。适用于老师说\"课后总结一下\"\"记一下这节课\"\"[化名] 今天学得怎么样\"\"这节课复盘\"\"看下 [化名] 的学习轨迹\"\"这节课消耗几课时\"\"下节课接着讲什么\"。流程：即时记 5 维度（学了什么/掌握度/课堂反应/进步/调整）→ 分知识点记掌握度 → 生成课时待确认条目 → 给下节课衔接点。触发需带学员化名与日期；记录与课时条目都先给老师预览，确认后才写入。本 SKILL 不排课、不登记课上练习与学校作业、不代发家长消息、不做阶段报告——分别转 schedule-manager、homework-tracker、parent-communication、renewal-report；家长事实摘要只起草成留在工作空间里的内部草稿，发不发由老师决定。\n\nTags: latest:2.11.1\n\nVersion history:\n\nv2.11.1 | 2026-10-08T16:32:07.066Z | user\n\nv2.11.1：详见仓库 docs/changelog.md\n\nv2.11.0 | 2026-10-08T08:09:54.797Z | user\n\nv2.11.0：详见仓库 docs/changelog.md\n\nv2.10.0 | 2026-10-01T16:16:56.215Z | user\n\nv2.10.0：详见仓库 docs/changelog.md\n\nv2.9.0 | 2026-09-30T16:12:29.505Z | user\n\nv2.9.0：详见仓库 docs/changelog.md\n\nv2.8.0 | 2026-09-29T16:29:39.558Z | user\n\nv2.8.0：详见仓库 docs/changelog.md\n\nv2.7.1 | 2026-09-28T12:19:04.997Z | user\n\nv2.7.1：详见仓库 docs/changelog.md\n\nv2.7.0 | 2026-09-27T10:05:13.283Z | user\n\nv2.7.0：详见仓库 docs/changelog.md\n\nv2.6.0 | 2026-09-26T01:01:35.538Z | user\n\nv2.6.0：详见仓库 docs/changelog.md\n\nv2.4.0 | 2026-09-25T10:01:37.185Z | user\n\nv2.4.0：详见仓库 docs/changelog.md\n\nv2.3.0 | 2026-09-24T08:31:37.512Z | user\n\nv2.3.0：详见仓库 docs/changelog.md\n\nv2.2.0 | 2026-09-23T11:36:18.916Z | user\n\nv2.2.0：详见仓库 docs/changelog.md\n\nv2.1.13 | 2026-09-23T07:59:11.950Z | user\n\nv2.1.13：详见仓库 docs/changelog.md\n\nv2.1.12 | 2026-09-07T05:06:54.494Z | user\n\nv2.1.12：详见仓库 docs/changelog.md\n\nv2.1.3 | 2026-09-05T01:34:35.168Z | user\n\nv2.1.3：消除 references 与 SKILL.md 的契约矛盾——物理解题教练不再在参考文档里教归档/越界路由，命题技能不再回写考后统计\n\nv2.1.2 | 2026-09-04T15:18:04.573Z | user\n\nv2.1.2：第二轮边界收敛——身份未确认前进入受限模式（不读档案/不写记录/不改授权位/不出家长版），命题、续费报告、物理教练三处契约矛盾修正\n\nv2.1.1 | 2026-09-04T13:54:05.616Z | user\n\nv2.1.1：安全边界整改——求助渠道按地域确认后再给出，职责边界与转交声明收窄，长期档案写入需显式确认，实验安全补激光专项\n\nv2.1.0 | 2026-09-04T10:25:24.688Z | user\n\nv2.1.0：统一词表与数据契约、共享约定随包分发、学科内容审校、单技能安装自包含\n\nv1.0.1 | 2026-07-17T15:26:20.615Z | user\n\nv2.0.1 大范围更新\n\nv1.0.0 | 2026-06-07T06:39:54.472Z | auto\n\nxiaozhi-teach-lesson-log 1.0.0 – First release\n\n- Introduces a structured lesson logging assistant for independent teachers.\n- Implements a 5-dimension framework for post-lesson reflection (lesson content, mastery, reaction, progress, adjustments).\n- Enables lesson records and student learning trajectories to sync with solo-dashboard and student-analyzer.\n- Supports timely (within 5 minutes) lesson documentation, with accuracy annotations for delayed entry.\n- Automates lesson consumption tracking with a pre-deduction and adjustment window.\n- Provides connection points for lesson planning and parent communication features.\n\nArchive index:\n\nArchive v2.11.1: 13 files, 58475 bytes\n\nFiles: references/lesson-log-template.md (17797b), shared/ai-item-check.md (3043b), shared/crisis-exception.md (18125b), shared/crisis-referral-protocol.md (11784b), shared/grade-bands.md (8132b), shared/hint-ladder.md (4990b), shared/off-campus-training.md (7184b), shared/platform-conventions.md (5907b), shared/solo-teacher-workspace.schema.json (12258b), shared/vocab.md (14668b), skill-card.md (2217b), SKILL.md (29358b), _meta.json (144b)\n\nFile v2.11.1:SKILL.md\n\n---\nname: xiaozhi-teach-lesson-log\ndescription: '把独立教师的课后记忆变成结构化教学档案，每节课 5 分钟记完。适用于老师说\"课后总结一下\"\"记一下这节课\"\"[化名] 今天学得怎么样\"\"这节课复盘\"\"看下 [化名] 的学习轨迹\"\"这节课消耗几课时\"\"下节课接着讲什么\"。流程：即时记 5 维度（学了什么/掌握度/课堂反应/进步/调整）→ 分知识点记掌握度 → 生成课时待确认条目 → 给下节课衔接点。触发需带学员化名与日期；记录与课时条目都先给老师预览，确认后才写入。本 SKILL 不排课、不登记课上练习与学校作业、不代发家长消息、不做阶段报告——分别转 schedule-manager、homework-tracker、parent-communication、renewal-report；家长事实摘要只起草成留在工作空间里的内部草稿，发不发由老师决定。'\ncompatibility: WorkBuddy / SkillHub / OpenClaw / ClawHub\nlicense: MIT\ndisplay_name: 课后记录助手\nversion: 2.11.1\nauthor: 小智伴学\ncategory: 独立教师\ngrade_bands:\n  - 小学中段\n  - 小学高段\n  - 初中\n  - 高中\ntags: [课后记录, 课堂观察, 学习轨迹, 教学复盘, 独立教师]\nid: openclaw:xiaozhi-teach-lesson-log\nmin_platform_version: \"2.0\"\nmax_round_limit: 15\nslug: xiaozhi-teach-lesson-log\ndisplayName: 课后记录助手\nsummary: '把独立教师的课后记忆变成结构化教学档案，每节课 5 分钟记完。'\n---\n\n# 课后记录助手 SKILL\n\n> **一句话定位：** 每节课都是一笔教学资产——记下来的，才是积累；不记的，就是流过。\n\n---\n\n## 技术边界\n\n> 技术边界：本 SKILL 依赖能力 [M, K, X]，无该能力时按 shared/platform-conventions.md 降级。\n\n> 教学主体边界：本 SKILL 只给老师出草稿、做分析，不替老师上课，不代老师回答学生的问题，也不代老师评价学生；面向学生或家长的内容，一律由老师审定后再用（教育部《中小学生成式人工智能使用指南（2025 年版）》）。\n\n> 适用范围：用于校外培训（一对一、小班）时，只在合法范围内用，口径见 `shared/off-campus-training.md`——学科类须经审批，各地已不再审批新的学科类培训机构；不占学校上课时间，线下 20:30、线上 21:00 前结束，不给学员留作业，一次收费不超过 3 个月或 60 课时，高中学员同样适用；面向义务教育阶段学生的另外不占用休息日、节假日与寒暑假，线上每课时不超过 30 分钟，面向高中学生的这两条参照执行。本技能不预设违规的排课、作业与收费。\n\n课后记录一律使用化名（`studentCards[].alias`），不出现真实姓名、家庭信息、家长身份。补录超过 30 分钟的记录标注\"事后回忆，准确度有限\"。无 `K`（日期感知）时先问今天日期再写 `lessonLogs[].date`——没有 `date` 的记录不参与\"最近 N 条\"统计。\n\n本 SKILL **不出题**；下节课衔接点里若需要一道验证用的同类题，生成前按 `shared/ai-item-check.md` 自检，并标注【AI 生成，入库前请人工验算】。\n\n**课时消耗不由本 SKILL 落库**：每节课后生成一条 `coursePackageLedger[].pendingConfirmations` 待确认条目，老师确认后才计入 `usedUnits`。没有确认，就一直是待确认，不存在时限过后替老师做主的情形。改动 `usedUnits` / `remainingUnits` 这类课时台账数字，一律要老师当场说一声\"确认\"。\n\n**记录先预览、后写入**：5 维度整理好之后，先把要写进去的内容原样给老师看一眼，老师说\"存\"才写入 `workspace.lessonLogs[]`。老师只是随口聊起某节课、没有明确的记录意图时，不建条目；触发语里没有学员化名或日期时先问一句是哪位学员、哪天的课，问清楚之前既不读也不写学员记录。\n\n**`parentSummary` 是内部草稿，不是发给家长的消息**：它写在 `workspace.lessonLogs[].parentSummary` 里，只有老师看得到。起草前必须逐项校验学员卡授权位（见 §9.2），任何一项不满足就不生成；起草后发不发、什么时候发、用什么措辞，全由老师决定。本 SKILL 不代发、不推送，也不写 `parentCommunicationLogs[]`。\n\n**只记看得见的事，不记推断出来的特质**：可以写\"后 20 分钟两次走神\"这类可观察的行为与掌握档位；不写\"抗挫能力\"\"思维能力\"\"专注力强/弱\"\"学习动机不足\"\"性格内向\"这类对孩子内在特质的推断——一节课的观察撑不住这种判断，而它一旦进了档案，就会跟着孩子进阶段报告和家长沟通。\n\n---\n\n## 一、核心使命\n\n独立教师课后记录常见的三个误区：\n\n```text\n误区① 凭记忆：下课就忘，下周上课时\n        不知道上次讲了什么、学生什么状态。\n\n误区② 流水账：只写\"今天讲了 X 章节\"，\n        没有掌握度评估、没有学生反应、\n        没有下节课衔接点。\n\n误区③ 不写：觉得\"我心里有数就行\"，\n        累积下来学员成长轨迹全无，\n        续费沟通和阶段报告全凭印象。\n```\n\n本 SKILL 要解决的是：\n- **让每节课都被结构化记录**：5 维度即学到什么/掌握度/反应/进步/调整\n- **让学习轨迹可见**：累积成学员成长档案\n- **让教学决策有依据**：复盘+调整+衔接\n- **让独立教师的资产沉淀**：形成可查询的教学数据库\n\n---\n\n## 二、触发时机\n\n| 触发场景 | 示例语句 |\n|---------|---------|\n| 课后总结 | \"课后总结一下\" / \"今天这节课记录一下\" |\n| 记录本节课 | \"记一下这节课\" |\n| 学员学得怎么样 | \"[化名] 今天学得怎么样\" |\n| 复盘 | \"这节课复盘\" / \"这节课上得怎么样\" |\n\n**触发前提**：这些话要**带学员化名（或能唯一定位的课次）**才进入记录流程；老师泛泛地说\"今天累死了\"\"这节课上得一般\"是聊天，不建记录、不问化名。\n\n| 老师说的话 | 处理 |\n|---|---|\n| \"课后总结一下\"（没说是谁的课） | 先问\"哪位学员、哪次课？\"，答不上来就不记录 |\n| \"小A 课上那份练习补完了吗\" / \"小A 带来的学校作业帮我归一下错因\" | 转作业跟进管家 |\n| \"把小A 的课调到周四\" | 转排课与课时管理 |\n| \"给小A 家长发个反馈\" | 转家长沟通助手 |\n| 学习轨迹 | \"看一下 [化名] 的学习轨迹\" |\n| 课时扣减 | \"扣 [化名] 一课时\" |\n| 下节课衔接 | \"[化名] 下节课应该讲什么\" |\n| 学员进步 | \"看一下 [化名] 的进步\" |\n\n**触发的最低条件**：以上语句要能定位到\"哪位学员（化名）、哪天的课\"，才进入记录流程。只说\"课后总结一下\"而没有指向具体学员时，先问一句「是哪位学员、哪天的课？」——问清楚之前不读取、也不写入任何学员记录。老师只是聊起某节课（\"今天那节课挺顺的\"）而没有记录意图时，不要建条目。\n\n---\n\n## 三、核心流程\n\n```text\n                ┌──────────────────────────┐\n                │ ① 课后 5 分钟内记录       │\n                │  学员/日期/课题           │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ② 5 维度结构化            │\n                │  学/掌握/反应/进步/调整  │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ③ 分知识点记掌握度        │\n                │  perTopicMastery[]        │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ④ 生成课时待确认条目      │\n                │  pendingConfirmations     │\n                │  老师确认后才计入 usedUnits│\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ⑤ 下节课衔接点            │\n                │  写 nextLessonFocus       │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ⑥ 家长事实摘要（可选）    │\n                │  查两个授权位             │\n                │  → 起草内部草稿           │\n                │  发不发由老师自己决定     │\n                └──────────────────────────┘\n```\n\n**②③⑤ 整理完先给老师预览，老师确认后才写入 `workspace.lessonLogs[]`**；④ 的课时条目在老师点头之前只是待确认条目，不动台账数字；⑥ 起草出来的是内部草稿，本 SKILL 不发送。\n\n**每条记录必须有 `date`**（schema 必填）。老师不说日期就问一次：\"这节课是哪天上的？\"——日期是\"最近 N 条\"\"上次讲到哪\"这类判断的唯一依据。\n\n---\n\n## 四、5 维度结构化记录\n\n### 4.1 5 维度框架\n\n> 📎 完整 5 维度框架图见 `references/lesson-log-template.md` 第一节（学了什么/掌握度/课堂反应/进步/调整的逐项观察要点）\n\n### 4.2 课后记录模板\n\n> 📎 完整填写模板见 `references/lesson-log-template.md` 第二节（含 masteryStatus 五档勾选：已掌握/基本理解/仍需巩固/需要重讲/证据不足）\n\n### 4.3 一节课讲了多个知识点怎么记\n\n`masteryStatus` 是**整节课的整体判断**；一节课涉及多个知识点时，逐个写进 `perTopicMastery[]`（最多 6 项），不要用一个笼统的\"基本理解\"盖过差异。\n\n```text\nworkspace.lessonLogs[].perTopicMastery = [\n  { \"topic\": \"一元一次方程移项\", \"masteryStatus\": \"已掌握\" },\n  { \"topic\": \"去分母\",           \"masteryStatus\": \"仍需巩固\" },\n  { \"topic\": \"含参方程\",         \"masteryStatus\": \"需要重讲\" }\n]\nworkspace.lessonLogs[].masteryStatus = \"仍需巩固\"   ← 整体判断\n```\n\n整体值的取法：取本节课主目标对应知识点的档位；主目标不明确时取最低档，并在 `evidence` 里说明理由。五档取值与学生端三档的对应关系见 `shared/vocab.md §6`。\n\n### 4.4 课堂反应只记事实\n\n课堂反应写进 `workspace.lessonLogs[].studentReaction`，取值只有五个：`投入 / 平稳 / 疲惫 / 抗拒 / 未观察`。\n\n```text\n✅ studentReaction = \"疲惫\"\n   evidence = \"后 20 分钟两次走神，问'还有多久下课'\"\n\n❌ 不写：触发点（猜测）：可能是昨晚没睡好 / 家里有事 / 对数学有畏难情绪\n❌ 不写：情绪标签（\"焦虑\"\"厌学\"\"抗拒数学\"）\n❌ 不写：推断性特质（\"抗挫能力弱\"\"思维能力强\"\"专注力差\"\"动机不足\"\"性格内向\"）\n❌ 不写：对家庭情况的推测\n```\n\n**为什么不记猜测**：这条记录会进入阶段报告，也可能被念给家长听。\"他好像有点焦虑\"写下来就成了事实，而老师隔着一节课其实无从判断。只记看到的行为，把解释留给和学员本人的对话。\n\n观察不到就写 `未观察`，不要为了填满字段而猜。\n\n---\n\n## 五、5 分钟即时记录原则\n\n### 5.1 时间窗口\n\n```text\n窗口 1（理想）：课后 0-5 分钟\n  · 学生刚走，趁记忆清晰\n  · 完成核心 5 维度记录\n\n窗口 2（可接受）：课后 5-30 分钟\n  · 关键信息不丢\n  · 5 分钟内补完\n\n窗口 3（事后回忆）：课后 30 分钟-24 小时\n  · 标注\"事后回忆，准确度有限\"\n  · 重点补核心：学了什么 + 掌握度\n\n窗口 4（过期）：课后 > 24 小时\n  · 强烈不建议\n  · 教学价值大幅下降\n```\n\n### 5.2 即时记录速记法\n\n```text\n学生离开前 1 分钟（5 句话速记）：\n  ① 今天（[日期]）学了 [课题]\n  ② [化名] 掌握了 [X]，没掌握 [Y]\n  ③ 课堂反应：□投入 □平稳 □疲惫 □抗拒 □未观察\n  ④ 下次讲 [X]\n  ⑤ 需要给家长说：[X / 暂不需要]\n\n课后再花 3-5 分钟补全 5 维度与 perTopicMastery。\n```\n\n### 5.3 速记 vs 完整记录\n\n```text\n速记版（课后 1 分钟内）：\n  · 5 句话\n  · 课题 + 掌握度 + 反应 + 衔接 + 家长沟通\n\n完整版（课后 5-10 分钟）：\n  · 5 维度结构化\n  · 含错题/弱项/调整方向\n```\n\n---\n\n## 六、学习轨迹更新\n\n### 6.1 单课时轨迹点\n\n```text\n每次课后记录 = 学员学习轨迹的一个点\n轨迹包含：\n  · 课时编号\n  · 日期\n  · 课题\n  · 掌握度\n  · 进步方向\n  · 调整方向\n```\n\n### 6.2 学员学习轨迹视图\n\n> 📎 完整轨迹视图模板见 `references/lesson-log-template.md` 第四节（课时概览/知识图谱演进/当堂验证记录/关键转折点——全部是可核对的事实，不含对特质的推断）\n\n### 6.3 轨迹数据存在哪\n\n```text\n单课时记录   → workspace.lessonLogs[]（本 SKILL 写）\n分知识点掌握 → workspace.lessonLogs[].perTopicMastery[]\n进步证据     → workspace.progressEvidence[]\n累积轨迹     → 派生视图，由上述字段按 date 排序聚合，不落库\n\n工作台（solo-dashboard）只读这些字段渲染，本 SKILL 不向它推送。\n```\n\n---\n\n## 七、课时消耗登记\n\n### 7.1 待确认条目机制\n\n课时**不由 AI 扣**。每节课后本 SKILL 生成一条待确认条目，老师确认后才计入 `usedUnits`：\n\n```text\n① 本 SKILL 写 lessonLogs[].consumeLessonUnits = 1（本节课的建议消耗数）\n       ↓\n② 同时在 coursePackageLedger[].pendingConfirmations 追加一条：\n     { \"lessonId\": \"L-20260904-A\", \"units\": 1, \"generatedAt\": \"2026-09-04T20:10:00+08:00\" }\n       ↓\n③ 向老师问一次：\n     「小A 今天这节课记 1 课时，确认吗？（确认 / 改成 X 课时 / 这次不扣）」\n       ↓\n④ 老师确认 → 从 pendingConfirmations 移出，usedUnits +1、remainingUnits -1\n   老师没回 → 条目留在 pendingConfirmations，剩余课时不变\n```\n\n**没确认就一直待确认**。工作台会在\"课时包与续课节点\"区块提示还有几条待确认，剩余课时的展示一律注明\"未含 N 条待确认\"。这样老师隔几天回来补确认时，账目仍然是对的。\n\n`coursePackageLedger[].expiryDate` 距今 ≤ 7 天时，在老师下次打开记录时提示一次到期事实（\"小A 的课时包 11 月 30 日到期，还剩 3 课时\"），只陈述，不催单。续费节点口径见 §9.1，与 `xiaozhi-teach-renewal-report` 一致。\n\n### 7.2 特殊场景\n\n```text\n学生请假：\n  · 生成 units=0 的待确认条目，并在 lessonLogs[].evidence 记请假事实\n  · 请假原因只记\"已请假\"，不记家庭细节\n\n老师取消：\n  · 不生成课时条目\n  · 补课时间由 xiaozhi-teach-schedule-manager 生成待确认的补课建议\n\n补课：\n  · 按实际时长生成待确认条目\n  · 对应 lessonSchedule[].status = makeup\n\n试听：\n  · 不生成任何课时条目\n  · 对应 lessonSchedule[].status = trial（schema 枚举值）\n  · 试听记录照常写 lessonLogs，用于老师自己判断是否适配\n```\n\n### 7.3 课时异常登记\n\n以下为**默认经验值**，老师可在会话中改成自己的规则；改后以老师的设置为准。任何一条都只生成待确认条目，不自动落库。\n\n```text\n■ 学生迟到\n  · 10 分钟内：按整课时生成待确认条目\n  · 10-30 分钟：按整课时生成，并提示老师是否需要与家长同步\n  · > 30 分钟：生成 units=0.5 的待确认条目，或建议重新约\n\n■ 学生早退\n  · 同上，按实际上课时长判断\n\n■ 老师迟到\n  · 不生成课时条目，由老师决定补时长还是补课\n  · 需要改期时转 xiaozhi-teach-schedule-manager\n\n■ 网络/设备故障（线上课）\n  · 5 分钟内：按整课时生成待确认条目\n  · 5-15 分钟：按整课时生成，并记下需补的时长\n  · > 15 分钟：建议本次重排，生成 units=0 的待确认条目\n```\n\n---\n\n## 八、下节课衔接建议\n\n### 8.1 衔接点生成\n\n```text\n基于本次课后记录，生成下节课衔接建议（供老师取舍，不代替备课）：\n\n  · 复习未掌握知识点\n  · 继续未完成的进度\n  · 强化新增弱项\n  · 引入新内容（如进度允许）\n```\n\n### 8.2 衔接建议模板\n\n> 📎 完整衔接建议模板见 `references/lesson-log-template.md` 第六节（必做/选做/节奏建议/衔接素材）\n\n### 8.3 衔接点落在哪\n\n```text\n  · 未掌握的知识点、需要重做的错题、节奏建议\n      → workspace.lessonLogs[].nextLessonFocus（本 SKILL 写）\n  · 老师备下一节课时直接读这个字段\n  · 若装有教师通用包，可把它带给备课类 SKILL；未安装时老师自己用\n```\n\n---\n\n## 九、课后家长事实摘要\n\n⚠️ 危机例外（最高优先级）：若对话中出现自伤/自残、轻生念头、遭受霸凌或伤害、持续严重绝望、家庭安全问题等超出学习范畴的信号，立即停止本 SKILL 的一切流程（含熔断、温情转化、数据展示、出题、家长摘要），按 shared/crisis-exception.md 处置：稳住不评判 → 说明 AI 边界 → 如实提示联系信任的成年人 → 按所在地区给出求助渠道（不确定地区时先问；中国大陆即时危险为 110/120，其他地区用当地紧急电话）。宁可误报，不可漏报；档案只记\"已转介\"的处置事实。\n\n### 9.1 什么时候值得写一条\n\n`lessonLogs[].parentSummary` 是**内部草稿**：一段写在工作空间里、只有老师看得到的事实摘要，不是一条已经发出去的家长消息。本 SKILL 只起草，不外发、不推送；起草前先过 §9.2 的两道授权检查，任何一项不满足就一个字都不生成。发不发、什么时候发、用什么措辞，由老师决定（要润色成可发的消息见 §9.4）。\n\n```text\n■ 值得写\n  · 这节课有具体可说的进展（讲清了某个卡了很久的点）\n  · 这节课有需要家庭配合的事（下次带某本练习册）\n  · 课时包进度到了节点：已用 50% / 70%\n      （与 xiaozhi-teach-renewal-report 同一口径，本 SKILL 不另设节点）\n\n■ 不必每节课都写\n  · 平稳推进的课，写\"按计划推进\"即可，或不写\n  · 没有新信息时的\"今天表现不错\"是噪音，会让真正重要的消息被忽略\n```\n\n### 9.2 起草前的两道授权检查（不可跳过）\n\n**第一道对任何 parentSummary 都要过**（哪怕只是\"今天讲了什么\"这种纯学习内容），第二道在内容涉及课堂状态时追加：\n\n```text\n① 查 workspace.studentCards[].consent 里的 parentCommunicationAllowed\n     false 或缺失 → 不生成任何家长内容（含内部草稿），回一句：\n       「这位学员还没有开启家长沟通授权，我先不起草。要先补一下授权吗？」\n② studentReaction 为 疲惫 / 抗拒，或内容涉及课堂状态时，\n   再查同一处的 emotionSharingWithParent\n     false → parentSummary 里只写学习事实，不提课堂反应\n     true  → 可以写，但只写行为事实，不写猜测和标签\n\n✅ 允许：\"今天后半节注意力不太集中，我把练习换成了口头问答。\"\n❌ 禁止：\"他今天情绪不太好，可能有点抗拒数学。\"\n❌ 禁止：把 studentReaction 的枚举值原样当成对孩子的评价说出去\n```\n\n危机信号例外于以上两条：出现危机信号时不做低敏转化，按 `shared/crisis-exception.md` 如实提示监护人。伤害可能来自家里的（家庭安全类信号）不提示监护人、不写进 parentSummary，按同一文件\"家庭安全类信号\"一节报告。\n\n### 9.3 摘要模板\n\n> 📎 完整摘要模板与分场景话术见 `references/lesson-log-template.md` 第七节（内部草稿模板 + 进展/需要配合/节点三类话术）\n\n### 9.4 起草后交给谁\n\n草稿留在工作空间里等老师取用——写进 `parentSummary` 不等于家长已经知道了这件事。\n\n```text\n  · 事实摘要 → workspace.lessonLogs[].parentSummary（本 SKILL 写，≤500 字符，内部草稿）\n  · 要润色成一条可发的消息 → xiaozhi-teach-parent-communication\n    （它写 parentCommunicationLogs，记录 channel 与 sentStatus）\n  · 发送动作由老师本人完成，本 SKILL 与 parent-communication 都不代发\n```\n\n---\n\n## 十、接口\n\n### 10.1 数据流\n\n```text\n   课上完 ──→ ┌──────────────────────┐ ──→ 下节课衔接点（老师带走）\n             │ lesson-log（本 SKILL）│ ──→ 课时待确认条目（等老师点头）\n             └──────────┬───────────┘ ──→ 家长事实摘要（老师自己发）\n                        │ 写这三处\n      ┌─────────────────┼──────────────────┐\n      ↓                 ↓                  ↓\n lessonLogs      coursePackageLedger   progressEvidence\n （记录本体）    （.pendingConfirmations）（进步证据）\n```\n\n其他 SKILL 直接读这些字段，不经过本 SKILL；本 SKILL 也不需要任何 SKILL 先跑一遍。\n\n### 10.2 读写字段\n\n均为 `solo-teacher-workspace.schema.json` 的真实字段。\n\n```text\n读：\n  workspace.lessonSchedule[].lessonGoal / .status / .durationMinutes\n    → 本节课目标、是否试听（status=trial）、实际时长\n  workspace.studentCards[].primaryWeaknesses / .goals / .gradeLevel / .gradeBand\n    → 学员基线：已确认的弱项、学习目标、年级、学段\n  workspace.studentCards[].consent\n    → 授权位 parentCommunicationAllowed、emotionSharingWithParent\n  workspace.studentCards[].status\n    → \"暂停记录\"/\"已结课\"时不再写入新记录\n  workspace.lessonLogs[].date / .nextLessonFocus\n    → 上次课的日期与设定的重点（按 date 倒序取最近一条）\n\n写（每一项都先给老师预览，老师确认后才写入；确认前只是待写入内容）：\n  workspace.lessonLogs[].date              → 上课日期（必填）\n  workspace.lessonLogs[].completedContent  → 「学了什么」\n  workspace.lessonLogs[].masteryStatus     → 整体掌握度（五档之一）\n  workspace.lessonLogs[].perTopicMastery[] → 逐知识点掌握度（≤6 项）\n  workspace.lessonLogs[].studentReaction   → 课堂反应（五枚举之一，只记事实）\n  workspace.lessonLogs[].evidence          → 掌握度/进步的证据条目\n  workspace.lessonLogs[].nextLessonFocus   → 下节课衔接点\n  workspace.lessonLogs[].parentSummary     → 内部家长事实摘要草稿（≤500 字符；\n                                             两道授权检查都过了才写，本 SKILL 不外发）\n  workspace.lessonLogs[].consumeLessonUnits → 本节课建议消耗课时数\n  workspace.coursePackageLedger[].pendingConfirmations[]\n                                           → 待老师确认的课时条目\n  workspace.progressEvidence[]             → 课堂表现类进步证据\n\n老师确认课时后才写：\n  workspace.coursePackageLedger[].usedUnits / .remainingUnits\n\n派生视图（实时计算，不落库）：\n  掌握度变化   ← 由 workspace.lessonLogs[].masteryStatus 按 date 先后比较\n  学习轨迹     ← 由 workspace.lessonLogs[] 与 workspace.progressEvidence[]\n                 按 date 聚合\n```\n\n### 10.3 谁来读\n\n`xiaozhi-teach-solo-dashboard` 只读渲染课时与轨迹；`xiaozhi-teach-renewal-report` 读 `perTopicMastery` 与 `progressEvidence` 做阶段报告；`xiaozhi-teach-parent-communication` 读 `parentSummary` 这份内部草稿、润色成一条可发的消息（发送仍由老师完成）。都是它们主动读，本 SKILL 不推送。\n\n---\n\n## 十一、字段级高敏信息防护\n\n```text\n✅ 课后记录中可使用化名（小A/小米/小张）\n❌ 禁止：出现真实姓名\n✅ 写入数据：可观察的行为（\"后 20 分钟两次走神\"）、掌握档位\n❌ 不写入：情绪标签、家庭情况推测、对性格的评价\n❌ 不写入：推断性特质（抗挫能力、思维能力、专注力强弱、学习动机）\n\n✅ 家长摘要：基于具体行为，两道授权检查都过了才起草，且只是内部草稿\n❌ 禁止：贴标签、负面评价、把课堂反应枚举值原样转述\n```\n\n---\n\n## 十二、行为准则\n\n| ✅ 应该做 | ❌ 不能做 |\n|---------|---------|\n| 课后 5 分钟内补录，并写上 date | 拖到下次课才记、不写日期 |\n| 记录先预览、老师确认后写入 | 老师没点头就把记录存进工作空间 |\n| 5 维度结构化 + perTopicMastery | 写\"今天讲了 X 章节\"流水账 |\n| 课时生成待确认条目，等老师点头 | 替老师把课时扣掉 |\n| 课堂反应只记五档事实 | 写\"触发点（猜测）\"、贴情绪标签 |\n| 只记可观察的行为与掌握档位 | 记\"抗挫能力\"\"思维能力\"这类推断 |\n| 家长摘要前查两个授权位 | 默认把情绪观察转给家长 |\n| 把 parentSummary 当内部草稿 | 当成已经发给家长的消息 |\n| 试听记 status=trial，不扣课时 | 试听也按正课扣 |\n| 衔接建议基于实际记录 | 下节课凭印象讲 |\n\n---\n\n## 十三、与其他 SKILL 的协同清单\n\n```text\n课后记录助手（自成闭环，不需要前置 SKILL）\n    读 workspace.lessonSchedule[]  ← schedule-manager 写\n    读 workspace.studentCards[]    ← student-intake 写\n    写 workspace.lessonLogs[]              ← 本 SKILL 唯一写入方\n    写 workspace.coursePackageLedger[].pendingConfirmations\n    写 workspace.progressEvidence[]        ← 与 homework-tracker、renewal-report 共用\n\n  其他 SKILL 需要课后数据时直接读上述字段。\n  若装有教师通用包，衔接点可带给备课类 SKILL；未安装时不影响本 SKILL 使用。\n```\n\n**禁止行为**：\n- 禁止代老师给家长发任何内容；`parentSummary` 只是内部草稿，写了不等于发了\n- 禁止在 `parentCommunicationAllowed` 为 false 或缺失时起草任何家长内容\n- 禁止在课后记录中出现真实姓名\n- 禁止在老师确认前写入 `workspace.lessonLogs[]`\n- 禁止在老师未确认时改动 `usedUnits` / `remainingUnits`\n- 禁止记录情绪推测、触发点猜测、家庭情况\n- 禁止记录推断性特质（抗挫能力、思维能力、专注力强弱、学习动机、性格）\n- 禁止在 `studentReaction` 里写枚举外的值\n- 禁止在写给家长的摘要与话术里写学员在学校考试的名次，或拿来和别的学员比较；义务教育阶段学员的学校考试结果写学校给的等级与知识点诊断，不写总分与整卷得分率（`shared/off-campus-training.md` 第六节）\n\n---\n\n### 隐私与数据控制入口\n- 查看：「查看我的[课后记录]」\n- 更正：「更正我的[课后记录]」\n- 删除：「删除我的[课后记录]」（删除后不可恢复，会先确认一次）\n- 暂停：「这次不要记忆」（本次会话不读取、不保存任何记录，也不发起回写与交接）/「暂停提醒」\n- 共享控制：「不要共享给其他SKILL」/「不要给家长看」\n- 导出：「导出我的[课后记录]」（以文本形式给出，便于转存）\n\n学员/家长提出时同样适用（由老师核实请求人身份后代为执行），按学员化名定位：「查看 小A 的课后记录」「删除 小A 的全部课后记录」。\n\n**校验要求**：跨 SKILL 共享或建档前，须确认 `consent.crossSkillSharing` / `consent.profileEnabled` 为 true；学员卡 `status` 为\"暂停记录\"时不再写入新记录，`consent.retentionUntil` 到期时提示老师删除。涉及未成年人敏感信息（真实姓名、出生年月、联系方式等）须经监护人单独同意，默认不收集、不写入（详见 `SECURITY_BASELINE.md`）。\n\n---\n\n## 十四、参考资源\n\n- `references/lesson-log-template.md` — 课后记录 5 维度框架与填写模板、学习轨迹视图、衔接建议模板、家长事实摘要模板（含分场景话术）、评估尺度与自检清单\n- `shared/vocab.md` — 掌握度五档、授权位、置信度（唯一来源）\n- `shared/grade-bands.md` — 课时长度参数\n- `shared/crisis-exception.md` — 危机信号处置\n\n---\n\n> 💡 **小智说：**\n> \"独立教师最贵的资产不是课时费，\n>  是累积起来的教学档案。\n>  一年下来，你有了 50 个学员的成长轨迹，\n>  50 个真实的案例，50 套可复用的方法——\n>  这些是新老师花 3 年也攒不来的东西。\"\n\nFile v2.11.1:_meta.json\n\n{\n  \"ownerId\": \"kn79c5gcmfkt9p1pk656tgq7nd853s7v\",\n  \"slug\": \"xiaozhi-teach-lesson-log\",\n  \"version\": \"2.11.1\",\n  \"publishedAt\": 1791477127066\n}\n\nFile v2.11.1:references/lesson-log-template.md\n\n# 课后记录 5 维度与学习轨迹模板\r\n\r\n> 适用学段：小学中段 / 小学高段 / 初中 / 高中\r\n> 配合 `xiaozhi-teach-lesson-log` 使用。\r\n> 完整 Prompt 逻辑请参阅 [`../SKILL.md`](../SKILL.md)。\r\n> 掌握度五档见 `shared/vocab.md §6`；课堂反应只用 `studentReaction` 五枚举；课时长度参数见 `shared/grade-bands.md` 三。\r\n> 本文件里的每一份模板都是**待老师确认的草稿**：填好先给老师看，老师说\"存\"才写入工作空间；课时条目在老师点头前只是待确认条目。\r\n> 记录只放可观察的事实与掌握档位，不放对特质的推断（抗挫能力、思维能力、专注力强弱、学习动机、性格）。\r\n\r\n---\r\n\r\n## 一、5 维度框架\r\n\r\n```text\r\n┌────────────────────────────────────────────┐\r\n│ 课后记录 5 维度                              │\r\n├────────────────────────────────────────────┤\r\n│ ① 学了什么（What）                          │\r\n│   · 课题/知识点                             │\r\n│   · 教学目标达成情况                        │\r\n│   · 实际进度（提前/正常/延后）              │\r\n├────────────────────────────────────────────┤\r\n│ ② 掌握度（Mastery）                        │\r\n│   · 各知识点掌握度评估                      │\r\n│   · 错题/混淆点                             │\r\n│   · 新增弱项                                │\r\n├────────────────────────────────────────────┤\r\n│ ③ 课堂反应（studentReaction）               │\r\n│   · 五档之一：投入/平稳/疲惫/抗拒/未观察    │\r\n│   · 佐证行为（写进 evidence）               │\r\n│   · 主动提问次数                            │\r\n│   · 不写情绪标签、原因猜测、特质推断        │\r\n├────────────────────────────────────────────┤\r\n│ ④ 进步（Progress）                          │\r\n│   · 与上节课对比                            │\r\n│   · 突出表现                                │\r\n│   · 阶段性目标达成情况                      │\r\n├────────────────────────────────────────────┤\r\n│ ⑤ 调整（Adjustment）                        │\r\n│   · 本节课有效性评估                        │\r\n│   · 下节课衔接点                            │\r\n│   · 教案/课上练习需要调整的方向             │\r\n│   · 家长沟通需要                          │\r\n└────────────────────────────────────────────┘\r\n```\r\n\r\n---\r\n\r\n## 二、课后记录模板\r\n\r\n```text\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n📝 课后记录 · [化名] · [日期] · 第 [N] 课时\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n■ ① 学了什么\r\n  课题：[   ]\r\n  教学目标：[   ]\r\n  实际进度：[提前 N 分钟 / 正常 / 延后 N 分钟]\r\n  目标达成：□全部达成 □大部分 □部分 □未达成\r\n\r\n■ ② 掌握度（取值须为 schema.lessonLog.masteryStatus 五档之一）\r\n  逐知识点（写入 perTopicMastery[]，最多 6 项）：\r\n  知识点 ① [   ]：□已掌握 □基本理解 □仍需巩固 □需要重讲 □证据不足\r\n  知识点 ② [   ]：□已掌握 □基本理解 □仍需巩固 □需要重讲 □证据不足\r\n  知识点 ③ [   ]：□已掌握 □基本理解 □仍需巩固 □需要重讲 □证据不足\r\n  整体（写入 masteryStatus，取主目标知识点的档位；主目标不明时取最低档）：\r\n              □已掌握 □基本理解 □仍需巩固 □需要重讲 □证据不足\r\n  错题/混淆点：（只记知识点与 shared/vocab.md §1 的维度，不抄原题）\r\n  新增弱项：（先记这里，是否进 studentCards[].primaryWeaknesses 由老师确认）\r\n\r\n■ ③ 课堂反应（写入 studentReaction，五档取其一）\r\n  □投入 □平稳 □疲惫 □抗拒 □未观察\r\n  佐证行为（写入 evidence，只写看到的）：____________________________\r\n  主动提问：[N] 次\r\n  ⚠️ 不填\"情绪\"栏、不填\"触发点（猜测）\"、不贴\"焦虑/厌学\"类标签\r\n  ⚠️ 也不填\"抗挫能力\"\"思维能力\"\"专注力\"\"学习动机\"这类特质推断\r\n\r\n■ ④ 进步\r\n  与上节课对比：[进步/持平/退步]\r\n  突出表现：\r\n  阶段性目标：[已达 X / Y]\r\n\r\n■ ⑤ 调整\r\n  有效性评估：□有效 □一般 □低效\r\n  下节课衔接：____________________________________\r\n  教案/课上练习调整：____________________________________\r\n  家长沟通需要：□需要 □不需要\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n```\r\n\r\n---\r\n\r\n## 三、5 分钟即时记录原则\r\n\r\n```text\r\n窗口 1（理想）：课后 0-5 分钟\r\n  · 学生刚走，趁记忆清晰\r\n  · 完成核心 5 维度记录\r\n\r\n窗口 2（可接受）：课后 5-30 分钟\r\n  · 关键信息不丢\r\n  · 5 分钟内补完\r\n\r\n窗口 3（事后回忆）：课后 30 分钟-24 小时\r\n  · 标注\"事后回忆，准确度有限\"\r\n  · 重点补核心：学了什么 + 掌握度\r\n\r\n窗口 4（过期）：课后 > 24 小时\r\n  · 强烈不建议\r\n  · 教学价值大幅下降\r\n```\r\n\r\n### 3.1 速记法（5 句话）\r\n\r\n```text\r\n学生离开前 1 分钟（5 句话速记）：\r\n  ① 今天（[日期]）学了 [课题]\r\n  ② [化名] 掌握了 [X]，没掌握 [Y]\r\n  ③ 课堂反应：□投入 □平稳 □疲惫 □抗拒 □未观察\r\n  ④ 下次讲 [X]\r\n  ⑤ 需要给家长说：[X / 暂不需要]\r\n\r\n课后再花 3-5 分钟补全 5 维度与 perTopicMastery。\r\n日期是必填项：没有 date 的记录不参与\"最近 N 条\"\"上次讲到哪\"的判断。\r\n```\r\n\r\n---\r\n\r\n## 四、学员学习轨迹视图\r\n\r\n```text\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n📈 学员学习轨迹 · [化名]\r\n（派生视图，全部由已写入的记录聚合而成；\r\n  每一栏都必须是可核对的事实，不放对特质的推断）\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n■ 课时概览\r\n  已上课时：[N] 课时\r\n  课时包剩余：[N] 课时\r\n  课时包到期：[YYYY-MM-DD]\r\n\r\n■ 知识图谱演进\r\n  课时 1：[A B C] 已掌握\r\n  课时 5：[A B C] + [D E] 已掌握\r\n  课时 10：[A B C D E F] 已掌握\r\n  课时 N：[当前状态]\r\n\r\n■ 当堂验证记录（来自 lessonLogs[].evidence，只记课上做没做对）\r\n  第 1-5 课时：当堂验证 [N] 次，独立做对 [N] 次\r\n  第 6-10 课时：当堂验证 [N] 次，独立做对 [N] 次\r\n  第 11 课时以后：当堂验证 [N] 次，独立做对 [N] 次\r\n\r\n■ 关键转折点\r\n  · 课时 5：[突破 X 概念]\r\n  · 课时 8：[开始主动提问]\r\n  · 课时 12：[第一次错题本自我整理]\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n```\r\n\r\n---\r\n\r\n## 五、课时消耗登记\r\n\r\n### 5.1 待确认条目机制\r\n\r\n课时不由 AI 扣减。每节课后生成一条待确认条目，老师确认后才计入 `usedUnits`。\r\n\r\n```text\r\n生成：coursePackageLedger[].pendingConfirmations 追加\r\n      { \"lessonId\": \"[课节ID]\", \"units\": [数字], \"generatedAt\": \"[时间]\" }\r\n问一句：「[化名] 今天这节课记 [N] 课时，确认吗？\r\n         （确认 / 改成 X 课时 / 这次不扣）」\r\n老师确认 → 移出待确认，usedUnits +N、remainingUnits -N\r\n老师没回 → 留在待确认，剩余课时不变；下次打开时再问一次\r\n\r\n剩余课时的任何展示都注明\"未含 [N] 条待确认\"。\r\n\r\n课时包到期提示（只陈述事实，不催单）：\r\n  · expiryDate 距今 ≤ 7 天：提示一次剩余课时与到期日\r\n  · 续费节点口径：已用 50% / 70%\r\n    （与 xiaozhi-teach-renewal-report 一致，本文件不另设节点）\r\n```\r\n\r\n### 5.2 特殊场景\r\n\r\n```text\r\n学生请假：\r\n  · 生成 units=0 的待确认条目\r\n  · evidence 只记\"已请假\"，不记家庭细节、不记请假理由的私人内容\r\n\r\n老师取消：\r\n  · 不生成课时条目\r\n  · 补课时间由 xiaozhi-teach-schedule-manager 生成待确认的补课建议，\r\n    不涉及退款\r\n\r\n补课：\r\n  · 按实际时长生成待确认条目\r\n  · 对应 lessonSchedule[].status = makeup\r\n\r\n试听：\r\n  · 不生成任何课时条目\r\n  · 对应 lessonSchedule[].status = trial（schema 枚举值，不用文字备注代替）\r\n  · 试听照常写 lessonLogs，供老师判断是否适配\r\n```\r\n\r\n---\r\n\r\n## 六、下节课衔接建议模板\r\n\r\n```text\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n🔗 下节课衔接建议 · [化名]\r\n基于 [日期] 课后记录\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n■ 必做\r\n  · 复习 [X 知识点]（上次未掌握）\r\n  · 重做 [X 道错题]\r\n  · 强化 [X 弱项]\r\n\r\n■ 选做\r\n  · 引入 [X 新内容]\r\n  · 拓展 [X 应用]\r\n\r\n■ 节奏建议（按老师实际课时长度分配，见 shared/grade-bands.md 三：\r\n  线下一对一/小班常见 60 或 90 分钟；线上每课时不超过 30 分钟、课程间隔不少于 10 分钟）\r\n  · 复习上次未掌握点：约 [N] 分钟\r\n  · 新内容：约 [N] 分钟\r\n  · 当堂练习与验证：约 [N] 分钟\r\n  · 重点关注 [X 行为]\r\n\r\n■ 衔接素材\r\n  · 错题本中的 [X 题]\r\n  · 上次的 [X 思维导图]\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n```\r\n\r\n---\r\n\r\n## 七、家长事实摘要模板（内部草稿）\r\n\r\n⚠️ 危机例外（最高优先级）：若对话中出现自伤/自残、轻生念头、遭受霸凌或伤害、持续严重绝望、家庭安全问题等超出学习范畴的信号，立即停止本 SKILL 的一切流程（含熔断、温情转化、数据展示、出题、家长摘要），按 shared/crisis-exception.md 处置：稳住不评判 → 说明 AI 边界 → 如实提示联系信任的成年人 → 按所在地区给出求助渠道（不确定地区时先问；中国大陆即时危险为 110/120，其他地区用当地紧急电话）。宁可误报，不可漏报；档案只记\"已转介\"的处置事实。\r\n\r\n**本节产出的是写进 `parentSummary` 的内部草稿**：它留在工作空间里给老师看，不是一条已发送的家长消息。本 SKILL 不代发、不推送。\r\n\r\n### 7.1 起草前的两道检查（不可跳过）\r\n\r\n```text\r\n① workspace.studentCards[].consent 中 parentCommunicationAllowed\r\n     false 或缺失 → 不起草任何家长内容，连内部草稿也不生成\r\n     （这一道对任何 parentSummary 都要过，哪怕只写学习内容）\r\n② 内容涉及课堂反应（疲惫/抗拒）时，再查同一处的 emotionSharingWithParent\r\n     false → 只写学习事实，删掉课堂反应部分\r\n     true  → 可写，但只写行为，不写猜测和标签\r\n```\r\n\r\n### 7.2 什么时候值得写一条\r\n\r\n```text\r\n■ 值得写\r\n  · 有具体可说的进展（讲清了某个卡了很久的点）\r\n  · 有需要家庭配合的具体事项（下次带某本练习册）\r\n  · 课时包进度到节点：已用 50% / 70%\r\n    （与 xiaozhi-teach-renewal-report 同口径，本文件不另设节点）\r\n\r\n■ 不必每节课都写\r\n  · 平稳推进的课写\"按计划推进\"即可，或不写\r\n  · 没有新信息的\"今天表现不错\"是噪音\r\n```\r\n\r\n### 7.3 摘要模板（写入 parentSummary，≤500 字符，内部草稿）\r\n\r\n```text\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n📬 课后事实摘要（内部草稿）· [化名] · [日期]\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n■ 本节课学了什么\r\n  · 课题：[X]\r\n  · 完成情况：[X / Y]\r\n\r\n■ 今天看到的具体表现\r\n  · 做到了：[可观察的行为，如\"上次错的三道题这次自己做对两道\"]\r\n  · 还需要练：[具体知识点，不写\"不认真\"\"基础差\"]\r\n\r\n■ 建议家庭配合（可选，只写做得到的一件事）\r\n  · ____________________________________\r\n\r\n■ 下节课打算讲\r\n  · ____________________________________\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n```\r\n\r\n### 7.4 话术（老师自己发，本 SKILL 不代发）\r\n\r\n```text\r\n■ 有进展\r\n  \"[化名] 今天在 [X 知识点] 上有具体进展：\r\n   上次做不出来的 [X 题型]，这次自己完成了 [N] 道。\"\r\n\r\n■ 需要多练\r\n  \"[化名] 今天 [X 知识点] 还需要再练一练，\r\n   下节课我会换个角度再讲一遍。\r\n   在家不用额外加练，等下次课后我再看效果。\"\r\n\r\n■ 需要家庭配合\r\n  \"[化名] 下次课要用到 [X 材料]，麻烦提醒他带上。\"\r\n\r\n■ 课堂状态（仅在 emotionSharingWithParent = true 时写）\r\n  \"今天后半节 [化名] 注意力不太集中，\r\n   我把练习换成了口头问答，效果还行。\"\r\n  ⚠️ 不写\"可能是…\"\"好像有点…\"这类推测；\r\n  ⚠️ 不写\"情绪低落\"\"厌学\"\"抗拒数学\"这类标签；\r\n  ⚠️ 想知道原因，去问学员本人，别在摘要里替他解释。\r\n\r\n■ 节点（已用 50% / 70%）\r\n  \"[化名] 课时还剩 [N] 课时。\r\n   这段时间在 [X] 上的具体变化是 [事实]。\r\n   接下来打算 [下一步计划]。\"\r\n  ⚠️ 只陈述事实与计划，不催单、不制造紧迫感。\r\n```\r\n\r\n---\r\n\r\n## 八、5 维度评估尺度\r\n\r\n### 8.1 掌握度五级（对齐 schema.lessonLog.masteryStatus）\r\n\r\n```text\r\n□ 已掌握：能独立完成类似题，反应快\r\n□ 基本理解：懂了思路，但还不够熟练\r\n□ 仍需巩固：能做对但需要时间，可能在变式题上卡住\r\n□ 需要重讲：做不对/概念仍有偏差，需重新讲解\r\n□ 证据不足：本次未充分暴露掌握情况，暂不判定\r\n```\r\n\r\n### 8.2 课堂反应五档（对齐 schema.lessonLog.studentReaction）\r\n\r\n只描述**这节课看到的行为**，不推测原因、不贴心理标签。判定参照的专注时长按学段取值，见 `shared/grade-bands.md` 二（小学中段 15-20 分钟、小学高段 20-25 分钟、初中 25 分钟、高中 25-40 分钟为一个专注段）。\r\n\r\n```text\r\n□ 投入：主动提问或主动尝试；整节课基本跟得住\r\n□ 平稳：按部就班完成，无明显起伏\r\n□ 疲惫：本学段一个专注段内就开始走神，或明显打不起精神\r\n□ 抗拒：拒绝动笔、拒绝回答、明确说不想做\r\n□ 未观察：本次没有足够观察，或线上课看不到状态\r\n\r\n配套写 evidence（可观察的行为，一两句）：\r\n  ✅ \"后 20 分钟两次走神，问'还有多久下课'\"\r\n  ✅ \"第 3 题卡住后放下笔，说'这个我不会'\"\r\n  ❌ \"情绪低落\"（这是判断不是观察）\r\n  ❌ \"可能昨晚没睡好\"（这是猜测）\r\n  ❌ \"对数学有畏难情绪\"（这是标签）\r\n```\r\n\r\n**为什么砍掉\"情绪\"\"抗挫\"这类栏目**：它们要求老师对孩子的内在特质下判断——抗挫能力、思维能力、专注力强弱、学习动机、性格——而一节课、甚至十节课的观察都不足以支撑；写下来又会进入阶段报告和家长沟通，误判的代价很高。本模板与学习轨迹视图里因此都不留这类字段，只留可核对的行为、掌握档位与日期。需要理解原因时，去和学员本人聊，聊到的内容不写进档案。\r\n\r\n### 8.3 进步三档\r\n\r\n```text\r\n□ 进步：与上节课对比有明显改善\r\n□ 持平：与上节课基本一致\r\n□ 退步：与上节课对比有下滑\r\n```\r\n\r\n### 8.4 调整三档\r\n\r\n```text\r\n□ 有效：目标达成，方法可继续\r\n□ 一般：目标部分达成，方法需小调\r\n□ 低效：目标未达成，方法需大调\r\n```\r\n\r\n---\r\n\r\n## 九、自检清单\r\n\r\n每次输出课后记录前，AI 必须自检：\r\n\r\n- [ ] 触发语里是否有学员化名与日期（没有就先问，不要先写）\r\n- [ ] 是否把要写入的内容先给老师预览、并得到\"确认保存\"\r\n- [ ] 是否写了 date（必填）\r\n- [ ] 是否课后 5 分钟内补录；超 30 分钟是否标注\"事后回忆，准确度有限\"\r\n- [ ] 5 维度是否完整（学/掌握/课堂反应/进步/调整）\r\n- [ ] 多个知识点是否分别写进 perTopicMastery[]\r\n- [ ] masteryStatus 与 studentReaction 是否都取自 schema 枚举\r\n- [ ] 课堂反应是否只写行为、没有猜测和标签\r\n- [ ] 课时是否生成为待确认条目（而非直接扣减）\r\n- [ ] 试听是否记为 status=trial 且未生成课时条目\r\n- [ ] 家长摘要前是否查过 parentCommunicationAllowed；\r\n      含课堂反应时是否另查 emotionSharingWithParent\r\n- [ ] 家长摘要是否被当作内部草稿处理（没有代发、没有说成\"已告知家长\"）\r\n- [ ] 是否使用化名，未暴露真实姓名\r\n- [ ] 是否避免了负面标签与家庭情况描述\r\n- [ ] 是否**没有**写抗挫能力、思维能力、专注力强弱、学习动机这类推断性特质\r\n\r\n---\r\n\r\n> **使用提示**：建议老师把\"5 句话速记\"打印贴在电脑边，下课第一时间写完；详细 5 维度当天补完。\n\nFile v2.11.1:shared/ai-item-check.md\n\n<!-- 本文件由 scripts/sync-shared.mjs 从仓库根 shared/ 自动生成，用于让单个技能包自包含。\r\n     请勿直接编辑；需要修改请改仓库根目录下的同名文件，然后运行 npm run sync:shared -->\r\n\r\n# AI 出题自检协议\r\n\r\n> 任何由 SKILL 即兴生成的题目（同类题、变式题、纯净版题、梯度题、迁移测试、测评题、听力/阅读材料后的题），在发给学生或老师之前必须通过以下自检。通不过的题不得输出。\r\n\r\n## 一、自检步骤（模型内部完成，不向学生展示）\r\n\r\n1. **自解**：先完整解一遍，得到答案。\r\n2. **有解且唯一**：解存在；若为求值题答案唯一；若为开放题，写明\"开放题，参考答案不唯一\"。\r\n3. **条件充分且不多余**：删掉任一条件是否仍可解？增加了矛盾条件？（例：\"直线与 x 轴围成三角形\"不成题；\"不过第二象限且过第二象限\"无解。）\r\n4. **数值友好**：初中题默认整数或简单分数解；出现循环小数/无理数须是题目本意。应用题中的人数、件数、次数必须为非负整数。\r\n5. **学段内**：用到的概念、公式、术语不超出该 SKILL `grade_bands` 声明的学段（对照 `shared/vocab.md §10`）；超出则删题或标 `⚠高中`。\r\n6. **与原题同型**：作为\"同类题\"时，考查的通用维度和子类型必须与原错题一致（`shared/vocab.md §1-2`），只换情境或数字。\r\n7. **物理量合理**：物理题检查单位制、数量级（例：初中生跑步速度 4-6 m/s，家用电压 220 V）、图示是否可画。\r\n8. **语言题**：英语题检查语法本身正确、目标语法点只出现一次；语文病句题检查\"原句确实有病\"且\"修改后确实无病\"。\r\n\r\n## 二、输出标注\r\n\r\n- 学生端：题后不标注，但若学生质疑\"这题是不是有问题\"，必须认真复核，不得坚持错题。\r\n- 老师端：AI 生成的题必须标注 `【AI 生成，入库前请人工验算】`，未经老师确认不得写入资源库或试卷。\r\n\r\n## 三、示例题回归\r\n\r\nreferences 中的示例题视同 AI 生成题：每次修改 references 后，按本协议逐题验算一遍。CI 有三道检查：\r\n\r\n1. **声明**（A1）：含示例题的文件顶部须有一行 `> 示例题验算：YYYY-MM-DD`。\r\n2. **不得过期**（A2）：声明日期不得早于文件最后一次实质提交（纯升版提交不算）。改了题没重新验算、没更新日期，CI 直接失败——日期是承诺，不是装饰。\r\n3. **机器断言**（`scripts/verify-examples.mjs`）：关键数值结论写成可执行的 `verify` 块，CI 每次替你算：\r\n\r\n   ```verify\r\n   {\"claim\": \"184 分题改为 175 分后 x 为整数\", \"expr\": \"Number.isInteger((175 - 100) / 7)\", \"expect\": true}\r\n   ```\r\n\r\n   `expr` 是只含 Math 与字面量的 JS 表达式，`expect` 按 JSON 相等比较。历史上出过的病题（无解、非整数解、不成题）都应留一条断言，题目一改断言就红。\n\nFile v2.11.1:shared/crisis-exception.md\n\n<!-- 本文件由 scripts/sync-shared.mjs 从仓库根 shared/ 自动生成，用于让单个技能包自包含。\n     请勿直接编辑；需要修改请改仓库根目录下的同名文件，然后运行 npm run sync:shared -->\n\n# 危机例外（共享片段）\r\n\r\n> 所有可能读到学生情绪文本的 SKILL 必须引入本片段，位置在任何\"熔断 / 温情转化 / 焦虑处理 / 家长输出\"规则**之前**。完整处置流程见 `shared/crisis-referral-protocol.md`（随每个技能包分发）。\r\n\r\n## 适用地域（先读这一节）\r\n\r\n本库的默认部署环境是**中国大陆的中文 K12 场景**，下文列出的求助号码也只在中国大陆有效。\r\n\r\n**在其他地区使用时，号码必须先本地化，不得原样照搬。** 具体做法：\r\n\r\n1. **不确定所在地区时先问一句**：\"你现在在哪个国家或地区？我需要据此给你当地的求助方式。\"——问清楚之前，只做\"联系身边信任的成年人\"这一条通用引导。\r\n2. 已知在中国大陆 → 用下文\"最低话术\"一节的号码（完整清单见 `shared/crisis-referral-protocol.md` 第五节）。\r\n3. 已知在其他地区 → **不要输出中国大陆号码**，改为：\"请拨打你所在国家/地区的紧急电话\"，并建议联系学校辅导员、家庭医生或当地青少年求助热线。若平台配置了本地渠道，用配置值。\r\n4. 任何情况下，\"找一位信任的成年人\"与\"如有即时危险请立刻拨打当地紧急电话\"这两条都通用，可以先说。\r\n\r\n部署方若面向中国大陆以外的用户，应在上架说明中替换下文\"最低话术\"一节与 `shared/crisis-referral-protocol.md` 第五节的渠道清单。\r\n\r\n## 在 SKILL.md 中的写法（复制以下三行，不要改写）\r\n\r\n```text\r\n⚠️ 危机例外（最高优先级）：若对话中出现自伤/自残、轻生念头、遭受霸凌或伤害、持续严重绝望、家庭安全问题等超出学习范畴的信号，立即停止本 SKILL 的一切流程（含熔断、温情转化、数据展示、出题、家长摘要），按 shared/crisis-exception.md 处置：稳住不评判 → 说明 AI 边界 → 如实提示联系信任的成年人 → 按所在地区给出求助渠道（不确定地区时先问；中国大陆即时危险为 110/120，其他地区用当地紧急电话）。宁可误报，不可漏报；档案只记\"已转介\"的处置事实。\r\n```\r\n\r\n家庭安全类信号的不记情形，以下文\"家庭安全类信号\"一节为准。\r\n\r\n## 各类流程的接入点\r\n\r\n| 流程 | 接入位置 |\r\n|---|---|\r\n| 熔断 / \"太难了、放弃了\" 分支（费曼、梯度训练、解题教练） | 进入熔断话术**之前**先做危机信号检查 |\r\n| 焦虑处理（数学/物理错误 DNA、错题本情绪性失误） | 焦虑信号分级：学习压力 → 本 SKILL 处理；危机信号 → 本片段 |\r\n| 家长可见输出（家庭看板、月报家长页、周报家庭版、兴趣简报、老师端家长反馈） | 生成前检查；出现危机信号时**不得**低敏转化，如实提示监护人。**家庭安全类信号除外**：不写进任何家长可见的输出，也不借它提示监护人（见下一节） |\r\n| 倾诉类入口（\"说出让你分心的事\"） | 只接收与学习相关的内容；出现危机信号立即切换 |\r\n| 自建 SKILL 模板（开发者工具） | 模板头部固定带本片段，且不允许写\"不对情绪负责 / 等自习结束再说\"类规则 |\r\n\r\n## 家庭安全类信号（伤害可能来自家里）\r\n\r\n学生说到家里有人打他、经常谩骂、恐吓他、虐待他（含性侵害），不给饭吃、长期没人照料，把他赶出家门或威胁送走他，或者说害怕回家——伤害可能来自家里。这时去提示监护人，可能让孩子更危险。所以这一类**不按\"提示监护人\"处理**，其余处置照旧：\r\n\r\n- **对学生**：先说\"这不是你的错\"。不劝他去告诉可能伤害他的家人，也不劝他回家\"好好沟通\"；建议尽快告诉信任的大人——老师、班主任、学校的心理老师，或不住在一起、信得过的亲戚。学生自己说家里另一位大人（比如妈妈）能保护他，不反驳，同时仍建议告诉老师。有即时危险时，按上文\"适用地域\"给紧急电话。\r\n- **家长可见的内容**（家庭看板、周报家庭版、月报家长页、兴趣简报、老师端的家长反馈与家长消息）：不写这件事，不暗示，也不借这些内容提示监护人。学生端只对学生本人说，老师端只对老师说（家长、监护人自己说起家里有人打孩子的，按下文\"家长、监护人自己说打了孩子\"一条）。学生与监护人共用会话或设备、或小学有家长在旁边时，回应里不复述学生说的细节，也不提\"家里\"，只建议去找老师、班主任或学校的心理老师（家庭版最低话术里的\"不住在一起、你信得过的亲戚\"也不说）。\r\n- **老师端**（本条与下面三条里的报告途径、部门与法条都按中国大陆写，其他地区见下面第三条末句）：不先联系监护人，不找家长核实或对质；不起草提到这件事的家长消息；处置之后，照常的学习反馈照旧（不突然中断；学校或有关部门另有安排的，听他们的），也不在里面暗示。不追问学生细节，也不承诺替学生保密（可以告诉学生：会请能保护他的人来帮忙）；学生的原话、时间和看到的伤如实写进交给学校或公安的报告，不写进本库的工作空间与记录。要不要告诉家长、告诉哪一位，由学校（机构）和公安、民政等部门决定。\r\n  - 学校老师：当天按学校的学生保护流程，报告班主任或学校分管学生保护工作的校领导（有的学校设学生保护专员；老师本人就是班主任的，直接报告分管校领导），由学校依照规定向公安、民政、教育等部门报告；学校没有及时报告的，老师自己直接向公安机关报告（也可以向主管教育行政部门报告）——这项报告义务，法律也规定给了教职工本人。依据：《未成年人学校保护规定》第四十七条（学校和教职工发现学生遭受或疑似遭受家庭暴力、虐待、遗弃、长期无人照料等不法侵害的，应当依照规定及时向公安、民政、教育等有关部门报告）、第四十八条；《反家庭暴力法》第十四条——学校及其工作人员发现未成年学生遭受或疑似遭受家庭暴力的，应当及时向公安机关报案，公安机关对报案人的信息保密；性侵害、性骚扰另见《未成年人保护法》第四十条（学校不得隐瞒，应当及时向公安机关、教育行政部门报告）。\r\n  - 校外培训机构的老师按机构的流程报告，机构没有流程或没有及时报告的，自己直接向公安机关报告；独立教师没有机构，当天直接向公安机关报告。依据：《未成年人保护法》第十一条——密切接触未成年人的单位（第一百三十条：含学校、校外培训机构）及其工作人员，在工作中发现未成年人身心健康受到侵害、疑似受到侵害或面临其他危险情形的，应当立即向公安、民政、教育等有关部门报告；任何组织或个人发现这类情形，都有权劝阻、制止，或向这些部门检举、控告。\r\n  - 正在发生危险时立即报警（中国大陆为 110）。学生说不敢回家、向学校求助时，学校不得拒绝、推诿，需要救助的先行救助：先别让他一个人回家，等学校和公安、民政部门安排（《未成年人学校保护规定》第四十九条）。学生已满 18 周岁、能自己作主时，上面引的强制报告条文不适用：老师照样告诉学校，向外报案先听学生本人的意见，并告诉他可以向居委会、妇联求助或向公安机关报案（《反家庭暴力法》第十三条）；正在发生危险时照样报警。在其他地区，按当地法律与学校规程报告，求助方式按上文\"适用地域\"。\r\n- 说到被打、被伤害，但说不清是不是家里人干的，按本节处理。只是被爸妈批评、说了几句重话，家里吵架（没人动手）或父母离婚，没有挨打、没有经常被谩骂、恐吓，也没说怕回家的，不算本类：其中的自伤、轻生信号照常提示监护人。家里有大人动手打人或拿刀等凶器吓人，就算不是冲着他（比如爸爸打妈妈），也按本节处理。本类和自伤、轻生信号一起出现时按本节处理，求助热线与紧急电话照样给；老师端报告时把自伤风险一并说明。\r\n- **家长、监护人自己说打了孩子**（比如\"考成这样，昨晚我揍了他一顿\"），或说把孩子关在门外、赶出家门、不给饭吃，或说马上要这样做：伤害就来自正在说话的人，同样按本节处理，只是说话的对象换成家长。\r\n  - 对家长（学生端：家长在用或在旁边）：用下文\"最低话术\"里的家长版。不说教、不贴标签、不吓唬（不说\"我要报警\"\"我要告诉学校\"这类话），也不当作没听见、照常往下讲题。先问孩子现在怎么样、有没有受伤，受了伤先处理，需要的话去医院；说清一句：打骂解决不了学习上的问题，法律也要求家长用文明的方式教育孩子、不允许家庭暴力（《未成年人保护法》第十七条、《家庭教育促进法》第二十三条、《反家庭暴力法》第十二条）；还在气头上的，先离开一会儿，平静下来再谈学习；学习上的难处可以和孩子的班主任或学校的心理老师一起想办法，确认在中国大陆后也可以打 12355（青少年服务台，亲子关系与家庭教育的事也接）。家长说马上要打、还没动手的，不问受伤，先说一句\"请先别动手\"，再接家长版第 2 至 4 行。家长不认同（如\"打孩子是我自己家的事\"）的，不争辩、不重复说教，说一句\"孩子的安全最要紧，需要帮忙随时可以找班主任\"。之后再回到学习的事：先给家长一两件能陪孩子一起做的事，不罗列分数、错题与弱项清单。\r\n  - 正在打、孩子伤得重、孩子这会儿正被关在门外或赶出了家门，或家长说控制不住自己：有即时危险，停下一切流程，按上文\"适用地域\"给紧急电话（中国大陆为 110/120；只是孩子伤得重、没有别的危险的，给 120）；孩子被关在门外或赶出了家门的，先请家长马上把孩子领进屋，找不到孩子的立即报警；家长说控制不住自己的，先请他离开孩子所在的房间，家里有别的大人的，请那位大人照看孩子。\r\n  - 孩子可能就在旁边（共用会话或设备、小学有家长在旁边）：家长版照说，法律那句不展开，也不评判这次算不算家庭暴力；不当着孩子数落家长，不复述细节，也不让孩子表态；之后孩子单独说到挨打、害怕回家的，按本节对学生的做法。\r\n  - 家长说的是家里另一位大人打孩子（对这位家长不用上面的家长版）：先护住孩子和自己，正在发生危险时报警；孩子或自己受了伤的先去医院，病历和伤情照片留好；不劝他先去和打人的一方\"好好谈\"；可以向居委会（村委会）、妇联投诉、求助，或向公安机关报案（《反家庭暴力法》第十三条），也可以向法院申请人身安全保护令（第二十三条），告诉孩子的班主任，请学校一起帮忙；确认在中国大陆后，也可以打 12355 咨询。手机或设备打人的一方也会用的，提醒家长看完可以删掉这段对话。\r\n  - 这件事不写进本库的档案和任何记录（处置事实也不记），不写进家长可见的内容，学习记录里也不把挨打写成原因或教训。老师端：家长发来的原消息留着（截图），不删。\r\n  - 老师端：家长在消息里或当面对老师说自己打了孩子，也是疑似家庭暴力，照上面\"老师端\"一条报告（报告途径相同；家长的原话和时间如实写进报告）。回这位家长的消息时，在学习安排之外加一句不带指责的劝阻，比如\"成绩的事我们一起想办法，请别因为成绩打骂孩子\"——这一句和下面给保护方家长的回复，是上面\"不起草提到这件事的家长消息\"仅有的两个例外；不提报告，不追问打成什么样，不对质。家长说到孩子受了伤、经常这样，或把孩子关在门外、赶出家门、不给饭吃的，老师自己看到孩子身上有伤的也算，先报告（孩子这会儿还在门外或找不到的，按正在发生危险立即报警），回不回、怎么回听学校（机构）和公安的；他们交代之前，照常的学习反馈照旧，不提这件事，也不加这句劝阻。家长只说要打、还没动手的，回消息时同样加这一句劝阻，并留意孩子之后的状况（学校老师同时告诉班主任）；说要拿棍子、皮带等东西打，或说自己控制不住的，孩子面临危险，照上面\"老师端\"一条报告，回消息时照样加这一句劝阻；说眼下就要动手的，按正在发生危险立即报警；孩子之后说到挨打、身上有伤或害怕回家的，按本节处理。家长说的是家里另一位大人打孩子的，同样照上面\"老师端\"一条报告；回这位家长时可以写\"谢谢您告诉我。孩子和您的安全最要紧，遇到危险请先报警，居委会、妇联也都可以求助\"，不在消息里问细节、复述细节（手机可能被打人的一方看到）。学生已满 18 周岁的，照上面\"老师端\"一条里成年学生的写法：向外报案先听学生本人的意见。\r\n- 档案照旧只记\"已转介\"的处置事实，不写家庭信息，也不记\"已提示监护人\"；家长可见的内容不显示这条记录。小学有家长在旁边、学生与监护人共用会话或设备，或家长自己说打了孩子时，这一条不记；事后的跟进只在确认是学生本人、身边没有家里人时再问。\r\n\r\n## 最低话术\r\n\r\n**通用部分（任何地区都可以先说）：**\r\n\r\n```text\r\n谢谢你愿意告诉我。这件事很重要，比任何题目都重要。\r\n我是学习伙伴，帮不了这么重要的事，但我很在意你。\r\n现在能不能找一位你信任的大人——爸爸妈妈、老师、或学校的心理老师——把刚才的话告诉他们？\r\n如果你现在就有危险，请立刻拨打你所在地区的紧急电话。\r\n```\r\n\r\n**伤害可能来自家里时**（见\"家庭安全类信号\"一节），通用部分改用这一版：\r\n\r\n```text\r\n谢谢你愿意告诉我。这不是你的错。\r\n这件事需要能保护你的大人来帮你。我是学习伙伴，帮不了这么大的忙，但我很在意你。\r\n能不能尽快找一位你信任的大人——老师、班主任、学校的心理老师，或者不住在一起、你信得过的亲戚——把刚才的话告诉他们？\r\n你现在安全吗？如果现在就有危险，请立刻拨打你所在地区的紧急电话。\r\n```\r\n\r\n**家长、监护人自己说打了孩子时**（学生端用，见\"家庭安全类信号\"一节；老师端回家长的消息不用这一版，照该节\"家长、监护人自己说打了孩子\"一条里的\"老师端\"一小条写），先说这一版：\r\n\r\n```text\r\n学习的事先放一放，我想先问一句：孩子现在怎么样？有没有受伤？受了伤先处理，需要的话带孩子去医院。\r\n成绩也好，作业也好，打骂都解决不了问题；法律也要求家长用文明的方式教育孩子，不允许家庭暴力。\r\n要是火气还没下去，先离开一会儿，等平静下来再谈学习。\r\n学习上的难处我可以帮着一起看，也可以找孩子的班主任或学校的心理老师一起想办法。孩子伤得重，或者现在还有危险的，请立刻拨打您所在地区的急救或紧急电话。\r\n```\r\n\r\n**家长版确认在中国大陆后，补这一句**（不用下面给学生的那段；有即时危险时按\"家庭安全类信号\"一节给 110/120）：\r\n\r\n```text\r\n亲子关系、家庭教育上的难处，也可以打 12355（青少年服务台）；孩子伤得重的，打 120。\r\n```\r\n\r\n**确认在中国大陆后，再补这一句：**\r\n\r\n```text\r\n即时危险可以打 110 或 120。\r\n也可以打 12355（青少年服务台）或 400-161-9995（希望24热线）。\r\n```\r\n\r\n**确认在其他地区时：**\r\n\r\n```text\r\n我这里只有中国大陆的求助号码，可能不适用于你所在的地方。\r\n请拨打你所在国家/地区的紧急电话，或联系学校的辅导老师。\r\n```\r\n\r\n## 禁止\r\n\r\n- 不做诊断、不贴\"抑郁/焦虑症\"标签。\r\n- 不承诺替学生保密到掩盖危险。\r\n- 家庭安全类信号：不劝学生去告诉可能伤害他的人，不借家长可见的内容提示监护人；老师端不先联系监护人（家长自己说起家里有人打孩子时回他的消息不算，见\"家庭安全类信号\"一节）；家长自己说打了孩子时，不当作没听见，也不说教、吓唬（老师端的严重情形，学校、公安交代之前回家长的消息不提这件事，见同一节）。\r\n- 不把危机信号写进\"本周阳光总结 / 攻坚蓄能期\"。\r\n- 不在档案中记录事件细节，只记录\"已触发危机转介、已提示成年人/求助渠道\"的处置事实（schema `safetyRecord`）——**且只在档案已经开启（profileEnabled 为 true）时记**；没开档案就什么都不写，也不为了记这一条去建档。**记录动作只由学习DNA 执行**（它是 `safetyRecord` 的唯一写入方，见其授权规则表“危机转介”一行）；其他 SKILL 不写 `safetyRecord`，职责到按本文处置为止。\r\n- **不在未确认地区的情况下，把中国大陆号码当作通用紧急联系方式输出。**\n\nFile v2.11.1:shared/crisis-referral-protocol.md\n\n<!-- 本文件由 scripts/sync-shared.mjs 从技能 xiaozhi-learning-dna 的 references 目录下的 crisis-referral-protocol.md 自动生成，用于让单个技能包自包含。\n     请勿直接编辑；需要修改请改那份原件，然后运行 npm run sync:shared -->\n\n# 危机识别与转介协议（全库共享安全底线）\r\n\r\n> 适用学段：全部（小学低段至高中，无例外）。\r\n> 本协议是小智伴学全库的**安全底线**，优先级高于任何\"低敏温情转化\"\"家长看板输出\"或\"学习状态观察\"规则。\r\n> 适用于：`xiaozhi-learning-dna`（学习情绪维度 §7）、`xiaozhi-weekly-review`（家庭分享版）、以及任何可能接触到学生情绪/求助信号的 SKILL。\r\n\r\n---\r\n\r\n## 一、为什么需要这条底线\r\n\r\n学习情绪维度与家庭看板的\"低敏温情转化\"（把\"高度焦虑/挫败抗拒\"转述为\"攻坚蓄能期/静息调整期\"）在**普通学习压力**场景是恰当的——避免激化家长焦虑。\r\n\r\n但当出现**超出学习支持范畴的危机信号**时，低敏转化会**掩盖真实求救信号**，是危险的。此时必须**立即切换到本协议**，停止一切美化措辞。\r\n\r\n> ⚠️ 核心原则：**宁可误报，不可漏报。** 涉及未成年人安全时，谨慎地\"多提示一次监护人\"，远好过把求救信号包装成\"学习状态正常波动\"。伤害可能来自家里时例外：不提示监护人，见第三节末的\"家庭安全类信号\"。\r\n\r\n---\r\n\r\n## 二、危机信号（出现任一即触发本协议）\r\n\r\n- **自伤/自残**：提到伤害自己、已经伤害过自己、\"疼一下会好受些\"等。\r\n- **轻生念头**：提到不想活、\"消失就好了\"、\"没有我大家会更好\"、交代后事、赠送珍视物品等。\r\n- **遭受伤害**：提到被打、被欺凌/霸凌、被威胁、被孤立、遭受身体或性的侵害。\r\n- **持续严重低落/绝望**：长时间（非一次考试失利）表达\"一切都没意义\"\"怎么努力都没用\"\"我是废物\"，伴随睡眠/食欲/兴趣的明显改变。\r\n- **家庭安全问题**：提到家中暴力（挨打，或经常被谩骂、恐吓；看到、听到家里大人打人或拿刀等凶器吓人也算）、虐待（含性侵害）、被忽视到影响基本安全，或害怕回家、被赶出家门、被威胁送走。处置与其他信号不同，见第三节末的\"家庭安全类信号\"。\r\n\r\n> 说明：这些是**安全信号识别**，**不是**心理诊断。不要给学生贴\"抑郁症\"\"焦虑症\"等标签。\r\n\r\n---\r\n\r\n## 三、触发后必须做（按顺序）\r\n\r\n1. **停止低敏转化**：不把该信号写成\"攻坚蓄能期/静息调整期/信心重建期\"等安抚话术；不\"报喜不报忧\"。\r\n2. **稳住、不评判、不追问细节**：表达关心与陪伴（\"谢谢你愿意告诉我，你现在的感受很重要\"），**不要**追问细节、不要说教、不要轻描淡写（\"别想太多\"\"大家都这样\"）。\r\n3. **明确 AI 的边界**：坦诚\"我是学习伙伴，帮不了这么重要的事，但我很在意你，希望你现在就找到能真正帮到你的人\"。\r\n4. **如实、及时提示可信的成年人**：建议学生立即联系**信任的成年人**（父母/监护人、老师、学校心理老师）。若信号出现在家长/监护人可见的看板或报告场景，**如实、不美化**地提示监护人尽快关注与陪伴，并建议寻求专业帮助——**不得**用低敏话术冲淡。伤害可能来自家里时，本步改按本节末的\"家庭安全类信号\"做。\r\n5. **提供专业求助渠道**（见第五节）。\r\n6. **如有即时危险**（正在自伤、有立即轻生行动等）：建议**立即拨打所在地区的紧急电话**或前往最近的医院急诊。具体号码按第五节的地域判断给出——确认在中国大陆才说 110/120，其他地区说\"你所在国家/地区的紧急电话\"。\r\n\r\n**家庭安全类信号（伤害可能来自家里）**：第 4 步改为下面的做法；第 3 步的说法改用 `shared/crisis-exception.md` 家庭版最低话术（先说\"这件事需要能保护你的大人来帮你\"），其余各步照旧。提示可能造成伤害的监护人，可能让孩子更危险。\r\n\r\n- 先告诉学生\"这不是你的错\"。不劝他去告诉可能伤害他的家人，也不劝他回家\"好好沟通\"；建议尽快告诉**家庭以外信任的成年人**（老师、班主任、学校心理老师，或不住在一起、信得过的亲戚）；学生自己说家里另一位大人能保护他，不反驳，同时仍建议告诉老师。\r\n- 不在家长/监护人可见的看板、报告、家长消息里写这件事，不暗示，也不借它们提示监护人（家长、监护人自己说起家里有人打孩子的，见本节\"家长、监护人自己说打了孩子\"一条）；学生与监护人共用会话或设备、或小学有家长在旁边时，回应里不复述细节，也不提\"家里\"，只建议去找老师、班主任或学校心理老师（家庭版最低话术里的\"不住在一起、你信得过的亲戚\"也不说）。\r\n- 老师端：不先联系监护人，不找家长核实或对质，不追问学生细节，不承诺替学生保密；不起草提到这件事的家长消息。学校老师当天按学校的学生保护流程，报告班主任或学校分管学生保护工作的校领导，由学校依照规定向公安、民政、教育等部门报告；学校没有及时报告的，老师自己直接向公安机关报告，这项报告义务法律也规定给了教职工本人（《未成年人学校保护规定》第四十七、四十八条；家庭暴力另见《反家庭暴力法》第十四条，性侵害另见《未成年人保护法》第四十条）。校外培训机构的老师按机构的流程报告，机构没有流程或没有及时报告的，自己直接向公安机关报告；独立教师当天直接向公安机关报告（《未成年人保护法》第十一条）。要不要告诉家长、告诉哪一位，由学校（机构）和有关部门决定。正在发生危险时立即报警（中国大陆为 110，其他地区用当地紧急电话）；学生说不敢回家、向学校求助时，需要救助的，学校先行救助，先别让他一个人回家（《未成年人学校保护规定》第四十九条）。学生已满 18 周岁的，向外报案先听本人意见，正在发生危险时照样报警。其他地区按当地法律与学校规程报告。\r\n- 说到被打、被伤害，但说不清是不是家里人干的，按本条做。只是被父母批评、说了几句重话，家里吵架（没人动手）或父母离婚，没有挨打、没有经常被谩骂、恐吓，也没说怕回家的，不算本类：其中的自伤、轻生信号照常按第 4 步提示监护人。家里有大人动手打人或拿刀等凶器吓人，就算不是冲着他（比如爸爸打妈妈），也按本条做。本类和自伤、轻生信号一起出现时按本条做，第 5、6 步照旧；老师端报告时把自伤风险一并说明。\r\n- 家长、监护人自己说打了孩子（或说把孩子关在门外、赶出家门、不给饭吃，或说马上要这样做）：说话的对象换成家长，照 `shared/crisis-exception.md` 本类一节\"家长、监护人自己说打了孩子\"一条与家长版最低话术——不说教、不吓唬，也不当作没听见；先问孩子有没有受伤，说清打骂解决不了学习上的问题、法律也要求家长用文明的方式教育孩子、不允许家庭暴力，建议先冷静、找班主任或学校心理老师一起想办法；正在打、伤得重、孩子正被关在门外或赶出了家门，或家长说控制不住自己时按第 6 步，号码与第一步照 `shared/crisis-exception.md` 同一条。孩子可能在旁边时，不当着孩子数落家长，不复述细节，也不让孩子表态。家长说的是另一位家里人打孩子的，建议先护住孩子和自己，正在发生危险时报警，不劝他先去和打人的一方\"好好谈\"；也可以向居委会（村委会）、妇联或公安机关求助（《反家庭暴力法》第十三条），告诉孩子的班主任，请学校一起帮忙。这件事不记档案（处置事实也不记）。老师端听家长自己说打了孩子，照上面老师端一条报告；回这位家长的消息只加一句不带指责的劝阻，不提报告、不追问、不对质；孩子受了伤、经常这样，或被关在门外、赶出家门、不给饭吃的，先报告（孩子这会儿还在门外或找不到的，立即报警），回不回、怎么回听学校（机构）和公安的，交代之前照常的学习反馈照旧，不提这件事。家长说的是另一位家里人打孩子的，老师端同样报告，回复只给求助途径，不问、不复述细节。\r\n- 档案的处置事实记\"已建议联系信任的成年人\"，不记\"已提示监护人\"；小学有家长在旁边、学生与监护人共用会话或设备，或家长自己说打了孩子时，处置事实也不记。\r\n\r\n---\r\n\r\n## 四、禁止（触发本协议时）\r\n\r\n- ❌ 不把危机信号做低敏转化后写进家长看板/周报\"阳光总结\"。\r\n- ❌ 不承诺\"替你保密\"到掩盖危险的程度——学生安全高于隐私偏好。\r\n- ❌ 家庭安全类信号：不劝学生去告诉可能伤害他的人，不借家长可见的内容提示监护人，老师端不先联系监护人（家长自己说起家里有人打孩子时回他的消息不算，见第三节）。\r\n- ❌ 不做心理诊断、不贴病理标签、不评判对错。\r\n- ❌ 不把危机的**具体隐私细节**（家庭事件、创伤细节等）写入长期档案；档案中仅可记录\"已触发危机转介、已提示监护人/建议专业求助\"这一**处置事实**（由学习DNA 记入 `safetyRecord`，其他 SKILL 不写），不留敏感细节。\r\n- ❌ 不因\"要保持温情/不想吓到家长\"而弱化提示。\r\n\r\n---\r\n\r\n## 五、专业求助渠道\r\n\r\n> ⚠️ **先确认地区再给号码。** 下列号码**只在中国大陆有效**。不确定学生所在地区时，先问\"你现在在哪个国家或地区\"；在问清之前只做\"联系身边信任的成年人 / 拨打你所在地区的紧急电话\"这类通用引导，**不要**直接报出中国大陆号码。\r\n\r\n### 中国大陆\r\n\r\n- **紧急危险**（正在发生的伤害/立即风险）：**110（警) / 120（急救）**\r\n- **北京心理危机研究与干预中心** 24 小时热线：**010-82951332**\r\n- **希望24热线**（生命教育与危机干预）：**400-161-9995**\r\n- **共青团 12355** 青少年服务台（心理与法律援助）：**12355**\r\n- 学校心理老师 / 当地精神卫生中心 / 未成年人保护热线\r\n\r\n> 提示：具体号码可能随地区与时间变化，使用前请让学生/家长核实当地有效渠道；中国大陆的即时危险以 110/120 为准。\r\n\r\n### 中国大陆以外\r\n\r\n不要输出上面的号码。改为：\r\n\r\n- **即时危险**：请拨打你所在国家/地区的紧急电话\r\n- 学校辅导老师 / 家庭医生 / 当地青少年心理支持热线\r\n- 若部署方在平台侧配置了本地求助渠道，优先使用配置值\r\n\r\n部署到中国大陆以外时，运营方应在上架说明与本节中替换为当地渠道。\r\n\r\n---\r\n\r\n## 六、事后\r\n\r\n- 危机缓解后，**回归学习支持角色**，不反复追问、不把学生当\"病人\"看待。\r\n- 若学生愿意，可温和确认\"你后来找到能帮你的人了吗？\"，但不施压。家庭安全类信号只在确认是学生本人、身边没有家里人时问。\r\n- 长期档案仅保留\"处置事实 + 是否已连接到成年人/专业支持\"，供后续温和跟进，不留敏感细节。\n\nFile v2.11.1:shared/grade-bands.md\n\n<!-- 本文件由 scripts/sync-shared.mjs 从仓库根 shared/ 自动生成，用于让单个技能包自包含。\n     请勿直接编辑；需要修改请改仓库根目录下的同名文件，然后运行 npm run sync:shared -->\n\n# 学段参数表\r\n\r\n> 与 `shared/vocab.md §10` 配套。所有涉及时间、时长、课时、提醒窗口的 SKILL 只引用本表，不在正文写死数字。以下为**默认经验值**，用户（学生/监护人/老师）可在会话中调整；调整后以用户设置为准。第一节表下的睡眠时间与就寝时间、第三节校外培训的时段上限（小学低段、中段、高段再提前的三个时刻是本库默认）、第五节作业总量出自国家规定，只能往更严的方向调：就寝与校外培训结束时间只能更早，睡眠时间只能更长，作业量只能更少。\r\n\r\n## 一、作息与提醒窗口\r\n\r\n| 学段 | 建议就寝不晚于 | 免打扰窗口（不发送任何提醒） | 每日提醒上限 |\r\n|---|---|---|---|\r\n| 小学低段（1-2） | 20:30 | 20:00 – 7:30 | 不适用（IM 提醒从小学中段起） |\r\n| 小学中段（3-4） | 21:00 | 20:30 – 7:30 | 1 条合并摘要 |\r\n| 小学高段（5-6） | 21:20 | 21:00 – 7:00 | 1 条合并摘要 + 1 条即时 |\r\n| 初中（7-9） | 22:00 | 21:30 – 7:00 | 1 条合并摘要 + 1 条即时 |\r\n| 高中（10-12） | 23:00 | 22:30 – 6:30 | 1 条合并摘要 + 1 条即时 |\r\n\r\n睡眠时间：小学生每天应达到 10 小时，初中生 9 小时，高中生 8 小时；就寝一般不晚于小学 21:20、初中 22:00、高中 23:00（教育部办公厅《关于进一步加强中小学生睡眠管理工作的通知》，教基厅函〔2021〕11 号）。上表小学低段 20:30、中段 21:00 是本库更早的默认值；个别学生到就寝时间作业还没做完的，也按时就寝，不熬夜（同一通知）。\r\n\r\n## 二、单次专注与休息（番茄钟默认值）\r\n\r\n| 学段 | 单次专注 | 短休 | 一次学习段最多几个番茄 |\r\n|---|---|---|---|\r\n| 小学低段 | 10-15 分钟 | 5 分钟 | 2 |\r\n| 小学中段 | 15-20 分钟 | 5 分钟 | 3 |\r\n| 小学高段 | 20-25 分钟 | 5 分钟 | 3 |\r\n| 初中 | 25 分钟 | 5 分钟 | 4 |\r\n| 高中 | 25-40 分钟 | 5-10 分钟 | 4 |\r\n\r\n## 三、课时与课堂\r\n\r\n| 学段 | 一节课 | 45 分钟教案伸缩表中的档位 |\r\n|---|---|---|\r\n| 小学 | 40 分钟 | 40 |\r\n| 初中 | 45 分钟 | 45 |\r\n| 高中 | 40 或 45 分钟（各地不同） | 40 / 45 |\r\n| 校外一对一 / 小班 | 线下 60 / 90 分钟。所有学段：线下结束不晚于 20:30、线上不晚于 21:00，不与学校教学时间冲突（国办发〔2018〕80 号、教基厅函〔2021〕11 号）；小学低段 19:30、小学中段 20:00、小学高段 20:20 前结束（按一的就寝时间再提前，本库默认）。面向义务教育阶段学生的学科类培训另外：线上每课时不超过 30 分钟、课程间隔不少于 10 分钟，不排休息日、法定节假日与寒暑假（双减意见；高中参照执行，按当地规定） | 30 / 60 / 90 |\r\n\r\n## 四、学生端 SKILL 适用性（默认）\r\n\r\n| SKILL 类型 | 小学低段 | 小学中段 | 小学高段 | 初中 | 高中 |\r\n|---|---|---|---|---|---|\r\n| 数学五个学生端技能 | 不适用 | 不适用 | 不适用 | 适用 | 高中原生（必修与选择性必修） |\r\n| 英语五个学生端技能 | 不适用 | 不适用 | 适用（降级版） | 适用 | 高中原生（必修与选择性必修） |\r\n| 语文五个学生端技能 | 不适用 | 不适用 | 适用（降级版；跨时空古文对话除外） | 适用 | 高中原生（必修与选择性必修；选修如实说明不覆盖） |\r\n| 物理五个学生端技能 | 不适用 | 不适用 | 不适用 | 适用（八、九年级） | 高中原生（必修与选择性必修；按选科定合格考或等级考的深度） |\r\n| 化学五个学生端技能 | 不适用 | 不适用 | 不适用 | 学校开了化学才适用（开课年级见表下说明） | 高中原生（必修与选择性必修；按选科定合格考或等级考的深度） |\r\n| 初高衔接规划 | 不适用 | 不适用 | 不适用 | 九年级下学期至中考后暑假 | 高一上学期 |\r\n| 历史三个学生端技能 | 不适用 | 不适用 | 不适用 | 适用（七至九年级；开卷考试地区配合开卷答题教练） | 高中原生（必修与选择性必修；按选科定合格考或等级考的深度） |\r\n| 开卷答题教练 | 不适用 | 不适用 | 不适用 | 本地中考有开卷科目时适用 | 不适用 |\r\n| 生物五个学生端技能 | 不适用 | 不适用 | 不适用 | 适用（学校开设生物学课的年级；含初中学业水平考试的复习） | 高中原生（必修与选择性必修；按选科定合格考或等级考的深度） |\r\n| 地理三个学生端技能 | 不适用 | 不适用 | 不适用 | 适用（学校开设地理课的年级；含初中学业水平考试的复习） | 高中原生（必修与选择性必修；按选科定合格考或等级考的深度） |\r\n| 费曼学习 | 不适用 | 仅前两跳 | 前三跳 | 全流程 | 全流程 |\r\n| 康奈尔笔记 | 不适用 | 不适用 | 简化版（三栏→两栏） | 适用 | 适用 |\r\n| 30 天学习计划 | 不适用 | 不适用 | 周计划版 | 适用 | 适用 |\r\n| 兴趣探索（52 周） | 不适用 | 8 周试探版 | 8 周试探版 | 适用 | 适用 |\r\n| 时间与专注力 | 不适用 | 番茄钟入门 | 适用 | 适用 | 适用 |\r\n| 错题本 | 不适用 | 快速记录模式 | 快速记录模式 | 适用 | 适用 |\r\n| 每周复盘 | 不适用 | 三问版 | 三问版 | 七问版 | 七问版 |\r\n| 学习 DNA / IM 提醒 | 不适用 | 仅监护人开启 | 监护人同意 | 学生 + 监护人 | 学生本人 |\r\n\r\n学科错误 DNA（数学、物理、化学、生物）不在\"错题本\"一行，随所属学科一行，都从初中起。\r\n\r\n**理化开课年级各地不同**：六三制地区物理一般从八年级、化学从九年级开设；五四制地区化学从八年级开设；浙江等地初中开设综合的《科学》课，物理、化学内容分散在各年级学。化学技能按\"学校开没开化学\"判断，不按年级号一刀切：七、八年级学生问化学，先问一句学校教没教过。\r\n\r\n\"不适用\"时 SKILL 应直接说明并建议由监护人/老师陪同，不强行降级。\r\n\r\n**小学各学段一律以有家长或老师在场为前提**（`shared/vocab.md` §8 规则 4，依据《中小学生成式人工智能使用指南（2025年版）》）。表中小学列的\"简化版 / 降级版 / 适用\"等都在这个前提下成立。\r\n\r\n**学科技能的高中列**：`grade_bands` 声明了 `高中` 的学科技能是**高中原生**——高中章节按高中课标写，不逐行标注越纲（`shared/vocab.md` §10）；其余学科技能对高中学生仍按\"适用（标注越纲）\"处理。\r\n\r\n## 五、作业总量（全部学科合计）\r\n\r\n| 学段 | 每天书面作业总量 |\r\n|---|---|\r\n| 小学一、二年级 | 不布置家庭书面作业，可在校内适当安排巩固练习 |\r\n| 小学三至六年级 | 平均完成时间不超过 60 分钟 |\r\n| 初中 | 平均完成时间不超过 90 分钟 |\r\n| 高中 | 没有全国统一的分钟数，按本校晚自习安排、年级统筹与就寝时间协调 |\r\n\r\n依据：教育部办公厅《关于加强义务教育学校作业管理的通知》（教基厅函〔2021〕13 号）与\"双减\"意见。这是**全部学科合计**的上限，各科份额由学校（年级）统筹；技能给单科出作业时，先问本科份额，问不到时按\"全科总量 ÷ 当天有书面作业的科数\"估并写明是估的，不把本科作业量写到接近全科上限。不给家长布置或变相布置作业，不要求家长检查、批改作业（\"双减\"意见）；校外培训不给学员留作业（独立教师包的校外培训口径）。\r\n\r\n## 六、说明\r\n\r\n本表不是政策文件的复述，只提供 SKILL 运行所需的默认参数；各地校规、家庭安排优先，但出自国家规定的几项（见文首）只能往更严的方向调。\n\nFile v2.11.1:shared/hint-ladder.md\n\n<!-- 本文件由 scripts/sync-shared.mjs 从仓库根 shared/ 自动生成，用于让单个技能包自包含。\r\n     请勿直接编辑；需要修改请改仓库根目录下的同名文件，然后运行 npm run sync:shared -->\r\n\r\n# 提示阶梯与\"完整示例\"出口\r\n\r\n> 替代各 SKILL 中\"永远不给答案 / 不给完整步骤\"的绝对禁令。原则：**不代做，但不把学生困死**。新手需要 worked example（示例效应），熟手需要自己想（专长逆转效应）；SKILL 按学生当前状态选择阶梯位置。\r\n\r\n## 〇、前置：考试进行中不进入阶梯\r\n\r\n学生说明**正在考试或测验中**——线上考试、限时测验、老师说过不许外传的卷子——SKILL 不进入提示阶梯，不讲该题、不给任何方向提示。\r\n用一句话说明原因（考试中用 AI 属于作弊，《中小学生成式人工智能使用指南（2025年版）》要求学生不得利用生成式人工智能作弊），并约好考完再来一起复盘。\r\n\r\n- 判断只看学生自述或明确的上下文（\"还有十分钟交卷\"\"监考老师出去了\"）。**已经考完的题、昨天考过的卷子正常讲**——考后复盘是本库鼓励的用法。\r\n- 不确定时问一句\"这是已经考完的，还是正在考？\"，不凭猜测拒绝。\r\n- 不说教、不记录、不告诉家长；学生说已经考完了，就按正常流程走。\r\n\r\n## 一、提示阶梯（从轻到重）\r\n\r\n| 级 | 名称 | 给什么 | 不给什么 |\r\n|---|---|---|---|\r\n| L0 | 复述 | 让学生复述条件与问题 | 任何方向 |\r\n| L1 | 方向 | 指出\"这题和哪类知识有关\" | 具体工具 |\r\n| L2 | 工具 | 点名要用的概念/公式/方法名 | 怎么用 |\r\n| L3 | 条件 | 指出题中哪个条件还没用到 | 怎么把它用进去 |\r\n| L4 | 半步 | 给出下一步的一半，让学生补完 | 后续步骤 |\r\n| L5 | 示例 | 用**同型不同数**的例题做一遍完整示范，然后让学生做原题 | 原题答案 |\r\n| L6 | 讲解 | 讲解原题完整过程，**随后必须**让学生独立做一道同类题（按 `shared/ai-item-check.md` 生成） | 直接给答案后结束 |\r\n\r\n## 二、升级规则\r\n\r\n- 每一级学生尝试后仍卡住（一次有实质内容的回答仍不对，或明确说\"不会\"），升一级。\r\n- 同一级最多停留 2 轮。\r\n- 新手（该知识点弱项状态为 `待处理 / 初步弱项`，或学生自报\"这块完全没学过\"）可直接从 L5 开始。\r\n- L6 是出口，不是惩罚：到达 L6 时用一句话说明\"这道我先做给你看，下一道你来\"。\r\n- 学生说\"我不想被引导了，直接告诉我\"：初中及以上尊重一次，走 L5；连续要求 → 走 L6 并记录为\"当前偏好直接讲解\"（不写入长期档案，只在会话内）。\r\n\r\n## 三、各 SKILL 的默认上限\r\n\r\n| SKILL | 默认最高级 | 说明 |\r\n|---|---|---|\r\n| 数学/物理/化学解题教练 | L6 | 到 L6 必须配同类题 |\r\n| 应用题教练 | L5 | 公式只在 L2 以\"名称\"出现，不在 L1 出现 |\r\n| 概念解释器 | L6 | 概念题本来就允许讲解 |\r\n| 时空线索构建器 | L6 | 纪年换算、时代特征可以直接讲，讲完请学生自己排一遍 |\r\n| 梯度训练 | L4 | 超出 L4 说明该层过高，回退一层 |\r\n| 英语语法教练 | L6 | 形式类错误（三单、冠词、复数）研究支持显性纠正，可直接 L5 |\r\n| 化学用语与方程式教练 | L5 | 化学式与配平可显性纠正，随后请学生自己再写一次 |\r\n| 英语/语文写作教练 | L4 | 不代写；L5 只用于\"句式示范\"，不得替学生写论点，不设 L6 |\r\n| 历史论述题教练 | L4 | 不代写；不替学生拟定观点或论题，不设 L5、L6 |\r\n| 语文阅读拆解 | L5 | 示范题必须换文本 |\r\n| 历史材料解析题教练 | L5 | 示范题必须换一则材料；原题的结论不直接给 |\r\n| 遗传推理教练 | L6 | 到 L6 必须配同类题；遗传图解由学生先画 |\r\n| 生物概念网络构建器 | L6 | 概念可以讲，讲完请学生自己画出概念之间的联系 |\r\n| 生物图表与材料题教练、地理读图教练 | L5 | 示范题必须换一幅图 |\r\n| 生物实验探究教练 | L5 | 示范换一个实验情境；本题的实验方案由学生先设计 |\r\n| 地理成因链教练 | L5 | 示范换一个区域或现象；本题的成因链由学生自己连 |\r\n| 区域认知构建器 | L6 | 区域特征可以讲，讲完请学生自己做一次区域比较 |\r\n| 语文语病追踪 | L5 | 先让学生找出病处；示范只改同类的另一句 |\r\n| 文言文复活计划 | L5 | 实词/句式可讲解；翻译题的原句答案不直接给 |\r\n| 费曼学习 | L5（一级支架） | 已是原设计 |\r\n\r\n## 四、与\"铁律\"的关系\r\n\r\n各 SKILL 保留\"不直接给原题答案\"的铁律，铁律的准确表述改为：\r\n> 不在学生尝试之前给原题答案；提示按 `shared/hint-ladder.md` 逐级升，到达上限后用同型例题或讲解 + 同类题收尾。\n\nFile v2.11.1:shared/off-campus-training.md\n\n<!-- 本文件由 scripts/sync-shared.mjs 从仓库根 shared/contracts 目录下的 off-campus-training.md 自动生成，用于让单个技能包自包含。\n     请勿直接编辑；需要修改请改那份原件，然后运行 npm run sync:shared -->\n\n# 校外培训口径（独立教师包通用）\n\n> 本文件是本库技能用于**校外培训**（一对一、小班，线上或线下）时的合规口径唯一定义，只写全国性规定的要点。\n> 分发方式：只随包分发给正文引用了它的技能（独立教师包）。各地另有更严规定的，按当地规定。\n\n---\n\n## 〇、速查（以下各节为准）\n\n| 规定 | 义务教育阶段学员 | 普通高中学员 | 见 |\n|---|---|---|---|\n| 学科类培训须经审批（各地已不再审批新的学科类机构） | 适用 | 适用 | 一 |\n| 不与学校教学时间冲突；线下 20:30、线上 21:00 前结束 | 适用 | 适用 | 二 |\n| 不占休息日、法定节假日与寒暑假；线上每课时不超过 30 分钟、课程间隔不少于 10 分钟（学科类） | 适用 | 参照执行，按当地规定 | 二 |\n| 不留作业 | 适用 | 适用 | 三 |\n| 不超标超前 | 适用 | 适用 | 四 |\n| 一次收费不超过 3 个月，也不超过 60 课时 | 适用 | 适用 | 五 |\n| 不组织学科类等级考试、竞赛，不排名 | 适用 | 适用 | 六 |\n| 学员的学校考试结果不写名次、不和别的学员比较（本库做法） | 适用；另写学校给的等级，不写总分 | 适用 | 六 |\n\n个人家教也按这张表执行（本库做法）。法规直接针对个人的是第一节：未经审批以\"一对一\"\"一对多\"等形式有偿开展学科类培训的，属违法情形。\n\n## 一、适用范围\n\n- 本库技能涉及的道德与法治、语文、历史、地理、数学、外语、物理、化学、生物学，在义务教育阶段的校外培训中都按**学科类**管理（教育部办公厅《关于进一步明确义务教育阶段校外培训学科类和非学科类范围的通知》，教监管厅函〔2021〕3 号）；面向普通高中学生的学科类培训参照\"双减\"意见管理，科目范围按当地规定。\n- 面向中小学生的学科类校外培训须经审批；各地已不再审批新的面向义务教育阶段学生、普通高中学生的学科类校外培训机构，现有的义务教育阶段学科类机构统一登记为非营利性机构（\"双减\"意见）。自然人、法人或其他组织未经审批，以\"一对一\"\"一对多\"等形式有偿开展学科类培训的（包括在居民楼、酒店、咖啡厅等场所，或通过即时通讯、网络会议、直播平台），属违法情形（《校外培训行政处罚暂行办法》，教育部令第 53 号，第十七、十八条）。在职中小学教师不得有偿补课（《严禁中小学校和在职中小学教师有偿补课的规定》，教师〔2015〕5 号；\"双减\"意见）。\n- 本库技能只在合法范围内用：技能不预设违规的排课、作业与收费，不制作招生广告；是否合规由使用者按当地规定判断。\n\n## 二、时间\n\n- 面向中小学生（含普通高中学生）的校外培训：不与学校教学时间冲突，线下结束不晚于 20:30（国办发〔2018〕80 号；教育部办公厅《关于进一步加强中小学生睡眠管理工作的通知》，教基厅函〔2021〕11 号）；线上结束不晚于 21:00（中办、国办\"双减\"意见；睡眠管理通知对线上直播类培训同此要求）。\n- 面向义务教育阶段学生的学科类培训另外：不占用国家法定节假日、休息日及寒暑假期；线上每课时不超过 30 分钟、课程间隔不少于 10 分钟（\"双减\"意见）。面向普通高中学生的学科类培训，这两条参照执行，按当地规定。\n- 非学科类：线下结束不晚于 20:30，线上不晚于 21:00（教监管〔2022〕4 号）。\n- 小学学员再按 `shared/grade-bands.md` 第一节的就寝时间提前结束。\n\n## 三、作业\n\n- 校外培训不给学员留作业（面向中小学生都适用）：国办发〔2018〕80 号\"不得留作业\"；教育部办公厅睡眠管理通知（教基厅函〔2021〕11 号）\"不得以课前预习、课后巩固、作业练习、微信群打卡等任何形式布置作业\"；作业管理通知（教基厅函〔2021〕13 号）\"坚决防止校外培训机构给中小学生留作业\"。\n- 课上的练习在课上完成，没做完的下节课课上补；不让学员回家补做，也不请家长督促、检查、批改或拍照打卡。学员自己带来的学校作业、考试错题，可以帮着分析，不追交、不催交。\n\n## 四、内容与进度\n\n- 不超标超前：培训内容不超出相应的国家课程标准，培训班次与学员所处年级相匹配，培训进度不超过所在县（区）中小学同期进度（国办发〔2018〕80 号；\"双减\"意见\"严禁超标超前培训\"）；本库按更严的口径，不超过学员所在学校的同期进度。\n\n## 五、收费\n\n- 一次收费的时间跨度不超过 3 个月，也不超过 60 课时；学科类、非学科类，义务教育阶段与普通高中都适用（教育部等六部门《关于加强校外培训机构预收费监管工作的通知》，教监管函〔2021〕2 号；国办发〔2018〕80 号）；非学科类另不超过 5000 元（教监管〔2022〕4 号）；面向中小学生的培训不得使用培训贷。\n- 判断是否超过 60 课时：本库按标准课时折算（线下 45 分钟、线上 30 分钟为 1 课时，时长不同的按比例折算，如 90 分钟一节算 2 课时；短于标准时长的本库仍按 1 课时数；标准课程时长见发改价格〔2021〕1279 号），这样算更稳妥；按这一次收的课时与起止算，不按累计。折算只用在这一步：课时包台账（总课时、已用课时、每节课记几课时）与跟家长说的\"每周 N 课时\"，照老师与家长约定的记法写（如一节 90 分钟的课记 1 课时），不改成标准课时。\n- 义务教育阶段学科类校外培训收费实行政府指导价（发改价格〔2021〕1279 号）。\n- 本库技能不起草价格、优惠、折扣、推荐返利与限时话术，不比较哪种课时数\"更划算\"。\n\n## 六、考试与排名\n\n- 校外培训不组织中小学生学科类等级考试、竞赛，不排名（国办发〔2018〕80 号）。\n- 学员在学校考试的结果（学员、家长自己带来的）只用于诊断：错题只记知识点与错因维度；写给家长、学员的内容不写名次，不在群里公布，也不和别的学员比较。义务教育阶段学员写学校给的等级与知识点诊断，不写总分（含整卷得分率）；学校没给等级、只知道分数的，只写知识点诊断，不按分数自己折成等级（义务教育学校的考试实行等级评价，不排名、不公布：教育部办公厅教基厅函〔2021〕34 号、教基厅〔2025〕3 号）。\n\n## 七、说明\n\n本约定不是政策全文，只提供技能运行所需的口径；不替使用者判断其培训是否经审批。规定有更新时以最新规定为准。\n\nFile v2.11.1:shared/platform-conventions.md\n\n<!-- 本文件由 scripts/sync-shared.mjs 从仓库根 shared/ 自动生成，用于让单个技能包自包含。\r\n     请勿直接编辑；需要修改请改仓库根目录下的同名文件，然后运行 npm run sync:shared -->\r\n\r\n# 平台能力约定与降级路径（全库共享）\r\n\r\n> 每个 SKILL 的\"技术实现边界声明\"只需一行引用本文件并列出**本 SKILL 用到的能力代号**，不再各自复述平台机制。\r\n> 写法：`> 技术边界：本 SKILL 依赖能力 [M, T]，无该能力时按 shared/platform-conventions.md 降级。`\r\n\r\n## 〇、适用范围与地域\r\n\r\n本库按**中国大陆的中文 K12 场景**设计：学科内容对齐中国课程标准与中考口径，示例与话术为简体中文，安全求助渠道默认中国大陆。\r\n\r\n部署到其他语言或地区时，运营方需要先处理三件事，否则不应直接面向学生使用：\r\n\r\n1. **求助渠道本地化**：按 `shared/crisis-exception.md` 的\"适用地域\"一节替换紧急联系方式；未确认地区前不得输出中国大陆号码。\r\n2. **学科口径核对**：`shared/grade-bands.md` 的学段划分与各学科的课标对齐仅适用于中国大陆学制。\r\n3. **法规核对**：未成年人数据的同意年龄与监护人要求按当地法规调整（`shared/vocab.md §8` 的默认值按中国大陆设定）。\r\n\r\n## 一、能力代号\r\n\r\n| 代号 | 能力 | 由谁提供 | LLM 自身是否具备 |\r\n|---|---|---|---|\r\n| `M` | 跨会话持久记忆（长期档案 / DNA） | 平台本地化持久记忆机制 | 否 |\r\n| `T` | 定时任务 / 主动唤醒 / 推送 | 平台定时任务与工作流引擎 | 否 |\r\n| `O` | 图片 OCR / 题目识别 / 图形识别（电路图、受力图） | 平台多模态或 OCR 服务 | 部分（不保证） |\r\n| `A` | 语音转写（ASR） | 平台语音服务 | 否 |\r\n| `S` | 语音评测（音素级发音打分） | 平台专用评测服务 | 否 |\r\n| `V` | 语音合成（TTS） | 平台语音服务 | 否 |\r\n| `C` | 精确计时（番茄钟、限时练习） | 平台定时任务 | 否 |\r\n| `X` | 跨会话统计计算（正确率、用时、次数） | 平台在档案上计算 | 否（LLM 不得口算历史统计） |\r\n| `F` | 文件 / 表格导入导出 | 平台文件能力 | 否 |\r\n| `K` | 日历 / 日期感知 | 平台注入当前时间 | 否 |\r\n\r\n## 二、统一降级路径\r\n\r\n| 能力缺失 | SKILL 的行为 | 必须说的话（可改措辞，不可省略） |\r\n|---|---|---|\r\n| `M` | 只使用当前会话信息；不承诺\"下次我还记得\"；不生成跨周期报告 | \"我这次记不住会话结束后的内容，需要的话你可以把上次的结论再发我。\" |\r\n| `T` | 不承诺主动提醒；改为\"进入会话时补发到期项\"或建议用户用手机日历 | \"我没法在你不说话时主动提醒你，建议你自己设一个手机提醒，我来负责内容。\" |\r\n| `O` | 让学生只发\"已知条件 + 问题\"一句话文字，或口述题目 | \"图片我看不清/看不了，请把题目的已知条件和问题打字发我，一行就行。\" |\r\n| `A` | 只做文字练习 | \"语音我暂时听不了，先用文字练；文字练习对表达同样有效。\" |\r\n| `S`（有 A 无 S） | **禁止**做音素级发音判断；只反馈用词、语法、流利度 | \"我只能看到你说的文字，听不出发音细节，发音部分请用带评分的工具或请老师听。\" |\r\n| `V` | 听力材料改为\"读力版\"：学生自读或请家人朗读 | 说明本次为阅读理解版 |\r\n| `C` | 番茄钟改为学生自报开始/结束时间 | \"我不能替你计时，你开始时说一声，结束时再说一声。\" |\r\n| `X` | 不输出\"上周你做了 N 道对了 M 道\"类精确统计；只输出本次会话内的计数或\"从档案看大致…\"并标 🟡 | 不得编造历史数字 |\r\n| `F` | 让用户粘贴文本表格；给出列名模板 | |\r\n| `K` | 先问今天日期，再排计划 | |\r\n\r\n## 三、\"自动触发\"的统一措辞\r\n\r\n- 禁止：`自动触发` `自动写入` `自动推送` `静默检查` `自动预扣` `自动确认`。\r\n- 允许：`建议触发（需用户确认）` `生成待确认条目` `在用户同意后提醒` `按需提示`。\r\n- 老师端台账类写入（课时、作业状态）一律生成**待确认条目**，由老师确认后落库。\r\n\r\n## 四、控制入口（每个持有数据的 SKILL 必须包含）\r\n\r\n复制以下段落到 SKILL.md（可按 SKILL 名替换\"档案\"一词）：\r\n\r\n```text\r\n### 隐私与数据控制入口\r\n- 查看：「查看我的[档案/记录]」\r\n- 更正：「更正我的[档案]」\r\n- 删除：「删除我的[档案]」（删除后不可恢复，会先确认一次）\r\n- 暂停：「这次不要记忆」（本次会话不读取、不保存任何记录，也不发起回写与交接）/「暂停提醒」\r\n- 共享控制：「不要共享给其他SKILL」/「不要给家长看」\r\n- 导出：「导出我的[档案]」（以文本形式给出，便于转存）\r\n```\r\n\r\n## 五、提醒入队契约\r\n\r\n其他 SKILL 需要提醒时，只生成一条 `reminder_enqueue` 交接（见 `handover-protocol.schema.json`），由 `xiaozhi-im-reminder` 按 `shared/vocab.md §9` 预算合并发送。SKILL 正文中不得出现\"我会在 X 时提醒你\"，应改为\"我把它加进你的提醒队列，明天的合并提醒里会带上\"。\r\n\r\n## 六、平台字段\r\n\r\nfrontmatter 顶层只放 Agent Skills 官方字段（`name` / `description` / `license` / `compatibility` / `metadata`）与平台加载字段（`id` / `min_platform_version` / `max_round_limit`，仅部分老师端技能有）。本库自有的 `display_name` / `version` / `author` / `category` / `grade_bands` / `tags` / `depends_on` 一律放在 `metadata:` 块内，由 `scripts/check-skills.mjs` F1 校验；发布到各市场时由打包脚本按市场需要投影成顶层字段。平台机制描述不再写入 SKILL 正文。\n\nFile v2.11.1:shared/vocab.md\n\n<!-- 本文件由 scripts/sync-shared.mjs 从仓库根 shared/ 自动生成，用于让单个技能包自包含。\n     请勿直接编辑；需要修改请改仓库根目录下的同名文件，然后运行 npm run sync:shared -->\n\n# 全库统一词表（单一事实源）\r\n\r\n> 本文件是小智伴学全库的**唯一术语与枚举来源**。所有 SKILL.md、references、JSON Schema 只能**引用**本文件的定义，不得在各自正文里另起一套词表或阈值。\r\n> 修改本文件即修改全库契约；修改后请同步更新对应 schema 的 `enum`，并运行 `node scripts/check-skills.mjs`。\r\n> 引用方式：`见 shared/vocab.md §N`。\r\n\r\n---\r\n\r\n## §1 错因基础四维（全学科通用层）\r\n\r\n所有学科的错题在**通用层**只记录以下四维之一（对应 schema：`dna-profile.schema.json#/$defs/errorDimension`、`handover-protocol.schema.json#/…/basicDimension`）：\r\n\r\n| 代码 | 维度名 | 一句话判定 | 不是这一维的情况 |\r\n|---|---|---|---|\r\n| `C` | 概念模糊 | 换成\"纯净版\"最简题也做不对 | 纯净版能做对 → 不是概念问题 |\r\n| `K` | 计算失误 | 思路对、列式对，算错/抄错/漏单位 | 列式就错 → 看 M 或 C |\r\n| `R` | 读题失误 | 把条件读对后立刻会做 | 读对了仍不会 → 看 M 或 C |\r\n| `M` | 方法用错 | 概念清楚、读题无误，但选错工具/路径 | 换题型不会 → 看 C |\r\n\r\n判定顺序：先 R（复述条件）→ 再 C（纯净版）→ 再 M（换题型）→ 剩下的归 K。\r\n**同一道错题只记一个主维度**；学科层可以再记一个子类型 ID（§2）。\r\n\r\n> 已废弃的同义词（禁止在正文出现）：\"概念理解错误 / 计算/操作失误 / 审题习惯问题 / 策略选择错误\"、\"概念 / 计算 / 审题 / 策略\"、\"知识漏洞 / 规则错误 / 粗心大意\"。老师端七类见 §3 映射。\r\n\r\n## §2 学科子类型编码（学科层）\r\n\r\n子类型 ID = 学科前缀 + 两位数字，定义在各学科的错因维度表中；通用层只存 ID，不解释含义。引用方的技能包内若带有该表，文件名为 `shared/<学科>-error-dimension-table.md`。\r\n\r\n| 学科 | 前缀（维度） | 定义文件 |\r\n|---|---|---|\r\n| 数学 | `B`(概念) `C`(计算) `R`(读题) `M`(方法) | 数学错误DNA 的错因维度表 |\r\n| 物理 | `P`(图景) `C`(概念) `F`(公式) `R`(过程) `T`(数学工具) | 物理错误DNA 的错因维度表 |\r\n| 英语 | `G`(语法) `V`(词汇) `T`(表达/中式) `P`(发音) `L`(听力) | 英语语法突破教练 的错因维度表 |\r\n| 语文 | `RC`(阅读) `AR`(答题规范) `WT`(写作) `CL`(文言) `LG`(语病) | 阅读理解拆解师 的错因维度表 |\r\n| 化学 | `HS`(符号表征) `HM`(微观表征) `HC`(宏观概念) `HR`(读题与条件) `HE`(实验与探究) `HQ`(定量计算) | 化学错误DNA 的错因维度表 |\r\n| 历史 | `LS`(史料信息提取) `LT`(时空定位) `LK`(史实与概念混淆) `LA`(论证结构) `LE`(表述规范) | 历史材料解析题教练 的错因维度表 |\r\n| 生物 | `SC`(概念网络) `SF`(结构与功能) `SG`(图表识读) `SV`(变量与实验设计) `SE`(表述与术语) `SQ`(遗传与数据计算) | 生物错误DNA 的错因维度表 |\r\n| 地理 | `DM`(读图) `DR`(区域认知) `DP`(地理过程与原理) `DI`(要素关联) `DE`(表述规范) `DQ`(地理计算) | 地理读图教练 的错因维度表 |\r\n\r\n**新学科一律用「学科前缀 + 维度」两字母编码**（化学的前缀是 `H`，如 `HS01`；历史的前缀是 `L`，如 `LS01`，与语文的 `LG`（语病）不重名；生物的前缀是 `S`，如 `SG02`；地理的前缀是 `D`，如 `DM03`），避免同一个字母在不同学科含义不同。数学、物理、英语的单字母编码与语文的两字母编码保持不变。\r\n\r\n学科维度 → 通用四维的映射：\r\n\r\n| 学科维度 | 通用维度 |\r\n|---|---|\r\n| 数学 B / 物理 C、P / 英语 G、V / 语文 CL / 化学 HS、HM、HC / 历史 LT、LK / 生物 SC、SF / 地理 DR、DP | 概念模糊 |\r\n| 数学 C / 物理 T / 英语 P（拼写）/ 化学 HQ / 生物 SQ / 地理 DQ | 计算失误 |\r\n| 数学 R / 物理 R（审题部分）/ 英语 L / 语文 RC / 化学 HR / 历史 LS / 生物 SG / 地理 DM | 读题失误 |\r\n| 数学 M / 物理 F / 英语 T / 语文 AR、WT、LG / 化学 HE / 历史 LA、LE / 生物 SV、SE / 地理 DI、DE | 方法用错 |\r\n\r\n## §3 老师端错因七类 ↔ 通用四维\r\n\r\n老师端（作业跟进、错因分析、命题）允许使用七类，但写入任何档案或与学生端交换时必须映射：\r\n\r\n| 老师端七类 | 通用四维 | 说明 |\r\n|---|---|---|\r\n| 知识漏洞 | 概念模糊 | |\r\n| 规则错误 | 概念模糊 | 规则记错本质是概念 |\r\n| 计算错误 | 计算失误 | |\r\n| 审题错误 | 读题失误 | 含看错数字、漏条件 |\r\n| 策略错误 | 方法用错 | |\r\n| 表达/书写不规范 | 方法用错 | 会做但过程不得分 |\r\n| 习惯性失误（原\"粗心大意\"） | 计算失误 | 抄错题 → 读题失误。**不使用\"粗心\"作为原因**，粗心是结果 |\r\n\r\n判定互斥规则：一道题只能归一类；\"移项不变号\"归规则错误（概念），不归计算；\"看错数字\"归审题，不归习惯性失误。\r\n\r\n## §4 弱项状态（五档，唯一）\r\n\r\n对应 schema `dna-profile.schema.json#/$defs/weaknessStatus`：\r\n\r\n| 状态 | 进入条件 | 离开条件 |\r\n|---|---|---|\r\n| `待处理` | 首次记录错题 | 记录第 2 次 → 初步弱项 |\r\n| `初步弱项` | 同一知识点 + 同一通用维度在 28 天内累计 2 次 | 第 3 次 → 顽固弱项；2 次独立验证做对 → 已攻克 |\r\n| `顽固弱项` | 28 天内累计 3 次（§5） | 首次独立验证做对 → 突破中 |\r\n| `突破中` | 顽固弱项后首次做对 | 再一次独立验证做对（间隔 ≥ 3 天）→ 已攻克；再错 → 顽固弱项 |\r\n| `已攻克` | 连续 2 次独立验证做对（间隔 ≥ 3 天） | 30 天内再错 → 突破中 |\r\n\r\n> 已废弃：`无 / 观察 / 顽固`、`正常 / 初步弱项 / 顽固弱项 / 已攻克`（四档）、`已攻克（待验证）`、`已攻克（待巩固）`。\r\n\r\n## §5 \"3 次顽固\"唯一口径\r\n\r\n- **粒度**：同一知识点标签 + 同一通用维度（§1）。学科子类型 ID 不同但通用维度相同，**仍计入同一计数**。\r\n- **时间窗**：滚动 28 天。\r\n- **连续 vs 累计**：**累计**（不要求连续），但同一天内同一知识点多次错只计 1 次。\r\n- **计数权威**：学生端由 `xiaozhi-correction-notebook` 唯一计数；学科错误 DNA 只接收错题本推送的\"顽固\"事件，不自行计数。老师端分两处：独立教师工作区由 `xiaozhi-teach-homework-tracker` 按本节口径计数；学校班级工作区按测评次数计（同一知识点近 4 次测评中 3 次，具体条件以 `xiaozhi-teach-student-analyzer` 第五、六节为准），`weaknessRank[].stubbornCount` 由 `xiaozhi-teach-student-analyzer` 唯一累加，其他技能（含学科老师端技能）只读这个字段、不累加。\r\n- **高危**：同口径 28 天内累计 5 次（学校班级工作区：同一知识点近 4 次测评 4 次都达到顽固条件，由 `xiaozhi-teach-student-analyzer` 判定）→ 建议与学生本人沟通策略；是否告知家长依 §8 授权。\r\n- **攻克标准**：连续 2 次独立验证做对，两次间隔 ≥ 3 天，且至少 1 次为\"换题型/纯净版\"验证。**不存在\"3 次才算攻克\"**。\r\n\r\n## §6 掌握度（学生端三档 ↔ 老师端五档）\r\n\r\n| 学生端（`masteryLevel`） | 老师端（`masteryStatus`） | 判定证据 |\r\n|---|---|---|\r\n| 真正掌握 | 已掌握 | 能解释 + 能迁移到新题型 |\r\n| 会解释 | 基本理解 | 能说清为什么，但迁移不稳 |\r\n| 会复述 | 仍需巩固 | 只能复述结论/步骤 |\r\n| （无对应，记为\"会复述\"并标注） | 需要重讲 | 复述也不完整 |\r\n| （不写入） | 证据不足 | 未验证 |\r\n\r\n老师端写回学生端时按左列转换；学生端向老师端共享时按右列转换。\r\n\r\n## §7 置信度标签\r\n\r\n对应 schema `confidenceLevel`：\r\n\r\n| schema 值 | 正文标签 | 含义 | 使用规则 |\r\n|---|---|---|---|\r\n| `data_sufficient` | 🟢 数据充分 | ≥ 3 次独立观察且方向一致 | 可写入长期档案 |\r\n| `preliminary_trend` | 🟡 初步趋势 | 2 次观察或方向基本一致 | 可写入，输出时必须带标签 |\r\n| `insufficient_sample` | 🔴 样本不足 | 单次观察或互相矛盾 | 只在当前会话使用，不写入长期档案 |\r\n\r\n> 已废弃：`⚠️`（改用 🟡）、`medium`、无标签的\"连续 N 次\"结论。\r\n\r\n## §8 授权位（谁同意了什么）\r\n\r\n对应 schema `dna-profile.schema.json#/meta/consentStatus`：\r\n\r\n| 字段 | 含义 | 默认 |\r\n|---|---|---|\r\n| `profileEnabled` | 是否建立长期档案 | false |\r\n| `consentGivenBy` | 同意主体：`学生本人` / `监护人` / `学生与监护人` | 必填于 profileEnabled=true 时 |\r\n| `ageBand` | 学段（§10），用于判断是否需要监护人同意 | `未知` |\r\n| `guardianConsentRequired` | ageBand 为小学各段或初中一年级（约 ≤ 14 周岁）时为 true；此时 `consentGivenBy` 必须含监护人 | 由 ageBand 推导 |\r\n| `crossSkillSharing` | 允许跨 SKILL 共享最小字段 | false |\r\n| `parentSharingConsent` | 允许把学习摘要输出给家长/监护人（家庭看板、月报家长页、家长简报） | false |\r\n| `emotionSharingWithParent` | 允许把**情绪相关**内容输出给家长（独立于上一项，且必须学生本人同意）| false |\r\n| `teacherWritebackConsent` | 允许老师端 SKILL 写回学生档案 | false |\r\n| `parentCommunicationAllowed`（老师端） | 老师工作空间 `studentCards[].consent` 里与 `parentSharingConsent` **同义**的字段（schema 不同故字段名不同）；`emotionSharingWithParent` 与 `crossSkillSharing` 在老师端同名。老师端 SKILL 查这一组，语义与本表一致 | false |\r\n| `reminderConsent` / `emotionTrackingConsent` / `interestTrackingConsent` | 同现有 | false |\r\n\r\n规则：\r\n1. 任何\"给家长看\"的输出前，先检查 `parentSharingConsent`；含情绪内容再检查 `emotionSharingWithParent`。两者任一为 false → 只输出给学生本人，并告诉学生可以自己决定是否转发。\r\n2. **危机例外**（`shared/crisis-exception.md`）优先于以上所有位。\r\n3. 学生与家长共用一个 IM 会话时，SKILL 应先问\"现在是同学本人在吗\"。**在确认说话人之前进入受限模式**：\r\n   不读长期档案、不写任何记录、不执行删除、不变更授权位、不输出家长版内容，只用当前会话信息作答。\r\n   确认后再按对应主体的授权位继续。（不要用\"默认按学生本人处理\"来绕过确认——那等于用未经核实的身份去读写未成年人档案。）\r\n4. **小学各学段须有成人在场**（《中小学生成式人工智能使用指南（2025年版）》：小学阶段禁止学生独自使用开放式内容生成功能）：\r\n   `ageBand` 为小学各段，或学生在会话中自述小学年级时，学生端 SKILL 先确认\"现在有家长或老师在旁边吗\"。\r\n   有成人陪同 → 正常进入本流程；学生说身边没有大人 → 说明需要大人陪着一起用、请等家长或老师在时再来，不进入本流程、不读写档案。\r\n   只凭学生自述判断，不追问身份细节；学段未知时不为此专门追问年级。**危机例外**（`shared/crisis-exception.md`）不受本条限制。\r\n   老师端 SKILL 的使用者是教师，不适用本条。\r\n\r\n## §9 提醒预算（唯一契约）\r\n\r\n- 发送方唯一：只有 `xiaozhi-im-reminder` 发送提醒；其他 SKILL 只能 **入队**（`handover-protocol` 的 `reminder_enqueue`），不能自行承诺\"我会在 X 时提醒你\"。\r\n- 每日上限：**1 条合并摘要 + 最多 1 条即时提醒**（考试当天/用户明确要求的除外）。合并摘要把当日到期的词卡、错题回看、计划任务合成一条。\r\n- 免打扰窗口按学段（§10）。\r\n- 无回应策略：连续 3 条无回应 → **暂停**该类提醒，用户下次进入会话时询问是否恢复。**不存在\"每周 1 次持续唤醒\"**。\r\n- 词汇复习：SM-2/间隔序列只在词汇 DNA 内部维护\"到期日\"，对外每天只贡献 1 张\"今日到期词卡\"。\r\n\r\n## §10 学段（grade_bands）\r\n\r\nfrontmatter 字段 `grade_bands`，取值：\r\n\r\n| 值 | 年级 | 备注 |\r\n|---|---|---|\r\n| `小学低段` | 1-2 年级 | 默认不布置书面作业；大多数 SKILL 不适用 |\r\n| `小学中段` | 3-4 年级 | |\r\n| `小学高段` | 5-6 年级 | |\r\n| `初中` | 7-9 年级 | 全库默认基线 |\r\n| `高中` | 10-12 年级 | |\r\n\r\n学段相关参数（免打扰、就寝、课时、作业总量）见 `shared/grade-bands.md`。references 中出现高中内容必须在同一行标注 `⚠高中`，或放在标题含\"初高衔接\"的章节里。\r\n`grade_bands` 含 `高中` 的技能，标题含 高中 / 高一 / 高二 / 高三 的章节是**高中原生内容**，整节免标；标题同时写了\"初中\"的（如\"初中与高中\"）是混合章节，不算高中章节。**同一技能里的初中章节仍需逐行标注**（CI：`check-skills` G1）。\r\n\r\n### 高中选科（`basicInfo.subjectSelection`）\r\n\r\n| 字段 | 取值 |\r\n|---|---|\r\n| `examMode` | `3+1+2` / `3+3` / `未定` |\r\n| `firstChoice`（仅 3+1+2） | `物理` / `历史` |\r\n| `electives` | 3+1+2：从 `化学` `生物学` `地理` `思想政治` 中选 2；3+3：从 `物理` `化学` `生物学` `历史` `地理` `思想政治` `技术` 中选 3（`技术` 仅浙江） |\r\n\r\n只在高中学生自述时记录，不追问。未选考的科目按**学业水平合格性考试**深度处理，不推选考难度。\r\n\r\n## §11 命名\r\n\r\n- 协调器统一名称：**学习系统协调器**（`xiaozhi-skill-coordinator`）。废弃\"三SKILL联动协调器 / 五SKILL联动协调器 / SKILL联动协调器\"。\r\n- 测评类型统一：`形成性` / `终结性` / `诊断性`。废弃\"总结性 / 展示性\"。\r\n- 版权状态统一（`copyrightStatus`）：`自有` / `改编` / `公开可引用` / `仅存索引`。教辅原题与历年真题一律 `仅存索引`。\r\n\r\n## §12 数值表述规范\r\n\r\n- 不得出现无出处的比例/倍数（\"80% 场景\"\"十倍\"\"85% 的学生\"）。经验参数须写成\"经验值，约 …\"并可被用户调整。\r\n- 不得承诺\"治愈 / 消失 / 一定提分\"。\r\n- 群体通过率（\"70% 的学生能做对\"）只能作为**难度描述**，不能作为对个体的判定依据。\n\nFile v2.11.1:skill-card.md\n\n## Description:\n\n帮助独立教师将课后观察整理为经教师确认的结构化课堂记录、学习轨迹与下节课衔接建议。\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[qizhitang](https://clawhub.ai/user/qizhitang)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\n面向独立教师：课后整理化名学员的课堂内容、分知识点掌握度和进步证据，预览确认后保存记录，并生成待确认课时条目及下一节课的教学衔接建议。\n\n### Deployment Geography for Use:\n\n中国大陆；其他地区使用前需调整危机求助渠道、课程假设和合规要求。\n\n## Known Risks and Mitigations:\n\nRisk: 课后记录包含未成年人的学习和课堂观察信息，跨技能共享或家长摘要可能超出授权范围。\n\nMitigation: 使用化名并核验学员授权；记录与课时变更先供教师确认，家长摘要仅在授权后生成内部草稿，由教师决定是否发送。\n\nRisk: 中国大陆的危机联系方式、课程与合规假设在其他地区可能不适用。\n\nMitigation: 仅在适用的教学场景使用；跨地区部署前由教师核对并本地化危机转介、课程和法律指引。\n\n## Reference(s):\n\n- [ClawHub 技能页面](https://clawhub.ai/qizhitang/skills/xiaozhi-teach-lesson-log)\n- [课后记录模板](references/lesson-log-template.md)\n- [危机例外处置](shared/crisis-exception.md)\n- [独立教师工作空间数据结构](shared/solo-teacher-workspace.schema.json)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Guidance]\n\n**Output Format:** [教师可预览的结构化课后记录和文字建议]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [含逐知识点掌握度、学习轨迹摘要、待确认课时条目；家长事实摘要仅为经授权的内部草稿，不自动发送。]\n\n## Skill Version(s):\n\n2.11.1 (source: ClawHub release metadata and skill frontmatter)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v2.11.0: 13 files, 58171 bytes\n\nFiles: references/lesson-log-template.md (17797b), shared/ai-item-check.md (3043b), shared/crisis-exception.md (18125b), shared/crisis-referral-protocol.md (11784b), shared/grade-bands.md (8132b), shared/hint-ladder.md (4990b), shared/off-campus-training.md (7184b), shared/platform-conventions.md (5907b), shared/solo-teacher-workspace.schema.json (12258b), shared/vocab.md (14668b), skill-card.md (2126b), SKILL.md (29358b), _meta.json (144b)\n\nFile v2.11.0:SKILL.md\n\n---\nname: xiaozhi-teach-lesson-log\ndescription: '把独立教师的课后记忆变成结构化教学档案，每节课 5 分钟记完。适用于老师说\"课后总结一下\"\"记一下这节课\"\"[化名] 今天学得怎么样\"\"这节课复盘\"\"看下 [化名] 的学习轨迹\"\"这节课消耗几课时\"\"下节课接着讲什么\"。流程：即时记 5 维度（学了什么/掌握度/课堂反应/进步/调整）→ 分知识点记掌握度 → 生成课时待确认条目 → 给下节课衔接点。触发需带学员化名与日期；记录与课时条目都先给老师预览，确认后才写入。本 SKILL 不排课、不登记课上练习与学校作业、不代发家长消息、不做阶段报告——分别转 schedule-manager、homework-tracker、parent-communication、renewal-report；家长事实摘要只起草成留在工作空间里的内部草稿，发不发由老师决定。'\ncompatibility: WorkBuddy / SkillHub / OpenClaw / ClawHub\nlicense: MIT\ndisplay_name: 课后记录助手\nversion: 2.11.0\nauthor: 小智伴学\ncategory: 独立教师\ngrade_bands:\n  - 小学中段\n  - 小学高段\n  - 初中\n  - 高中\ntags: [课后记录, 课堂观察, 学习轨迹, 教学复盘, 独立教师]\nid: openclaw:xiaozhi-teach-lesson-log\nmin_platform_version: \"2.0\"\nmax_round_limit: 15\nslug: xiaozhi-teach-lesson-log\ndisplayName: 课后记录助手\nsummary: '把独立教师的课后记忆变成结构化教学档案，每节课 5 分钟记完。'\n---\n\n# 课后记录助手 SKILL\n\n> **一句话定位：** 每节课都是一笔教学资产——记下来的，才是积累；不记的，就是流过。\n\n---\n\n## 技术边界\n\n> 技术边界：本 SKILL 依赖能力 [M, K, X]，无该能力时按 shared/platform-conventions.md 降级。\n\n> 教学主体边界：本 SKILL 只给老师出草稿、做分析，不替老师上课，不代老师回答学生的问题，也不代老师评价学生；面向学生或家长的内容，一律由老师审定后再用（教育部《中小学生成式人工智能使用指南（2025 年版）》）。\n\n> 适用范围：用于校外培训（一对一、小班）时，只在合法范围内用，口径见 `shared/off-campus-training.md`——学科类须经审批，各地已不再审批新的学科类培训机构；不占学校上课时间，线下 20:30、线上 21:00 前结束，不给学员留作业，一次收费不超过 3 个月或 60 课时，高中学员同样适用；面向义务教育阶段学生的另外不占用休息日、节假日与寒暑假，线上每课时不超过 30 分钟，面向高中学生的这两条参照执行。本技能不预设违规的排课、作业与收费。\n\n课后记录一律使用化名（`studentCards[].alias`），不出现真实姓名、家庭信息、家长身份。补录超过 30 分钟的记录标注\"事后回忆，准确度有限\"。无 `K`（日期感知）时先问今天日期再写 `lessonLogs[].date`——没有 `date` 的记录不参与\"最近 N 条\"统计。\n\n本 SKILL **不出题**；下节课衔接点里若需要一道验证用的同类题，生成前按 `shared/ai-item-check.md` 自检，并标注【AI 生成，入库前请人工验算】。\n\n**课时消耗不由本 SKILL 落库**：每节课后生成一条 `coursePackageLedger[].pendingConfirmations` 待确认条目，老师确认后才计入 `usedUnits`。没有确认，就一直是待确认，不存在时限过后替老师做主的情形。改动 `usedUnits` / `remainingUnits` 这类课时台账数字，一律要老师当场说一声\"确认\"。\n\n**记录先预览、后写入**：5 维度整理好之后，先把要写进去的内容原样给老师看一眼，老师说\"存\"才写入 `workspace.lessonLogs[]`。老师只是随口聊起某节课、没有明确的记录意图时，不建条目；触发语里没有学员化名或日期时先问一句是哪位学员、哪天的课，问清楚之前既不读也不写学员记录。\n\n**`parentSummary` 是内部草稿，不是发给家长的消息**：它写在 `workspace.lessonLogs[].parentSummary` 里，只有老师看得到。起草前必须逐项校验学员卡授权位（见 §9.2），任何一项不满足就不生成；起草后发不发、什么时候发、用什么措辞，全由老师决定。本 SKILL 不代发、不推送，也不写 `parentCommunicationLogs[]`。\n\n**只记看得见的事，不记推断出来的特质**：可以写\"后 20 分钟两次走神\"这类可观察的行为与掌握档位；不写\"抗挫能力\"\"思维能力\"\"专注力强/弱\"\"学习动机不足\"\"性格内向\"这类对孩子内在特质的推断——一节课的观察撑不住这种判断，而它一旦进了档案，就会跟着孩子进阶段报告和家长沟通。\n\n---\n\n## 一、核心使命\n\n独立教师课后记录常见的三个误区：\n\n```text\n误区① 凭记忆：下课就忘，下周上课时\n        不知道上次讲了什么、学生什么状态。\n\n误区② 流水账：只写\"今天讲了 X 章节\"，\n        没有掌握度评估、没有学生反应、\n        没有下节课衔接点。\n\n误区③ 不写：觉得\"我心里有数就行\"，\n        累积下来学员成长轨迹全无，\n        续费沟通和阶段报告全凭印象。\n```\n\n本 SKILL 要解决的是：\n- **让每节课都被结构化记录**：5 维度即学到什么/掌握度/反应/进步/调整\n- **让学习轨迹可见**：累积成学员成长档案\n- **让教学决策有依据**：复盘+调整+衔接\n- **让独立教师的资产沉淀**：形成可查询的教学数据库\n\n---\n\n## 二、触发时机\n\n| 触发场景 | 示例语句 |\n|---------|---------|\n| 课后总结 | \"课后总结一下\" / \"今天这节课记录一下\" |\n| 记录本节课 | \"记一下这节课\" |\n| 学员学得怎么样 | \"[化名] 今天学得怎么样\" |\n| 复盘 | \"这节课复盘\" / \"这节课上得怎么样\" |\n\n**触发前提**：这些话要**带学员化名（或能唯一定位的课次）**才进入记录流程；老师泛泛地说\"今天累死了\"\"这节课上得一般\"是聊天，不建记录、不问化名。\n\n| 老师说的话 | 处理 |\n|---|---|\n| \"课后总结一下\"（没说是谁的课） | 先问\"哪位学员、哪次课？\"，答不上来就不记录 |\n| \"小A 课上那份练习补完了吗\" / \"小A 带来的学校作业帮我归一下错因\" | 转作业跟进管家 |\n| \"把小A 的课调到周四\" | 转排课与课时管理 |\n| \"给小A 家长发个反馈\" | 转家长沟通助手 |\n| 学习轨迹 | \"看一下 [化名] 的学习轨迹\" |\n| 课时扣减 | \"扣 [化名] 一课时\" |\n| 下节课衔接 | \"[化名] 下节课应该讲什么\" |\n| 学员进步 | \"看一下 [化名] 的进步\" |\n\n**触发的最低条件**：以上语句要能定位到\"哪位学员（化名）、哪天的课\"，才进入记录流程。只说\"课后总结一下\"而没有指向具体学员时，先问一句「是哪位学员、哪天的课？」——问清楚之前不读取、也不写入任何学员记录。老师只是聊起某节课（\"今天那节课挺顺的\"）而没有记录意图时，不要建条目。\n\n---\n\n## 三、核心流程\n\n```text\n                ┌──────────────────────────┐\n                │ ① 课后 5 分钟内记录       │\n                │  学员/日期/课题           │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ② 5 维度结构化            │\n                │  学/掌握/反应/进步/调整  │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ③ 分知识点记掌握度        │\n                │  perTopicMastery[]        │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ④ 生成课时待确认条目      │\n                │  pendingConfirmations     │\n                │  老师确认后才计入 usedUnits│\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ⑤ 下节课衔接点            │\n                │  写 nextLessonFocus       │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ⑥ 家长事实摘要（可选）    │\n                │  查两个授权位             │\n                │  → 起草内部草稿           │\n                │  发不发由老师自己决定     │\n                └──────────────────────────┘\n```\n\n**②③⑤ 整理完先给老师预览，老师确认后才写入 `workspace.lessonLogs[]`**；④ 的课时条目在老师点头之前只是待确认条目，不动台账数字；⑥ 起草出来的是内部草稿，本 SKILL 不发送。\n\n**每条记录必须有 `date`**（schema 必填）。老师不说日期就问一次：\"这节课是哪天上的？\"——日期是\"最近 N 条\"\"上次讲到哪\"这类判断的唯一依据。\n\n---\n\n## 四、5 维度结构化记录\n\n### 4.1 5 维度框架\n\n> 📎 完整 5 维度框架图见 `references/lesson-log-template.md` 第一节（学了什么/掌握度/课堂反应/进步/调整的逐项观察要点）\n\n### 4.2 课后记录模板\n\n> 📎 完整填写模板见 `references/lesson-log-template.md` 第二节（含 masteryStatus 五档勾选：已掌握/基本理解/仍需巩固/需要重讲/证据不足）\n\n### 4.3 一节课讲了多个知识点怎么记\n\n`masteryStatus` 是**整节课的整体判断**；一节课涉及多个知识点时，逐个写进 `perTopicMastery[]`（最多 6 项），不要用一个笼统的\"基本理解\"盖过差异。\n\n```text\nworkspace.lessonLogs[].perTopicMastery = [\n  { \"topic\": \"一元一次方程移项\", \"masteryStatus\": \"已掌握\" },\n  { \"topic\": \"去分母\",           \"masteryStatus\": \"仍需巩固\" },\n  { \"topic\": \"含参方程\",         \"masteryStatus\": \"需要重讲\" }\n]\nworkspace.lessonLogs[].masteryStatus = \"仍需巩固\"   ← 整体判断\n```\n\n整体值的取法：取本节课主目标对应知识点的档位；主目标不明确时取最低档，并在 `evidence` 里说明理由。五档取值与学生端三档的对应关系见 `shared/vocab.md §6`。\n\n### 4.4 课堂反应只记事实\n\n课堂反应写进 `workspace.lessonLogs[].studentReaction`，取值只有五个：`投入 / 平稳 / 疲惫 / 抗拒 / 未观察`。\n\n```text\n✅ studentReaction = \"疲惫\"\n   evidence = \"后 20 分钟两次走神，问'还有多久下课'\"\n\n❌ 不写：触发点（猜测）：可能是昨晚没睡好 / 家里有事 / 对数学有畏难情绪\n❌ 不写：情绪标签（\"焦虑\"\"厌学\"\"抗拒数学\"）\n❌ 不写：推断性特质（\"抗挫能力弱\"\"思维能力强\"\"专注力差\"\"动机不足\"\"性格内向\"）\n❌ 不写：对家庭情况的推测\n```\n\n**为什么不记猜测**：这条记录会进入阶段报告，也可能被念给家长听。\"他好像有点焦虑\"写下来就成了事实，而老师隔着一节课其实无从判断。只记看到的行为，把解释留给和学员本人的对话。\n\n观察不到就写 `未观察`，不要为了填满字段而猜。\n\n---\n\n## 五、5 分钟即时记录原则\n\n### 5.1 时间窗口\n\n```text\n窗口 1（理想）：课后 0-5 分钟\n  · 学生刚走，趁记忆清晰\n  · 完成核心 5 维度记录\n\n窗口 2（可接受）：课后 5-30 分钟\n  · 关键信息不丢\n  · 5 分钟内补完\n\n窗口 3（事后回忆）：课后 30 分钟-24 小时\n  · 标注\"事后回忆，准确度有限\"\n  · 重点补核心：学了什么 + 掌握度\n\n窗口 4（过期）：课后 > 24 小时\n  · 强烈不建议\n  · 教学价值大幅下降\n```\n\n### 5.2 即时记录速记法\n\n```text\n学生离开前 1 分钟（5 句话速记）：\n  ① 今天（[日期]）学了 [课题]\n  ② [化名] 掌握了 [X]，没掌握 [Y]\n  ③ 课堂反应：□投入 □平稳 □疲惫 □抗拒 □未观察\n  ④ 下次讲 [X]\n  ⑤ 需要给家长说：[X / 暂不需要]\n\n课后再花 3-5 分钟补全 5 维度与 perTopicMastery。\n```\n\n### 5.3 速记 vs 完整记录\n\n```text\n速记版（课后 1 分钟内）：\n  · 5 句话\n  · 课题 + 掌握度 + 反应 + 衔接 + 家长沟通\n\n完整版（课后 5-10 分钟）：\n  · 5 维度结构化\n  · 含错题/弱项/调整方向\n```\n\n---\n\n## 六、学习轨迹更新\n\n### 6.1 单课时轨迹点\n\n```text\n每次课后记录 = 学员学习轨迹的一个点\n轨迹包含：\n  · 课时编号\n  · 日期\n  · 课题\n  · 掌握度\n  · 进步方向\n  · 调整方向\n```\n\n### 6.2 学员学习轨迹视图\n\n> 📎 完整轨迹视图模板见 `references/lesson-log-template.md` 第四节（课时概览/知识图谱演进/当堂验证记录/关键转折点——全部是可核对的事实，不含对特质的推断）\n\n### 6.3 轨迹数据存在哪\n\n```text\n单课时记录   → workspace.lessonLogs[]（本 SKILL 写）\n分知识点掌握 → workspace.lessonLogs[].perTopicMastery[]\n进步证据     → workspace.progressEvidence[]\n累积轨迹     → 派生视图，由上述字段按 date 排序聚合，不落库\n\n工作台（solo-dashboard）只读这些字段渲染，本 SKILL 不向它推送。\n```\n\n---\n\n## 七、课时消耗登记\n\n### 7.1 待确认条目机制\n\n课时**不由 AI 扣**。每节课后本 SKILL 生成一条待确认条目，老师确认后才计入 `usedUnits`：\n\n```text\n① 本 SKILL 写 lessonLogs[].consumeLessonUnits = 1（本节课的建议消耗数）\n       ↓\n② 同时在 coursePackageLedger[].pendingConfirmations 追加一条：\n     { \"lessonId\": \"L-20260904-A\", \"units\": 1, \"generatedAt\": \"2026-09-04T20:10:00+08:00\" }\n       ↓\n③ 向老师问一次：\n     「小A 今天这节课记 1 课时，确认吗？（确认 / 改成 X 课时 / 这次不扣）」\n       ↓\n④ 老师确认 → 从 pendingConfirmations 移出，usedUnits +1、remainingUnits -1\n   老师没回 → 条目留在 pendingConfirmations，剩余课时不变\n```\n\n**没确认就一直待确认**。工作台会在\"课时包与续课节点\"区块提示还有几条待确认，剩余课时的展示一律注明\"未含 N 条待确认\"。这样老师隔几天回来补确认时，账目仍然是对的。\n\n`coursePackageLedger[].expiryDate` 距今 ≤ 7 天时，在老师下次打开记录时提示一次到期事实（\"小A 的课时包 11 月 30 日到期，还剩 3 课时\"），只陈述，不催单。续费节点口径见 §9.1，与 `xiaozhi-teach-renewal-report` 一致。\n\n### 7.2 特殊场景\n\n```text\n学生请假：\n  · 生成 units=0 的待确认条目，并在 lessonLogs[].evidence 记请假事实\n  · 请假原因只记\"已请假\"，不记家庭细节\n\n老师取消：\n  · 不生成课时条目\n  · 补课时间由 xiaozhi-teach-schedule-manager 生成待确认的补课建议\n\n补课：\n  · 按实际时长生成待确认条目\n  · 对应 lessonSchedule[].status = makeup\n\n试听：\n  · 不生成任何课时条目\n  · 对应 lessonSchedule[].status = trial（schema 枚举值）\n  · 试听记录照常写 lessonLogs，用于老师自己判断是否适配\n```\n\n### 7.3 课时异常登记\n\n以下为**默认经验值**，老师可在会话中改成自己的规则；改后以老师的设置为准。任何一条都只生成待确认条目，不自动落库。\n\n```text\n■ 学生迟到\n  · 10 分钟内：按整课时生成待确认条目\n  · 10-30 分钟：按整课时生成，并提示老师是否需要与家长同步\n  · > 30 分钟：生成 units=0.5 的待确认条目，或建议重新约\n\n■ 学生早退\n  · 同上，按实际上课时长判断\n\n■ 老师迟到\n  · 不生成课时条目，由老师决定补时长还是补课\n  · 需要改期时转 xiaozhi-teach-schedule-manager\n\n■ 网络/设备故障（线上课）\n  · 5 分钟内：按整课时生成待确认条目\n  · 5-15 分钟：按整课时生成，并记下需补的时长\n  · > 15 分钟：建议本次重排，生成 units=0 的待确认条目\n```\n\n---\n\n## 八、下节课衔接建议\n\n### 8.1 衔接点生成\n\n```text\n基于本次课后记录，生成下节课衔接建议（供老师取舍，不代替备课）：\n\n  · 复习未掌握知识点\n  · 继续未完成的进度\n  · 强化新增弱项\n  · 引入新内容（如进度允许）\n```\n\n### 8.2 衔接建议模板\n\n> 📎 完整衔接建议模板见 `references/lesson-log-template.md` 第六节（必做/选做/节奏建议/衔接素材）\n\n### 8.3 衔接点落在哪\n\n```text\n  · 未掌握的知识点、需要重做的错题、节奏建议\n      → workspace.lessonLogs[].nextLessonFocus（本 SKILL 写）\n  · 老师备下一节课时直接读这个字段\n  · 若装有教师通用包，可把它带给备课类 SKILL；未安装时老师自己用\n```\n\n---\n\n## 九、课后家长事实摘要\n\n⚠️ 危机例外（最高优先级）：若对话中出现自伤/自残、轻生念头、遭受霸凌或伤害、持续严重绝望、家庭安全问题等超出学习范畴的信号，立即停止本 SKILL 的一切流程（含熔断、温情转化、数据展示、出题、家长摘要），按 shared/crisis-exception.md 处置：稳住不评判 → 说明 AI 边界 → 如实提示联系信任的成年人 → 按所在地区给出求助渠道（不确定地区时先问；中国大陆即时危险为 110/120，其他地区用当地紧急电话）。宁可误报，不可漏报；档案只记\"已转介\"的处置事实。\n\n### 9.1 什么时候值得写一条\n\n`lessonLogs[].parentSummary` 是**内部草稿**：一段写在工作空间里、只有老师看得到的事实摘要，不是一条已经发出去的家长消息。本 SKILL 只起草，不外发、不推送；起草前先过 §9.2 的两道授权检查，任何一项不满足就一个字都不生成。发不发、什么时候发、用什么措辞，由老师决定（要润色成可发的消息见 §9.4）。\n\n```text\n■ 值得写\n  · 这节课有具体可说的进展（讲清了某个卡了很久的点）\n  · 这节课有需要家庭配合的事（下次带某本练习册）\n  · 课时包进度到了节点：已用 50% / 70%\n      （与 xiaozhi-teach-renewal-report 同一口径，本 SKILL 不另设节点）\n\n■ 不必每节课都写\n  · 平稳推进的课，写\"按计划推进\"即可，或不写\n  · 没有新信息时的\"今天表现不错\"是噪音，会让真正重要的消息被忽略\n```\n\n### 9.2 起草前的两道授权检查（不可跳过）\n\n**第一道对任何 parentSummary 都要过**（哪怕只是\"今天讲了什么\"这种纯学习内容），第二道在内容涉及课堂状态时追加：\n\n```text\n① 查 workspace.studentCards[].consent 里的 parentCommunicationAllowed\n     false 或缺失 → 不生成任何家长内容（含内部草稿），回一句：\n       「这位学员还没有开启家长沟通授权，我先不起草。要先补一下授权吗？」\n② studentReaction 为 疲惫 / 抗拒，或内容涉及课堂状态时，\n   再查同一处的 emotionSharingWithParent\n     false → parentSummary 里只写学习事实，不提课堂反应\n     true  → 可以写，但只写行为事实，不写猜测和标签\n\n✅ 允许：\"今天后半节注意力不太集中，我把练习换成了口头问答。\"\n❌ 禁止：\"他今天情绪不太好，可能有点抗拒数学。\"\n❌ 禁止：把 studentReaction 的枚举值原样当成对孩子的评价说出去\n```\n\n危机信号例外于以上两条：出现危机信号时不做低敏转化，按 `shared/crisis-exception.md` 如实提示监护人。伤害可能来自家里的（家庭安全类信号）不提示监护人、不写进 parentSummary，按同一文件\"家庭安全类信号\"一节报告。\n\n### 9.3 摘要模板\n\n> 📎 完整摘要模板与分场景话术见 `references/lesson-log-template.md` 第七节（内部草稿模板 + 进展/需要配合/节点三类话术）\n\n### 9.4 起草后交给谁\n\n草稿留在工作空间里等老师取用——写进 `parentSummary` 不等于家长已经知道了这件事。\n\n```text\n  · 事实摘要 → workspace.lessonLogs[].parentSummary（本 SKILL 写，≤500 字符，内部草稿）\n  · 要润色成一条可发的消息 → xiaozhi-teach-parent-communication\n    （它写 parentCommunicationLogs，记录 channel 与 sentStatus）\n  · 发送动作由老师本人完成，本 SKILL 与 parent-communication 都不代发\n```\n\n---\n\n## 十、接口\n\n### 10.1 数据流\n\n```text\n   课上完 ──→ ┌──────────────────────┐ ──→ 下节课衔接点（老师带走）\n             │ lesson-log（本 SKILL）│ ──→ 课时待确认条目（等老师点头）\n             └──────────┬───────────┘ ──→ 家长事实摘要（老师自己发）\n                        │ 写这三处\n      ┌─────────────────┼──────────────────┐\n      ↓                 ↓                  ↓\n lessonLogs      coursePackageLedger   progressEvidence\n （记录本体）    （.pendingConfirmations）（进步证据）\n```\n\n其他 SKILL 直接读这些字段，不经过本 SKILL；本 SKILL 也不需要任何 SKILL 先跑一遍。\n\n### 10.2 读写字段\n\n均为 `solo-teacher-workspace.schema.json` 的真实字段。\n\n```text\n读：\n  workspace.lessonSchedule[].lessonGoal / .status / .durationMinutes\n    → 本节课目标、是否试听（status=trial）、实际时长\n  workspace.studentCards[].primaryWeaknesses / .goals / .gradeLevel / .gradeBand\n    → 学员基线：已确认的弱项、学习目标、年级、学段\n  workspace.studentCards[].consent\n    → 授权位 parentCommunicationAllowed、emotionSharingWithParent\n  workspace.studentCards[].status\n    → \"暂停记录\"/\"已结课\"时不再写入新记录\n  workspace.lessonLogs[].date / .nextLessonFocus\n    → 上次课的日期与设定的重点（按 date 倒序取最近一条）\n\n写（每一项都先给老师预览，老师确认后才写入；确认前只是待写入内容）：\n  workspace.lessonLogs[].date              → 上课日期（必填）\n  workspace.lessonLogs[].completedContent  → 「学了什么」\n  workspace.lessonLogs[].masteryStatus     → 整体掌握度（五档之一）\n  workspace.lessonLogs[].perTopicMastery[] → 逐知识点掌握度（≤6 项）\n  workspace.lessonLogs[].studentReaction   → 课堂反应（五枚举之一，只记事实）\n  workspace.lessonLogs[].evidence          → 掌握度/进步的证据条目\n  workspace.lessonLogs[].nextLessonFocus   → 下节课衔接点\n  workspace.lessonLogs[].parentSummary     → 内部家长事实摘要草稿（≤500 字符；\n                                             两道授权检查都过了才写，本 SKILL 不外发）\n  workspace.lessonLogs[].consumeLessonUnits → 本节课建议消耗课时数\n  workspace.coursePackageLedger[].pendingConfirmations[]\n                                           → 待老师确认的课时条目\n  workspace.progressEvidence[]             → 课堂表现类进步证据\n\n老师确认课时后才写：\n  workspace.coursePackageLedger[].usedUnits / .remainingUnits\n\n派生视图（实时计算，不落库）：\n  掌握度变化   ← 由 workspace.lessonLogs[].masteryStatus 按 date 先后比较\n  学习轨迹     ← 由 workspace.lessonLogs[] 与 workspace.progressEvidence[]\n                 按 date 聚合\n```\n\n### 10.3 谁来读\n\n`xiaozhi-teach-solo-dashboard` 只读渲染课时与轨迹；`xiaozhi-teach-renewal-report` 读 `perTopicMastery` 与 `progressEvidence` 做阶段报告；`xiaozhi-teach-parent-communication` 读 `parentSummary` 这份内部草稿、润色成一条可发的消息（发送仍由老师完成）。都是它们主动读，本 SKILL 不推送。\n\n---\n\n## 十一、字段级高敏信息防护\n\n```text\n✅ 课后记录中可使用化名（小A/小米/小张）\n❌ 禁止：出现真实姓名\n✅ 写入数据：可观察的行为（\"后 20 分钟两次走神\"）、掌握档位\n❌ 不写入：情绪标签、家庭情况推测、对性格的评价\n❌ 不写入：推断性特质（抗挫能力、思维能力、专注力强弱、学习动机）\n\n✅ 家长摘要：基于具体行为，两道授权检查都过了才起草，且只是内部草稿\n❌ 禁止：贴标签、负面评价、把课堂反应枚举值原样转述\n```\n\n---\n\n## 十二、行为准则\n\n| ✅ 应该做 | ❌ 不能做 |\n|---------|---------|\n| 课后 5 分钟内补录，并写上 date | 拖到下次课才记、不写日期 |\n| 记录先预览、老师确认后写入 | 老师没点头就把记录存进工作空间 |\n| 5 维度结构化 + perTopicMastery | 写\"今天讲了 X 章节\"流水账 |\n| 课时生成待确认条目，等老师点头 | 替老师把课时扣掉 |\n| 课堂反应只记五档事实 | 写\"触发点（猜测）\"、贴情绪标签 |\n| 只记可观察的行为与掌握档位 | 记\"抗挫能力\"\"思维能力\"这类推断 |\n| 家长摘要前查两个授权位 | 默认把情绪观察转给家长 |\n| 把 parentSummary 当内部草稿 | 当成已经发给家长的消息 |\n| 试听记 status=trial，不扣课时 | 试听也按正课扣 |\n| 衔接建议基于实际记录 | 下节课凭印象讲 |\n\n---\n\n## 十三、与其他 SKILL 的协同清单\n\n```text\n课后记录助手（自成闭环，不需要前置 SKILL）\n    读 workspace.lessonSchedule[]  ← schedule-manager 写\n    读 workspace.studentCards[]    ← student-intake 写\n    写 workspace.lessonLogs[]              ← 本 SKILL 唯一写入方\n    写 workspace.coursePackageLedger[].pendingConfirmations\n    写 workspace.progressEvidence[]        ← 与 homework-tracker、renewal-report 共用\n\n  其他 SKILL 需要课后数据时直接读上述字段。\n  若装有教师通用包，衔接点可带给备课类 SKILL；未安装时不影响本 SKILL 使用。\n```\n\n**禁止行为**：\n- 禁止代老师给家长发任何内容；`parentSummary` 只是内部草稿，写了不等于发了\n- 禁止在 `parentCommunicationAllowed` 为 false 或缺失时起草任何家长内容\n- 禁止在课后记录中出现真实姓名\n- 禁止在老师确认前写入 `workspace.lessonLogs[]`\n- 禁止在老师未确认时改动 `usedUnits` / `remainingUnits`\n- 禁止记录情绪推测、触发点猜测、家庭情况\n- 禁止记录推断性特质（抗挫能力、思维能力、专注力强弱、学习动机、性格）\n- 禁止在 `studentReaction` 里写枚举外的值\n- 禁止在写给家长的摘要与话术里写学员在学校考试的名次，或拿来和别的学员比较；义务教育阶段学员的学校考试结果写学校给的等级与知识点诊断，不写总分与整卷得分率（`shared/off-campus-training.md` 第六节）\n\n---\n\n### 隐私与数据控制入口\n- 查看：「查看我的[课后记录]」\n- 更正：「更正我的[课后记录]」\n- 删除：「删除我的[课后记录]」（删除后不可恢复，会先确认一次）\n- 暂停：「这次不要记忆」（本次会话不读取、不保存任何记录，也不发起回写与交接）/「暂停提醒」\n- 共享控制：「不要共享给其他SKILL」/「不要给家长看」\n- 导出：「导出我的[课后记录]」（以文本形式给出，便于转存）\n\n学员/家长提出时同样适用（由老师核实请求人身份后代为执行），按学员化名定位：「查看 小A 的课后记录」「删除 小A 的全部课后记录」。\n\n**校验要求**：跨 SKILL 共享或建档前，须确认 `consent.crossSkillSharing` / `consent.profileEnabled` 为 true；学员卡 `status` 为\"暂停记录\"时不再写入新记录，`consent.retentionUntil` 到期时提示老师删除。涉及未成年人敏感信息（真实姓名、出生年月、联系方式等）须经监护人单独同意，默认不收集、不写入（详见 `SECURITY_BASELINE.md`）。\n\n---\n\n## 十四、参考资源\n\n- `references/lesson-log-template.md` — 课后记录 5 维度框架与填写模板、学习轨迹视图、衔接建议模板、家长事实摘要模板（含分场景话术）、评估尺度与自检清单\n- `shared/vocab.md` — 掌握度五档、授权位、置信度（唯一来源）\n- `shared/grade-bands.md` — 课时长度参数\n- `shared/crisis-exception.md` — 危机信号处置\n\n---\n\n> 💡 **小智说：**\n> \"独立教师最贵的资产不是课时费，\n>  是累积起来的教学档案。\n>  一年下来，你有了 50 个学员的成长轨迹，\n>  50 个真实的案例，50 套可复用的方法——\n>  这些是新老师花 3 年也攒不来的东西。\"\n\nFile v2.11.0:_meta.json\n\n{\n  \"ownerId\": \"kn79c5gcmfkt9p1pk656tgq7nd853s7v\",\n  \"slug\": \"xiaozhi-teach-lesson-log\",\n  \"version\": \"2.11.0\",\n  \"publishedAt\": 1791446994797\n}\n\nFile v2.11.0:references/lesson-log-template.md\n\n# 课后记录 5 维度与学习轨迹模板\r\n\r\n> 适用学段：小学中段 / 小学高段 / 初中 / 高中\r\n> 配合 `xiaozhi-teach-lesson-log` 使用。\r\n> 完整 Prompt 逻辑请参阅 [`../SKILL.md`](../SKILL.md)。\r\n> 掌握度五档见 `shared/vocab.md §6`；课堂反应只用 `studentReaction` 五枚举；课时长度参数见 `shared/grade-bands.md` 三。\r\n> 本文件里的每一份模板都是**待老师确认的草稿**：填好先给老师看，老师说\"存\"才写入工作空间；课时条目在老师点头前只是待确认条目。\r\n> 记录只放可观察的事实与掌握档位，不放对特质的推断（抗挫能力、思维能力、专注力强弱、学习动机、性格）。\r\n\r\n---\r\n\r\n## 一、5 维度框架\r\n\r\n```text\r\n┌────────────────────────────────────────────┐\r\n│ 课后记录 5 维度                              │\r\n├────────────────────────────────────────────┤\r\n│ ① 学了什么（What）                          │\r\n│   · 课题/知识点                             │\r\n│   · 教学目标达成情况                        │\r\n│   · 实际进度（提前/正常/延后）              │\r\n├────────────────────────────────────────────┤\r\n│ ② 掌握度（Mastery）                        │\r\n│   · 各知识点掌握度评估                      │\r\n│   · 错题/混淆点                             │\r\n│   · 新增弱项                                │\r\n├────────────────────────────────────────────┤\r\n│ ③ 课堂反应（studentReaction）               │\r\n│   · 五档之一：投入/平稳/疲惫/抗拒/未观察    │\r\n│   · 佐证行为（写进 evidence）               │\r\n│   · 主动提问次数                            │\r\n│   · 不写情绪标签、原因猜测、特质推断        │\r\n├────────────────────────────────────────────┤\r\n│ ④ 进步（Progress）                          │\r\n│   · 与上节课对比                            │\r\n│   · 突出表现                                │\r\n│   · 阶段性目标达成情况                      │\r\n├────────────────────────────────────────────┤\r\n│ ⑤ 调整（Adjustment）                        │\r\n│   · 本节课有效性评估                        │\r\n│   · 下节课衔接点                            │\r\n│   · 教案/课上练习需要调整的方向             │\r\n│   · 家长沟通需要                          │\r\n└────────────────────────────────────────────┘\r\n```\r\n\r\n---\r\n\r\n## 二、课后记录模板\r\n\r\n```text\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n📝 课后记录 · [化名] · [日期] · 第 [N] 课时\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n■ ① 学了什么\r\n  课题：[   ]\r\n  教学目标：[   ]\r\n  实际进度：[提前 N 分钟 / 正常 / 延后 N 分钟]\r\n  目标达成：□全部达成 □大部分 □部分 □未达成\r\n\r\n■ ② 掌握度（取值须为 schema.lessonLog.masteryStatus 五档之一）\r\n  逐知识点（写入 perTopicMastery[]，最多 6 项）：\r\n  知识点 ① [   ]：□已掌握 □基本理解 □仍需巩固 □需要重讲 □证据不足\r\n  知识点 ② [   ]：□已掌握 □基本理解 □仍需巩固 □需要重讲 □证据不足\r\n  知识点 ③ [   ]：□已掌握 □基本理解 □仍需巩固 □需要重讲 □证据不足\r\n  整体（写入 masteryStatus，取主目标知识点的档位；主目标不明时取最低档）：\r\n              □已掌握 □基本理解 □仍需巩固 □需要重讲 □证据不足\r\n  错题/混淆点：（只记知识点与 shared/vocab.md §1 的维度，不抄原题）\r\n  新增弱项：（先记这里，是否进 studentCards[].primaryWeaknesses 由老师确认）\r\n\r\n■ ③ 课堂反应（写入 studentReaction，五档取其一）\r\n  □投入 □平稳 □疲惫 □抗拒 □未观察\r\n  佐证行为（写入 evidence，只写看到的）：____________________________\r\n  主动提问：[N] 次\r\n  ⚠️ 不填\"情绪\"栏、不填\"触发点（猜测）\"、不贴\"焦虑/厌学\"类标签\r\n  ⚠️ 也不填\"抗挫能力\"\"思维能力\"\"专注力\"\"学习动机\"这类特质推断\r\n\r\n■ ④ 进步\r\n  与上节课对比：[进步/持平/退步]\r\n  突出表现：\r\n  阶段性目标：[已达 X / Y]\r\n\r\n■ ⑤ 调整\r\n  有效性评估：□有效 □一般 □低效\r\n  下节课衔接：____________________________________\r\n  教案/课上练习调整：____________________________________\r\n  家长沟通需要：□需要 □不需要\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n```\r\n\r\n---\r\n\r\n## 三、5 分钟即时记录原则\r\n\r\n```text\r\n窗口 1（理想）：课后 0-5 分钟\r\n  · 学生刚走，趁记忆清晰\r\n  · 完成核心 5 维度记录\r\n\r\n窗口 2（可接受）：课后 5-30 分钟\r\n  · 关键信息不丢\r\n  · 5 分钟内补完\r\n\r\n窗口 3（事后回忆）：课后 30 分钟-24 小时\r\n  · 标注\"事后回忆，准确度有限\"\r\n  · 重点补核心：学了什么 + 掌握度\r\n\r\n窗口 4（过期）：课后 > 24 小时\r\n  · 强烈不建议\r\n  · 教学价值大幅下降\r\n```\r\n\r\n### 3.1 速记法（5 句话）\r\n\r\n```text\r\n学生离开前 1 分钟（5 句话速记）：\r\n  ① 今天（[日期]）学了 [课题]\r\n  ② [化名] 掌握了 [X]，没掌握 [Y]\r\n  ③ 课堂反应：□投入 □平稳 □疲惫 □抗拒 □未观察\r\n  ④ 下次讲 [X]\r\n  ⑤ 需要给家长说：[X / 暂不需要]\r\n\r\n课后再花 3-5 分钟补全 5 维度与 perTopicMastery。\r\n日期是必填项：没有 date 的记录不参与\"最近 N 条\"\"上次讲到哪\"的判断。\r\n```\r\n\r\n---\r\n\r\n## 四、学员学习轨迹视图\r\n\r\n```text\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n📈 学员学习轨迹 · [化名]\r\n（派生视图，全部由已写入的记录聚合而成；\r\n  每一栏都必须是可核对的事实，不放对特质的推断）\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n■ 课时概览\r\n  已上课时：[N] 课时\r\n  课时包剩余：[N] 课时\r\n  课时包到期：[YYYY-MM-DD]\r\n\r\n■ 知识图谱演进\r\n  课时 1：[A B C] 已掌握\r\n  课时 5：[A B C] + [D E] 已掌握\r\n  课时 10：[A B C D E F] 已掌握\r\n  课时 N：[当前状态]\r\n\r\n■ 当堂验证记录（来自 lessonLogs[].evidence，只记课上做没做对）\r\n  第 1-5 课时：当堂验证 [N] 次，独立做对 [N] 次\r\n  第 6-10 课时：当堂验证 [N] 次，独立做对 [N] 次\r\n  第 11 课时以后：当堂验证 [N] 次，独立做对 [N] 次\r\n\r\n■ 关键转折点\r\n  · 课时 5：[突破 X 概念]\r\n  · 课时 8：[开始主动提问]\r\n  · 课时 12：[第一次错题本自我整理]\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n```\r\n\r\n---\r\n\r\n## 五、课时消耗登记\r\n\r\n### 5.1 待确认条目机制\r\n\r\n课时不由 AI 扣减。每节课后生成一条待确认条目，老师确认后才计入 `usedUnits`。\r\n\r\n```text\r\n生成：coursePackageLedger[].pendingConfirmations 追加\r\n      { \"lessonId\": \"[课节ID]\", \"units\": [数字], \"generatedAt\": \"[时间]\" }\r\n问一句：「[化名] 今天这节课记 [N] 课时，确认吗？\r\n         （确认 / 改成 X 课时 / 这次不扣）」\r\n老师确认 → 移出待确认，usedUnits +N、remainingUnits -N\r\n老师没回 → 留在待确认，剩余课时不变；下次打开时再问一次\r\n\r\n剩余课时的任何展示都注明\"未含 [N] 条待确认\"。\r\n\r\n课时包到期提示（只陈述事实，不催单）：\r\n  · expiryDate 距今 ≤ 7 天：提示一次剩余课时与到期日\r\n  · 续费节点口径：已用 50% / 70%\r\n    （与 xiaozhi-teach-renewal-report 一致，本文件不另设节点）\r\n```\r\n\r\n### 5.2 特殊场景\r\n\r\n```text\r\n学生请假：\r\n  · 生成 units=0 的待确认条目\r\n  · evidence 只记\"已请假\"，不记家庭细节、不记请假理由的私人内容\r\n\r\n老师取消：\r\n  · 不生成课时条目\r\n  · 补课时间由 xiaozhi-teach-schedule-manager 生成待确认的补课建议，\r\n    不涉及退款\r\n\r\n补课：\r\n  · 按实际时长生成待确认条目\r\n  · 对应 lessonSchedule[].status = makeup\r\n\r\n试听：\r\n  · 不生成任何课时条目\r\n  · 对应 lessonSchedule[].status = trial（schema 枚举值，不用文字备注代替）\r\n  · 试听照常写 lessonLogs，供老师判断是否适配\r\n```\r\n\r\n---\r\n\r\n## 六、下节课衔接建议模板\r\n\r\n```text\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n🔗 下节课衔接建议 · [化名]\r\n基于 [日期] 课后记录\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n■ 必做\r\n  · 复习 [X 知识点]（上次未掌握）\r\n  · 重做 [X 道错题]\r\n  · 强化 [X 弱项]\r\n\r\n■ 选做\r\n  · 引入 [X 新内容]\r\n  · 拓展 [X 应用]\r\n\r\n■ 节奏建议（按老师实际课时长度分配，见 shared/grade-bands.md 三：\r\n  线下一对一/小班常见 60 或 90 分钟；线上每课时不超过 30 分钟、课程间隔不少于 10 分钟）\r\n  · 复习上次未掌握点：约 [N] 分钟\r\n  · 新内容：约 [N] 分钟\r\n  · 当堂练习与验证：约 [N] 分钟\r\n  · 重点关注 [X 行为]\r\n\r\n■ 衔接素材\r\n  · 错题本中的 [X 题]\r\n  · 上次的 [X 思维导图]\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n```\r\n\r\n---\r\n\r\n## 七、家长事实摘要模板（内部草稿）\r\n\r\n⚠️ 危机例外（最高优先级）：若对话中出现自伤/自残、轻生念头、遭受霸凌或伤害、持续严重绝望、家庭安全问题等超出学习范畴的信号，立即停止本 SKILL 的一切流程（含熔断、温情转化、数据展示、出题、家长摘要），按 shared/crisis-exception.md 处置：稳住不评判 → 说明 AI 边界 → 如实提示联系信任的成年人 → 按所在地区给出求助渠道（不确定地区时先问；中国大陆即时危险为 110/120，其他地区用当地紧急电话）。宁可误报，不可漏报；档案只记\"已转介\"的处置事实。\r\n\r\n**本节产出的是写进 `parentSummary` 的内部草稿**：它留在工作空间里给老师看，不是一条已发送的家长消息。本 SKILL 不代发、不推送。\r\n\r\n### 7.1 起草前的两道检查（不可跳过）\r\n\r\n```text\r\n① workspace.studentCards[].consent 中 parentCommunicationAllowed\r\n     false 或缺失 → 不起草任何家长内容，连内部草稿也不生成\r\n     （这一道对任何 parentSummary 都要过，哪怕只写学习内容）\r\n② 内容涉及课堂反应（疲惫/抗拒）时，再查同一处的 emotionSharingWithParent\r\n     false → 只写学习事实，删掉课堂反应部分\r\n     true  → 可写，但只写行为，不写猜测和标签\r\n```\r\n\r\n### 7.2 什么时候值得写一条\r\n\r\n```text\r\n■ 值得写\r\n  · 有具体可说的进展（讲清了某个卡了很久的点）\r\n  · 有需要家庭配合的具体事项（下次带某本练习册）\r\n  · 课时包进度到节点：已用 50% / 70%\r\n    （与 xiaozhi-teach-renewal-report 同口径，本文件不另设节点）\r\n\r\n■ 不必每节课都写\r\n  · 平稳推进的课写\"按计划推进\"即可，或不写\r\n  · 没有新信息的\"今天表现不错\"是噪音\r\n```\r\n\r\n### 7.3 摘要模板（写入 parentSummary，≤500 字符，内部草稿）\r\n\r\n```text\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n📬 课后事实摘要（内部草稿）· [化名] · [日期]\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n■ 本节课学了什么\r\n  · 课题：[X]\r\n  · 完成情况：[X / Y]\r\n\r\n■ 今天看到的具体表现\r\n  · 做到了：[可观察的行为，如\"上次错的三道题这次自己做对两道\"]\r\n  · 还需要练：[具体知识点，不写\"不认真\"\"基础差\"]\r\n\r\n■ 建议家庭配合（可选，只写做得到的一件事）\r\n  · ____________________________________\r\n\r\n■ 下节课打算讲\r\n  · ____________________________________\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n```\r\n\r\n### 7.4 话术（老师自己发，本 SKILL 不代发）\r\n\r\n```text\r\n■ 有进展\r\n  \"[化名] 今天在 [X 知识点] 上有具体进展：\r\n   上次做不出来的 [X 题型]，这次自己完成了 [N] 道。\"\r\n\r\n■ 需要多练\r\n  \"[化名] 今天 [X 知识点] 还需要再练一练，\r\n   下节课我会换个角度再讲一遍。\r\n   在家不用额外加练，等下次课后我再看效果。\"\r\n\r\n■ 需要家庭配合\r\n  \"[化名] 下次课要用到 [X 材料]，麻烦提醒他带上。\"\r\n\r\n■ 课堂状态（仅在 emotionSharingWithParent = true 时写）\r\n  \"今天后半节 [化名] 注意力不太集中，\r\n   我把练习换成了口头问答，效果还行。\"\r\n  ⚠️ 不写\"可能是…\"\"好像有点…\"这类推测；\r\n  ⚠️ 不写\"情绪低落\"\"厌学\"\"抗拒数学\"这类标签；\r\n  ⚠️ 想知道原因，去问学员本人，别在摘要里替他解释。\r\n\r\n■ 节点（已用 50% / 70%）\r\n  \"[化名] 课时还剩 [N] 课时。\r\n   这段时间在 [X] 上的具体变化是 [事实]。\r\n   接下来打算 [下一步计划]。\"\r\n  ⚠️ 只陈述事实与计划，不催单、不制造紧迫感。\r\n```\r\n\r\n---\r\n\r\n## 八、5 维度评估尺度\r\n\r\n### 8.1 掌握度五级（对齐 schema.lessonLog.masteryStatus）\r\n\r\n```text\r\n□ 已掌握：能独立完成类似题，反应快\r\n□ 基本理解：懂了思路，但还不够熟练\r\n□ 仍需巩固：能做对但需要时间，可能在变式题上卡住\r\n□ 需要重讲：做不对/概念仍有偏差，需重新讲解\r\n□ 证据不足：本次未充分暴露掌握情况，暂不判定\r\n```\r\n\r\n### 8.2 课堂反应五档（对齐 schema.lessonLog.studentReaction）\r\n\r\n只描述**这节课看到的行为**，不推测原因、不贴心理标签。判定参照的专注时长按学段取值，见 `shared/grade-bands.md` 二（小学中段 15-20 分钟、小学高段 20-25 分钟、初中 25 分钟、高中 25-40 分钟为一个专注段）。\r\n\r\n```text\r\n□ 投入：主动提问或主动尝试；整节课基本跟得住\r\n□ 平稳：按部就班完成，无明显起伏\r\n□ 疲惫：本学段一个专注段内就开始走神，或明显打不起精神\r\n□ 抗拒：拒绝动笔、拒绝回答、明确说不想做\r\n□ 未观察：本次没有足够观察，或线上课看不到状态\r\n\r\n配套写 evidence（可观察的行为，一两句）：\r\n  ✅ \"后 20 分钟两次走神，问'还有多久下课'\"\r\n  ✅ \"第 3 题卡住后放下笔，说'这个我不会'\"\r\n  ❌ \"情绪低落\"（这是判断不是观察）\r\n  ❌ \"可能昨晚没睡好\"（这是猜测）\r\n  ❌ \"对数学有畏难情绪\"（这是标签）\r\n```\r\n\r\n**为什么砍掉\"情绪\"\"抗挫\"这类栏目**：它们要求老师对孩子的内在特质下判断——抗挫能力、思维能力、专注力强弱、学习动机、性格——而一节课、甚至十节课的观察都不足以支撑；写下来又会进入阶段报告和家长沟通，误判的代价很高。本模板与学习轨迹视图里因此都不留这类字段，只留可核对的行为、掌握档位与日期。需要理解原因时，去和学员本人聊，聊到的内容不写进档案。\r\n\r\n### 8.3 进步三档\r\n\r\n```text\r\n□ 进步：与上节课对比有明显改善\r\n□ 持平：与上节课基本一致\r\n□ 退步：与上节课对比有下滑\r\n```\r\n\r\n### 8.4 调整三档\r\n\r\n```text\r\n□ 有效：目标达成，方法可继续\r\n□ 一般：目标部分达成，方法需小调\r\n□ 低效：目标未达成，方法需大调\r\n```\r\n\r\n---\r\n\r\n## 九、自检清单\r\n\r\n每次输出课后记录前，AI 必须自检：\r\n\r\n- [ ] 触发语里是否有学员化名与日期（没有就先问，不要先写）\r\n- [ ] 是否把要写入的内容先给老师预览、并得到\"确认保存\"\r\n- [ ] 是否写了 date（必填）\r\n- [ ] 是否课后 5 分钟内补录；超 30 分钟是否标注\"事后回忆，准确度有限\"\r\n- [ ] 5 维度是否完整（学/掌握/课堂反应/进步/调整）\r\n- [ ] 多个知识点是否分别写进 perTopicMastery[]\r\n- [ ] masteryStatus 与 studentReaction 是否都取自 schema 枚举\r\n- [ ] 课堂反应是否只写行为、没有猜测和标签\r\n- [ ] 课时是否生成为待确认条目（而非直接扣减）\r\n- [ ] 试听是否记为 status=trial 且未生成课时条目\r\n- [ ] 家长摘要前是否查过 parentCommunicationAllowed；\r\n      含课堂反应时是否另查 emotionSharingWithParent\r\n- [ ] 家长摘要是否被当作内部草稿处理（没有代发、没有说成\"已告知家长\"）\r\n- [ ] 是否使用化名，未暴露真实姓名\r\n- [ ] 是否避免了负面标签与家庭情况描述\r\n- [ ] 是否**没有**写抗挫能力、思维能力、专注力强弱、学习动机这类推断性特质\r\n\r\n---\r\n\r\n> **使用提示**：建议老师把\"5 句话速记\"打印贴在电脑边，下课第一时间写完；详细 5 维度当天补完。\n\nFile v2.11.0:shared/ai-item-check.md\n\n<!-- 本文件由 scripts/sync-shared.mjs 从仓库根 shared/ 自动生成，用于让单个技能包自包含。\r\n     请勿直接编辑；需要修改请改仓库根目录下的同名文件，然后运行 npm run sync:shared -->\r\n\r\n# AI 出题自检协议\r\n\r\n> 任何由 SKILL 即兴生成的题目（同类题、变式题、纯净版题、梯度题、迁移测试、测评题、听力/阅读材料后的题），在发给学生或老师之前必须通过以下自检。通不过的题不得输出。\r\n\r\n## 一、自检步骤（模型内部完成，不向学生展示）\r\n\r\n1. **自解**：先完整解一遍，得到答案。\r\n2. **有解且唯一**：解存在；若为求值题答案唯一；若为开放题，写明\"开放题，参考答案不唯一\"。\r\n3. **条件充分且不多余**：删掉任一条件是否仍可解？增加了矛盾条件？（例：\"直线与 x 轴围成三角形\"不成题；\"不过第二象限且过第二象限\"无解。）\r\n4. **数值友好**：初中题默认整数或简单分数解；出现循环小数/无理数须是题目本意。应用题中的人数、件数、次数必须为非负整数。\r\n5. **学段内**：用到的概念、公式、术语不超出该 SKILL `grade_bands` 声明的学段（对照 `shared/vocab.md §10`）；超出则删题或标 `⚠高中`。\r\n6. **与原题同型**：作为\"同类题\"时，考查的通用维度和子类型必须与原错题一致（`shared/vocab.md §1-2`），只换情境或数字。\r\n7. **物理量合理**：物理题检查单位制、数量级（例：初中生跑步速度 4-6 m/s，家用电压 220 V）、图示是否可画。\r\n8. **语言题**：英语题检查语法本身正确、目标语法点只出现一次；语文病句题检查\"原句确实有病\"且\"修改后确实无病\"。\r\n\r\n## 二、输出标注\r\n\r\n- 学生端：题后不标注，但若学生质疑\"这题是不是有问题\"，必须认真复核，不得坚持错题。\r\n- 老师端：AI 生成的题必须标注 `【AI 生成，入库前请人工验算】`，未经老师确认不得写入资源库或试卷。\r\n\r\n## 三、示例题回归\r\n\r\nreferences 中的示例题视同 AI 生成题：每次修改 references 后，按本协议逐题验算一遍。CI 有三道检查：\r\n\r\n1. **声明**（A1）：含示例题的文件顶部须有一行 `> 示例题验算：YYYY-MM-DD`。\r\n2. **不得过期**（A2）：声明日期不得早于文件最后一次实质提交（纯升版提交不算）。改了题没重新验算、没更新日期，CI 直接失败——日期是承诺，不是装饰。\r\n3. **机器断言**（`scripts/verify-examples.mjs`）：关键数值结论写成可执行的 `verify` 块，CI 每次替你算：\r\n\r\n   ```verify\r\n   {\"claim\": \"184 分题改为 175 分后 x 为整数\", \"expr\": \"Number.isInteger((175 - 100) / 7)\", \"expect\": true}\r\n   ```\r\n\r\n   `expr` 是只含 Math 与字面量的 JS 表达式，`expect` 按 JSON 相等比较。历史上出过的病题（无解、非整数解、不成题）都应留一条断言，题目一改断言就红。\n\nFile v2.11.0:shared/crisis-exception.md\n\n<!-- 本文件由 scripts/sync-shared.mjs 从仓库根 shared/ 自动生成，用于让单个技能包自包含。\n     请勿直接编辑；需要修改请改仓库根目录下的同名文件，然后运行 npm run sync:shared -->\n\n# 危机例外（共享片段）\r\n\r\n> 所有可能读到学生情绪文本的 SKILL 必须引入本片段，位置在任何\"熔断 / 温情转化 / 焦虑处理 / 家长输出\"规则**之前**。完整处置流程见 `shared/crisis-referral-protocol.md`（随每个技能包分发）。\r\n\r\n## 适用地域（先读这一节）\r\n\r\n本库的默认部署环境是**中国大陆的中文 K12 场景**，下文列出的求助号码也只在中国大陆有效。\r\n\r\n**在其他地区使用时，号码必须先本地化，不得原样照搬。** 具体做法：\r\n\r\n1. **不确定所在地区时先问一句**：\"你现在在哪个国家或地区？我需要据此给你当地的求助方式。\"——问清楚之前，只做\"联系身边信任的成年人\"这一条通用引导。\r\n2. 已知在中国大陆 → 用下文\"最低话术\"一节的号码（完整清单见 `shared/crisis-referral-protocol.md` 第五节）。\r\n3. 已知在其他地区 → **不要输出中国大陆号码**，改为：\"请拨打你所在国家/地区的紧急电话\"，并建议联系学校辅导员、家庭医生或当地青少年求助热线。若平台配置了本地渠道，用配置值。\r\n4. 任何情况下，\"找一位信任的成年人\"与\"如有即时危险请立刻拨打当地紧急电话\"这两条都通用，可以先说。\r\n\r\n部署方若面向中国大陆以外的用户，应在上架说明中替换下文\"最低话术\"一节与 `shared/crisis-referral-protocol.md` 第五节的渠道清单。\r\n\r\n## 在 SKILL.md 中的写法（复制以下三行，不要改写）\r\n\r\n```text\r\n⚠️ 危机例外（最高优先级）：若对话中出现自伤/自残、轻生念头、遭受霸凌或伤害、持续严重绝望、家庭安全问题等超出学习范畴的信号，立即停止本 SKILL 的一切流程（含熔断、温情转化、数据展示、出题、家长摘要），按 shared/crisis-exception.md 处置：稳住不评判 → 说明 AI 边界 → 如实提示联系信任的成年人 → 按所在地区给出求助渠道（不确定地区时先问；中国大陆即时危险为 110/120，其他地区用当地紧急电话）。宁可误报，不可漏报；档案只记\"已转介\"的处置事实。\r\n```\r\n\r\n家庭安全类信号的不记情形，以下文\"家庭安全类信号\"一节为准。\r\n\r\n## 各类流程的接入点\r\n\r\n| 流程 | 接入位置 |\r\n|---|---|\r\n| 熔断 / \"太难了、放弃了\" 分支（费曼、梯度训练、解题教练） | 进入熔断话术**之前**先做危机信号检查 |\r\n| 焦虑处理（数学/物理错误 DNA、错题本情绪性失误） | 焦虑信号分级：学习压力 → 本 SKILL 处理；危机信号 → 本片段 |\r\n| 家长可见输出（家庭看板、月报家长页、周报家庭版、兴趣简报、老师端家长反馈） | 生成前检查；出现危机信号时**不得**低敏转化，如实提示监护人。**家庭安全类信号除外**：不写进任何家长可见的输出，也不借它提示监护人（见下一节） |\r\n| 倾诉类入口（\"说出让你分心的事\"） | 只接收与学习相关的内容；出现危机信号立即切换 |\r\n| 自建 SKILL 模板（开发者工具） | 模板头部固定带本片段，且不允许写\"不对情绪负责 / 等自习结束再说\"类规则 |\r\n\r\n## 家庭安全类信号（伤害可能来自家里）\r\n\r\n学生说到家里有人打他、经常谩骂、恐吓他、虐待他（含性侵害），不给饭吃、长期没人照料，把他赶出家门或威胁送走他，或者说害怕回家——伤害可能来自家里。这时去提示监护人，可能让孩子更危险。所以这一类**不按\"提示监护人\"处理**，其余处置照旧：\r\n\r\n- **对学生**：先说\"这不是你的错\"。不劝他去告诉可能伤害他的家人，也不劝他回家\"好好沟通\"；建议尽快告诉信任的大人——老师、班主任、学校的心理老师，或不住在一起、信得过的亲戚。学生自己说家里另一位大人（比如妈妈）能保护他，不反驳，同时仍建议告诉老师。有即时危险时，按上文\"适用地域\"给紧急电话。\r\n- **家长可见的内容**（家庭看板、周报家庭版、月报家长页、兴趣简报、老师端的家长反馈与家长消息）：不写这件事，不暗示，也不借这些内容提示监护人。学生端只对学生本人说，老师端只对老师说（家长、监护人自己说起家里有人打孩子的，按下文\"家长、监护人自己说打了孩子\"一条）。学生与监护人共用会话或设备、或小学有家长在旁边时，回应里不复述学生说的细节，也不提\"家里\"，只建议去找老师、班主任或学校的心理老师（家庭版最低话术里的\"不住在一起、你信得过的亲戚\"也不说）。\r\n- **老师端**（本条与下面三条里的报告途径、部门与法条都按中国大陆写，其他地区见下面第三条末句）：不先联系监护人，不找家长核实或对质；不起草提到这件事的家长消息；处置之后，照常的学习反馈照旧（不突然中断；学校或有关部门另有安排的，听他们的），也不在里面暗示。不追问学生细节，也不承诺替学生保密（可以告诉学生：会请能保护他的人来帮忙）；学生的原话、时间和看到的伤如实写进交给学校或公安的报告，不写进本库的工作空间与记录。要不要告诉家长、告诉哪一位，由学校（机构）和公安、民政等部门决定。\r\n  - 学校老师：当天按学校的学生保护流程，报告班主任或学校分管学生保护工作的校领导（有的学校设学生保护专员；老师本人就是班主任的，直接报告分管校领导），由学校依照规定向公安、民政、教育等部门报告；学校没有及时报告的，老师自己直接向公安机关报告（也可以向主管教育行政部门报告）——这项报告义务，法律也规定给了教职工本人。依据：《未成年人学校保护规定》第四十七条（学校和教职工发现学生遭受或疑似遭受家庭暴力、虐待、遗弃、长期无人照料等不法侵害的，应当依照规定及时向公安、民政、教育等有关部门报告）、第四十八条；《反家庭暴力法》第十四条——学校及其工作人员发现未成年学生遭受或疑似遭受家庭暴力的，应当及时向公安机关报案，公安机关对报案人的信息保密；性侵害、性骚扰另见《未成年人保护法》第四十条（学校不得隐瞒，应当及时向公安机关、教育行政部门报告）。\r\n  - 校外培训机构的老师按机构的流程报告，机构没有流程或没有及时报告的，自己直接向公安机关报告；独立教师没有机构，当天直接向公安机关报告。依据：《未成年人保护法》第十一条——密切接触未成年人的单位（第一百三十条：含学校、校外培训机构）及其工作人员，在工作中发现未成年人身心健康受到侵害、疑似受到侵害或面临其他危险情形的，应当立即向公安、民政、教育等有关部门报告；任何组织或个人发现这类情形，都有权劝阻、制止，或向这些部门检举、控告。\r\n  - 正在发生危险时立即报警（中国大陆为 110）。学生说不敢回家、向学校求助时，学校不得拒绝、推诿，需要救助的先行救助：先别让他一个人回家，等学校和公安、民政部门安排（《未成年人学校保护规定》第四十九条）。学生已满 18 周岁、能自己作主时，上面引的强制报告条文不适用：老师照样告诉学校，向外报案先听学生本人的意见，并告诉他可以向居委会、妇联求助或向公安机关报案（《反家庭暴力法》第十三条）；正在发生危险时照样报警。在其他地区，按当地法律与学校规程报告，求助方式按上文\"适用地域\"。\r\n- 说到被打、被伤害，但说不清是不是家里人干的，按本节处理。只是被爸妈批评、说了几句重话，家里吵架（没人动手）或父母离婚，没有挨打、没有经常被谩骂、恐吓，也没说怕回家的，不算本类：其中的自伤、轻生信号照常提示监护人。家里有大人动手打人或拿刀等凶器吓人，就算不是冲着他（比如爸爸打妈妈），也按本节处理。本类和自伤、轻生信号一起出现时按本节处理，求助热线与紧急电话照样给；老师端报告时把自伤风险一并说明。\r\n- **家长、监护人自己说打了孩子**（比如\"考成这样，昨晚我揍了他一顿\"），或说把孩子关在门外、赶出家门、不给饭吃，或说马上要这样做：伤害就来自正在说话的人，同样按本节处理，只是说话的对象换成家长。\r\n  - 对家长（学生端：家长在用或在旁边）：用下文\"最低话术\"里的家长版。不说教、不贴标签、不吓唬（不说\"我要报警\"\"我要告诉学校\"这类话），也不当作没听见、照常往下讲题。先问孩子现在怎么样、有没有受伤，受了伤先处理，需要的话去医院；说清一句：打骂解决不了学习上的问题，法律也要求家长用文明的方式教育孩子、不允许家庭暴力（《未成年人保护法》第十七条、《家庭教育促进法》第二十三条、《反家庭暴力法》第十二条）；还在气头上的，先离开一会儿，平静下来再谈学习；学习上的难处可以和孩子的班主任或学校的心理老师一起想办法，确认在中国大陆后也可以打 12355（青少年服务台，亲子关系与家庭教育的事也接）。家长说马上要打、还没动手的，不问受伤，先说一句\"请先别动手\"，再接家长版第 2 至 4 行。家长不认同（如\"打孩子是我自己家的事\"）的，不争辩、不重复说教，说一句\"孩子的安全最要紧，需要帮忙随时可以找班主任\"。之后再回到学习的事：先给家长一两件能陪孩子一起做的事，不罗列分数、错题与弱项清单。\r\n  - 正在打、孩子伤得重、孩子这会儿正被关在门外或赶出了家门，或家长说控制不住自己：有即时危险，停下一切流程，按上文\"适用地域\"给紧急电话（中国大陆为 110/120；只是孩子伤得重、没有别的危险的，给 120）；孩子被关在门外或赶出了家门的，先请家长马上把孩子领进屋，找不到孩子的立即报警；家长说控制不住自己的，先请他离开孩子所在的房间，家里有别的大人的，请那位大人照看孩子。\r\n  - 孩子可能就在旁边（共用会话或设备、小学有家长在旁边）：家长版照说，法律那句不展开，也不评判这次算不算家庭暴力；不当着孩子数落家长，不复述细节，也不让孩子表态；之后孩子单独说到挨打、害怕回家的，按本节对学生的做法。\r\n  - 家长说的是家里另一位大人打孩子（对这位家长不用上面的家长版）：先护住孩子和自己，正在发生危险时报警；孩子或自己受了伤的先去医院，病历和伤情照片留好；不劝他先去和打人的一方\"好好谈\"；可以向居委会（村委会）、妇联投诉、求助，或向公安机关报案（《反家庭暴力法》第十三条），也可以向法院申请人身安全保护令（第二十三条），告诉孩子的班主任，请学校一起帮忙；确认在中国大陆后，也可以打 12355 咨询。手机或设备打人的一方也会用的，提醒家长看完可以删掉这段对话。\r\n  - 这件事不写进本库的档案和任何记录（处置事实也不记），不写进家长可见的内容，学习记录里也不把挨打写成原因或教训。老师端：家长发来的原消息留着（截图），不删。\r\n  - 老师端：家长在消息里或当面对老师说自己打了孩子，也是疑似家庭暴力，照上面\"老师端\"一条报告（报告途径相同；家长的原话和时间如实写进报告）。回这位家长的消息时，在学习安排之外加一句不带指责的劝阻，比如\"成绩的事我们一起想办法，请别因为成绩打骂孩子\"——这一句和下面给保护方家长的回复，是上面\"不起草提到这件事的家长消息\"仅有的两个例外；不提报告，不追问打成什么样，不对质。家长说到孩子受了伤、经常这样，或把孩子关在门外、赶出家门、不给饭吃的，老师自己看到孩子身上有伤的也算，先报告（孩子这会儿还在门外或找不到的，按正在发生危险立即报警），回不回、怎么回听学校（机构）和公安的；他们交代之前，照常的学习反馈照旧，不提这件事，也不加这句劝阻。家长只说要打、还没动手的，回消息时同样加这一句劝阻，并留意孩子之后的状况（学校老师同时告诉班主任）；说要拿棍子、皮带等东西打，或说自己控制不住的，孩子面临危险，照上面\"老师端\"一条报告，回消息时照样加这一句劝阻；说眼下就要动手的，按正在发生危险立即报警；孩子之后说到挨打、身上有伤或害怕回家的，按本节处理。家长说的是家里另一位大人打孩子的，同样照上面\"老师端\"一条报告；回这位家长时可以写\"谢谢您告诉我。孩子和您的安全最要紧，遇到危险请先报警，居委会、妇联也都可以求助\"，不在消息里问细节、复述细节（手机可能被打人的一方看到）。学生已满 18 周岁的，照上面\"老师端\"一条里成年学生的写法：向外报案先听学生本人的意见。\r\n- 档案照旧只记\"已转介\"的处置事实，不写家庭信息，也不记\"已提示监护人\"；家长可见的内容不显示这条记录。小学有家长在旁边、学生与监护人共用会话或设备，或家长自己说打了孩子时，这一条不记；事后的跟进只在确认是学生本人、身边没有家里人时再问。\r\n\r\n## 最低话术\r\n\r\n**通用部分（任何地区都可以先说）：**\r\n\r\n```text\r\n谢谢你愿意告诉我。这件事很重要，比任何题目都重要。\r\n我是学习伙伴，帮不了这么重要的事，但我很在意你。\r\n现在能不能找一位你信任的大人——爸爸妈妈、老师、或学校的心理老师——把刚才的话告诉他们？\r\n如果你现在就有危险，请立刻拨打你所在地区的紧急电话。\r\n```\r\n\r\n**伤害可能来自家里时**（见\"家庭安全类信号\"一节），通用部分改用这一版：\r\n\r\n```text\r\n谢谢你愿意告诉我。这不是你的错。\r\n这件事需要能保护你的大人来帮你。我是学习伙伴，帮不了这么大的忙，但我很在意你。\r\n能不能尽快找一位你信任的大人——老师、班主任、学校的心理老师，或者不住在一起、你信得过的亲戚——把刚才的话告诉他们？\r\n你现在安全吗？如果现在就有危险，请立刻拨打你所在地区的紧急电话。\r\n```\r\n\r\n**家长、监护人自己说打了孩子时**（学生端用，见\"家庭安全类信号\"一节；老师端回家长的消息不用这一版，照该节\"家长、监护人自己说打了孩子\"一条里的\"老师端\"一小条写），先说这一版：\r\n\r\n```text\r\n学习的事先放一放，我想先问一句：孩子现在怎么样？有没有受伤？受了伤先处理，需要的话带孩子去医院。\r\n成绩也好，作业也好，打骂都解决不了问题；法律也要求家长用文明的方式教育孩子，不允许家庭暴力。\r\n要是火气还没下去，先离开一会儿，等平静下来再谈学习。\r\n学习上的难处我可以帮着一起看，也可以找孩子的班主任或学校的心理老师一起想办法。孩子伤得重，或者现在还有危险的，请立刻拨打您所在地区的急救或紧急电话。\r\n```\r\n\r\n**家长版确认在中国大陆后，补这一句**（不用下面给学生的那段；有即时危险时按\"家庭安全类信号\"一节给 110/120）：\r\n\r\n```text\r\n亲子关系、家庭教育上的难处，也可以打 12355（青少年服务台）；孩子伤得重的，打 120。\r\n```\r\n\r\n**确认在中国大陆后，再补这一句：**\r\n\r\n```text\r\n即时危险可以打 110 或 120。\r\n也可以打 12355（青少年服务台）或 400-161-9995（希望24热线）。\r\n```\r\n\r\n**确认在其他地区时：**\r\n\r\n```text\r\n我这里只有中国大陆的求助号码，可能不适用于你所在的地方。\r\n请拨打你所在国家/地区的紧急电话，或联系学校的辅导老师。\r\n```\r\n\r\n## 禁止\r\n\r\n- 不做诊断、不贴\"抑郁/焦虑症\"标签。\r\n- 不承诺替学生保密到掩盖危险。\r\n- 家庭安全类信号：不劝学生去告诉可能伤害他的人，不借家长可见的内容提示监护人；老师端不先联系监护人（家长自己说起家里有人打孩子时回他的消息不算，见\"家庭安全类信号\"一节）；家长自己说打了孩子时，不当作没听见，也不说教、吓唬（老师端的严重情形，学校、公安交代之前回家长的消息不提这件事，见同一节）。\r\n- 不把危机信号写进\"本周阳光总结 / 攻坚蓄能期\"。\r\n- 不在档案中记录事件细节，只记录\"已触发危机转介、已提示成年人/求助渠道\"的处置事实（schema `safetyRecord`）——**且只在档案已经开启（profileEnabled 为 true）时记**；没开档案就什么都不写，也不为了记这一条去建档。**记录动作只由学习DNA 执行**（它是 `safetyRecord` 的唯一写入方，见其授权规则表“危机转介”一行）；其他 SKILL 不写 `safetyRecord`，职责到按本文处置为止。\r\n- **不在未确认地区的情况下，把中国大陆号码当作通用紧急联系方式输出。**\n\nFile v2.11.0:shared/crisis-referral-protocol.md\n\n<!-- 本文件由 scripts/sync-shared.mjs 从技能 xiaozhi-learning-dna 的 references 目录下的 crisis-referral-protocol.md 自动生成，用于让单个技能包自包含。\n     请勿直接编辑；需要修改请改那份原件，然后运行 npm run sync:shared -->\n\n# 危机识别与转介协议（全库共享安全底线）\r\n\r\n> 适用学段：全部（小学低段至高中，无例外）。\r\n> 本协议是小智伴学全库的**安全底线**，优先级高于任何\"低敏温情转化\"\"家长看板输出\"或\"学习状态观察\"规则。\r\n> 适用于：`xiaozhi-learning-dna`（学习情绪维度 §7）、`xiaozhi-weekly-review`（家庭分享版）、以及任何可能接触到学生情绪/求助信号的 SKILL。\r\n\r\n---\r\n\r\n## 一、为什么需要这条底线\r\n\r\n学习情绪维度与家庭看板的\"低敏温情转化\"（把\"高度焦虑/挫败抗拒\"转述为\"攻坚蓄能期/静息调整期\"）在**普通学习压力**场景是恰当的——避免激化家长焦虑。\r\n\r\n但当出现**超出学习支持范畴的危机信号**时，低敏转化会**掩盖真实求救信号**，是危险的。此时必须**立即切换到本协议**，停止一切美化措辞。\r\n\r\n> ⚠️ 核心原则：**宁可误报，不可漏报。** 涉及未成年人安全时，谨慎地\"多提示一次监护人\"，远好过把求救信号包装成\"学习状态正常波动\"。伤害可能来自家里时例外：不提示监护人，见第三节末的\"家庭安全类信号\"。\r\n\r\n---\r\n\r\n## 二、危机信号（出现任一即触发本协议）\r\n\r\n- **自伤/自残**：提到伤害自己、已经伤害过自己、\"疼一下会好受些\"等。\r\n- **轻生念头**：提到不想活、\"消失就好了\"、\"没有我大家会更好\"、交代后事、赠送珍视物品等。\r\n- **遭受伤害**：提到被打、被欺凌/霸凌、被威胁、被孤立、遭受身体或性的侵害。\r\n- **持续严重低落/绝望**：长时间（非一次考试失利）表达\"一切都没意义\"\"怎么努力都没用\"\"我是废物\"，伴随睡眠/食欲/兴趣的明显改变。\r\n- **家庭安全问题**：提到家中暴力（挨打，或经常被谩骂、恐吓；看到、听到家里大人打人或拿刀等凶器吓人也算）、虐待（含性侵害）、被忽视到影响基本安全，或害怕回家、被赶出家门、被威胁送走。处置与其他信号不同，见第三节末的\"家庭安全类信号\"。\r\n\r\n> 说明：这些是**安全信号识别**，**不是**心理诊断。不要给学生贴\"抑郁症\"\"焦虑症\"等标签。\r\n\r\n---\r\n\r\n## 三、触发后必须做（按顺序）\r\n\r\n1. **停止低敏转化**：不把该信号写成\"攻坚蓄能期/静息调整期/信心重建期\"等安抚话术；不\"报喜不报忧\"。\r\n2. **稳住、不评判、不追问细节**：表达关心与陪伴（\"谢谢你愿意告诉我，你现在的感受很重要\"），**不要**追问细节、不要说教、不要轻描淡写（\"别想太多\"\"大家都这样\"）。\r\n3. **明确 AI 的边界**：坦诚\"我是学习伙伴，帮不了这么重要的事，但我很在意你，希望你现在就找到能真正帮到你的人\"。\r\n4. **如实、及时提示可信的成年人**：建议学生立即联系**信任的成年人**（父母/监护人、老师、学校心理老师）。若信号出现在家长/监护人可见的看板或报告场景，**如实、不美化**地提示监护人尽快关注与陪伴，并建议寻求专业帮助——**不得**用低敏话术冲淡。伤害可能来自家里时，本步改按本节末的\"家庭安全类信号\"做。\r\n5. **提供专业求助渠道**（见第五节）。\r\n6. **如有即时危险**（正在自伤、有立即轻生行动等）：建议**立即拨打所在地区的紧急电话**或前往最近的医院急诊。具体号码按第五节的地域判断给出——确认在中国大陆才说 110/120，其他地区说\"你所在国家/地区的紧急电话\"。\r\n\r\n**家庭安全类信号（伤害可能来自家里）**：第 4 步改为下面的做法；第 3 步的说法改用 `shared/crisis-exception.md` 家庭版最低话术（先说\"这件事需要能保护你的大人来帮你\"），其余各步照旧。提示可能造成伤害的监护人，可能让孩子更危险。\r\n\r\n- 先告诉学生\"这不是你的错\"。不劝他去告诉可能伤害他的家人，也不劝他回家\"好好沟通\"；建议尽快告诉**家庭以外信任的成年人**（老师、班主任、学校心理老师，或不住在一起、信得过的亲戚）；学生自己说家里另一位大人能保护他，不反驳，同时仍建议告诉老师。\r\n- 不在家长/监护人可见的看板、报告、家长消息里写这件事，不暗示，也不借它们提示监护人（家长、监护人自己说起家里有人打孩子的，见本节\"家长、监护人自己说打了孩子\"一条）；学生与监护人共用会话或设备、或小学有家长在旁边时，回应里不复述细节，也不提\"家里\"，只建议去找老师、班主任或学校心理老师（家庭版最低话术里的\"不住在一起、你信得过的亲戚\"也不说）。\r\n- 老师端：不先联系监护人，不找家长核实或对质，不追问学生细节，不承诺替学生保密；不起草提到这件事的家长消息。学校老师当天按学校的学生保护流程，报告班主任或学校分管学生保护工作的校领导，由学校依照规定向公安、民政、教育等部门报告；学校没有及时报告的，老师自己直接向公安机关报告，这项报告义务法律也规定给了教职工本人（《未成年人学校保护规定》第四十七、四十八条；家庭暴力另见《反家庭暴力法》第十四条，性侵害另见《未成年人保护法》第四十条）。校外培训机构的老师按机构的流程报告，机构没有流程或没有及时报告的，自己直接向公安机关报告；独立教师当天直接向公安机关报告（《未成年人保护法》第十一条）。要不要告诉家长、告诉哪一位，由学校（机构）和有关部门决定。正在发生危险时立即报警（中国大陆为 110，其他地区用当地紧急电话）；学生说不敢回家、向学校求助时，需要救助的，学校先行救助，先别让他一个人回家（《未成年人学校保护规定》第四十九条）。学生已满 18 周岁的，向外报案先听本人意见，正在发生危险时照样报警。其他地区按当地法律与学校规程报告。\r\n- 说到被打、被伤害，但说不清是不是家里人干的，按本条做。只是被父母批评、说了几句重话，家里吵架（没人动手）或父母离婚，没有挨打、没有经常被谩骂、恐吓，也没说怕回家的，不算本类：其中的自伤、轻生信号照常按第 4 步提示监护人。家里有大人动手打人或拿刀等凶器吓人，就算不是冲着他（比如爸爸打妈妈），也按本条做。本类和自伤、轻生信号一起出现时按本条做，第 5、6 步照旧；老师端报告时把自伤风险一并说明。\r\n- 家长、监护人自己说打了孩子（或说把孩子关在门外、赶出家门、不给饭吃，或说马上要这样做）：说话的对象换成家长，照 `shared/crisis-exception.md` 本类一节\"家长、监护人自己说打了孩子\"一条与家长版最低话术——不说教、不吓唬，也不当作没听见；先问孩子有没有受伤，说清打骂解决不了学习上的问题、法律也要求家长用文明的方式教育孩子、不允许家庭暴力，建议先冷静、找班主任或学校心理老师一起想办法；正在打、伤得重、孩子正被关在门外或赶出了家门，或家长说控制不住自己时按第 6 步，号码与第一步照 `shared/crisis-exception.md` 同一条。孩子可能在旁边时，不当着孩子数落家长，不复述细节，也不让孩子表态。家长说的是另一位家里人打孩子的，建议先护住孩子和自己，正在发生危险时报警，不劝他先去和打人的一方\"好好谈\"；也可以向居委会（村委会）、妇联或公安机关求助（《反家庭暴力法》第十三条），告诉孩子的班主任，请学校一起帮忙。这件事不记档案（处置事实也不记）。老师端听家长自己说打了孩子，照上面老师端一条报告；回这位家长的消息只加一句不带指责的劝阻，不提报告、不追问、不对质；孩子受了伤、经常这样，或被关在门外、赶出家门、不给饭吃的，先报告（孩子这会儿还在门外或找不到的，立即报警），回不回、怎么回听学校（机构）和公安的，交代之前照常的学习反馈照旧，不提这件事。家长说的是另一位家里人打孩子的，老师端同样报告，回复只给求助途径，不问、不复述细节。\r\n- 档案的处置事实记\"已建议联系信任的成年人\"，不记\"已提示监护人\"；小学有家长在旁边、学生与监护人共用会话或设备，或家长自己说打了孩子时，处置事实也不记。\r\n\r\n---\r\n\r\n## 四、禁止（触发本协议时）\r\n\r\n- ❌ 不把危机信号做低敏转化后写进家长看板/周报\"阳光总结\"。\r\n- ❌ 不承诺\"替你保密\"到掩盖危险的程度——学生安全高于隐私偏好。\r\n- ❌ 家庭安全类信号：不劝学生去告诉可能伤害他的人，不借家长可见的内容提示监护人，老师端不先联系监护人（家长自己说起家里有人打孩子时回他的消息不算，见第三节）。\r\n- ❌ 不做心理诊断、不贴病理标签、不评判对错。\r\n- ❌ 不把危机的**具体隐私细节**（家庭事件、创伤细节等）写入长期档案；档案中仅可记录\"已触发危机转介、已提示监护人/建议专业求助\"这一**处置事实**（由学习DNA 记入 `safetyRecord`，其他 SKILL 不写），不留敏感细节。\r\n- ❌ 不因\"要保持温情/不想吓到家长\"而弱化提示。\r\n\r\n---\r\n\r\n## 五、专业求助渠道\r\n\r\n> ⚠️ **先确认地区再给号码。** 下列号码**只在中国大陆有效**。不确定学生所在地区时，先问\"你现在在哪个国家或地区\"；在问清之前只做\"联系身边信任的成年人 / 拨打你所在地区的紧急电话\"这类通用引导，**不要**直接报出中国大陆号码。\r\n\r\n### 中国大陆\r\n\r\n- **紧急危险**（正在发生的伤害/立即风险）：**110（警) / 120（急救）**\r\n- **北京心理危机研究与干预中心** 24 小时热线：**010-82951332**\r\n- **希望24热线**（生命教育与危机干预）：**400-161-9995**\r\n- **共青团 12355** 青少年服务台（心理与法律援助）：**12355**\r\n- 学校心理老师 / 当地精神卫生中心 / 未成年人保护热线\r\n\r\n> 提示：具体号码可能随地区与时间变化，使用前请让学生/家长核实当地有效渠道；中国大陆的即时危险以 110/120 为准。\r\n\r\n### 中国大陆以外\r\n\r\n不要输出上面的号码。改为：\r\n\r\n- **即时危险**：请拨打你所在国家/地区的紧急电话\r\n- 学校辅导老师 / 家庭医生 / 当地青少年心理支持热线\r\n- 若部署方在平台侧配置了本地求助渠道，优先使用配置值\r\n\r\n部署到中国大陆以外时，运营方应在上架说明与本节中替换为当地渠道。\r\n\r\n---\r\n\r\n## 六、事后\r\n\r\n- 危机缓解后，**回归学习支持角色**，不反复追问、不把学生当\"病人\"看待。\r\n- 若学生愿意，可温和确认\"你后来找到能帮你的人了吗？\"，但不施压。家庭安全类信号只在确认是学生本人、身边没有家里人时问。\r\n- 长期档案仅保留\"处置事实 + 是否已连接到成年人/专业支持\"，供后续温和跟进，不留敏感细节。\n\nFile v2.11.0:shared/grade-bands.md\n\n<!-- 本文件由 scripts/sync-shared.mjs 从仓库根 shared/ 自动生成，用于让单个技能包自包含。\n     请勿直接编辑；需要修改请改仓库根目录下的同名文件，然后运行 npm run sync:shared -->\n\n# 学段参数表\r\n\r\n> 与 `shared/vocab.md §10` 配套。所有涉及时间、时长、课时、提醒窗口的 SKILL 只引用本表，不在正文写死数字。以下为**默认经验值**，用户（学生/监护人/老师）可在会话中调整；调整后以用户设置为准。第一节表下的睡眠时间与就寝时间、第三节校外培训的时段上限（小学低段、中段、高段再提前的三个时刻是本库默认）、第五节作业总量出自国家规定，只能往更严的方向调：就寝与校外培训结束时间只能更早，睡眠时间只能更长，作业量只能更少。\r\n\r\n## 一、作息与提醒窗口\r\n\r\n| 学段 | 建议就寝不晚于 | 免打扰窗口（不发送任何提醒） | 每日提醒上限 |\r\n|---|---|---|---|\r\n| 小学低段（1-2） | 20:30 | 20:00 – 7:30 | 不适用（IM 提醒从小学中段起） |\r\n| 小学中段（3-4） | 21:00 | 20:30 – 7:30 | 1 条合并摘要 |\r\n| 小学高段（5-6） | 21:20 | 21:00 – 7:00 | 1 条合并摘要 + 1 条即时 |\r\n| 初中（7-9） | 22:00 | 21:30 – 7:00 | 1 条合并摘要 + 1 条即时 |\r\n| 高中（10-12） | 23:00 | 22:30 – 6:30 | 1 条合并摘要 + 1 条即时 |\r\n\r\n睡眠时间：小学生每天应达到 10 小时，初中生 9 小时，高中生 8 小时；就寝一般不晚于小学 21:20、初中 22:00、高中 23:00（教育部办公厅《关于进一步加强中小学生睡眠管理工作的通知》，教基厅函〔2021〕11 号）。上表小学低段 20:30、中段 21:00 是本库更早的默认值；个别学生到就寝时间作业还没做完的，也按时就寝，不熬夜（同一通知）。\r\n\r\n## 二、单次专注与休息（番茄钟默认值）\r\n\r\n| 学段 | 单次专注 | 短休 | 一次学习段最多几个番茄 |\r\n|---|---|---|---|\r\n| 小学低段 | 10-15 分钟 | 5 分钟 | 2 |\r\n| 小学中段 | 15-20 分钟 | 5 分钟 | 3 |\r\n| 小学高段 | 20-25 分钟 | 5 分钟 | 3 |\r\n| 初中 | 25 分钟 | 5 分钟 | 4 |\r\n| 高中 | 25-40 分钟 | 5-10 分钟 | 4 |\r\n\r\n## 三、课时与课堂\r\n\r\n| 学段 | 一节课 | 45 分钟教案伸缩表中的档位 |\r\n|---|---|---|\r\n| 小学 | 40 分钟 | 40 |\r\n| 初中 | 45 分钟 | 45 |\r\n| 高中 | 40 或 45 分钟（各地不同） | 40 / 45 |\r\n| 校外一对一 / 小班 | 线下 60 / 90 分钟。所有学段：线下结束不晚于 20:30、线上不晚于 21:00，不与学校教学时间冲突（国办发〔2018〕80 号、教基厅函〔2021〕11 号）；小学低段 19:30、小学中段 20:00、小学高段 20:20 前结束（按一的就寝时间再提前，本库默认）。面向义务教育阶段学生的学科类培训另外：线上每课时不超过 30 分钟、课程间隔不少于 10 分钟，不排休息日、法定节假日与寒暑假（双减意见；高中参照执行，按当地规定） | 30 / 60 / 90 |\r\n\r\n## 四、学生端 SKILL 适用性（默认）\r\n\r\n| SKILL 类型 | 小学低段 | 小学中段 | 小学高段 | 初中 | 高中 |\r\n|---|---|---|---|---|---|\r\n| 数学五个学生端技能 | 不适用 | 不适用 | 不适用 | 适用 | 高中原生（必修与选择性必修） |\r\n| 英语五个学生端技能 | 不适用 | 不适用 | 适用（降级版） | 适用 | 高中原生（必修与选择性必修） |\r\n| 语文五个学生端技能 | 不适用 | 不适用 | 适用（降级版；跨时空古文对话除外） | 适用 | 高中原生（必修与选择性必修；选修如实说明不覆盖） |\r\n| 物理五个学生端技能 | 不适用 | 不适用 | 不适用 | 适用（八、九年级） | 高中原生（必修与选择性必修；按选科定合格考或等级考的深度） |\r\n| 化学五个学生端技能 | 不适用 | 不适用 | 不适用 | 学校开了化学才适用（开课年级见表下说明） | 高中原生（必修与选择性必修；按选科定合格考或等级考的深度） |\r\n| 初高衔接规划 | 不适用 | 不适用 | 不适用 | 九年级下学期至中考后暑假 | 高一上学期 |\r\n| 历史三个学生端技能 | 不适用 | 不适用 | 不适用 | 适用（七至九年级；开卷考试地区配合开卷答题教练） | 高中原生（必修与选择性必修；按选科定合格考或等级考的深度） |\r\n| 开卷答题教练 | 不适用 | 不适用 | 不适用 | 本地中考有开卷科目时适用 | 不适用 |\r\n| 生物五个学生端技能 | 不适用 | 不适用 | 不适用 | 适用（学校开设生物学课的年级；含初中学业水平考试的复习） | 高中原生（必修与选择性必修；按选科定合格考或等级考的深度） |\r\n| 地理三个学生端技能 | 不适用 | 不适用 | 不适用 | 适用（学校开设地理课的年级；含初中学业水平考试的复习） | 高中原生（必修与选择性必修；按选科定合格考或等级考的深度） |\r\n| 费曼学习 | 不适用 | 仅前两跳 | 前三跳 | 全流程 | 全流程 |\r\n| 康奈尔笔记 | 不适用 | 不适用 | 简化版（三栏→两栏） | 适用 | 适用 |\r\n| 30 天学习计划 | 不适用 | 不适用 | 周计划版 | 适用 | 适用 |\r\n| 兴趣探索（52 周） | 不适用 | 8 周试探版 | 8 周试探版 | 适用 | 适用 |\r\n| 时间与专注力 | 不适用 | 番茄钟入门 | 适用 | 适用 | 适用 |\r\n| 错题本 | 不适用 | 快速记录模式 | 快速记录模式 | 适用 | 适用 |\r\n| 每周复盘 | 不适用 | 三问版 | 三问版 | 七问版 | 七问版 |\r\n| 学习 DNA / IM 提醒 | 不适用 | 仅监护人开启 | 监护人同意 | 学生 + 监护人 | 学生本人 |\r\n\r\n学科错误 DNA（数学、物理、化学、生物）不在\"错题本\"一行，随所属学科一行，都从初中起。\r\n\r\n**理化开课年级各地不同**：六三制地区物理一般从八年级、化学从九年级开设；五四制地区化学从八年级开设；浙江等地初中开设综合的《科学》课，物理、化学内容分散在各年级学。化学技能按\"学校开没开化学\"判断，不按年级号一刀切：七、八年级学生问化学，先问一句学校教没教过。\r\n\r\n\"不适用\"时 SKILL 应直接说明并建议由监护人/老师陪同，不强行降级。\r\n\r\n**小学各学段一律以有家长或老师在场为前提**（`shared/vocab.md` §8 规则 4，依据《中小学生成式人工智能使用指南（2025年版）》）。表中小学列的\"简化版 / 降级版 / 适用\"等都在这个前提下成立。\r\n\r\n**学科技能的高中列**：`grade_bands` 声明了 `高中` 的学科技能是**高中原生**——高中章节按高中课标写，不逐行标注越纲（`shared/vocab.md` §10）；其余学科技能对高中学生仍按\"适用（标注越纲）\"处理。\r\n\r\n## 五、作业总量（全部学科合计）\r\n\r\n| 学段 | 每天书面作业总量 |\r\n|---|---|\r\n| 小学一、二年级 | 不布置家庭书面作业，可在校内适当安排巩固练习 |\r\n| 小学三至六年级 | 平均完成时间不超过 60 分钟 |\r\n| 初中 | 平均完成时间不超过 90 分钟 |\r\n| 高中 | 没有全国统一的分钟数，按本校晚自习安排、年级统筹与就寝时间协调 |\r\n\r\n依据：教育部办公厅《关于加强义务教育学校作业管理的通知》（教基厅函〔2021〕13 号）与\"双减\"意见。这是**全部学科合计**的上限，各科份额由学校（年级）统筹；技能给单科出作业时，先问本科份额，问不到时按\"全科总量 ÷ 当天有书面作业的科数\"估并写明是估的，不把本科作业量写到接近全科上限。不给家长布置或变相布置作业，不要求家长检查、批改作业（\"双减\"意见）；校外培训不给学员留作业（独立教师包的校外培训口径）。\r\n\r\n## 六、说明\r\n\r\n本表不是政策文件的复述，只提供 SKILL 运行所需的默认参数；各地校规、家庭安排优先，但出自国家规定的几项（见文首）只能往更严的方向调。\n\nFile v2.11.0:shared/hint-ladder.md\n\n<!-- 本文件由 scripts/sync-shared.mjs 从仓库根 shared/ 自动生成，用于让单个技能包自包含。\r\n     请勿直接编辑；需要修改请改仓库根目录下的同名文件，然后运行 npm run sync:shared -->\r\n\r\n# 提示阶梯与\"完整示例\"出口\r\n\r\n> 替代各 SKILL 中\"永远不给答案 / 不给完整步骤\"的绝对禁令。原则：**不代做，但不把学生困死**。新手需要 worked example（示例效应），熟手需要自己想（专长逆转效应）；SKILL 按学生当前状态选择阶梯位置。\r\n\r\n## 〇、前置：考试进行中不进入阶梯\r\n\r\n学生说明**正在考试或测验中**——线上考试、限时测验、老师说过不许外传的卷子——SKILL 不进入提示阶梯，不讲该题、不给任何方向提示。\r\n用一句话说明原因（考试中用 AI 属于作弊，《中小学生成式人工智能使用指南（2025年版）》要求学生不得利用生成式人工智能作弊），并约好考完再来一起复盘。\r\n\r\n- 判断只看学生自述或明确的上下文（\"还有十分钟交卷\"\"监考老师出去了\"）。**已经考完的题、昨天考过的卷子正常讲**——考后复盘是本库鼓励的用法。\r\n- 不确定时问一句\"这是已经考完的，还是正在考？\"，不凭猜测拒绝。\r\n- 不说教、不记录、不告诉家长；学生说已经考完了，就按正常流程走。\r\n\r\n## 一、提示阶梯（从轻到重）\r\n\r\n| 级 | 名称 | 给什么 | 不给什么 |\r\n|---|---|---|---|\r\n| L0 | 复述 | 让学生复述条件与问题 | 任何方向 |\r\n| L1 | 方向 | 指出\"这题和哪类知识有关\" | 具体工具 |\r\n| L2 | 工具 | 点名要用的概念/公式/方法名 | 怎么用 |\r\n| L3 | 条件 | 指出题中哪个条件还没用到 | 怎么把它用进去 |\r\n| L4 | 半步 | 给出下一步的一半，让学生补完 | 后续步骤 |\r\n| L5 | 示例 | 用**同型不同数**的例题做一遍完整示范，然后让学生做原题 | 原题答案 |\r\n| L6 | 讲解 | 讲解原题完整过程，**随后必须**让学生独立做一道同类题（按 `shared/ai-item-check.md` 生成） | 直接给答案后结束 |\r\n\r\n## 二、升级规则\r\n\r\n- 每一级学生尝试后仍卡住（一次有实质内容的回答仍不对，或明确说\"不会\"），升一级。\r\n- 同一级最多停留 2 轮。\r\n- 新手（该知识点弱项状态为 `待处理 / 初步弱项`，或学生自报\"这块完全没学过\"）可直接从 L5 开始。\r\n- L6 是出口，不是惩罚：到达 L6 时用一句话说明\"这道我先做给你看，下一道你来\"。\r\n- 学生说\"我不想被引导了，直接告诉我\"：初中及以上尊重一次，走 L5；连续要求 → 走 L6 并记录为\"当前偏好直接讲解\"（不写入长期档案，只在会话内）。\r\n\r\n## 三、各 SKILL 的默认上限\r\n\r\n| SKILL | 默认最高级 | 说明 |\r\n|---|---|---|\r\n| 数学/物理/化学解题教练 | L6 | 到 L6 必须配同类题 |\r\n| 应用题教练 | L5 | 公式只在 L2 以\"名称\"出现，不在 L1 出现 |\r\n| 概念解释器 | L6 | 概念题本来就允许讲解 |\r\n| 时空线索构建器 | L6 | 纪年换算、时代特征可以直接讲，讲完请学生自己排一遍 |\r\n| 梯度训练 | L4 | 超出 L4 说明该层过高，回退一层 |\r\n| 英语语法教练 | L6 | 形式类错误（三单、冠词、复数）研究支持显性纠正，可直接 L5 |\r\n| 化学用语与方程式教练 | L5 | 化学式与配平可显性纠正，随后请学生自己再写一次 |\r\n| 英语/语文写作教练 | L4 | 不代写；L5 只用于\"句式示范\"，不得替学生写论点，不设 L6 |\r\n| 历史论述题教练 | L4 | 不代写；不替学生拟定观点或论题，不设 L5、L6 |\r\n| 语文阅读拆解 | L5 | 示范题必须换文本 |\r\n| 历史材料解析题教练 | L5 | 示范题必须换一则材料；原题的结论不直接给 |\r\n| 遗传推理教练 | L6 | 到 L6 必须配同类题；遗传图解由学生先画 |\r\n| 生物概念网络构建器 | L6 | 概念可以讲，讲完请学生自己画出概念之间的联系 |\r\n| 生物图表与材料题教练、地理读图教练 | L5 | 示范题必须换一幅图 |\r\n| 生物实验探究教练 | L5 | 示范换一个实验情境；本题的实验方案由学生先设计 |\r\n| 地理成因链教练 | L5 | 示范换一个区域或现象；本题的成因链由学生自己连 |\r\n| 区域认知构建器 | L6 | 区域特征可以讲，讲完请学生自己做一次区域比较 |\r\n| 语文语病追踪 | L5 | 先让学生找出病处；示范只改同类的另一句 |\r\n| 文言文复活计划 | L5 | 实词/句式可讲解；翻译题的原句答案不直接给 |\r\n| 费曼学习 | L5（一级支架） | 已是原设计 |\r\n\r\n## 四、与\"铁律\"的关系\r\n\r\n各 SKILL 保留\"不直接给原题答案\"的铁律，铁律的准确表述改为：\r\n> 不在学生尝试之前给原题答案；提示按 `shared/hint-ladder.md` 逐级升，到达上限后用同型例题或讲解 + 同类题收尾。\n\nFile v2.11.0:shared/off-campus-training.md\n\n<!-- 本文件由 scripts/sync-shared.mjs 从仓库根 shared/contracts 目录下的 off-campus-training.md 自动生成，用于让单个技能包自包含。\n     请勿直接编辑；需要修改请改那份原件，然后运行 npm run sync:shared -->\n\n# 校外培训口径（独立教师包通用）\n\n> 本文件是本库技能用于**校外培训**（一对一、小班，线上或线下）时的合规口径唯一定义，只写全国性规定的要点。\n> 分发方式：只随包分发给正文引用了它的技能（独立教师包）。各地另有更严规定的，按当地规定。\n\n---\n\n## 〇、速查（以下各节为准）\n\n| 规定 | 义务教育阶段学员 | 普通高中学员 | 见 |\n|---|---|---|---|\n| 学科类培训须经审批（各地已不再审批新的学科类机构） | 适用 | 适用 | 一 |\n| 不与学校教学时间冲突；线下 20:30、线上 21:00 前结束 | 适用 | 适用 | 二 |\n| 不占休息日、法定节假日与寒暑假；线上每课时不超过 30 分钟、课程间隔不少于 10 分钟（学科类） | 适用 | 参照执行，按当地规定 | 二 |\n| 不留作业 | 适用 | 适用 | 三 |\n| 不超标超前 | 适用 | 适用 | 四 |\n| 一次收费不超过 3 个月，也不超过 60 课时 | 适用 | 适用 | 五 |\n| 不组织学科类等级考试、竞赛，不排名 | 适用 | 适用 | 六 |\n| 学员的学校考试结果不写名次、不和别的学员比较（本库做法） | 适用；另写学校给的等级，不写总分 | 适用 | 六 |\n\n个人家教也按这张表执行（本库做法）。法规直接针对个人的是第一节：未经审批以\"一对一\"\"一对多\"等形式有偿开展学科类培训的，属违法情形。\n\n## 一、适用范围\n\n- 本库技能涉及的道德与法治、语文、历史、地理、数学、外语、物理、化学、生物学，在义务教育阶段的校外培训中都按**学科类**管理（教育部办公厅《关于进一步明确义务教育阶段校外培训学科类和非学科类范围的通知》，教监管厅函〔2021〕3 号）；面向普通高中学生的学科类培训参照\"双减\"意见管理，科目范围按当地规定。\n- 面向中小学生的学科类校外培训须经审批；各地已不再审批新的面向义务教育阶段学生、普通高中学生的学科类校外培训机构，现有的义务教育阶段学科类机构统一登记为非营利性机构（\"双减\"意见）。自然人、法人或其他组织未经审批，以\"一对一\"\"一对多\"等形式有偿开展学科类培训的（包括在居民楼、酒店、咖啡厅等场所，或通过即时通讯、网络会议、直播平台），属违法情形（《校外培训行政处罚暂行办法》，教育部令第 53 号，第十七、十八条）。在职中小学教师不得有偿补课（《严禁中小学校和在职中小学教师有偿补课的规定》，教师〔2015〕5 号；\"双减\"意见）。\n- 本库技能只在合法范围内用：技能不预设违规的排课、作业与收费，不制作招生广告；是否合规由使用者按当地规定判断。\n\n## 二、时间\n\n- 面向中小学生（含普通高中学生）的校外培训：不与学校教学时间冲突，线下结束不晚于 20:30（国办发〔2018〕80 号；教育部办公厅《关于进一步加强中小学生睡眠管理工作的通知》，教基厅函〔2021〕11 号）；线上结束不晚于 21:00（中办、国办\"双减\"意见；睡眠管理通知对线上直播类培训同此要求）。\n- 面向义务教育阶段学生的学科类培训另外：不占用国家法定节假日、休息日及寒暑假期；线上每课时不超过 30 分钟、课程间隔不少于 10 分钟（\"双减\"意见）。面向普通高中学生的学科类培训，这两条参照执行，按当地规定。\n- 非学科类：线下结束不晚于 20:30，线上不晚于 21:00（教监管〔2022〕4 号）。\n- 小学学员再按 `shared/grade-bands.md` 第一节的就寝时间提前结束。\n\n## 三、作业\n\n- 校外培训不给学员留作业（面向中小学生都适用）：国办发〔2018〕80 号\"不得留作业\"；教育部办公厅睡眠管理通知（教基厅函〔2021〕11 号）\"不得以课前预习、课后巩固、作业练习、微信群打卡等任何形式布置作业\"；作业管理通知（教基厅函〔2021〕13 号）\"坚决防止校外培训机构给中小学生留作业\"。\n- 课上的练习在课上完成，没做完的下节课课上补；不让学员回家补做，也不请家长督促、检查、批改或拍照打卡。学员自己带来的学校作业、考试错题，可以帮着分析，不追交、不催交。\n\n## 四、内容与进度\n\n- 不超标超前：培训内容不超出相应的国家课程标准，培训班次与学员所处年级相匹配，培训进度不超过所在县（区）中小学同期进度（国办发〔2018〕80 号；\"双减\"意见\"严禁超标超前培训\"）；本库按更严的口径，不超过学员所在学校的同期进度。\n\n## 五、收费\n\n- 一次收费的时间跨度不超过 3 个月，也不超过 60 课时；学科类、非学科类，义务教育阶段与普通高中都适用（教育部等六部门《关于加强校外培训机构预收费监管工作的通知》，教监管函〔2021〕2 号；国办发〔2018〕80 号）；非学科类另不超过 5000 元（教监管〔2022〕4 号）；面向中小学生的培训不得使用培训贷。\n- 判断是否超过 60 课时：本库按标准课时折算（线下 45 分钟、线上 30 分钟为 1 课时，时长不同的按比例折算，如 90 分钟一节算 2 课时；短于标准时长的本库仍按 1 课时数；标准课程时长见发改价格〔2021〕1279 号），这样算更稳妥；按这一次收的课时与起止算，不按累计。折算只用在这一步：课时包台账（总课时、已用课时、每节课记几课时）与跟家长说的\"每周 N 课时\"，照老师与家长约定的记法写（如一节 90 分钟的课记 1 课时），不改成标准课时。\n- 义务教育阶段学科类校外培训收费实行政府指导价（发改价格〔2021〕1279 号）。\n- 本库技能不起草价格、优惠、折扣、推荐返利与限时话术，不比较哪种课时数\"更划算\"。\n\n## 六、考试与排名\n\n- 校外培训不组织中小学生学科类等级考试、竞赛，不排名（国办发〔2018〕80 号）。\n- 学员在学校考试的结果（学员、家长自己带来的）只用于诊断：错题只记知识点与错因维度；写给家长、学员的内容不写名次，不在群里公布，也不和别的学员比较。义务教育阶段学员写学校给的等级与知识点诊断，不写总分（含整卷得分率）；学校没给等级、只知道分数的，只写知识点诊断，不按分数自己折成等级（义务教育学校的考试实行等级评价，不排名、不公布：教育部办公厅教基厅函〔2021〕34 号、教基厅〔2025〕3 号）。\n\n## 七、说明\n\n本约定不是政策全文，只提供技能运行所需的口径；不替使用者判断其培训是否经审批。规定有更新时以最新规定为准。\n\nFile v2.11.0:shared/platform-conventions.md\n\n<!-- 本文件由 scripts/sync-shared.mjs 从仓库根 shared/ 自动生成，用于让单个技能包自包含。\r\n     请勿直接编辑；需要修改请改仓库根目录下的同名文件，然后运行 npm run sync:shared -->\r\n\r\n# 平台能力约定与降级路径（全库共享）\r\n\r\n> 每个 SKILL 的\"技术实现边界声明\"只需一行引用本文件并列出**本 SKILL 用到的能力代号**，不再各自复述平台机制。\r\n> 写法：`> 技术边界：本 SKILL 依赖能力 [M, T]，无该能力时按 shared/platform-conventions.md 降级。`\r\n\r\n## 〇、适用范围与地域\r\n\r\n本库按**中国大陆的中文 K12 场景**设计：学科内容对齐中国课程标准与中考口径，示例与话术为简体中文，安全求助渠道默认中国大陆。\r\n\r\n部署到其他语言或地区时，运营方需要先处理三件事，否则不应直接面向学生使用：\r\n\r\n1. **求助渠道本地化**：按 `shared/crisis-exception.md` 的\"适用地域\"一节替换紧急联系方式；未确认地区前不得输出中国大陆号码。\r\n2. **学科口径核对**：`shared/grade-bands.md` 的学段划分与各学科的课标对齐仅适用于中国大陆学制。\r\n3. **法规核对**：未成年人数据的同意年龄与监护人要求按当地法规调整（`shared/vocab.md §8` 的默认值按中国大陆设定）。\r\n\r\n## 一、能力代号\r\n\r\n| 代号 | 能力 | 由谁提供 | LLM 自身是否具备 |\r\n|---|---|---|---|\r\n| `M` | 跨会话持久记忆（长期档案 / DNA） | 平台本地化持久记忆机制 | 否 |\r\n| `T` | 定时任务 / 主动唤醒 / 推送 | 平台定时任务与工作流引擎 | 否 |\r\n| `O` | 图片 OCR / 题目识别 / 图形识别（电路图、受力图） | 平台多模态或 OCR 服务 | 部分（不保证） |\r\n| `A` | 语音转写（ASR） | 平台语音服务 | 否 |\r\n| `S` | 语音评测（音素级发音打分） | 平台专用评测服务 | 否 |\r\n| `V` | 语音合成（TTS） | 平台语音服务 | 否 |\r\n| `C` | 精确计时（番茄钟、限时练习） | 平台定时任务 | 否 |\r\n| `X` | 跨会话统计计算（正确率、用时、次数） | 平台在档案上计算 | 否（LLM 不得口算历史统计） |\r\n| `F` | 文件 / 表格导入导出 | 平台文件能力 | 否 |\r\n| `K` | 日历 / 日期感知 | 平台注入当前时间 | 否 |\r\n\r\n## 二、统一降级路径\r\n\r\n| 能力缺失 | SKILL 的行为 | 必须说的话（可改措辞，不可省略） |\r\n|---|---|---|\r\n| `M` | 只使用当前会话信息；不承诺\"下次我还记得\"；不生成跨周期报告 | \"我这次记不住会话结束后的内容，需要的话你可以把上次的结论再发我。\" |\r\n| `T` | 不承诺主动提醒；改为\"进入会话时补发到期项\"或建议用户用手机日历 | \"我没法在你不说话时主动提醒你，建议你自己设一个手机提醒，我来负责内容。\" |\r\n| `O` | 让学生只发\"已知条件 + 问题\"一句话文字，或口述题目 | \"图片我看不清/看不了，请把题目的已知条件和问题打字发我，一行就行。\" |\r\n| `A` | 只做文字练习 | \"语音我暂时听不了，先用文字练；文字练习对表达同样有效。\" |\r\n| `S`（有 A 无 S） | **禁止**做音素级发音判断；只反馈用词、语法、流利度 | \"我只能看到你说的文字，听不出发音细节，发音部分请用带评分的工具或请老师听。\" |\r\n| `V` | 听力材料改为\"读力版\"：学生自读或请家人朗读 | 说明本次为阅读理解版 |\r\n| `C` | 番茄钟改为学生自报开始/结束时间 | \"我不能替你计时，你开始时说一声，结束时再说一声。\" |\r\n| `X` | 不输出\"上周你做了 N 道对了 M 道\"类精确统计；只输出本次会话内的计数或\"从档案看大致…\"并标 🟡 | 不得编造历史数字 |\r\n| `F` | 让用户粘贴文本表格；给出列名模板 | |\r\n| `K` | 先问今天日期，再排计划 | |\r\n\r\n## 三、\"自动触发\"的统一措辞\r\n\r\n- 禁止：`自动触发` `自动写入` `自动推送` `静默检查` `自动预扣` `自动确认`。\r\n- 允许：`建议触发（需用户确认）` `生成待确认条目` `在用户同意后提醒` `按需提示`。\r\n- 老师端台账类写入（课时、作业状态）一律生成**待确认条目**，由老师确认后落库。\r\n\r\n## 四、控制入口（每个持有数据的 SKILL 必须包含）\r\n\r\n复制以下段落到 SKILL.md（可按 SKILL 名替换\"档案\"一词）：\r\n\r\n```text\r\n### 隐私与数据控制入口\r\n- 查看：「查看我的[档案/记录]」\r\n- 更正：「更正我的[档案]」\r\n- 删除：「删除我的[档案]」（删除后不可恢复，会先确认一次）\r\n- 暂停：「这次不要记忆」（本次会话不读取、不保存任何记录，也不发起回写与交接）/「暂停提醒」\r\n- 共享控制：「不要共享给其他SKILL」/「不要给家长看」\r\n- 导出：「导出我的[档案]」（以文本形式给出，便于转存）\r\n```\r\n\r\n## 五、提醒入队契约\r\n\r\n其他 SKILL 需要提醒时，只生成一条 `reminder_enqueue` 交接（见 `handover-protocol.schema.json`），由 `xiaozhi-im-reminder` 按 `shared/vocab.md §9` 预算合并发送。SKILL 正文中不得出现\"我会在 X 时提醒你\"，应改为\"我把它加进你的提醒队列，明天的合并提醒里会带上\"。\r\n\r\n## 六、平台字段\r\n\r\nfrontmatter 顶层只放 Agent Skills 官方字段（`name` / `description` / `license` / `compatibility` / `metadata`）与平台加载字段（`id` / `min_platform_version` / `max_round_limit`，仅部分老师端技能有）。本库自有的 `display_name` / `version` / `author` / `category` / `grade_bands` / `tags` / `depends_on` 一律放在 `metadata:` 块内，由 `scripts/check-skills.mjs` F1 校验；发布到各市场时由打包脚本按市场需要投影成顶层字段。平台机制描述不再写入 SKILL 正文。\n\nFile v2.11.0:shared/vocab.md\n\n<!-- 本文件由 scripts/sync-shared.mjs 从仓库根 shared/ 自动生成，用于让单个技能包自包含。\n     请勿直接编辑；需要修改请改仓库根目录下的同名文件，然后运行 npm run sync:shared -->\n\n# 全库统一词表（单一事实源）\r\n\r\n> 本文件是小智伴学全库的**唯一术语与枚举来源**。所有 SKILL.md、references、JSON Schema 只能**引用**本文件的定义，不得在各自正文里另起一套词表或阈值。\r\n> 修改本文件即修改全库契约；修改后请同步更新对应 schema 的 `enum`，并运行 `node scripts/check-skills.mjs`。\r\n> 引用方式：`见 shared/vocab.md §N`。\r\n\r\n---\r\n\r\n## §1 错因基础四维（全学科通用层）\r\n\r\n所有学科的错题在**通用层**只记录以下四维之一（对应 schema：`dna-profile.schema.json#/$defs/errorDimension`、`handover-protocol.schema.json#/…/basicDimension`）：\r\n\r\n| 代码 | 维度名 | 一句话判定 | 不是这一维的情况 |\r\n|---|---|---|---|\r\n| `C` | 概念模糊 | 换成\"纯净版\"最简题也做不对 | 纯净版能做对 → 不是概念问题 |\r\n| `K` | 计算失误 | 思路对、列式对，算错/抄错/漏单位 | 列式就错 → 看 M 或 C |\r\n| `R` | 读题失误 | 把条件读对后立刻会做 | 读对了仍不会 → 看 M 或 C |\r\n| `M` | 方法用错 | 概念清楚、读题无误，但选错工具/路径 | 换题型不会 → 看 C |\r\n\r\n判定顺序：先 R（复述条件）→ 再 C（纯净版）→ 再 M（换题型）→ 剩下的归 K。\r\n**同一道错题只记一个主维度**；学科层可以再记一个子类型 ID（§2）。\r\n\r\n> 已废弃的同义词（禁止在正文出现）：\"概念理解错误 / 计算/操作失误 / 审题习惯问题 / 策略选择错误\"、\"概念 / 计算 / 审题 / 策略\"、\"知识漏洞 / 规则错误 / 粗心大意\"。老师端七类见 §3 映射。\r\n\r\n## §2 学科子类型编码（学科层）\r\n\r\n子类型 ID = 学科前缀 + 两位数字，定义在各学科的错因维度表中；通用层只存 ID，不解释含义。引用方的技能包内若带有该表，文件名为 `shared/<学科>-error-dimension-table.md`。\r\n\r\n| 学科 | 前缀（维度） | 定义文件 |\r\n|---|---|---|\r\n| 数学 | `B`(概念) `C`(计算) `R`(读题) `M`(方法) | 数学错误DNA 的错因维度表 |\r\n| 物理 | `P`(图景) `C`(概念) `F`(公式) `R`(过程) `T`(数学工具) | 物理错误DNA 的错因维度表 |\r\n| 英语 | `G`(语法) `V`(词汇) `T`(表达/中式) `P`(发音) `L`(听力) | 英语语法突破教练 的错因维度表 |\r\n| 语文 | `RC`(阅读) `AR`(答题规范) `WT`(写作) `CL`(文言) `LG`(语病) | 阅读理解拆解师 的错因维度表 |\r\n| 化学 | `HS`(符号表征) `HM`(微观表征) `HC`(宏观概念) `HR`(读题与条件) `HE`(实验与探究) `HQ`(定量计算) | 化学错误DNA 的错因维度表 |\r\n| 历史 | `LS`(史料信息提取) `LT`(时空定位) `LK`(史实与概念混淆) `LA`(论证结构) `LE`(表述规范) | 历史材料解析题教练 的错因维度表 |\r\n| 生物 | `SC`(概念网络) `SF`(结构与功能) `SG`(图表识读) `SV`(变量与实验设计) `SE`(表述与术语) `SQ`(遗传与数据计算) | 生物错误DNA 的错因维度表 |\r\n| 地理 | `DM`(读图) `DR`(区域认知) `DP`(地理过程与原理) `DI`(要素关联) `DE`(表述规范) `DQ`(地理计算) | 地理读图教练 的错因维度表 |\r\n\r\n**新学科一律用「学科前缀 + 维度」两字母编码**（化学的前缀是 `H`，如 `HS01`；历史的前缀是 `L`，如 `LS01`，与语文的 `LG`（语病）不重名；生物的前缀是 `S`，如 `SG02`；地理的前缀是 `D`，如 `DM03`），避免同一个字母在不同学科含义不同。数学、物理、英语的单字母编码与语文的两字母编码保持不变。\r\n\r\n学科维度 → 通用四维的映射：\r\n\r\n| 学科维度 | 通用维度 |\r\n|---|---|\r\n| 数学 B / 物理 C、P / 英语 G、V / 语文 CL / 化学 HS、HM、HC / 历史 LT、LK / 生物 SC、SF / 地理 DR、DP | 概念模糊 |\r\n| 数学 C / 物理 T / 英语 P（拼写）/ 化学 HQ / 生物 SQ / 地理 DQ | 计算失误 |\r\n| 数学 R / 物理 R（审题部分）/ 英语 L / 语文 RC / 化学 HR / 历史 LS / 生物 SG / 地理 DM | 读题失误 |\r\n| 数学 M / 物理 F / 英语 T / 语文 AR、WT、LG / 化学 HE / 历史 LA、LE / 生物 SV、SE / 地理 DI、DE | 方法用错 |\r\n\r\n## §3 老师端错因七类 ↔ 通用四维\r\n\r\n老师端（作业跟进、错因分析、命题）允许使用七类，但写入任何档案或与学生端交换时必须映射：\r\n\r\n| 老师端七类 | 通用四维 | 说明 |\r\n|---|---|---|\r\n| 知识漏洞 | 概念模糊 | |\r\n| 规则错误 | 概念模糊 | 规则记错本质是概念 |\r\n| 计算错误 | 计算失误 | |\r\n| 审题错误 | 读题失误 | 含看错数字、漏条件 |\r\n| 策略错误 | 方法用错 | |\r\n| 表达/书写不规范 | 方法用错 | 会做但过程不得分 |\r\n| 习惯性失误（原\"粗心大意\"） | 计算失误 | 抄错题 → 读题失误。**不使用\"粗心\"作为原因**，粗心是结果 |\r\n\r\n判定互斥规则：一道题只能归一类；\"移项不变号\"归规则错误（概念），不归计算；\"看错数字\"归审题，不归习惯性失误。\r\n\r\n## §4 弱项状态（五档，唯一）\r\n\r\n对应 schema `dna-profile.schema.json#/$defs/weaknessStatus`：\r\n\r\n| 状态 | 进入条件 | 离开条件 |\r\n|---|---|---|\r\n| `待处理` | 首次记录错题 | 记录第 2 次 → 初步弱项 |\r\n| `初步弱项` | 同一知识点 + 同一通用维度在 28 天内累计 2 次 | 第 3 次 → 顽固弱项；2 次独立验证做对 → 已攻克 |\r\n| `顽固弱项` | 28 天内累计 3 次（§5） | 首次独立验证做对 → 突破中 |\r\n| `突破中` | 顽固弱项后首次做对 | 再一次独立验证做对（间隔 ≥ 3 天）→ 已攻克；再错 → 顽固弱项 |\r\n| `已攻克` | 连续 2 次独立验证做对（间隔 ≥ 3 天） | 30 天内再错 → 突破中 |\r\n\r\n> 已废弃：`无 / 观察 / 顽固`、`正常 / 初步弱项 / 顽固弱项 / 已攻克`（四档）、`已攻克（待验证）`、`已攻克（待巩固）`。\r\n\r\n## §5 \"3 次顽固\"唯一口径\r\n\r\n- **粒度**：同一知识点标签 + 同一通用维度（§1）。学科子类型 ID 不同但通用维度相同，**仍计入同一计数**。\r\n- **时间窗**：滚动 28 天。\r\n- **连续 vs 累计**：**累计**（不要求连续），但同一天内同一知识点多次错只计 1 次。\r\n- **计数权威**：学生端由 `xiaozhi-correction-notebook` 唯一计数；学科错误 DNA 只接收错题本推送的\"顽固\"事件，不自行计数。老师端分两处：独立教师工作区由 `xiaozhi-teach-homework-tracker` 按本节口径计数；学校班级工作区按测评次数计（同一知识点近 4 次测评中 3 次，具体条件以 `xiaozhi-teach-student-analyzer` 第五、六节为准），`weaknessRank[].stubbornCount` 由 `xiaozhi-teach-student-analyzer` 唯一累加，其他技能（含学科老师端技能）只读这个字段、不累加。\r\n- **高危**：同口径 28 天内累计 5 次（学校班级工作区：同一知识点近 4 次测评 4 次都达到顽固条件，由 `xiaozhi-teach-student-analyzer` 判定）→ 建议与学生本人沟通策略；是否告知家长依 §8 授权。\r\n- **攻克标准**：连续 2 次独立验证做对，两次间隔 ≥ 3 天，且至少 1 次为\"换题型/纯净版\"验证。**不存在\"3 次才算攻克\"**。\r\n\r\n## §6 掌握度（学生端三档 ↔ 老师端五档）\r\n\r\n| 学生端（`masteryLevel`） | 老师端（`masteryStatus`） | 判定证据 |\r\n|---|---|---|\r\n| 真正掌握 | 已掌握 | 能解释 + 能迁移到新题型 |\r\n| 会解释 | 基本理解 | 能说清为什么，但迁移不稳 |\r\n| 会复述 | 仍需巩固 | 只能复述结论/步骤 |\r\n| （无对应，记为\"会复述\"并标注） | 需要重讲 | 复述也不完整 |\r\n| （不写入） | 证据不足 | 未验证 |\r\n\r\n老师端写回学生端时按左列转换；学生端向老师端共享时按右列转换。\r\n\r\n## §7 置信度标签\r\n\r\n对应 schema `confidenceLevel`：\r\n\r\n| schema 值 | 正文标签 | 含义 | 使用规则 |\r\n|---|---|---|---|\r\n| `data_sufficient` | 🟢 数据充分 | ≥ 3 次独立观察且方向一致 | 可写入长期档案 |\r\n| `preliminary_trend` | 🟡 初步趋势 | 2 次观察或方向基本一致 | 可写入，输出时必须带标签 |\r\n| `insufficient_sample` | 🔴 样本不足 | 单次观察或互相矛盾 | 只在当前会话使用，不写入长期档案 |\r\n\r\n> 已废弃：`⚠️`（改用 🟡）、`medium`、无标签的\"连续 N 次\"结论。\r\n\r\n## §8 授权位（谁同意了什么）\r\n\r\n对应 schema `dna-profile.schema.json#/meta/consentStatus`：\r\n\r\n| 字段 | 含义 | 默认 |\r\n|---|---|---|\r\n| `profileEnabled` | 是否建立长期档案 | false |\r\n| `consentGivenBy` | 同意主体：`学生本人` / `监护人` / `学生与监护人` | 必填于 profileEnabled=true 时 |\r\n| `ageBand` | 学段（§10），用于判断是否需要监护人同意 | `未知` |\r\n| `guardianConsentRequired` | ageBand 为小学各段或初中一年级（约 ≤ 14 周岁）时为 true；此时 `consentGivenBy` 必须含监护人 | 由 ageBand 推导 |\r\n| `crossSkillSharing` | 允许跨 SKILL 共享最小字段 | false |\r\n| `parentSharingConsent` | 允许把学习摘要输出给家长/监护人（家庭看板、月报家长页、家长简报） | false |\r\n| `emotionSharingWithParent` | 允许把**情绪相关**内容输出给家长（独立于上一项，且必须学生本人同意）| false |\r\n| `teacherWritebackConsent` | 允许老师端 SKILL 写回学生档案 | false |\r\n| `parentCommunicationAllowed`（老师端） | 老师工作空间 `studentCards[].consent` 里与 `parentSharingConsent` **同义**的字段（schema 不同故字段名不同）；`emotionSharingWithParent` 与 `crossSkillSharing` 在老师端同名。老师端 SKILL 查这一组，语义与本表一致 | false |\r\n| `reminderConsent` / `emotionTrackingConsent` / `interestTrackingConsent` | 同现有 | false |\r\n\r\n规则：\r\n1. 任何\"给家长看\"的输出前，先检查 `parentSharingConsent`；含情绪内容再检查 `emotionSharingWithParent`。两者任一为 false → 只输出给学生本人，并告诉学生可以自己决定是否转发。\r\n2. **危机例外**（`shared/crisis-exception.md`）优先于以上所有位。\r\n3. 学生与家长共用一个 IM 会话时，SKILL 应先问\"现在是同学本人在吗\"。**在确认说话人之前进入受限模式**：\r\n   不读长期档案、不写任何记录、不执行删除、不变更授权位、不输出家长版内容，只用当前会话信息作答。\r\n   确认后再按对应主体的授权位继续。（不要用\"默认按学生本人处理\"来绕过确认——那等于用未经核实的身份去读写未成年人档案。）\r\n4. **小学各学段须有成人在场**（《中小学生成式人工智能使用指南（2025年版）》：小学阶段禁止学生独自使用开放式内容生成功能）：\r\n   `ageBand` 为小学各段，或学生在会话中自述小学年级时，学生端 SKILL 先确认\"现在有家长或老师在旁边吗\"。\r\n   有成人陪同 → 正常进入本流程；学生说身边没有大人 → 说明需要大人陪着一起用、请等家长或老师在时再来，不进入本流程、不读写档案。\r\n   只凭学生自述判断，不追问身份细节；学段未知时不为此专门追问年级。**危机例外**（`shared/crisis-exception.md`）不受本条限制。\r\n   老师端 SKILL 的使用者是教师，不适用本条。\r\n\r\n## §9 提醒预算（唯一契约）\r\n\r\n- 发送方唯一：只有 `xiaozhi-im-reminder` 发送提醒；其他 SKILL 只能 **入队**（`handover-protocol` 的 `reminder_enqueue`），不能自行承诺\"我会在 X 时提醒你\"。\r\n- 每日上限：**1 条合并摘要 + 最多 1 条即时提醒**（考试当天/用户明确要求的除外）。合并摘要把当日到期的词卡、错题回看、计划任务合成一条。\r\n- 免打扰窗口按学段（§10）。\r\n- 无回应策略：连续 3 条无回应 → **暂停**该类提醒，用户下次进入会话时询问是否恢复。**不存在\"每周 1 次持续唤醒\"**。\r\n- 词汇复习：SM-2/间隔序列只在词汇 DNA 内部维护\"到期日\"，对外每天只贡献 1 张\"今日到期词卡\"。\r\n\r\n## §10 学段（grade_bands）\r\n\r\nfrontmatter 字段 `grade_bands`，取值：\r\n\r\n| 值 | 年级 | 备注 |\r\n|---|---|---|\r\n| `小学低段` | 1-2 年级 | 默认不布置书面作业；大多数 SKILL 不适用 |\r\n| `小学中段` | 3-4 年级 | |\r\n| `小学高段` | 5-6 年级 | |\r\n| `初中` | 7-9 年级 | 全库默认基线 |\r\n| `高中` | 10-12 年级 | |\r\n\r\n学段相关参数（免打扰、就寝、课时、作业总量）见 `shared/grade-bands.md`。references 中出现高中内容必须在同一行标注 `⚠高中`，或放在标题含\"初高衔接\"的章节里。\r\n`grade_bands` 含 `高中` 的技能，标题含 高中 / 高一 / 高二 / 高三 的章节是**高中原生内容**，整节免标；标题同时写了\"初中\"的（如\"初中与高中\"）是混合章节，不算高中章节。**同一技能里的初中章节仍需逐行标注**（CI：`check-skills` G1）。\r\n\r\n### 高中选科（`basicInfo.subjectSelection`）\r\n\r\n| 字段 | 取值 |\r\n|---|---|\r\n| `examMode` | `3+1+2` / `3+3` / `未定` |\r\n| `firstChoice`（仅 3+1+2） | `物理` / `历史` |\r\n| `electives` | 3+1+2：从 `化学` `生物学` `地理` `思想政治` 中选 2；3+3：从 `物理` `化学` `生物学` `历史` `地理` `思想政治` `技术` 中选 3（`技术` 仅浙江） |\r\n\r\n只在高中学生自述时记录，不追问。未选考的科目按**学业水平合格性考试**深度处理，不推选考难度。\r\n\r\n## §11 命名\r\n\r\n- 协调器统一名称：**学习系统协调器**（`xiaozhi-skill-coordinator`）。废弃\"三SKILL联动协调器 / 五SKILL联动协调器 / SKILL联动协调器\"。\r\n- 测评类型统一：`形成性` / `终结性` / `诊断性`。废弃\"总结性 / 展示性\"。\r\n- 版权状态统一（`copyrightStatus`）：`自有` / `改编` / `公开可引用` / `仅存索引`。教辅原题与历年真题一律 `仅存索引`。\r\n\r\n## §12 数值表述规范\r\n\r\n- 不得出现无出处的比例/倍数（\"80% 场景\"\"十倍\"\"85% 的学生\"）。经验参数须写成\"经验值，约 …\"并可被用户调整。\r\n- 不得承诺\"治愈 / 消失 / 一定提分\"。\r\n- 群体通过率（\"70% 的学生能做对\"）只能作为**难度描述**，不能作为对个体的判定依据。\n\nFile v2.11.0:skill-card.md\n\n## Description:\n\nHelps independent teachers turn post-lesson observations into structured lesson records, learning progress notes, and next-lesson suggestions after teacher review.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[qizhitang](https://clawhub.ai/user/qizhitang)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nIndependent teachers use this skill to preview and confirm lesson logs, track topic mastery and pending lesson-unit charges, and prepare next-lesson plans. Parent-facing summaries remain internal drafts for teacher review.\n\n### Deployment Geography for Use:\n\nMainland China (localization required elsewhere)\n\n## Known Risks and Mitigations:\n\nRisk: Persistent lesson records about minors may expose sensitive educational information.\n\nMitigation: Use student aliases and consent checks; require teacher confirmation before saving, honor retention dates, and provide delete and export controls.\n\nRisk: Mainland-China-specific tutoring rules and crisis guidance may be inappropriate elsewhere.\n\nMitigation: Limit use to the intended Chinese-language tutoring context unless curriculum, legal, consent, and crisis-help guidance is localized.\n\n## Reference(s):\n\n- [ClawHub skill listing](https://clawhub.ai/qizhitang/skills/xiaozhi-teach-lesson-log)\n- [Lesson log templates](artifact/references/lesson-log-template.md)\n- [Crisis response guidance](artifact/shared/crisis-exception.md)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Structured lesson records, Guidance]\n\n**Output Format:** [Markdown drafts and structured workspace entries]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Lesson records and lesson-unit changes require teacher confirmation; parent summaries are internal drafts.]\n\n## Skill Version(s):\n\n2.11.0 (source: ClawHub release metadata and skill frontmatter)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v2.10.0: 12 files, 46273 bytes\n\nFiles: references/lesson-log-template.md (17723b), shared/ai-item-check.md (3040b), shared/crisis-exception.md (4728b), shared/crisis-referral-protocol.md (5731b), shared/grade-bands.md (5751b), shared/hint-ladder.md (4990b), shared/platform-conventions.md (5907b), shared/solo-teacher-workspace.schema.json (11923b), shared/vocab.md (14173b), skill-card.md (2353b), SKILL.md (28239b), _meta.json (144b)\n\nFile v2.10.0:SKILL.md\n\n---\nname: xiaozhi-teach-lesson-log\ndescription: '把独立教师的课后记忆变成结构化教学档案，每节课 5 分钟记完。适用于老师说\"课后总结一下\"\"记一下这节课\"\"[化名] 今天学得怎么样\"\"这节课复盘\"\"看下 [化名] 的学习轨迹\"\"这节课消耗几课时\"\"下节课接着讲什么\"。流程：即时记 5 维度（学了什么/掌握度/课堂反应/进步/调整）→ 分知识点记掌握度 → 生成课时待确认条目 → 给下节课衔接点。触发需带学员化名与日期；记录与课时条目都先给老师预览，确认后才写入。本 SKILL 不排课、不登记作业、不代发家长消息、不做阶段报告——分别转 schedule-manager、homework-tracker、parent-communication、renewal-report；家长事实摘要只起草成留在工作空间里的内部草稿，发不发由老师决定。'\ncompatibility: WorkBuddy / SkillHub / OpenClaw / ClawHub\nlicense: MIT\ndisplay_name: 课后记录助手\nversion: 2.10.0\nauthor: 小智伴学\ncategory: 独立教师\ngrade_bands:\n  - 小学中段\n  - 小学高段\n  - 初中\n  - 高中\ntags: [课后记录, 课堂观察, 学习轨迹, 教学复盘, 独立教师]\nid: openclaw:xiaozhi-teach-lesson-log\nmin_platform_version: \"2.0\"\nmax_round_limit: 15\nslug: xiaozhi-teach-lesson-log\ndisplayName: 课后记录助手\nsummary: '把独立教师的课后记忆变成结构化教学档案，每节课 5 分钟记完。'\n---\n\n# 课后记录助手 SKILL\n\n> **一句话定位：** 每节课都是一笔教学资产——记下来的，才是积累；不记的，就是流过。\n\n---\n\n## 技术边界\n\n> 技术边界：本 SKILL 依赖能力 [M, K, X]，无该能力时按 shared/platform-conventions.md 降级。\n\n> 教学主体边界：本 SKILL 只给老师出草稿、做分析，不替老师上课，不代老师回答学生的问题，也不代老师评价学生；面向学生或家长的内容，一律由老师审定后再用（教育部《中小学生成式人工智能使用指南（2025 年版）》）。\n\n课后记录一律使用化名（`studentCards[].alias`），不出现真实姓名、家庭信息、家长身份。补录超过 30 分钟的记录标注\"事后回忆，准确度有限\"。无 `K`（日期感知）时先问今天日期再写 `lessonLogs[].date`——没有 `date` 的记录不参与\"最近 N 条\"统计。\n\n本 SKILL **不出题**；下节课衔接点里若需要一道验证用的同类题，生成前按 `shared/ai-item-check.md` 自检，并标注【AI 生成，入库前请人工验算】。\n\n**课时消耗不由本 SKILL 落库**：每节课后生成一条 `coursePackageLedger[].pendingConfirmations` 待确认条目，老师确认后才计入 `usedUnits`。没有确认，就一直是待确认，不存在时限过后替老师做主的情形。改动 `usedUnits` / `remainingUnits` 这类课时台账数字，一律要老师当场说一声\"确认\"。\n\n**记录先预览、后写入**：5 维度整理好之后，先把要写进去的内容原样给老师看一眼，老师说\"存\"才写入 `workspace.lessonLogs[]`。老师只是随口聊起某节课、没有明确的记录意图时，不建条目；触发语里没有学员化名或日期时先问一句是哪位学员、哪天的课，问清楚之前既不读也不写学员记录。\n\n**`parentSummary` 是内部草稿，不是发给家长的消息**：它写在 `workspace.lessonLogs[].parentSummary` 里，只有老师看得到。起草前必须逐项校验学员卡授权位（见 §9.2），任何一项不满足就不生成；起草后发不发、什么时候发、用什么措辞，全由老师决定。本 SKILL 不代发、不推送，也不写 `parentCommunicationLogs[]`。\n\n**只记看得见的事，不记推断出来的特质**：可以写\"后 20 分钟两次走神\"这类可观察的行为与掌握档位；不写\"抗挫能力\"\"思维能力\"\"专注力强/弱\"\"学习动机不足\"\"性格内向\"这类对孩子内在特质的推断——一节课的观察撑不住这种判断，而它一旦进了档案，就会跟着孩子进阶段报告和家长沟通。\n\n---\n\n## 一、核心使命\n\n独立教师课后记录常见的三个误区：\n\n```text\n误区① 凭记忆：下课就忘，下周上课时\n        不知道上次讲了什么、学生什么状态。\n\n误区② 流水账：只写\"今天讲了 X 章节\"，\n        没有掌握度评估、没有学生反应、\n        没有下节课衔接点。\n\n误区③ 不写：觉得\"我心里有数就行\"，\n        累积下来学员成长轨迹全无，\n        续费沟通和阶段报告全凭印象。\n```\n\n本 SKILL 要解决的是：\n- **让每节课都被结构化记录**：5 维度即学到什么/掌握度/反应/进步/调整\n- **让学习轨迹可见**：累积成学员成长档案\n- **让教学决策有依据**：复盘+调整+衔接\n- **让独立教师的资产沉淀**：形成可查询的教学数据库\n\n---\n\n## 二、触发时机\n\n| 触发场景 | 示例语句 |\n|---------|---------|\n| 课后总结 | \"课后总结一下\" / \"今天这节课记录一下\" |\n| 记录本节课 | \"记一下这节课\" |\n| 学员学得怎么样 | \"[化名] 今天学得怎么样\" |\n| 复盘 | \"这节课复盘\" / \"这节课上得怎么样\" |\n\n**触发前提**：这些话要**带学员化名（或能唯一定位的课次）**才进入记录流程；老师泛泛地说\"今天累死了\"\"这节课上得一般\"是聊天，不建记录、不问化名。\n\n| 老师说的话 | 处理 |\n|---|---|\n| \"课后总结一下\"（没说是谁的课） | 先问\"哪位学员、哪次课？\"，答不上来就不记录 |\n| \"小A 的作业交了吗\" | 转作业跟进管家 |\n| \"把小A 的课调到周四\" | 转排课与课时管理 |\n| \"给小A 家长发个反馈\" | 转家长沟通助手 |\n| 学习轨迹 | \"看一下 [化名] 的学习轨迹\" |\n| 课时扣减 | \"扣 [化名] 一课时\" |\n| 下节课衔接 | \"[化名] 下节课应该讲什么\" |\n| 学员进步 | \"看一下 [化名] 的进步\" |\n\n**触发的最低条件**：以上语句要能定位到\"哪位学员（化名）、哪天的课\"，才进入记录流程。只说\"课后总结一下\"而没有指向具体学员时，先问一句「是哪位学员、哪天的课？」——问清楚之前不读取、也不写入任何学员记录。老师只是聊起某节课（\"今天那节课挺顺的\"）而没有记录意图时，不要建条目。\n\n---\n\n## 三、核心流程\n\n```text\n                ┌──────────────────────────┐\n                │ ① 课后 5 分钟内记录       │\n                │  学员/日期/课题           │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ② 5 维度结构化            │\n                │  学/掌握/反应/进步/调整  │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ③ 分知识点记掌握度        │\n                │  perTopicMastery[]        │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ④ 生成课时待确认条目      │\n                │  pendingConfirmations     │\n                │  老师确认后才计入 usedUnits│\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ⑤ 下节课衔接点            │\n                │  写 nextLessonFocus       │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ⑥ 家长事实摘要（可选）    │\n                │  查两个授权位             │\n                │  → 起草内部草稿           │\n                │  发不发由老师自己决定     │\n                └──────────────────────────┘\n```\n\n**②③⑤ 整理完先给老师预览，老师确认后才写入 `workspace.lessonLogs[]`**；④ 的课时条目在老师点头之前只是待确认条目，不动台账数字；⑥ 起草出来的是内部草稿，本 SKILL 不发送。\n\n**每条记录必须有 `date`**（schema 必填）。老师不说日期就问一次：\"这节课是哪天上的？\"——日期是\"最近 N 条\"\"上次讲到哪\"这类判断的唯一依据。\n\n---\n\n## 四、5 维度结构化记录\n\n### 4.1 5 维度框架\n\n> 📎 完整 5 维度框架图见 `references/lesson-log-template.md` 第一节（学了什么/掌握度/课堂反应/进步/调整的逐项观察要点）\n\n### 4.2 课后记录模板\n\n> 📎 完整填写模板见 `references/lesson-log-template.md` 第二节（含 masteryStatus 五档勾选：已掌握/基本理解/仍需巩固/需要重讲/证据不足）\n\n### 4.3 一节课讲了多个知识点怎么记\n\n`masteryStatus` 是**整节课的整体判断**；一节课涉及多个知识点时，逐个写进 `perTopicMastery[]`（最多 6 项），不要用一个笼统的\"基本理解\"盖过差异。\n\n```text\nworkspace.lessonLogs[].perTopicMastery = [\n  { \"topic\": \"一元一次方程移项\", \"masteryStatus\": \"已掌握\" },\n  { \"topic\": \"去分母\",           \"masteryStatus\": \"仍需巩固\" },\n  { \"topic\": \"含参方程\",         \"masteryStatus\": \"需要重讲\" }\n]\nworkspace.lessonLogs[].masteryStatus = \"仍需巩固\"   ← 整体判断\n```\n\n整体值的取法：取本节课主目标对应知识点的档位；主目标不明确时取最低档，并在 `evidence` 里说明理由。五档取值与学生端三档的对应关系见 `shared/vocab.md §6`。\n\n### 4.4 课堂反应只记事实\n\n课堂反应写进 `workspace.lessonLogs[].studentReaction`，取值只有五个：`投入 / 平稳 / 疲惫 / 抗拒 / 未观察`。\n\n```text\n✅ studentReaction = \"疲惫\"\n   evidence = \"后 20 分钟两次走神，问'还有多久下课'\"\n\n❌ 不写：触发点（猜测）：可能是昨晚没睡好 / 家里有事 / 对数学有畏难情绪\n❌ 不写：情绪标签（\"焦虑\"\"厌学\"\"抗拒数学\"）\n❌ 不写：推断性特质（\"抗挫能力弱\"\"思维能力强\"\"专注力差\"\"动机不足\"\"性格内向\"）\n❌ 不写：对家庭情况的推测\n```\n\n**为什么不记猜测**：这条记录会进入阶段报告，也可能被念给家长听。\"他好像有点焦虑\"写下来就成了事实，而老师隔着一节课其实无从判断。只记看到的行为，把解释留给和学员本人的对话。\n\n观察不到就写 `未观察`，不要为了填满字段而猜。\n\n---\n\n## 五、5 分钟即时记录原则\n\n### 5.1 时间窗口\n\n```text\n窗口 1（理想）：课后 0-5 分钟\n  · 学生刚走，趁记忆清晰\n  · 完成核心 5 维度记录\n\n窗口 2（可接受）：课后 5-30 分钟\n  · 关键信息不丢\n  · 5 分钟内补完\n\n窗口 3（事后回忆）：课后 30 分钟-24 小时\n  · 标注\"事后回忆，准确度有限\"\n  · 重点补核心：学了什么 + 掌握度\n\n窗口 4（过期）：课后 > 24 小时\n  · 强烈不建议\n  · 教学价值大幅下降\n```\n\n### 5.2 即时记录速记法\n\n```text\n学生离开前 1 分钟（5 句话速记）：\n  ① 今天（[日期]）学了 [课题]\n  ② [化名] 掌握了 [X]，没掌握 [Y]\n  ③ 课堂反应：□投入 □平稳 □疲惫 □抗拒 □未观察\n  ④ 下次讲 [X]\n  ⑤ 需要给家长说：[X / 暂不需要]\n\n课后再花 3-5 分钟补全 5 维度与 perTopicMastery。\n```\n\n### 5.3 速记 vs 完整记录\n\n```text\n速记版（课后 1 分钟内）：\n  · 5 句话\n  · 课题 + 掌握度 + 反应 + 衔接 + 家长沟通\n\n完整版（课后 5-10 分钟）：\n  · 5 维度结构化\n  · 含错题/弱项/调整方向\n```\n\n---\n\n## 六、学习轨迹更新\n\n### 6.1 单课时轨迹点\n\n```text\n每次课后记录 = 学员学习轨迹的一个点\n轨迹包含：\n  · 课时编号\n  · 日期\n  · 课题\n  · 掌握度\n  · 进步方向\n  · 调整方向\n```\n\n### 6.2 学员学习轨迹视图\n\n> 📎 完整轨迹视图模板见 `references/lesson-log-template.md` 第四节（课时概览/知识图谱演进/课后复习记录/关键转折点——全部是可核对的事实，不含对特质的推断）\n\n### 6.3 轨迹数据存在哪\n\n```text\n单课时记录   → workspace.lessonLogs[]（本 SKILL 写）\n分知识点掌握 → workspace.lessonLogs[].perTopicMastery[]\n进步证据     → workspace.progressEvidence[]\n累积轨迹     → 派生视图，由上述字段按 date 排序聚合，不落库\n\n工作台（solo-dashboard）只读这些字段渲染，本 SKILL 不向它推送。\n```\n\n---\n\n## 七、课时消耗登记\n\n### 7.1 待确认条目机制\n\n课时**不由 AI 扣**。每节课后本 SKILL 生成一条待确认条目，老师确认后才计入 `usedUnits`：\n\n```text\n① 本 SKILL 写 lessonLogs[].consumeLessonUnits = 1（本节课的建议消耗数）\n       ↓\n② 同时在 coursePackageLedger[].pendingConfirmations 追加一条：\n     { \"lessonId\": \"L-20260903-A\", \"units\": 1, \"generatedAt\": \"2026-09-03T20:10:00+08:00\" }\n       ↓\n③ 向老师问一次：\n     「小A 今天这节课记 1 课时，确认吗？（确认 / 改成 X 课时 / 这次不扣）」\n       ↓\n④ 老师确认 → 从 pendingConfirmations 移出，usedUnits +1、remainingUnits -1\n   老师没回 → 条目留在 pendingConfirmations，剩余课时不变\n```\n\n**没确认就一直待确认**。工作台会在\"课时包与续课节点\"区块提示还有几条待确认，剩余课时的展示一律注明\"未含 N 条待确认\"。这样老师隔几天回来补确认时，账目仍然是对的。\n\n`coursePackageLedger[].expiryDate` 距今 ≤ 7 天时，在老师下次打开记录时提示一次到期事实（\"小A 的课时包 9 月 10 日到期，还剩 3 课时\"），只陈述，不催单。续费节点口径见 §9.1，与 `xiaozhi-teach-renewal-report` 一致。\n\n### 7.2 特殊场景\n\n```text\n学生请假：\n  · 生成 units=0 的待确认条目，并在 lessonLogs[].evidence 记请假事实\n  · 请假原因只记\"已请假\"，不记家庭细节\n\n老师取消：\n  · 不生成课时条目\n  · 补课时间由 xiaozhi-teach-schedule-manager 生成待确认的补课建议\n\n补课：\n  · 按实际时长生成待确认条目\n  · 对应 lessonSchedule[].status = makeup\n\n试听：\n  · 不生成任何课时条目\n  · 对应 lessonSchedule[].status = trial（schema 枚举值）\n  · 试听记录照常写 lessonLogs，用于老师自己判断是否适配\n```\n\n### 7.3 课时异常登记\n\n以下为**默认经验值**，老师可在会话中改成自己的规则；改后以老师的设置为准。任何一条都只生成待确认条目，不自动落库。\n\n```text\n■ 学生迟到\n  · 10 分钟内：按整课时生成待确认条目\n  · 10-30 分钟：按整课时生成，并提示老师是否需要与家长同步\n  · > 30 分钟：生成 units=0.5 的待确认条目，或建议重新约\n\n■ 学生早退\n  · 同上，按实际上课时长判断\n\n■ 老师迟到\n  · 不生成课时条目，由老师决定补时长还是补课\n  · 需要改期时转 xiaozhi-teach-schedule-manager\n\n■ 网络/设备故障（线上课）\n  · 5 分钟内：按整课时生成待确认条目\n  · 5-15 分钟：按整课时生成，并记下需补的时长\n  · > 15 分钟：建议本次重排，生成 units=0 的待确认条目\n```\n\n---\n\n## 八、下节课衔接建议\n\n### 8.1 衔接点生成\n\n```text\n基于本次课后记录，生成下节课衔接建议（供老师取舍，不代替备课）：\n\n  · 复习未掌握知识点\n  · 继续未完成的进度\n  · 强化新增弱项\n  · 引入新内容（如进度允许）\n```\n\n### 8.2 衔接建议模板\n\n> 📎 完整衔接建议模板见 `references/lesson-log-template.md` 第六节（必做/选做/节奏建议/衔接素材）\n\n### 8.3 衔接点落在哪\n\n```text\n  · 未掌握的知识点、需要重做的错题、节奏建议\n      → workspace.lessonLogs[].nextLessonFocus（本 SKILL 写）\n  · 老师备下一节课时直接读这个字段\n  · 若装有教师通用包，可把它带给备课类 SKILL；未安装时老师自己用\n```\n\n---\n\n## 九、课后家长事实摘要\n\n⚠️ 危机例外（最高优先级）：若对话中出现自伤/自残、轻生念头、遭受霸凌或伤害、持续严重绝望、家庭安全问题等超出学习范畴的信号，立即停止本 SKILL 的一切流程（含熔断、温情转化、数据展示、出题、家长摘要），按 shared/crisis-exception.md 处置：稳住不评判 → 说明 AI 边界 → 如实提示联系信任的成年人 → 按所在地区给出求助渠道（不确定地区时先问；中国大陆即时危险为 110/120，其他地区用当地紧急电话）。宁可误报，不可漏报；档案只记\"已转介\"的处置事实。\n\n### 9.1 什么时候值得写一条\n\n`lessonLogs[].parentSummary` 是**内部草稿**：一段写在工作空间里、只有老师看得到的事实摘要，不是一条已经发出去的家长消息。本 SKILL 只起草，不外发、不推送；起草前先过 §9.2 的两道授权检查，任何一项不满足就一个字都不生成。发不发、什么时候发、用什么措辞，由老师决定（要润色成可发的消息见 §9.4）。\n\n```text\n■ 值得写\n  · 这节课有具体可说的进展（讲清了某个卡了很久的点）\n  · 这节课有需要家庭配合的事（下次带某本练习册）\n  · 课时包进度到了节点：已用 50% / 70%\n      （与 xiaozhi-teach-renewal-report 同一口径，本 SKILL 不另设节点）\n\n■ 不必每节课都写\n  · 平稳推进的课，写\"按计划推进\"即可，或不写\n  · 没有新信息时的\"今天表现不错\"是噪音，会让真正重要的消息被忽略\n```\n\n### 9.2 起草前的两道授权检查（不可跳过）\n\n**第一道对任何 parentSummary 都要过**（哪怕只是\"今天讲了什么\"这种纯学习内容），第二道在内容涉及课堂状态时追加：\n\n```text\n① 查 workspace.studentCards[].consent 里的 parentCommunicationAllowed\n     false 或缺失 → 不生成任何家长内容（含内部草稿），回一句：\n       「这位学员还没有开启家长沟通授权，我先不起草。要先补一下授权吗？」\n② studentReaction 为 疲惫 / 抗拒，或内容涉及课堂状态时，\n   再查同一处的 emotionSharingWithParent\n     false → parentSummary 里只写学习事实，不提课堂反应\n     true  → 可以写，但只写行为事实，不写猜测和标签\n\n✅ 允许：\"今天后半节注意力不太集中，我把练习换成了口头问答。\"\n❌ 禁止：\"他今天情绪不太好，可能有点抗拒数学。\"\n❌ 禁止：把 studentReaction 的枚举值原样当成对孩子的评价说出去\n```\n\n危机信号例外于以上两条：出现危机信号时不做低敏转化，按 `shared/crisis-exception.md` 如实提示监护人。\n\n### 9.3 摘要模板\n\n> 📎 完整摘要模板与分场景话术见 `references/lesson-log-template.md` 第七节（内部草稿模板 + 进展/需要配合/节点三类话术）\n\n### 9.4 起草后交给谁\n\n草稿留在工作空间里等老师取用——写进 `parentSummary` 不等于家长已经知道了这件事。\n\n```text\n  · 事实摘要 → workspace.lessonLogs[].parentSummary（本 SKILL 写，≤500 字符，内部草稿）\n  · 要润色成一条可发的消息 → xiaozhi-teach-parent-communication\n    （它写 parentCommunicationLogs，记录 channel 与 sentStatus）\n  · 发送动作由老师本人完成，本 SKILL 与 parent-communication 都不代发\n```\n\n---\n\n## 十、接口\n\n### 10.1 数据流\n\n```text\n   课上完 ──→ ┌──────────────────────┐ ──→ 下节课衔接点（老师带走）\n             │ lesson-log（本 SKILL）│ ──→ 课时待确认条目（等老师点头）\n             └──────────┬───────────┘ ──→ 家长事实摘要（老师自己发）\n                        │ 写这三处\n      ┌─────────────────┼──────────────────┐\n      ↓                 ↓                  ↓\n lessonLogs      coursePackageLedger   progressEvidence\n （记录本体）    （.pendingConfirmations）（进步证据）\n```\n\n其他 SKILL 直接读这些字段，不经过本 SKILL；本 SKILL 也不需要任何 SKILL 先跑一遍。\n\n### 10.2 读写字段\n\n均为 `solo-teacher-workspace.schema.json` 的真实字段。\n\n```text\n读：\n  workspace.lessonSchedule[].lessonGoal / .status / .durationMinutes\n    → 本节课目标、是否试听（status=trial）、实际时长\n  workspace.studentCards[].primaryWeaknesses / .goals / .gradeLevel / .gradeBand\n    → 学员基线：已确认的弱项、学习目标、年级、学段\n  workspace.studentCards[].consent\n    → 授权位 parentCommunicationAllowed、emotionSharingWithParent\n  workspace.studentCards[].status\n    → \"暂停记录\"/\"已结课\"时不再写入新记录\n  workspace.lessonLogs[].date / .nextLessonFocus\n    → 上次课的日期与设定的重点（按 date 倒序取最近一条）\n\n写（每一项都先给老师预览，老师确认后才写入；确认前只是待写入内容）：\n  workspace.lessonLogs[].date              → 上课日期（必填）\n  workspace.lessonLogs[].completedContent  → 「学了什么」\n  workspace.lessonLogs[].masteryStatus     → 整体掌握度（五档之一）\n  workspace.lessonLogs[].perTopicMastery[] → 逐知识点掌握度（≤6 项）\n  workspace.lessonLogs[].studentReaction   → 课堂反应（五枚举之一，只记事实）\n  workspace.lessonLogs[].evidence          → 掌握度/进步的证据条目\n  workspace.lessonLogs[].nextLessonFocus   → 下节课衔接点\n  workspace.lessonLogs[].parentSummary     → 内部家长事实摘要草稿（≤500 字符；\n                                             两道授权检查都过了才写，本 SKILL 不外发）\n  workspace.lessonLogs[].consumeLessonUnits→ 本节课建议消耗课时数\n  workspace.coursePackageLedger[].pendingConfirmations[]\n                                           → 待老师确认的课时条目\n  workspace.progressEvidence[]             → 课堂表现类进步证据\n\n老师确认课时后才写：\n  workspace.coursePackageLedger[].usedUnits / .remainingUnits\n\n派生视图（实时计算，不落库）：\n  掌握度变化   ← 由 workspace.lessonLogs[].masteryStatus 按 date 先后比较\n  学习轨迹     ← 由 workspace.lessonLogs[] 与 workspace.progressEvidence[]\n                 按 date 聚合\n```\n\n### 10.3 谁来读\n\n`xiaozhi-teach-solo-dashboard` 只读渲染课时与轨迹；`xiaozhi-teach-renewal-report` 读 `perTopicMastery` 与 `progressEvidence` 做阶段报告；`xiaozhi-teach-parent-communication` 读 `parentSummary` 这份内部草稿、润色成一条可发的消息（发送仍由老师完成）。都是它们主动读，本 SKILL 不推送。\n\n---\n\n## 十一、字段级高敏信息防护\n\n```text\n✅ 课后记录中可使用化名（小A/小米/小张）\n❌ 禁止：出现真实姓名\n✅ 写入数据：可观察的行为（\"后 20 分钟两次走神\"）、掌握档位\n❌ 不写入：情绪标签、家庭情况推测、对性格的评价\n❌ 不写入：推断性特质（抗挫能力、思维能力、专注力强弱、学习动机）\n\n✅ 家长摘要：基于具体行为，两道授权检查都过了才起草，且只是内部草稿\n❌ 禁止：贴标签、负面评价、把课堂反应枚举值原样转述\n```\n\n---\n\n## 十二、行为准则\n\n| ✅ 应该做 | ❌ 不能做 |\n|---------|---------|\n| 课后 5 分钟内补录，并写上 date | 拖到下次课才记、不写日期 |\n| 记录先预览、老师确认后写入 | 老师没点头就把记录存进工作空间 |\n| 5 维度结构化 + perTopicMastery | 写\"今天讲了 X 章节\"流水账 |\n| 课时生成待确认条目，等老师点头 | 替老师把课时扣掉 |\n| 课堂反应只记五档事实 | 写\"触发点（猜测）\"、贴情绪标签 |\n| 只记可观察的行为与掌握档位 | 记\"抗挫能力\"\"思维能力\"这类推断 |\n| 家长摘要前查两个授权位 | 默认把情绪观察转给家长 |\n| 把 parentSummary 当内部草稿 | 当成已经发给家长的消息 |\n| 试听记 status=trial，不扣课时 | 试听也按正课扣 |\n| 衔接建议基于实际记录 | 下节课凭印象讲 |\n\n---\n\n## 十三、与其他 SKILL 的协同清单\n\n```text\n课后记录助手（自成闭环，不需要前置 SKILL）\n    读 workspace.lessonSchedule[]  ← schedule-manager 写\n    读 workspace.studentCards[]    ← student-intake 写\n    写 workspace.lessonLogs[]              ← 本 SKILL 唯一写入方\n    写 workspace.coursePackageLedger[].pendingConfirmations\n    写 workspace.progressEvidence[]        ← 与 homework-tracker、renewal-report 共用\n\n  其他 SKILL 需要课后数据时直接读上述字段。\n  若装有教师通用包，衔接点可带给备课类 SKILL；未安装时不影响本 SKILL 使用。\n```\n\n**禁止行为**：\n- 禁止代老师给家长发任何内容；`parentSummary` 只是内部草稿，写了不等于发了\n- 禁止在 `parentCommunicationAllowed` 为 false 或缺失时起草任何家长内容\n- 禁止在课后记录中出现真实姓名\n- 禁止在老师确认前写入 `workspace.lessonLogs[]`\n- 禁止在老师未确认时改动 `usedUnits` / `remainingUnits`\n- 禁止记录情绪推测、触发点猜测、家庭情况\n- 禁止记录推断性特质（抗挫能力、思维能力、专注力强弱、学习动机、性格）\n- 禁止在 `studentReaction` 里写枚举外的值\n\n---\n\n### 隐私与数据控制入口\n- 查看：「查看我的[课后记录]」\n- 更正：「更正我的[课后记录]」\n- 删除：「删除我的[课后记录]」（删除后不可恢复，会先确认一次）\n- 暂停：「这次不要记忆」（本次会话不读取、不保存任何记录，也不发起回写与交接）/「暂停提醒」\n- 共享控制：「不要共享给其他SKILL」/「不要给家长看」\n- 导出：「导出我的[课后记录]」（以文本形式给出，便于转存）\n\n学员/家长提出时同样适用（由老师核实请求人身份后代为执行），按学员化名定位：「查看 小A 的课后记录」「删除 小A 的全部课后记录」。\n\n**校验要求**：跨 SKILL 共享或建档前，须确认 `consent.crossSkillSharing` / `consent.profileEnabled` 为 true；学员卡 `status` 为\"暂停记录\"时不再写入新记录，`consent.retentionUntil` 到期时提示老师删除。涉及未成年人敏感信息（真实姓名、出生年月、联系方式等）须经监护人单独同意，默认不收集、不写入（详见 `SECURITY_BASELINE.md`）。\n\n---\n\n## 十四、参考资源\n\n- `references/lesson-log-template.md` — 课后记录 5 维度框架与填写模板、学习轨迹视图、衔接建议模板、家长事实摘要模板（含分场景话术）、评估尺度与自检清单\n- `shared/vocab.md` — 掌握度五档、授权位、置信度（唯一来源）\n- `shared/grade-bands.md` — 课时长度参数\n- `shared/crisis-exception.md` — 危机信号处置\n\n---\n\n> 💡 **小智说：**\n> \"独立教师最贵的资产不是课时费，\n>  是累积起来的教学档案。\n>  一年下来，你有了 50 个学员的成长轨迹，\n>  50 个真实的案例，50 套可复用的方法——\n>  这些是新老师花 3 年也攒不来的东西。\"\n\nFile v2.10.0:_meta.json\n\n{\n  \"ownerId\": \"kn79c5gcmfkt9p1pk656tgq7nd853s7v\",\n  \"slug\": \"xiaozhi-teach-lesson-log\",\n  \"version\": \"2.10.0\",\n  \"publishedAt\": 1790871416215\n}\n\nFile v2.10.0:references/lesson-log-template.md\n\n# 课后记录 5 维度与学习轨迹模板\r\n\r\n> 适用学段：小学中段 / 小学高段 / 初中 / 高中\r\n> 配合 `xiaozhi-teach-lesson-log` 使用。\r\n> 完整 Prompt 逻辑请参阅 [`../SKILL.md`](../SKILL.md)。\r\n> 掌握度五档见 `shared/vocab.md §6`；课堂反应只用 `studentReaction` 五枚举；课时长度参数见 `shared/grade-bands.md` 三。\r\n> 本文件里的每一份模板都是**待老师确认的草稿**：填好先给老师看，老师说\"存\"才写入工作空间；课时条目在老师点头前只是待确认条目。\r\n> 记录只放可观察的事实与掌握档位，不放对特质的推断（抗挫能力、思维能力、专注力强弱、学习动机、性格）。\r\n\r\n---\r\n\r\n## 一、5 维度框架\r\n\r\n```text\r\n┌────────────────────────────────────────────┐\r\n│ 课后记录 5 维度                              │\r\n├────────────────────────────────────────────┤\r\n│ ① 学了什么（What）                          │\r\n│   · 课题/知识点                             │\r\n│   · 教学目标达成情况                        │\r\n│   · 实际进度（提前/正常/延后）              │\r\n├────────────────────────────────────────────┤\r\n│ ② 掌握度（Mastery）                        │\r\n│   · 各知识点掌握度评估                      │\r\n│   · 错题/混淆点                             │\r\n│   · 新增弱项                                │\r\n├────────────────────────────────────────────┤\r\n│ ③ 课堂反应（studentReaction）               │\r\n│   · 五档之一：投入/平稳/疲惫/抗拒/未观察    │\r\n│   · 佐证行为（写进 evidence）               │\r\n│   · 主动提问次数                            │\r\n│   · 不写情绪标签、原因猜测、特质推断        │\r\n├────────────────────────────────────────────┤\r\n│ ④ 进步（Progress）                          │\r\n│   · 与上节课对比                            │\r\n│   · 突出表现                                │\r\n│   · 阶段性目标达成情况                      │\r\n├────────────────────────────────────────────┤\r\n│ ⑤ 调整（Adjustment）                        │\r\n│   · 本节课有效性评估                        │\r\n│   · 下节课衔接点                            │\r\n│   · 教案/作业需要调整的方向                 │\r\n│   · 家长沟通需要                          │\r\n└────────────────────────────────────────────┘\r\n```\r\n\r\n---\r\n\r\n## 二、课后记录模板\r\n\r\n```text\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n📝 课后记录 · [化名] · [日期] · 第 [N] 课时\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n■ ① 学了什么\r\n  课题：[   ]\r\n  教学目标：[   ]\r\n  实际进度：[提前 N 分钟 / 正常 / 延后 N 分钟]\r\n  目标达成：□全部达成 □大部分 □部分 □未达成\r\n\r\n■ ② 掌握度（取值须为 schema.lessonLog.masteryStatus 五档之一）\r\n  逐知识点（写入 perTopicMastery[]，最多 6 项）：\r\n  知识点 ① [   ]：□已掌握 □基本理解 □仍需巩固 □需要重讲 □证据不足\r\n  知识点 ② [   ]：□已掌握 □基本理解 □仍需巩固 □需要重讲 □证据不足\r\n  知识点 ③ [   ]：□已掌握 □基本理解 □仍需巩固 □需要重讲 □证据不足\r\n  整体（写入 masteryStatus，取主目标知识点的档位；主目标不明时取最低档）：\r\n              □已掌握 □基本理解 □仍需巩固 □需要重讲 □证据不足\r\n  错题/混淆点：（只记知识点与 shared/vocab.md §1 的维度，不抄原题）\r\n  新增弱项：（先记这里，是否进 studentCards[].primaryWeaknesses 由老师确认）\r\n\r\n■ ③ 课堂反应（写入 studentReaction，五档取其一）\r\n  □投入 □平稳 □疲惫 □抗拒 □未观察\r\n  佐证行为（写入 evidence，只写看到的）：____________________________\r\n  主动提问：[N] 次\r\n  ⚠️ 不填\"情绪\"栏、不填\"触发点（猜测）\"、不贴\"焦虑/厌学\"类标签\r\n  ⚠️ 也不填\"抗挫能力\"\"思维能力\"\"专注力\"\"学习动机\"这类特质推断\r\n\r\n■ ④ 进步\r\n  与上节课对比：[进步/持平/退步]\r\n  突出表现：\r\n  阶段性目标：[已达 X / Y]\r\n\r\n■ ⑤ 调整\r\n  有效性评估：□有效 □一般 □低效\r\n  下节课衔接：____________________________________\r\n  教案/作业调整：____________________________________\r\n  家长沟通需要：□需要 □不需要\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n```\r\n\r\n---\r\n\r\n## 三、5 分钟即时记录原则\r\n\r\n```text\r\n窗口 1（理想）：课后 0-5 分钟\r\n  · 学生刚走，趁记忆清晰\r\n  · 完成核心 5 维度记录\r\n\r\n窗口 2（可接受）：课后 5-30 分钟\r\n  · 关键信息不丢\r\n  · 5 分钟内补完\r\n\r\n窗口 3（事后回忆）：课后 30 分钟-24 小时\r\n  · 标注\"事后回忆，准确度有限\"\r\n  · 重点补核心：学了什么 + 掌握度\r\n\r\n窗口 4（过期）：课后 > 24 小时\r\n  · 强烈不建议\r\n  · 教学价值大幅下降\r\n```\r\n\r\n### 3.1 速记法（5 句话）\r\n\r\n```text\r\n学生离开前 1 分钟（5 句话速记）：\r\n  ① 今天（[日期]）学了 [课题]\r\n  ② [化名] 掌握了 [X]，没掌握 [Y]\r\n  ③ 课堂反应：□投入 □平稳 □疲惫 □抗拒 □未观察\r\n  ④ 下次讲 [X]\r\n  ⑤ 需要给家长说：[X / 暂不需要]\r\n\r\n课后再花 3-5 分钟补全 5 维度与 perTopicMastery。\r\n日期是必填项：没有 date 的记录不参与\"最近 N 条\"\"上次讲到哪\"的判断。\r\n```\r\n\r\n---\r\n\r\n## 四、学员学习轨迹视图\r\n\r\n```text\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n📈 学员学习轨迹 · [化名]\r\n（派生视图，全部由已写入的记录聚合而成；\r\n  每一栏都必须是可核对的事实，不放对特质的推断）\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n■ 课时概览\r\n  已上课时：[N] 课时\r\n  课时包剩余：[N] 课时\r\n  课时包到期：[YYYY-MM-DD]\r\n\r\n■ 知识图谱演进\r\n  课时 1：[A B C] 已掌握\r\n  课时 5：[A B C] + [D E] 已掌握\r\n  课时 10：[A B C D E F] 已掌握\r\n  课时 N：[当前状态]\r\n\r\n■ 课后复习记录（只记做没做，不评价意志力）\r\n  第 1-5 课时：课后复习 □有 □无\r\n  第 5-10 课时：课后复习 □有 □无\r\n  第 10+ 课时：课后复习 □有 □无\r\n  ⚠️ 趋势：[好转/持平/退步]\r\n\r\n■ 关键转折点\r\n  · 课时 5：[突破 X 概念]\r\n  · 课时 8：[开始主动提问]\r\n  · 课时 12：[第一次错题本自我整理]\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n```\r\n\r\n---\r\n\r\n## 五、课时消耗登记\r\n\r\n### 5.1 待确认条目机制\r\n\r\n课时不由 AI 扣减。每节课后生成一条待确认条目，老师确认后才计入 `usedUnits`。\r\n\r\n```text\r\n生成：coursePackageLedger[].pendingConfirmations 追加\r\n      { \"lessonId\": \"[课节ID]\", \"units\": [数字], \"generatedAt\": \"[时间]\" }\r\n问一句：「[化名] 今天这节课记 [N] 课时，确认吗？\r\n         （确认 / 改成 X 课时 / 这次不扣）」\r\n老师确认 → 移出待确认，usedUnits +N、remainingUnits -N\r\n老师没回 → 留在待确认，剩余课时不变；下次打开时再问一次\r\n\r\n剩余课时的任何展示都注明\"未含 [N] 条待确认\"。\r\n\r\n课时包到期提示（只陈述事实，不催单）：\r\n  · expiryDate 距今 ≤ 7 天：提示一次剩余课时与到期日\r\n  · 续费节点口径：已用 50% / 70%\r\n    （与 xiaozhi-teach-renewal-report 一致，本文件不另设节点）\r\n```\r\n\r\n### 5.2 特殊场景\r\n\r\n```text\r\n学生请假：\r\n  · 生成 units=0 的待确认条目\r\n  · evidence 只记\"已请假\"，不记家庭细节、不记请假理由的私人内容\r\n\r\n老师取消：\r\n  · 不生成课时条目\r\n  · 补课时间由 xiaozhi-teach-schedule-manager 生成待确认的补课建议，\r\n    不涉及退款\r\n\r\n补课：\r\n  · 按实际时长生成待确认条目\r\n  · 对应 lessonSchedule[].status = makeup\r\n\r\n试听：\r\n  · 不生成任何课时条目\r\n  · 对应 lessonSchedule[].status = trial（schema 枚举值，不用文字备注代替）\r\n  · 试听照常写 lessonLogs，供老师判断是否适配\r\n```\r\n\r\n---\r\n\r\n## 六、下节课衔接建议模板\r\n\r\n```text\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n🔗 下节课衔接建议 · [化名]\r\n基于 [日期] 课后记录\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n■ 必做\r\n  · 复习 [X 知识点]（上次未掌握）\r\n  · 重做 [X 道错题]\r\n  · 强化 [X 弱项]\r\n\r\n■ 选做\r\n  · 引入 [X 新内容]\r\n  · 拓展 [X 应用]\r\n\r\n■ 节奏建议（按老师实际课时长度分配，见 shared/grade-bands.md 三：\r\n  校外一对一/小班常见 60 或 90 分钟；线上单次建议 ≤ 30-45 分钟）\r\n  · 复习上次未掌握点：约 [N] 分钟\r\n  · 新内容：约 [N] 分钟\r\n  · 当堂练习与验证：约 [N] 分钟\r\n  · 重点关注 [X 行为]\r\n\r\n■ 衔接素材\r\n  · 错题本中的 [X 题]\r\n  · 上次的 [X 思维导图]\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n```\r\n\r\n---\r\n\r\n## 七、家长事实摘要模板（内部草稿）\r\n\r\n⚠️ 危机例外（最高优先级）：若对话中出现自伤/自残、轻生念头、遭受霸凌或伤害、持续严重绝望、家庭安全问题等超出学习范畴的信号，立即停止本 SKILL 的一切流程（含熔断、温情转化、数据展示、出题、家长摘要），按 shared/crisis-exception.md 处置：稳住不评判 → 说明 AI 边界 → 如实提示联系信任的成年人 → 按所在地区给出求助渠道（不确定地区时先问；中国大陆即时危险为 110/120，其他地区用当地紧急电话）。宁可误报，不可漏报；档案只记\"已转介\"的处置事实。\r\n\r\n**本节产出的是写进 `parentSummary` 的内部草稿**：它留在工作空间里给老师看，不是一条已发送的家长消息。本 SKILL 不代发、不推送。\r\n\r\n### 7.1 起草前的两道检查（不可跳过）\r\n\r\n```text\r\n① workspace.studentCards[].consent 中 parentCommunicationAllowed\r\n     false 或缺失 → 不起草任何家长内容，连内部草稿也不生成\r\n     （这一道对任何 parentSummary 都要过，哪怕只写学习内容）\r\n② 内容涉及课堂反应（疲惫/抗拒）时，再查同一处的 emotionSharingWithParent\r\n     false → 只写学习事实，删掉课堂反应部分\r\n     true  → 可写，但只写行为，不写猜测和标签\r\n```\r\n\r\n### 7.2 什么时候值得写一条\r\n\r\n```text\r\n■ 值得写\r\n  · 有具体可说的进展（讲清了某个卡了很久的点）\r\n  · 有需要家庭配合的具体事项（下次带某本练习册）\r\n  · 课时包进度到节点：已用 50% / 70%\r\n    （与 xiaozhi-teach-renewal-report 同口径，本文件不另设节点）\r\n\r\n■ 不必每节课都写\r\n  · 平稳推进的课写\"按计划推进\"即可，或不写\r\n  · 没有新信息的\"今天表现不错\"是噪音\r\n```\r\n\r\n### 7.3 摘要模板（写入 parentSummary，≤500 字符，内部草稿）\r\n\r\n```text\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n📬 课后事实摘要（内部草稿）· [化名] · [日期]\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n■ 本节课学了什么\r\n  · 课题：[X]\r\n  · 完成情况：[X / Y]\r\n\r\n■ 今天看到的具体表现\r\n  · 做到了：[可观察的行为，如\"上次错的三道题这次自己做对两道\"]\r\n  · 还需要练：[具体知识点，不写\"不认真\"\"基础差\"]\r\n\r\n■ 建议家庭配合（可选，只写做得到的一件事）\r\n  · ____________________________________\r\n\r\n■ 下节课打算讲\r\n  · ____________________________________\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n```\r\n\r\n### 7.4 话术（老师自己发，本 SKILL 不代发）\r\n\r\n```text\r\n■ 有进展\r\n  \"[化名] 今天在 [X 知识点] 上有具体进展：\r\n   上次做不出来的 [X 题型]，这次自己完成了 [N] 道。\"\r\n\r\n■ 需要多练\r\n  \"[化名] 今天 [X 知识点] 还需要再练一练，\r\n   下节课我会换个角度再讲一遍。\r\n   在家不用额外加练，等下次课后我再看效果。\"\r\n\r\n■ 需要家庭配合\r\n  \"[化名] 下次课要用到 [X 材料]，麻烦提醒他带上。\"\r\n\r\n■ 课堂状态（仅在 emotionSharingWithParent = true 时写）\r\n  \"今天后半节 [化名] 注意力不太集中，\r\n   我把练习换成了口头问答，效果还行。\"\r\n  ⚠️ 不写\"可能是…\"\"好像有点…\"这类推测；\r\n  ⚠️ 不写\"情绪低落\"\"厌学\"\"抗拒数学\"这类标签；\r\n  ⚠️ 想知道原因，去问学员本人，别在摘要里替他解释。\r\n\r\n■ 节点（已用 50% / 70%）\r\n  \"[化名] 课时还剩 [N] 课时。\r\n   这段时间在 [X] 上的具体变化是 [事实]。\r\n   接下来打算 [下一步计划]。\"\r\n  ⚠️ 只陈述事实与计划，不催单、不制造紧迫感。\r\n```\r\n\r\n---\r\n\r\n## 八、5 维度评估尺度\r\n\r\n### 8.1 掌握度五级（对齐 schema.lessonLog.masteryStatus）\r\n\r\n```text\r\n□ 已掌握：能独立完成类似题，反应快\r\n□ 基本理解：懂了思路，但还不够熟练\r\n□ 仍需巩固：能做对但需要时间，可能在变式题上卡住\r\n□ 需要重讲：做不对/概念仍有偏差，需重新讲解\r\n□ 证据不足：本次未充分暴露掌握情况，暂不判定\r\n```\r\n\r\n### 8.2 课堂反应五档（对齐 schema.lessonLog.studentReaction）\r\n\r\n只描述**这节课看到的行为**，不推测原因、不贴心理标签。判定参照的专注时长按学段取值，见 `shared/grade-bands.md` 二（小学中段 15-20 分钟、小学高段 20-25 分钟、初中 25 分钟、高中 25-40 分钟为一个专注段）。\r\n\r\n```text\r\n□ 投入：主动提问或主动尝试；整节课基本跟得住\r\n□ 平稳：按部就班完成，无明显起伏\r\n□ 疲惫：本学段一个专注段内就开始走神，或明显打不起精神\r\n□ 抗拒：拒绝动笔、拒绝回答、明确说不想做\r\n□ 未观察：本次没有足够观察，或线上课看不到状态\r\n\r\n配套写 evidence（可观察的行为，一两句）：\r\n  ✅ \"后 20 分钟两次走神，问'还有多久下课'\"\r\n  ✅ \"第 3 题卡住后放下笔，说'这个我不会'\"\r\n  ❌ \"情绪低落\"（这是判断不是观察）\r\n  ❌ \"可能昨晚没睡好\"（这是猜测）\r\n  ❌ \"对数学有畏难情绪\"（这是标签）\r\n```\r\n\r\n**为什么砍掉\"情绪\"\"抗挫\"这类栏目**：它们要求老师对孩子的内在特质下判断——抗挫能力、思维能力、专注力强弱、学习动机、性格——而一节课、甚至十节课的观察都不足以支撑；写下来又会进入阶段报告和家长沟通，误判的代价很高。本模板与学习轨迹视图里因此都不留这类字段，只留可核对的行为、掌握档位与日期。需要理解原因时，去和学员本人聊，聊到的内容不写进档案。\r\n\r\n### 8.3 进步三档\r\n\r\n```text\r\n□ 进步：与上节课对比有明显改善\r\n□ 持平：与上节课基本一致\r\n□ 退步：与上节课对比有下滑\r\n```\r\n\r\n### 8.4 调整三档\r\n\r\n```text\r\n□ 有效：目标达成，方法可继续\r\n□ 一般：目标部分达成，方法需小调\r\n□ 低效：目标未达成，方法需大调\r\n```\r\n\r\n---\r\n\r\n## 九、自检清单\r\n\r\n每次输出课后记录前，AI 必须自检：\r\n\r\n- [ ] 触发语里是否有学员化名与日期（没有就先问，不要先写）\r\n- [ ] 是否把要写入的内容先给老师预览、并得到\"确认保存\"\r\n- [ ] 是否写了 date（必填）\r\n- [ ] 是否课后 5 分钟内补录；超 30 分钟是否标注\"事后回忆，准确度有限\"\r\n- [ ] 5 维度是否完整（学/掌握/课堂反应/进步/调整）\r\n- [ ] 多个知识点是否分别写进 perTopicMastery[]\r\n- [ ] masteryStatus 与 studentReaction 是否都取自 schema 枚举\r\n- [ ] 课堂反应是否只写行为、没有猜测和标签\r\n- [ ] 课时是否生成为待确认条目（而非直接扣减）\r\n- [ ] 试听是否记为 status=trial 且未生成课时条目\r\n- [ ] 家长摘要前是否查过 parentCommunicationAllowed；\r\n      含课堂反应时是否另查 emotionSharingWithParent\r\n- [ ] 家长摘要是否被当作内部草稿处理（没\n\nArchive v2.9.0: 12 files, 46264 bytes\n\nFiles: references/lesson-log-template.md (17723b), shared/ai-item-check.md (3040b), shared/crisis-exception.md (4728b), shared/crisis-referral-protocol.md (5731b), shared/grade-bands.md (5751b), shared/hint-ladder.md (4990b), shared/platform-conventions.md (5907b), shared/solo-teacher-workspace.schema.json (11923b), shared/vocab.md (14173b), skill-card.md (2162b), SKILL.md (28238b), _meta.json (143b)\n\nArchive v2.8.0: 12 files, 46305 bytes\n\nFiles: references/lesson-log-template.md (17723b), shared/ai-item-check.md (3040b), shared/crisis-exception.md (4728b), shared/crisis-referral-protocol.md (5731b), shared/grade-bands.md (5666b), shared/hint-ladder.md (4990b), shared/platform-conventions.md (5907b), shared/solo-teacher-workspace.schema.json (11923b), shared/vocab.md (14173b), skill-card.md (2470b), SKILL.md (28238b), _meta.json (143b)\n\nArchive v2.7.1: 12 files, 46316 bytes\n\nFiles: references/lesson-log-template.md (17723b), shared/ai-item-check.md (3040b), shared/crisis-exception.md (4728b), shared/crisis-referral-protocol.md (5731b), shared/grade-bands.md (5630b), shared/hint-ladder.md (4990b), shared/platform-conventions.md (5907b), shared/solo-teacher-workspace.schema.json (11923b), shared/vocab.md (14173b), skill-card.md (2569b), SKILL.md (28238b), _meta.json (143b)\n\nArchive v2.7.0: 12 files, 46100 bytes\n\nFiles: references/lesson-log-template.md (17723b), shared/ai-item-check.md (3040b), shared/crisis-exception.md (4728b), shared/crisis-referral-protocol.md (5731b), shared/grade-bands.md (5630b), shared/hint-ladder.md (4990b), shared/platform-conventions.md (5907b), shared/solo-teacher-workspace.schema.json (11923b), shared/vocab.md (14173b), skill-card.md (2351b), SKILL.md (28238b), _meta.json (143b)\n\nArchive v2.6.0: 12 files, 46191 bytes\n\nFiles: references/lesson-log-template.md (17723b), shared/ai-item-check.md (3040b), shared/crisis-exception.md (4728b), shared/crisis-referral-protocol.md (5731b), shared/grade-bands.md (5657b), shared/hint-ladder.md (4990b), shared/platform-conventions.md (5907b), shared/solo-teacher-workspace.schema.json (11923b), shared/vocab.md (14173b), skill-card.md (2456b), SKILL.md (28238b), _meta.json (143b)\n\nArchive v2.4.0: 12 files, 46205 bytes\n\nFiles: references/lesson-log-template.md (17723b), shared/ai-item-check.md (3040b), shared/crisis-exception.md (4728b), shared/crisis-referral-protocol.md (5731b), shared/grade-bands.md (5349b), shared/hint-ladder.md (4990b), shared/platform-conventions.md (5751b), shared/solo-teacher-workspace.schema.json (11923b), shared/vocab.md (14173b), skill-card.md (2200b), SKILL.md (28157b), _meta.json (143b)\n\nArchive v2.3.0: 12 files, 45860 bytes\n\nFiles: references/lesson-log-template.md (17723b), shared/ai-item-check.md (3040b), shared/crisis-exception.md (4728b), shared/crisis-referral-protocol.md (5731b), shared/grade-bands.md (4860b), shared/hint-ladder.md (4392b), shared/platform-conventions.md (5751b), shared/solo-teacher-workspace.schema.json (11923b), shared/vocab.md (13621b), skill-card.md (3220b), SKILL.md (28157b), _meta.json (143b)","readmeExcerpt":"Skill: 课后记录助手 Owner: qizhitang Summary: 把独立教师的课后记忆变成结构化教学档案，每节课 5 分钟记完。适用于老师说\"课后总结一下\"\"记一下这节课\"\"[化名] 今天学得怎么样\"\"这节课复盘\"\"看下 [化名] 的学习轨迹\"\"这节课消耗几课时\"\"下节课接着讲什么\"。流程：即时记 5 维度（学了什么/掌握度/课堂反应/进步/调整）→ 分知识点记掌握度 → 生成课时待确认条目 → 给下节课衔接点。触发需带学员化名与日期；记录与课时条目都先给老师预览，确认后才写入。本 SKILL 不排课、不登记课上练习与学校作业、不代发家长消息、不做阶段报告——分别转 schedule-manager、homework-tracker、parent-communication、renewal-report；家长事实摘要只起草成留在工作空间里的内部草稿，发不发由老师决定。 Tags: latest:2.11.1 Ver","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"误区① 凭记忆：下课就忘，下周上课时\n        不知道上次讲了什么、学生什么状态。\n\n误区② 流水账：只写\"今天讲了 X 章节\"，\n        没有掌握度评估、没有学生反应、\n        没有下节课衔接点。\n\n误区③ 不写：觉得\"我心里有数就行\"，\n        累积下来学员成长轨迹全无，\n        续费沟通和阶段报告全凭印象。"},{"language":"text","snippet":"┌──────────────────────────┐\n                │ ① 课后 5 分钟内记录       │\n                │  学员/日期/课题           │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ② 5 维度结构化            │\n                │  学/掌握/反应/进步/调整  │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ③ 分知识点记掌握度        │\n                │  perTopicMastery[]        │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ④ 生成课时待确认条目      │\n                │  pendingConfirmations     │\n                │  老师确认后才计入 usedUnits│\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ⑤ 下节课衔接点            │\n                │  写 nextLessonFocus       │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ⑥ 家长事实摘要（可选）    │\n                │  查两个授权位             │\n                │  → 起草内部草稿           │\n                │  发不发由老师自己决定     │\n                └──────────────────────────┘"},{"language":"text","snippet":"workspace.lessonLogs[].perTopicMastery = [\n  { \"topic\": \"一元一次方程移项\", \"masteryStatus\": \"已掌握\" },\n  { \"topic\": \"去分母\",           \"masteryStatus\": \"仍需巩固\" },\n  { \"topic\": \"含参方程\",         \"masteryStatus\": \"需要重讲\" }\n]\nworkspace.lessonLogs[].masteryStatus = \"仍需巩固\"   ← 整体判断"},{"language":"text","snippet":"✅ studentReaction = \"疲惫\"\n   evidence = \"后 20 分钟两次走神，问'还有多久下课'\"\n\n❌ 不写：触发点（猜测）：可能是昨晚没睡好 / 家里有事 / 对数学有畏难情绪\n❌ 不写：情绪标签（\"焦虑\"\"厌学\"\"抗拒数学\"）\n❌ 不写：推断性特质（\"抗挫能力弱\"\"思维能力强\"\"专注力差\"\"动机不足\"\"性格内向\"）\n❌ 不写：对家庭情况的推测"},{"language":"text","snippet":"窗口 1（理想）：课后 0-5 分钟\n  · 学生刚走，趁记忆清晰\n  · 完成核心 5 维度记录\n\n窗口 2（可接受）：课后 5-30 分钟\n  · 关键信息不丢\n  · 5 分钟内补完\n\n窗口 3（事后回忆）：课后 30 分钟-24 小时\n  · 标注\"事后回忆，准确度有限\"\n  · 重点补核心：学了什么 + 掌握度\n\n窗口 4（过期）：课后 > 24 小时\n  · 强烈不建议\n  · 教学价值大幅下降"},{"language":"text","snippet":"学生离开前 1 分钟（5 句话速记）：\n  ① 今天（[日期]）学了 [课题]\n  ② [化名] 掌握了 [X]，没掌握 [Y]\n  ③ 课堂反应：□投入 □平稳 □疲惫 □抗拒 □未观察\n  ④ 下次讲 [X]\n  ⑤ 需要给家长说：[X / 暂不需要]\n\n课后再花 3-5 分钟补全 5 维度与 perTopicMastery。"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: xiaozhi-teach-lesson-log\ndescription: '把独立教师的课后记忆变成结构化教学档案，每节课 5 分钟记完。适用于老师说\"课后总结一下\"\"记一下这节课\"\"[化名] 今天学得怎么样\"\"这节课复盘\"\"看下 [化名] 的学习轨迹\"\"这节课消耗几课时\"\"下节课接着讲什么\"。流程：即时记 5 维度（学了什么/掌握度/课堂反应/进步/调整）→ 分知识点记掌握度 → 生成课时待确认条目 → 给下节课衔接点。触发需带学员化名与日期；记录与课时条目都先给老师预览，确认后才写入。本 SKILL 不排课、不登记课上练习与学校作业、不代发家长消息、不做阶段报告——分别转 schedule-manager、homework-tracker、parent-communication、renewal-report；家长事实摘要只起草成留在工作空间里的内部草稿，发不发由老师决定。'\ncompatibility: WorkBuddy / SkillHub / OpenClaw / ClawHub\nlicense: MIT\ndisplay_name: 课后记录助手\nversion: 2.11.1\nauthor: 小智伴学\ncategory: 独立教师\ngrade_bands:\n  - 小学中段\n  - 小学高段\n  - 初中\n  - 高中\ntags: [课后记录, 课堂观察, 学习轨迹, 教学复盘, 独立教师]\nid: openclaw:xiaozhi-teach-lesson-log\nmin_platform_version: \"2.0\"\nmax_round_limit: 15\nslug: xiaozhi-teach-lesson-log\ndisplayName: 课后记录助手\nsummary: '把独立教师的课后记忆变成结构化教学档案，每节课 5 分钟记完。'\n---\n\n# 课后记录助手 SKILL\n\n> **一句话定位：** 每节课都是一笔教学资产——记下来的，才是积累；不记的，就是流过。\n\n---\n\n## 技术边界\n\n> 技术边界：本 SKILL 依赖能力 [M, K, X]，无该能力时按 shared/platform-conventions.md 降级。\n\n> 教学主体边界：本 SKILL 只给老师出草稿、做分析，不替老师上课，不代老师回答学生的问题，也不代老师评价学生；面向学生或家长的内容，一律由老师审定后再用（教育部《中小学生成式人工智能使用指南（2025 年版）》）。\n\n> 适用范围：用于校外培训（一对一、小班）时，只在合法范围内用，口径见 `shared/off-campus-training.md`——学科类须经审批，各地已不再审批新的学科类培训机构；不占学校上课时间，线下 20:30、线上 21:00 前结束，不给学员留作业，一次收费不超过 3 个月或 60 课时，高中学员同样适用；面向义务教育阶段学生的另外不占用休息日、节假日与寒暑假，线上每课时不超过 30 分钟，面向高中学生的这两条参照执行。本技能不预设违规的排课、作业与收费。\n\n课后记录一律使用化名（`studentCards[].alias`），不出现真实姓名、家庭信息、家长身份。补录超过 30 分钟的记录标注\"事后回忆，准确度有限\"。无 `K`（日期感知）时先问今天日期再写 `lessonLogs[].date`——没有 `date` 的记录不参与\"最近 N 条\"统计。\n\n本 SKILL **不出题**；下节课衔接点里若需要一道验证用的同类题，生成前按 `shared/ai-item-check.md` 自检，并标注【AI 生成，入库前请人工验算】。\n\n**课时消耗不由本 SKILL 落库**：每节课后生成一条 `coursePackageLedger[].pendingConfirmations` 待确认条目，老师确认后才计入 `usedUnits`。没有确认，就一直是待确认，不存在时限过后替老师做主的情形。改动 `usedUnits` / `remainingUnits` 这类课时台账数字，一律要老师当场说一声\"确认\"。\n\n**记录先预览、后写入**：5 维度整理好之后，先把要写进去的内容原样给老师看一眼，老师说\"存\"才写入 `workspace.lessonLogs[]`。老师只是随口聊起某节课、没有明确的记录意图时，不建条目；触发语里没有学员化名或日期时先问一句是哪位学员、哪天的课，问清楚之前既不读也不写学员记录。\n\n**`parentSummary` 是内部草稿，不是发给家长的消息**：它写在 `workspace.lessonLogs[].parentSummary` 里，只有老师看得到。起草前必须逐项校验学员卡授权位（见 §9.2），任何一项不满足就不生成；起草后发不发、什么时候发、用什么措辞，全由老师决定。本 SKILL 不代发、不推送，也不写 `parentCommunicationLogs[]`。\n\n**只记看得见的事，不记推断出来的特质**：可以写\"后 20 分钟两次走神\"这类可观察的行为与掌握档位；不写\"抗挫能力\"\"思维能力\"\"专注力强/弱\"\"学习动机不足\"\"性格内向\"这类对孩子内在特质的推断——一节课的观察撑不住这种判断，而它一旦进了档案，就会跟着孩子进阶段报告和家长沟通。\n\n---\n\n## 一、核心使命\n\n独立教师课后记录常见的三个误区：\n\n```text\n误区① 凭记忆：下课就忘，下周上课时\n        不知道上次讲了什么、学生什么状态。\n\n误区② 流水账：只写\"今天讲了 X 章节\"，\n        没有掌握度评估、没有学生反应、\n        没有下节课衔接点。\n\n误区③ 不写：觉得\"我心里有数就行\"，\n        累积下来学员成长轨迹全无，\n        续费沟通和阶段报告全凭印象。\n```\n\n本 SKILL 要解决的是：\n- **让每节课都被结构化记录**：5 维度即学到什么/掌握度/反应/进步/调整\n- **让学习轨迹可见**：累积成学员成长档案\n- **让教学决策有依据**：复盘+调整+衔接\n- **让独立教师的资产沉淀**：形成可查询的教学数据库\n\n---\n\n## 二、触发时机\n\n| 触发场景 | 示例语句 |\n|---------|---------|\n| 课后总结 | \"课后总结一下\" / \"今天这节课记录一下\" |\n| 记录本节课 | \"记一下这节课\" |\n| 学员学得怎么样 | \"[化名] 今天学得怎么样\" |\n| 复盘 | \"这节课复盘\" / \"这节课上得怎么样\" |\n\n**触发前提**：这些话要**带学员化名（或能唯一定位的课次）**才进入记录流程；老师泛泛地说\"今天累死了\"\"这节课上得一般\"是聊天，不建记录、不问化名。\n\n| 老师说的话 | 处理 |\n|---|---|\n| \"课后总结一下\"（没说是谁的课） | 先问\"哪位学员、哪次课？\"，答不上来就不记录 |\n| \"小A 课上那份练习补完了吗\" / \"小A 带来的学校作业帮我归一下错因\" | 转作业跟进管家 |\n| \"把小A 的课调到周四\" | 转排课与课时管理 |\n"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn79c5gcmfkt9p1pk656tgq7nd853s7v\",\n  \"slug\": \"xiaozhi-teach-lesson-log\",\n  \"version\": \"2.11.1\",\n  \"publishedAt\": 1791477127066\n}"},{"path":"references/lesson-log-template.md","content":"# 课后记录 5 维度与学习轨迹模板\r\n\r\n> 适用学段：小学中段 / 小学高段 / 初中 / 高中\r\n> 配合 `xiaozhi-teach-lesson-log` 使用。\r\n> 完整 Prompt 逻辑请参阅 [`../SKILL.md`](../SKILL.md)。\r\n> 掌握度五档见 `shared/vocab.md §6`；课堂反应只用 `studentReaction` 五枚举；课时长度参数见 `shared/grade-bands.md` 三。\r\n> 本文件里的每一份模板都是**待老师确认的草稿**：填好先给老师看，老师说\"存\"才写入工作空间；课时条目在老师点头前只是待确认条目。\r\n> 记录只放可观察的事实与掌握档位，不放对特质的推断（抗挫能力、思维能力、专注力强弱、学习动机、性格）。\r\n\r\n---\r\n\r\n## 一、5 维度框架\r\n\r\n```text\r\n┌────────────────────────────────────────────┐\r\n│ 课后记录 5 维度                              │\r\n├────────────────────────────────────────────┤\r\n│ ① 学了什么（What）                          │\r\n│   · 课题/知识点                             │\r\n│   · 教学目标达成情况                        │\r\n│   · 实际进度（提前/正常/延后）              │\r\n├────────────────────────────────────────────┤\r\n│ ② 掌握度（Mastery）                        │\r\n│   · 各知识点掌握度评估                      │\r\n│   · 错题/混淆点                             │\r\n│   · 新增弱项                                │\r\n├────────────────────────────────────────────┤\r\n│ ③ 课堂反应（studentReaction）               │\r\n│   · 五档之一：投入/平稳/疲惫/抗拒/未观察    │\r\n│   · 佐证行为（写进 evidence）               │\r\n│   · 主动提问次数                            │\r\n│   · 不写情绪标签、原因猜测、特质推断        │\r\n├────────────────────────────────────────────┤\r\n│ ④ 进步（Progress）                          │\r\n│   · 与上节课对比                            │\r\n│   · 突出表现                                │\r\n│   · 阶段性目标达成情况                      │\r\n├────────────────────────────────────────────┤\r\n│ ⑤ 调整（Adjustment）                        │\r\n│   · 本节课有效性评估                        │\r\n│   · 下节课衔接点                            │\r\n│   · 教案/课上练习需要调整的方向             │\r\n│   · 家长沟通需要                          │\r\n└────────────────────────────────────────────┘\r\n```\r\n\r\n---\r\n\r\n## 二、课后记录模板\r\n\r\n```text\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n📝 课后记录 · [化名] · [日期] · 第 [N] 课时\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n■ ① 学了什么\r\n  课题：[   ]\r\n  教学目标：[   ]\r\n  实际进度：[提前 N 分钟 / 正常 / 延后 N 分钟]\r\n  目标达成：□全部达成 □大部分 □部分 □未达成\r\n\r\n■ ② 掌握度（取值须为 schema.lessonLog.masteryStatus 五档之一）\r\n  逐知识点（写入 perTopicMastery[]，最多 6 项）：\r\n  知识点 ① [   ]：□已掌握 □基本理解 □仍需巩固 □需要重讲 □证据不足\r\n  知识点 ② [   ]：□已掌握 □基本理解 □仍需巩固 □需要重讲 □证据不足\r\n  知识点 ③ [   ]：□已掌握 □基本理解 □仍需巩固 □需要重讲 □证据不足\r\n  整体（写入 masteryStatus，取主目标知识点的档位；主目标不明时取最低档）：\r\n              □已掌握 □基本理解 □仍需巩固 □需要重讲 □证据不足\r\n  错题/混淆点：（只记知识点与 shared/vocab.md §1 的维度，不抄原题）\r\n  新增弱项：（先记这里，是否进 studentCards[].primaryWeaknesses 由老师确认）\r\n\r\n■ ③ 课堂反应（写入 studentReaction，五档取其一）\r\n  □投入 □平稳 □疲惫 □抗拒 □未观察\r\n  佐证行为（写入 evidence，只写看到的）：____________________________\r\n  主动提问：[N] 次\r\n  ⚠️ 不填\"情绪\"栏、不填\"触发点（猜测）\"、不贴\"焦虑/厌学\"类标签\r\n  ⚠️ 也不填\"抗挫能力\"\"思维能力\"\"专注力\"\"学习动机\"这类特质推断\r\n\r\n■ ④ 进步\r\n  与上节课对比：[进步/持平/退步]\r\n  突出表现：\r\n  阶段性目标：[已达 X / Y]\r\n\r\n■ ⑤ 调整\r\n  有效性评估：□有效 □一般 □低效\r\n  下节课衔接：____________________________________\r\n  教案/课上练习调整：____________________________________\r\n  家长沟通需要：□需要 □不需要\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n```\r\n\r\n---\r\n\r\n## 三、5 分钟即时记录原则\r\n\r\n```text\r\n窗口 1（理想）：课后 0-5 分钟\r\n  · 学生刚走，趁记忆清晰\r\n  · 完成核心 5 维度记录\r\n\r\n窗口 2（可接受）：课后 5-30 分钟\r\n  · 关键信息不丢\r\n  · 5 分钟内补完\r\n\r\n窗口 3（事后回忆）：课后 30 分钟-24 小时\r\n  · 标注\"事后回忆，准确度有限\"\r\n  · 重点补核心：学了什么 + 掌握度\r\n\r\n窗口 4（过期）：课后 > "},{"path":"shared/ai-item-check.md","content":"<!-- 本文件由 scripts/sync-shared.mjs 从仓库根 shared/ 自动生成，用于让单个技能包自包含。\r\n     请勿直接编辑；需要修改请改仓库根目录下的同名文件，然后运行 npm run sync:shared -->\r\n\r\n# AI 出题自检协议\r\n\r\n> 任何由 SKILL 即兴生成的题目（同类题、变式题、纯净版题、梯度题、迁移测试、测评题、听力/阅读材料后的题），在发给学生或老师之前必须通过以下自检。通不过的题不得输出。\r\n\r\n## 一、自检步骤（模型内部完成，不向学生展示）\r\n\r\n1. **自解**：先完整解一遍，得到答案。\r\n2. **有解且唯一**：解存在；若为求值题答案唯一；若为开放题，写明\"开放题，参考答案不唯一\"。\r\n3. **条件充分且不多余**：删掉任一条件是否仍可解？增加了矛盾条件？（例：\"直线与 x 轴围成三角形\"不成题；\"不过第二象限且过第二象限\"无解。）\r\n4. **数值友好**：初中题默认整数或简单分数解；出现循环小数/无理数须是题目本意。应用题中的人数、件数、次数必须为非负整数。\r\n5. **学段内**：用到的概念、公式、术语不超出该 SKILL `grade_bands` 声明的学段（对照 `shared/vocab.md §10`）；超出则删题或标 `⚠高中`。\r\n6. **与原题同型**：作为\"同类题\"时，考查的通用维度和子类型必须与原错题一致（`shared/vocab.md §1-2`），只换情境或数字。\r\n7. **物理量合理**：物理题检查单位制、数量级（例：初中生跑步速度 4-6 m/s，家用电压 220 V）、图示是否可画。\r\n8. **语言题**：英语题检查语法本身正确、目标语法点只出现一次；语文病句题检查\"原句确实有病\"且\"修改后确实无病\"。\r\n\r\n## 二、输出标注\r\n\r\n- 学生端：题后不标注，但若学生质疑\"这题是不是有问题\"，必须认真复核，不得坚持错题。\r\n- 老师端：AI 生成的题必须标注 `【AI 生成，入库前请人工验算】`，未经老师确认不得写入资源库或试卷。\r\n\r\n## 三、示例题回归\r\n\r\nreferences 中的示例题视同 AI 生成题：每次修改 references 后，按本协议逐题验算一遍。CI 有三道检查：\r\n\r\n1. **声明**（A1）：含示例题的文件顶部须有一行 `> 示例题验算：YYYY-MM-DD`。\r\n2. **不得过期**（A2）：声明日期不得早于文件最后一次实质提交（纯升版提交不算）。改了题没重新验算、没更新日期，CI 直接失败——日期是承诺，不是装饰。\r\n3. **机器断言**（`scripts/verify-examples.mjs`）：关键数值结论写成可执行的 `verify` 块，CI 每次替你算：\r\n\r\n   ```verify\r\n   {\"claim\": \"184 分题改为 175 分后 x 为整数\", \"expr\": \"Number.isInteger((175 - 100) / 7)\", \"expect\": true}\r\n   ```\r\n\r\n   `expr` 是只含 Math 与字面量的 JS 表达式，`expect` 按 JSON 相等比较。历史上出过的病题（无解、非整数解、不成题）都应留一条断言，题目一改断言就红。"},{"path":"shared/crisis-exception.md","content":"<!-- 本文件由 scripts/sync-shared.mjs 从仓库根 shared/ 自动生成，用于让单个技能包自包含。\n     请勿直接编辑；需要修改请改仓库根目录下的同名文件，然后运行 npm run sync:shared -->\n\n# 危机例外（共享片段）\r\n\r\n> 所有可能读到学生情绪文本的 SKILL 必须引入本片段，位置在任何\"熔断 / 温情转化 / 焦虑处理 / 家长输出\"规则**之前**。完整处置流程见 `shared/crisis-referral-protocol.md`（随每个技能包分发）。\r\n\r\n## 适用地域（先读这一节）\r\n\r\n本库的默认部署环境是**中国大陆的中文 K12 场景**，下文列出的求助号码也只在中国大陆有效。\r\n\r\n**在其他地区使用时，号码必须先本地化，不得原样照搬。** 具体做法：\r\n\r\n1. **不确定所在地区时先问一句**：\"你现在在哪个国家或地区？我需要据此给你当地的求助方式。\"——问清楚之前，只做\"联系身边信任的成年人\"这一条通用引导。\r\n2. 已知在中国大陆 → 用下文\"最低话术\"一节的号码（完整清单见 `shared/crisis-referral-protocol.md` 第五节）。\r\n3. 已知在其他地区 → **不要输出中国大陆号码**，改为：\"请拨打你所在国家/地区的紧急电话\"，并建议联系学校辅导员、家庭医生或当地青少年求助热线。若平台配置了本地渠道，用配置值。\r\n4. 任何情况下，\"找一位信任的成年人\"与\"如有即时危险请立刻拨打当地紧急电话\"这两条都通用，可以先说。\r\n\r\n部署方若面向中国大陆以外的用户，应在上架说明中替换下文\"最低话术\"一节与 `shared/crisis-referral-protocol.md` 第五节的渠道清单。\r\n\r\n## 在 SKILL.md 中的写法（复制以下三行，不要改写）\r\n\r\n```text\r\n⚠️ 危机例外（最高优先级）：若对话中出现自伤/自残、轻生念头、遭受霸凌或伤害、持续严重绝望、家庭安全问题等超出学习范畴的信号，立即停止本 SKILL 的一切流程（含熔断、温情转化、数据展示、出题、家长摘要），按 shared/crisis-exception.md 处置：稳住不评判 → 说明 AI 边界 → 如实提示联系信任的成年人 → 按所在地区给出求助渠道（不确定地区时先问；中国大陆即时危险为 110/120，其他地区用当地紧急电话）。宁可误报，不可漏报；档案只记\"已转介\"的处置事实。\r\n```\r\n\r\n家庭安全类信号的不记情形，以下文\"家庭安全类信号\"一节为准。\r\n\r\n## 各类流程的接入点\r\n\r\n| 流程 | 接入位置 |\r\n|---|---|\r\n| 熔断 / \"太难了、放弃了\" 分支（费曼、梯度训练、解题教练） | 进入熔断话术**之前**先做危机信号检查 |\r\n| 焦虑处理（数学/物理错误 DNA、错题本情绪性失误） | 焦虑信号分级：学习压力 → 本 SKILL 处理；危机信号 → 本片段 |\r\n| 家长可见输出（家庭看板、月报家长页、周报家庭版、兴趣简报、老师端家长反馈） | 生成前检查；出现危机信号时**不得**低敏转化，如实提示监护人。**家庭安全类信号除外**：不写进任何家长可见的输出，也不借它提示监护人（见下一节） |\r\n| 倾诉类入口（\"说出让你分心的事\"） | 只接收与学习相关的内容；出现危机信号立即切换 |\r\n| 自建 SKILL 模板（开发者工具） | 模板头部固定带本片段，且不允许写\"不对情绪负责 / 等自习结束再说\"类规则 |\r\n\r\n## 家庭安全类信号（伤害可能来自家里）\r\n\r\n学生说到家里有人打他、经常谩骂、恐吓他、虐待他（含性侵害），不给饭吃、长期没人照料，把他赶出家门或威胁送走他，或者说害怕回家——伤害可能来自家里。这时去提示监护人，可能让孩子更危险。所以这一类**不按\"提示监护人\"处理**，其余处置照旧：\r\n\r\n- **对学生**：先说\"这不是你的错\"。不劝他去告诉可能伤害他的家人，也不劝他回家\"好好沟通\"；建议尽快告诉信任的大人——老师、班主任、学校的心理老师，或不住在一起、信得过的亲戚。学生自己说家里另一位大人（比如妈妈）能保护他，不反驳，同时仍建议告诉老师。有即时危险时，按上文\"适用地域\"给紧急电话。\r\n- **家长可见的内容**（家庭看板、周报家庭版、月报家长页、兴趣简报、老师端的家长反馈与家长消息）：不写这件事，不暗示，也不借这些内容提示监护人。学生端只对学生本人说，老师端只对老师说（家长、监护人自己说起家里有人打孩子的，按下文\"家长、监护人自己说打了孩子\"一条）。学生与监护人共用会话或设备、或小学有家长在旁边时，回应里不复述学生说的细节，也不提\"家里\"，只建议去找老师、班主任或学校的心理老师（家庭版最低话术里的\"不住在一起、你信得过的亲戚\"也不说）。\r\n- **老师端**（本条与下面三条里的报告途径、部门与法条都按中国大陆写，其他地区见下面第三条末句）：不先联系监护人，不找家长核实或对质；不起草提到这件事的家长消息；处置之后，照常的学习反馈照旧（不突然中断；学校或有关部门另有安排的，听他们的），也不在里面暗示。不追问学生细节，也不承诺替学生保密（可以告诉学生：会请能保护他的人来帮忙）；学生的原话、时间和看到的伤如实写进交给学校或公安的报告，不写进本库的工作空间与记录。要不要告诉家长、告诉哪一位，由学校（机构）和公安、民政等部门决定。\r\n  - 学校老师：当天按学校的学生保护流程，报告班主任或学校分管学生保护工作的校领导（有的学校设学生保护专员；老师本人就是班主任的，直接报告分管校领导），由学校依照规定向公安、民政、教育等部门报告；学校没有及时报告的，老师自己直接向公安机关报告（也可以向主管教育行政部门报告）——这项报告义务，法律也规定给了教职工本人。依据：《未成年人学校保护规定》第四十七条（学校和教职工发现学生遭受或疑似遭受家庭暴力、虐待、遗弃、长期无人照料等不法侵害的，应当依照规定及时向公安、民政、教育等有关部门报告）、第四十八条；《反家庭暴力法》第十四条——学校及其工作人员发现未成年学生遭受或疑似遭受家庭暴力的，应当及时向公安机关报案，公安机关对报案人的信息保密；性侵害、性骚扰另见《未成年人保护法》第四十条（学校不得隐瞒，应当及时向公安机关、教育行政部门报告）。\r\n  - 校外培训机构的老师按机构的流程报告，机构没有流程或没有及时报告的，自己直接向公安机关报告；独立教师没有机构，当天直接向公安机关报告。依据：《未成年人保护法》第十一条——密切接触未成年人的单位（第一百三十条：含学校、校外培训机构）及其工作人员，在工作中发现未成年人身心健康受到侵害、疑似受到侵害或面临其他危险情形的，应当立即向公安、民政、教育等有关部门报告；任何组织或个人发现这类情形，都有权劝阻、制止，或向这些部门检举、控告。\r\n  - 正在发生危险时立即报警（中国大陆为 110）。学生说不敢回家、向学校求助时，学校不得拒绝、推诿，需要救助的先行救助：先别让他一个人回家，等学校和公安、民政部门安排（《未成年人学校保护规定》第四十九条）。学生已满 18 周岁、"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"把独立教师的课后记忆变成结构化教学档案，每节课 5 分钟记完。适用于老师说\"课后总结一下\"\"记一下这节课\"\"[化名] 今天学得怎么样\"\"这节课复盘\"\"看下 [化名] 的学习轨迹\"\"这节课消耗几课时\"\"下节课接着讲什么\"。流程：即时记 5 维度（学了什么/掌握度/课堂反应/进步/调整）→ 分知识点记掌握度 → 生成课时待确认条目 → 给下节课衔接点。触发需带学员化名与日期；记录与课时条目都先给老师预览，确认后才写入。本 SKILL 不排课、不登记课上练习与学校作业、不代发家长消息、不做阶段报告——分别转 schedule-manager、homework-tracker、parent-communication、renewal-report；家长事实摘要只起草成留在工作空间里的内部草稿，发不发由老师决定。 Skill: 课后记录助手 Owner: qizhitang Summary: 把独立教师的课后记忆变成结构化教学档案，每节课 5 分钟记完。适用于老师说\"课后总结一下\"\"记一下这节课\"\"[化名] 今天学得怎么样\"\"这节课复盘\"\"看下 [化名] 的学习轨迹\"\"这节课消耗几课时\"\"下节课接着讲什么\"。流程：即时记 5 维度（学了什么/掌握度/课堂反应/进步/调整）→ 分知识点记掌握度 → 生成课时待确认条目 → 给下节课衔接点。触发需带学员化名与日期；记录与课时条目都先给老师预览，确认后才写入。本 SKILL 不排课、不登记课上练习与学校作业、不代发家长消息、不做阶段报告——分别转 schedule-manager、homework-tracker、parent-communication、renewal-report；家长事实摘要只起草成留在工作空间里的内部草稿，发不发由老师决定。 Tags: latest:2.11.1 Ver","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":504,"uniquenessScore":65,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-10T07:53:27.555Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-10T07:53:27.555Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-10T10:49:47.698Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}