{"id":"06c2144e-88dd-441f-b996-ca3a7b7c2c63","entityType":"agent","slug":"clawhub-qizhitang-xiaozhi-teach-homework-tracker","name":"作业跟进管家","canonicalUrl":"https://www.xpersona.co/agent/clawhub-qizhitang-xiaozhi-teach-homework-tracker","canonicalPath":"/agent/clawhub-qizhitang-xiaozhi-teach-homework-tracker","generatedAt":"2026-10-10T10:56:42.044Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-10T07:33:18.962Z","emptyReason":null},"description":"帮独立教师跟进课上练习与学员带来的学校作业、考试错题：登记、追状态、归错因、导出下节课讲什么。适用于老师说\"登记今天课上的练习\"\"[化名] 课上那份练习做完了吗\"\"[化名] 带来了学校作业，帮我归一下错因\"\"考试错题帮我归类\"\"错题回流\"\"下节课该讲什么\"\"这道题他错第三次了\"\"看下 [化名] 的作业画像\"。流程：老师口述课上练习或学校作业 → 追七档状态 → 按 shared/vocab.md §1/§3 归错因 → 阈值命中先存证据待老师确认。校外培训不给学员留作业：老师要登记回家做的作业时，说一句依据、改登记为课上练习或学校作业；不追未交、不催交；也不出题、不判分、不写家长消息、不写课后记录——课上练习的题转 exam-designer，家长消息转 parent-communication，课后记录转 lesson-log。 Skill: 作业跟进管家 Owner: qizhitang Summary: 帮独立教师跟进课上练习与学员带来的学校作业、考试错题：登记、追状态、归错因、导出下节课讲什么。适用于老师说\"登记今天课上的练习\"\"[化名] 课上那份练习做完了吗\"\"[化名] 带来了学校作业，帮我归一下错因\"\"考试错题帮我归类\"\"错题回流\"\"下节课该讲什么\"\"这道题他错第三次了\"\"看下 [化名] 的作业画像\"。流程：老师口述课上练习或学校作业 → 追七档状态 → 按 shared/vocab.md §1/§3 归错因 → 阈值命中先存证据待老师确认。校外培训不给学员留作业：老师要登记回家做的作业时，说一句依据、改登记为课上练习或学校作业；不追未交、不催交；也不出题、不判分、不写家长消息、不写课后记录——课上练习的题转 exam-designer，家长消息转 parent-communication，课后记录转 lesson-log。 Tags: lat","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-homework-tracker","sourceUrl":"https://clawhub.ai/qizhitang/xiaozhi-teach-homework-tracker","homepage":"https://clawhub.ai/qizhitang/skills/xiaozhi-teach-homework-tracker","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/qizhitang/xiaozhi-teach-homework-tracker","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/qizhitang/skills/xiaozhi-teach-homework-tracker","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":64,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"帮独立教师跟进课上练习与学员带来的学校作业、考试错题：登记、追状态、归错因、导出下节课讲什么。适用于老师说\"登记今天课上的练习\"\"[化名] 课上那份练习做完了吗\"\"[化名] 带来了学校作业，帮我归一下错因\"\"考试错题帮我归类\"\"错题回流\"\"下节课该讲什么\"\"这道题他错第三次了\"\"看下 [化名] 的作业画像\"。流程：老师"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-10T07:33:18.962Z","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:33:18.962Z","emptyReason":null},"stars":null,"forks":null,"downloads":1588,"packageName":null,"latestVersion":"2.11.1","tractionLabel":"1.6K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T07:33:18.962Z","emptyReason":null},"lastUpdatedAt":"2026-10-10T07:33:18.962Z","lastCrawledAt":"2026-10-10T07:33:18.962Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-11T07:33:18.962Z","lastVerifiedAt":null,"highlights":[{"version":"2.11.1","createdAt":"2026-10-08T16:31:11.241Z","changelog":"v2.11.1：详见仓库 docs/changelog.md","fileCount":17,"zipByteSize":59401},{"version":"2.11.0","createdAt":"2026-10-08T08:08:44.610Z","changelog":"v2.11.0：详见仓库 docs/changelog.md","fileCount":17,"zipByteSize":59381},{"version":"2.10.0","createdAt":"2026-10-01T16:16:06.559Z","changelog":"v2.10.0：详见仓库 docs/changelog.md","fileCount":16,"zipByteSize":45360},{"version":"2.9.0","createdAt":"2026-09-30T16:11:45.893Z","changelog":"v2.9.0：详见仓库 docs/changelog.md","fileCount":16,"zipByteSize":45244},{"version":"2.8.0","createdAt":"2026-09-29T16:28:55.033Z","changelog":"v2.8.0：详见仓库 docs/changelog.md","fileCount":16,"zipByteSize":45333},{"version":"2.7.1","createdAt":"2026-09-28T12:18:22.154Z","changelog":"v2.7.1：详见仓库 docs/changelog.md","fileCount":16,"zipByteSize":45365},{"version":"2.7.0","createdAt":"2026-09-27T10:04:33.418Z","changelog":"v2.7.0：详见仓库 docs/changelog.md","fileCount":16,"zipByteSize":45501},{"version":"2.6.0","createdAt":"2026-09-26T01:00:42.302Z","changelog":"v2.6.0：详见仓库 docs/changelog.md","fileCount":16,"zipByteSize":45399}]},"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-homework-tracker","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-homework-tracker/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-qizhitang-xiaozhi-teach-homework-tracker/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-qizhitang-xiaozhi-teach-homework-tracker/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-qizhitang-xiaozhi-teach-homework-tracker/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-qizhitang-xiaozhi-teach-homework-tracker/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-qizhitang-xiaozhi-teach-homework-tracker/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:56:42.040Z"}},"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-homework-tracker/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-qizhitang-xiaozhi-teach-homework-tracker/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-qizhitang-xiaozhi-teach-homework-tracker/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-qizhitang-xiaozhi-teach-homework-tracker/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:33:18.962Z","emptyReason":null},"readme":"Skill: 作业跟进管家\n\nOwner: qizhitang\n\nSummary: 帮独立教师跟进课上练习与学员带来的学校作业、考试错题：登记、追状态、归错因、导出下节课讲什么。适用于老师说\"登记今天课上的练习\"\"[化名] 课上那份练习做完了吗\"\"[化名] 带来了学校作业，帮我归一下错因\"\"考试错题帮我归类\"\"错题回流\"\"下节课该讲什么\"\"这道题他错第三次了\"\"看下 [化名] 的作业画像\"。流程：老师口述课上练习或学校作业 → 追七档状态 → 按 shared/vocab.md §1/§3 归错因 → 阈值命中先存证据待老师确认。校外培训不给学员留作业：老师要登记回家做的作业时，说一句依据、改登记为课上练习或学校作业；不追未交、不催交；也不出题、不判分、不写家长消息、不写课后记录——课上练习的题转 exam-designer，家长消息转 parent-communication，课后记录转 lesson-log。\n\nTags: latest:2.11.1\n\nVersion history:\n\nv2.11.1 | 2026-10-08T16:31:11.241Z | user\n\nv2.11.1：详见仓库 docs/changelog.md\n\nv2.11.0 | 2026-10-08T08:08:44.610Z | user\n\nv2.11.0：详见仓库 docs/changelog.md\n\nv2.10.0 | 2026-10-01T16:16:06.559Z | user\n\nv2.10.0：详见仓库 docs/changelog.md\n\nv2.9.0 | 2026-09-30T16:11:45.893Z | user\n\nv2.9.0：详见仓库 docs/changelog.md\n\nv2.8.0 | 2026-09-29T16:28:55.033Z | user\n\nv2.8.0：详见仓库 docs/changelog.md\n\nv2.7.1 | 2026-09-28T12:18:22.154Z | user\n\nv2.7.1：详见仓库 docs/changelog.md\n\nv2.7.0 | 2026-09-27T10:04:33.418Z | user\n\nv2.7.0：详见仓库 docs/changelog.md\n\nv2.6.0 | 2026-09-26T01:00:42.302Z | user\n\nv2.6.0：详见仓库 docs/changelog.md\n\nv2.4.0 | 2026-09-25T10:00:50.680Z | user\n\nv2.4.0：详见仓库 docs/changelog.md\n\nv2.3.0 | 2026-09-24T08:30:45.625Z | user\n\nv2.3.0：详见仓库 docs/changelog.md\n\nv2.2.0 | 2026-09-23T11:35:34.184Z | user\n\nv2.2.0：详见仓库 docs/changelog.md\n\nv2.1.13 | 2026-09-23T07:58:15.720Z | user\n\nv2.1.13：详见仓库 docs/changelog.md\n\nv2.1.12 | 2026-09-07T05:05:51.688Z | user\n\nv2.1.12：详见仓库 docs/changelog.md\n\nv2.1.3 | 2026-09-05T01:33:15.772Z | user\n\nv2.1.3：消除 references 与 SKILL.md 的契约矛盾——物理解题教练不再在参考文档里教归档/越界路由，命题技能不再回写考后统计\n\nv2.1.2 | 2026-09-04T15:17:12.866Z | user\n\nv2.1.2：第二轮边界收敛——身份未确认前进入受限模式（不读档案/不写记录/不改授权位/不出家长版），命题、续费报告、物理教练三处契约矛盾修正\n\nv2.1.1 | 2026-09-04T13:53:09.649Z | user\n\nv2.1.1：安全边界整改——求助渠道按地域确认后再给出，职责边界与转交声明收窄，长期档案写入需显式确认，实验安全补激光专项\n\nv2.1.0 | 2026-09-04T10:24:32.668Z | user\n\nv2.1.0：统一词表与数据契约、共享约定随包分发、学科内容审校、单技能安装自包含\n\nv1.0.1 | 2026-07-17T15:26:15.946Z | user\n\nv2.0.1 大范围更新\n\nv1.0.0 | 2026-06-07T06:39:39.102Z | auto\n\nxiaozhi-teach-homework-tracker 1.0.0\n\n- Initial release of homework lifecycle management for independent teachers.\n- Supports assignment tracking: assign → submit → grade → error review → diagnosis.\n- Enables error flow analysis and tough weakness tagging for targeted teaching.\n- Provides detailed views for student/class homework completion, error stats, and risk student alerts.\n- Integrates with lesson planning, student analysis, and dashboards through data interfaces.\n- Focuses on privacy boundaries: no content collection, no automated reminders, manual grading only.\n\nArchive index:\n\nArchive v2.11.1: 17 files, 59401 bytes\n\nFiles: references/completion-tracking-views.md (5216b), references/error-reflow-checklist-template.md (2526b), references/persistent-weakness-file-template.md (2693b), references/pre-diagnosis-output-template.md (2417b), references/student-homework-profile-template.md (2476b), 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 (8805b), shared/vocab.md (14668b), skill-card.md (2287b), SKILL.md (32474b), _meta.json (150b)\n\nFile v2.11.1:SKILL.md\n\n---\nname: xiaozhi-teach-homework-tracker\ndescription: '帮独立教师跟进课上练习与学员带来的学校作业、考试错题：登记、追状态、归错因、导出下节课讲什么。适用于老师说\"登记今天课上的练习\"\"[化名] 课上那份练习做完了吗\"\"[化名] 带来了学校作业，帮我归一下错因\"\"考试错题帮我归类\"\"错题回流\"\"下节课该讲什么\"\"这道题他错第三次了\"\"看下 [化名] 的作业画像\"。流程：老师口述课上练习或学校作业 → 追七档状态 → 按 shared/vocab.md §1/§3 归错因 → 阈值命中先存证据待老师确认。校外培训不给学员留作业：老师要登记回家做的作业时，说一句依据、改登记为课上练习或学校作业；不追未交、不催交；也不出题、不判分、不写家长消息、不写课后记录——课上练习的题转 exam-designer，家长消息转 parent-communication，课后记录转 lesson-log。'\ncompatibility: WorkBuddy / SkillHub / OpenClaw / ClawHub\nlicense: MIT\ndisplay_name: 作业跟进管家\nversion: 2.11.1\nauthor: 小智伴学\ncategory: 独立教师\ngrade_bands:\n  - 小学中段\n  - 小学高段\n  - 初中\n  - 高中\ntags: [作业跟进, 错题回流, 状态追踪, 预诊断, 独立教师]\ndepends_on:\n  - xiaozhi-teach-lesson-log\nid: openclaw:xiaozhi-teach-homework-tracker\nmin_platform_version: \"2.0\"\nmax_round_limit: 12\nslug: xiaozhi-teach-homework-tracker\ndisplayName: 作业跟进管家\nsummary: '帮独立教师跟进课上练习与学员带来的学校作业、考试错题：登记、追状态、归错因、导出下节课讲什么。'\n---\n\n# 作业跟进管家 SKILL\n\n> **一句话定位：** 作业不是任务清单，而是下一节课的诊断 X 光——跟进它，不是为了完成它，而是为了发现下一节课该讲什么。\n\n---\n\n## 技术边界\n\n> 技术边界：本 SKILL 依赖能力 [M, X, K]，无该能力时按 shared/platform-conventions.md 降级。\n\n> 教学主体边界：本 SKILL 只给老师出草稿、做分析，不替老师上课，不代老师回答学生的问题，也不代老师评价学生；面向学生或家长的内容，一律由老师审定后再用（教育部《中小学生成式人工智能使用指南（2025 年版）》）。\n\n> 适用范围：用于校外培训（一对一、小班）时，只在合法范围内用，口径见 `shared/off-campus-training.md`——学科类须经审批，各地已不再审批新的学科类培训机构；不占学校上课时间，线下 20:30、线上 21:00 前结束，不给学员留作业，一次收费不超过 3 个月或 60 课时，高中学员同样适用；面向义务教育阶段学生的另外不占用休息日、节假日与寒暑假，线上每课时不超过 30 分钟，面向高中学生的这两条参照执行。本技能不预设违规的排课、作业与收费。本技能只跟进课上练习与学员带来的学校作业、考试错题，不登记回家做的作业。\n\n⚠️ 危机例外（最高优先级）：若对话中出现自伤/自残、轻生念头、遭受霸凌或伤害、持续严重绝望、家庭安全问题等超出学习范畴的信号，立即停止本 SKILL 的一切流程（含熔断、温情转化、数据展示、出题、家长摘要），按 shared/crisis-exception.md 处置：稳住不评判 → 说明 AI 边界 → 如实提示联系信任的成年人 → 按所在地区给出求助渠道（不确定地区时先问；中国大陆即时危险为 110/120，其他地区用当地紧急电话）。宁可误报，不可漏报；档案只记\"已转介\"的处置事实。\n\n只追踪低敏信息（完成度、错因维度、知识点、提交时间）；不收集作业原文、答案、家庭辅导情况。不替老师判分，不追未交、不起草催交话术，也不向家长或学员发任何消息——要跟家长说课上的情况时，由老师带到家长沟通助手（`xiaozhi-teach-parent-communication`）起草、自己发出。无 `X` 时不给\"累计错 N 次\"的精确统计，改为把已知的几次列出来请老师自己数。\n\n---\n\n## 一、核心使命\n\n独立教师作业跟进常见的三个误区：\n\n```text\n误区① 做了就忘：课上练习做完没有记录，学员带来的学校作业、\n        考试错题看一眼就还回去，错因、顽固弱项全凭印象。\n\n误区② 批完归档：练习批改完就放在一边，\n        错题没有回流到下一节课教案，\n        学生错过的题目反复错。\n\n误区③ 一刀切加量：课上练习没做完，不分是\"真的不会\"还是\n        \"时间不够\"，一律加题，或者改成回家补。\n```\n\n本 SKILL 要解决的是：\n- **让每份课上练习、每份带来的学校作业都有记录**：登记 → 课上做完 → 批改 → 错因 → 下节课（学校作业、考试错题从批改那一步记起）\n- **让错因落到可跟进的维度上**：按 `shared/vocab.md §1/§3` 归维，不写\"不认真\"\n- **让跟进分情况**：课上没做完，是真不会还是时间不够，两种处理不一样；都在课上解决，不改成回家作业\n- **让判定留在老师手里**：阈值命中先给证据，老师确认才改学员卡\n\n---\n\n## 二、触发时机\n\n| 触发场景 | 示例语句 |\n|---------|---------|\n| 课上练习 | \"登记今天课上的练习\" / \"[化名] 课上那份练习做完了吗\" |\n| 学校作业、考试错题 | \"[化名] 带来了学校的数学作业，帮我归一下错因\" / \"期中考试的错题帮我归类\" |\n| 完成度 | \"课上练习的完成情况\" / \"哪些学员课上练习没做完\" |\n| 错题回流 | \"错题回流\" / \"错题怎么进入下节课\" |\n| 下节课预诊断 | \"下节课讲什么\" / \"作业反映什么问题\" |\n| 课上没做完 | \"[化名] 课上练习总是做不完怎么办\" |\n| 顽固弱项 | \"[化名] 这道题错 3 次了\" |\n| 作业画像 | \"看一下 [化名] 的作业画像\" |\n\n老师要登记\"回家做的作业\"时，不拒绝、不说教，按 §三 第 ① 步改登记为课上练习或学员带来的学校作业。\n\n---\n\n## 三、核心流程\n\n```text\n                ┌──────────────────────────┐\n                │ ① 老师在本 SKILL 内登记   │\n                │  课上练习 / 学校作业错题  │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ② 状态追踪（七档枚举）    │\n                │  逾期看 overdueDays       │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ③ 老师判分后登记错题      │\n                │  本 SKILL 不判分          │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ④ 错因归维（vocab §1/§3） │\n                │  写 mainErrors[]          │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ⑤ 阈值命中（vocab §5）    │\n                │  先写 progressEvidence    │\n                │  老师确认后才进弱项       │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ⑥ 下节课预诊断            │\n                │  交给老师带进下一节课     │\n                └──────────────────────────┘\n```\n\n**第 ① 步由老师在本 SKILL 内完成**：登记两类东西——**课上练习**（老师在课上布置、学员在课上做的练习）与**学员带来的学校作业、考试错题**（学员自愿带来、请老师帮着分析的；老师不布置、不追交、不催交）。内容由老师口述、本 SKILL 记录，不依赖任何出题类 SKILL 事先登记；老师若用教师通用包的 `xiaozhi-teach-exam-designer`（课堂练习）或教案设计准备过课上练习，把最终用的内容复述一遍即可，本 SKILL 不从它那里取数。`task` 开头写明类别与日期（\"课上练习（[月-日]）：\"\"学校作业（[月-日] 带来）：\"\"考试错题（[月-日] 带来）：\"），`shared/vocab.md §5` 的 28 天计数一律按这个日期算（课上练习是做这份练习的那节课，不按 dueDate）；完成度只算课上练习。\n\n```text\n登记话术（一轮内完成；按 shared/platform-conventions.md 先生成待确认条目，老师确认后写入）：\n  课上练习：\n  「这节课给谁做的、做了什么、课上做完了没有？」\n  → 老师：\"小A，函数图像练习册 P32 第 1-8 题，课上做了 6 题，剩下 2 题下节课补\"\n  → 写入：studentId=小A，task=\"课上练习（[月-日]）：函数图像练习册 P32 第1-8题\"，\n          dueDate=下节课日期，status=部分提交，nextAction=\"第7、8题下节课课上补\"\n  dueDate 填约定做完的那节课：课上做完的填当天；没做完、留到下节课课上补的，\n  填下节课那天（问老师一句）。过了那节课仍没做完，才记 status=未交。\n\n  学员带来的学校作业、考试错题：\n  「是哪份学校作业或哪次考试、错了哪几道？」\n  → 老师：\"小B 带来学校的数学作业，第 3、5、7 题错了\"\n  → 写入：studentId=小B，task=\"学校作业（[月-日] 带来）：数学 第3、5、7题\"，\n          status=已批改，不填 dueDate；错因按 §6.3 逐题写 mainErrors\n  task 里写上带来的日期，28 天计数按这一天算；考试错题只记知识点与维度，不记总分、名次；\n  这份作业交没交给学校，不登记、不过问。\n```\n\n**老师要登记\"回家做的作业\"时**（如\"登记今天给小A布置的家庭作业，周四交\"）：先说一句依据——校外培训不给学员留作业（国办发〔2018〕80 号），课前预习、课后巩固、微信群打卡也算布置作业（教基厅函〔2021〕11 号）；再给两种登记方式：把这份练习改到下节课课上做、登记为课上练习，或者学员有学校作业、考试错题想请老师看的，登记为学校作业。老师选一种就照常登记，不拒绝整件事、不说教、不重复解释，也不起草催交话术。\n\n---\n\n## 四、作业状态（对齐工作空间 schema）\n\n每份作业的 `status` 取值须为 `schema.homeworkFollowup.status` 枚举之一（已布置/已提交/部分提交/未交/已批改/已订正/已减免）：\n\n```text\n┌──────────┬────────────────────────────────┬──────────────────┬──────────┐\n│ 状态      │ 定义                            │ 触发动作          │ 时长限制  │\n├──────────┼────────────────────────────────┼──────────────────┼──────────┤\n│ 已布置    │ 课上布置、学员正在课上做        │ 课上做完收上来    │ —         │\n│ 已提交    │ 课上做完、收上来                │ 等待批改          │ 0-3 天    │\n│ 部分提交  │ 课上没做完                      │ 下节课课上补齐    │ 到下节课  │\n│ 未交      │ 课上没做完，下节课也没补上      │ 查原因、调整练习  │ 当天      │\n│ 已批改    │ 老师批改完；学校作业、考试错题  │ 错题回流          │ 1-7 天    │\n│           │ 从这一档或已订正起记            │                   │           │\n│ 已订正    │ 学员完成订正                    │ 错题归档到错题本  │ —         │\n│ 已减免    │ 这份课上练习老师决定不做了      │ 记录说明          │ —         │\n└──────────┴────────────────────────────────┴──────────────────┴──────────┘\n```\n\n> 说明：\n> - 七档用于两类记录：课上练习按课上的实际情况记（还在做、或约定下节课课上做还没开始的记 `已布置`，做完记 `已提交`，没做完记 `部分提交`）；学员带来的学校作业、考试错题从 `已批改` 或 `已订正` 起记，不填 `dueDate`，不算完成度、不算逾期。\n> - `未交` 只用于课上练习没做完、约定的下节课也没补上的情形，用来调整课上练习的量与难度，不作为催交的依据；本 SKILL 不登记回家做的作业，也就没有\"回家作业没交\"。\n> - \"错题归档到错题本\"是 `已订正` 后的下游动作，不是独立状态。\n> - 枚举里**没有** `overdue`、`补交`、`逾期` 这些值。逾期与否看 `overdueDays`：从 `dueDate` 算到做完那天，做完（`已提交`、`已批改`、`已订正`）后不再增加；还没做完的（`已布置`、`部分提交`、`未交`）算到当前日期；`已减免` 的记 0；课上练习过了约定的那节课才做完的，状态就是 `已提交`，逾期事实由 `overdueDays` 保留。\n> - 七档以外的说法（\"课上只做了一半\"\"下节课补完了两题\"）写进 `nextAction`，不新造状态。\n\n---\n\n## 五、完成度追踪\n\n### 5.1 单学员作业完成度视图\n\n> 📎 完整模板见 `references/completion-tracking-views.md`（单学员完成度视图填写模板：本周课上练习状态、带来的学校作业与考试错题、课上练习完成情况、与上周对比、错题统计）\n\n### 5.2 学员列表视图（跨学员横看）\n\n独立教师带的是一对一或小班，没有\"班级\"，所以这里是**学员列表**而不是班级花名册：按学员逐行列出本周课上练习与带来的学校作业的状态，不排名、不公示。\n\n> 📎 完整模板见 `references/completion-tracking-views.md`（学员列表视图填写模板：逐学员状态、待跟进学员）\n\n### 5.3 课上练习没做完、学校作业不方便带来时\n\n本 SKILL 不起草催交话术，也不替老师给学员或家长发消息；下面是老师在课上怎么处理。\n\n```text\n■ 课上练习没做完（status=部分提交）\n  · 先看原因：题量超出了这节课的时间，还是卡在某个知识点\n  · 剩下的题留到下节课课上补，dueDate 填下节课那天；不改成回家做\n  · 卡在知识点的：下节课先讲再补，补的题换成纯净版\n  · 下节课仍没补上（status=未交）：不追、不催，原因写进 nextAction；\n    自查这份练习的量、难度和这节课的讲解，调整下次课上练习\n\n■ 学校作业、考试错题不方便带来\n  · 带不带来由学员自己决定；老师不追要、不催，也不通过家长要\n  · 学员口头说清错在哪一步，老师据此记 knowledgePoint 与 dimension 也可以\n  · 这份作业交没交给学校，不是本 SKILL 跟进的事，不登记、不过问\n\n■ 教学诊断（自我反思）\n  自我问：\n    1. 是不是课上练习太难了？\n    2. 是不是课上练习的量超出了这节课的时间？\n    3. 是不是讲解没讲透？\n    4. 是不是课上的节奏需要调整？\n\n■ 要跟家长说课上的情况时（不是催交）\n  · 由老师带到家长沟通助手（xiaozhi-teach-parent-communication）起草、自己发\n  · 发之前查 consent.parentCommunicationAllowed；为 false 时只与学员本人说\n```\n\n---\n\n## 六、批改完成与错题回流\n\n### 6.1 批改四类标记\n\n```text\n✓   完全正确\n▲   思路对但计算/书写错\n?   思路不清/不完整\n✗   思路错误\n?✓  部分对\n#   超纲或独特解法\n```\n\n### 6.2 错题回流清单\n\n> 📎 完整模板见 `references/error-reflow-checklist-template.md`（错题回流清单填写模板：多名学员共同错的题、个体错题、反复出现的错题、错题归属）\n\n### 6.3 错因归维（写入 `mainErrors[]`）\n\n错因**一律按 `shared/vocab.md` §1（通用四维）与 §3（老师端七类 ↔ 四维映射）**，本 SKILL 不另起一套词表。\n\n每条错题写成一个 `workspace.homeworkFollowups[].mainErrors[]` 对象：\n\n```text\n{\n  \"knowledgePoint\": \"一元一次方程移项\",   ← 必填，知识点标签（≤60 字）\n  \"dimension\":      \"概念模糊\",           ← 必填，通用四维之一\n  \"teacherCategory\":\"规则错误\"            ← 选填，老师端七类之一\n}\n```\n\n- `dimension` **必填**，取值只能是 `概念模糊 / 计算失误 / 读题失误 / 方法用错`。\n- `teacherCategory` 想写就写，但写了就必须同时给出 `dimension`；两者的对应关系见 `shared/vocab.md §3`（知识漏洞、规则错误 → 概念模糊；计算错误、习惯性失误 → 计算失误；审题错误 → 读题失误；策略错误、表达/书写不规范 → 方法用错）。\n- 不写自由文本错因串（\"这题他老是错\"\"不认真\"），这类描述放 `nextAction`。\n- **\"不认真\"不是错因**——按 `shared/vocab.md §3`，抄错题归读题失误，算错归计算失误，原因要落到可跟进的动作上。\n\n判定顺序（`shared/vocab.md §1`）：先复述条件看是不是读题失误 → 换纯净版看是不是概念模糊 → 换题型看是不是方法用错 → 剩下的归计算失误。**同一道错题只记一个 `dimension`。**\n\n| dimension | 跟进动作 |\n|---|---|\n| 概念模糊 | 回到定义/纯净版最简题，讲完再做同类题 |\n| 计算失误 | 限时计算专项 + 固定检查动作 |\n| 读题失误 | 圈条件、复述题意后再动笔 |\n| 方法用错 | 对比两种解法，讲清什么时候用哪个 |\n\n> 跟进动作里若需要一道验证用的同类题/纯净版题，**生成前按 `shared/ai-item-check.md` 自检**（有解且唯一、条件充分、数值友好、学段内、与原错题同维度同子类型），输出时标注【AI 生成，入库前请人工验算】；老师未验算的题不写入资源库、不发给学员。\n\n---\n\n## 七、反复出错的跟踪与顽固弱项确认\n\n### 7.1 阈值口径\n\n顽固弱项的计数口径**不在本 SKILL 定义**，一律按 `shared/vocab.md §5`：\n- 粒度：同一知识点标签 + 同一通用维度（`dimension`）。\n- 时间窗：滚动 28 天。\n- 累计（不要求连续），同一天同一知识点多次错只计 1 次。\n- 独立教师工作区由本 SKILL 计数（学生端由错题本计数；学校班级工作区的顽固计数由学情分析师累加，见 `shared/vocab.md §5`；各算各的，不互相覆盖）。\n- 高危：同口径 28 天内累计 5 次 → 建议与学员本人谈策略；是否告知家长依 `shared/vocab.md §8` 授权。\n- 攻克标准：连续 2 次独立验证做对、间隔 ≥ 3 天、至少 1 次为换题型/纯净版验证。\n\n弱项状态五档（`待处理 / 初步弱项 / 顽固弱项 / 突破中 / 已攻克`）的进出条件见 `shared/vocab.md §4`，本 SKILL 直接引用。\n\n### 7.2 命中阈值后的动作：先存证据，再等老师确认\n\n阈值命中**不直接写 `studentCards[].primaryWeaknesses`**。顺序是：\n\n```text\n① 命中 vocab §5 阈值\n      ↓\n② 写入 workspace.progressEvidence[]：\n     evidenceType = \"作业\"\n     description  = \"[知识点] 在 28 天内第 3 次出现 [dimension]，\n                     日期 [d1] [d2] [d3]\"\n     confidenceLevel = data_sufficient（≥3 次独立观察）\n      ↓\n③ 向老师提一次确认（一轮，不重复追问）：\n     「小A 的『一元一次方程移项』28 天内第 3 次记到概念模糊\n       （6-1 / 6-8 / 6-15）。要把它加进 小A 的重点弱项吗？\n        加 / 不加 / 再看一次」\n      ↓\n④ 老师说\"加\" → 才写入 studentCards[].primaryWeaknesses（上限 5 条）\n   老师说\"不加\"或没回 → 证据留在 progressEvidence，弱项不写\n```\n\n老师不确认就不写，是因为 `primaryWeaknesses` 会被家长沟通和阶段报告读到，误标的成本比漏标高。\n\n### 7.3 顽固弱项档案\n\n> 📎 完整模板见 `references/persistent-weakness-file-template.md`（顽固弱项档案填写模板：知识点、通用维度、跟进动作、弱项状态）\n\n### 7.4 与学情分析类 SKILL 的衔接\n\n若老师同时安装了教师通用包，可把 `mainErrors[]` 的聚合结果口头带给 `xiaozhi-teach-student-analyzer` 做进一步分析；未安装时本 SKILL 的错因分布已可直接用于备下一节课。两种情况下，写回学员卡的动作都只发生在本 SKILL 且需老师确认。\n\n---\n\n## 八、下节课预诊断\n\n### 8.1 预诊断三步走\n\n```text\n第 1 步：错题聚合\n  · 按 dimension + knowledgePoint 归拢本次作业的错题\n  · 小班场景再区分：多名学员共同错的 vs 只有一人错的\n\n第 2 步：教学决策\n  · 多人共同错：下节课必须讲\n  · 单人错：给这名学员单独的任务\n  · 已达 vocab §5 阈值的：需要专项突破\n\n第 3 步：衔接下一节课\n  · 把错因分析整理成下节课重点\n  · 老师带进备课；本 SKILL 不写教案\n```\n\n### 8.2 预诊断输出\n\n> 📎 完整模板见 `references/pre-diagnosis-output-template.md`（下节课预诊断输出填写模板：必须讲/选讲/个体关注/教案调整建议）\n\n### 8.3 结论落在哪\n\n预诊断本身是**生成的报告段落**，不是存储字段。落库的只有两处：\n- 错因明细 → `workspace.homeworkFollowups[].mainErrors[]`\n- 下节课要盯的动作 → `workspace.homeworkFollowups[].nextAction`\n\n老师在 `xiaozhi-teach-lesson-log` 记录下节课时，可以把这段结论写进 `lessonLogs[].nextLessonFocus`，由那个 SKILL 负责落库。\n\n---\n\n## 九、学员作业画像\n\n### 9.1 单学员画像\n\n> 📎 完整模板见 `references/student-homework-profile-template.md`（单学员作业画像填写模板：完成度趋势、错因分布、反复出错清单、订正率）\n\n### 9.2 画像的数据边界\n\n```text\n  · 画像由 workspace.homeworkFollowups[] 实时聚合，不单独落库\n  · 作业不消耗课时，本 SKILL 不碰 coursePackageLedger\n  · 画像可由 solo-dashboard 只读展示；本 SKILL 不向它推送\n```\n\n---\n\n## 十、需要跟进的学员标记\n\n标记只用于提醒老师，不写入学员卡，也不作为对学员的评价。\n\n```text\n■ 课上练习没补上（看 overdueDays，不看 status）\n  · 中度：近 4 周（按 dueDate）有 2 条 overdueDays ≥ 1\n  · 高度：近 4 周（按 dueDate）有 3 条 overdueDays ≥ 1，或近 4 周内单条 overdueDays ≥ 7\n\n■ 反复出错跟进\n  · 按 shared/vocab.md §5 命中顽固阈值的知识点数 ≥ 3 个\n\n■ 应对\n  · 中度：课上问学员一句卡在哪，看是难度还是时间问题；相应调整课上练习\n  · 高度：先自查课上练习的难度与量、讲解的节奏；要跟家长说课上情况时再沟通，\n          不催交（发家长内容前查 consent.parentCommunicationAllowed）\n\n■ 不做的事\n  · 不按\"错题率 %\"给学员分级——单次作业题量小，比例不稳定\n  · 不把标记本身告诉学员或家长（\"你被标成高风险了\"）\n```\n\n---\n\n## 十一、接口\n\n### 11.1 数据流\n\n本 SKILL 自成闭环：老师在这里登记课上练习与学员带来的学校作业、考试错题，在这里记错因、在这里确认弱项。不需要任何 SKILL 先跑一遍，也不向任何 SKILL 推送。\n\n```text\n  老师口述 ──→ ┌──────────────────────┐ ──→ 老师带走一份\"下节课讲什么\"\n              │ homework-tracker      │\n              │ （本 SKILL）           │\n              └──────────┬───────────┘\n                         │ 只写这三处\n       ┌─────────────────┼─────────────────┐\n       ↓                 ↓                 ↓\n homeworkFollowups  progressEvidence   studentCards\n （状态/错因/动作）  （阈值证据）      （确认后的弱项）\n```\n\n### 11.2 读写字段\n\n均为 `solo-teacher-workspace.schema.json` 的真实字段。\n\n```text\n读：\n  workspace.homeworkFollowups[].task / .dueDate / .status / .overdueDays\n      → 本 SKILL 自己登记的课上练习与学校作业条目（历次）\n  workspace.homeworkFollowups[].mainErrors[].knowledgePoint / .dimension\n      → 历次错因，用于 vocab §5 计数\n  workspace.studentCards[].primaryWeaknesses / .goals / .gradeLevel / .gradeBand\n      → 学员基线（已确认弱项、目标、年级、学段）\n  workspace.studentCards[].status\n      → 为\"暂停记录\"或\"已结课\"时，不再写入任何新条目\n  workspace.lessonLogs[].nextLessonFocus / .date\n      → 上次课设定的重点，用于对照作业表现\n\n写：\n  workspace.homeworkFollowups[].task / .dueDate\n      → 老师登记的内容（task 开头写类别与日期，28 天计数按这个日期算）；课上练习的 dueDate 是约定做完的那节课，学校作业、考试错题不填\n  workspace.homeworkFollowups[].status\n      → 七档枚举之一（已布置/已提交/部分提交/未交/已批改/已订正/已减免）\n  workspace.homeworkFollowups[].overdueDays\n      → 逾期天数：从 dueDate 算到做完那天（已提交、已批改、已订正），做完后不再增加；还没做完的算到当前日期；已减免的记 0（无 dueDate 时不写）\n  workspace.homeworkFollowups[].mainErrors[]\n      → 每条 {knowledgePoint, dimension, teacherCategory?}，dimension 必填\n  workspace.homeworkFollowups[].nextAction\n      → 跟进动作；自由描述放这里，不塞进 mainErrors\n  workspace.progressEvidence[].evidenceType / .description / .date / .confidenceLevel\n      → 阈值命中证据、订正证据、攻克证据\n  workspace.studentCards[].primaryWeaknesses\n      → 仅在老师逐条确认后追加（§7.2），上限 5 条\n\n派生视图（实时计算，不落库）：\n  完成度        ← 由 workspace.homeworkFollowups[].status 聚合（只算课上练习）\n  错因分布      ← 由 workspace.homeworkFollowups[].mainErrors[].dimension 聚合\n  顽固计数      ← 由 mainErrors 跨条目按 shared/vocab.md §5 比对\n  需跟进标记    ← 由 workspace.homeworkFollowups[].overdueDays 统计\n\n生成的报告段落（非存储字段）：\n  下节课预诊断  ← 事实来源为 workspace.homeworkFollowups[].mainErrors；\n                  老师若要留档，由 lesson-log 写入 lessonLogs[].nextLessonFocus\n```\n\n### 11.3 谁来读这些字段\n\n其他 SKILL 直接读工作空间字段即可，不经由本 SKILL：`xiaozhi-teach-solo-dashboard` 读 `overdueDays` 提示课上练习没补上的学员，`xiaozhi-teach-renewal-report` 读 `mainErrors`、`progressEvidence` 与 `task` / `status` / `overdueDays`（按 task 开头的类别只算课上练习）做阶段报告，`xiaozhi-teach-parent-communication` 读 `task`、`status` 与 `nextAction` 起草家长反馈（两类按 task 开头的类别分开说；只说课上情况与错因，不催交；发送前查 `consent.parentCommunicationAllowed`）。\n\n---\n\n## 十二、字段级高敏信息防护\n\n```text\n✅ 追踪中可使用：化名、作业完成度、错因维度、知识点、提交时间\n❌ 禁止：作业具体答案、家庭辅导情况、家长监督方式\n✅ 写入数据：聚合错因、完成度\n❌ 不写入：学员真实身份（一律用 alias）\n\n✅ 错题回流：只存 knowledgePoint + dimension\n❌ 禁止：错题原文、学员答题原文\n```\n\n---\n\n## 十三、行为准则\n\n| ✅ 应该做 | ❌ 不能做 |\n|---------|---------|\n| 只登记课上练习与学员带来的学校作业、考试错题 | 登记回家做的作业、追未交、起草催交话术 |\n| 错因归到 vocab 四维，可跟进 | 写\"不认真\"\"老是错\"当错因 |\n| 阈值命中先存证据、请老师确认 | 越过老师直接改学员卡弱项 |\n| 逾期看 overdueDays | 造一个 status=overdue |\n| 分情况跟进（真不会/时间不够），都在课上解决 | 一律加量，或改成回家补 |\n| 预诊断基于真实错题 | 凭印象决定下节课重点 |\n| 一律用 alias | 记录里出现真实姓名 |\n\n---\n\n## 十四、与其他 SKILL 的协同清单\n\n```text\n作业跟进管家（自成闭环，不需要前置 SKILL）\n    读 workspace.studentCards[]      ← student-intake 建卡\n    读 workspace.lessonLogs[]        ← lesson-log 写课后重点\n    写 workspace.homeworkFollowups[] ← 本 SKILL 唯一写入方\n    写 workspace.progressEvidence[]  ← 与 renewal-report 共用\n    写 workspace.studentCards[].primaryWeaknesses ← 老师确认后\n\n  其他 SKILL 需要作业数据时，直接读上述字段，不经过本 SKILL。\n  若装有教师通用包，可把错因分布带给 student-analyzer / exam-designer\n  做进一步分析或出课上练习的题；未安装时本 SKILL 的输出已可直接用。\n```\n\n**禁止行为**：\n- 禁止登记布置给学员回家做的作业；禁止追未交、起草或代发催交消息（无论发给学员还是家长）\n- 禁止在记录中出现学员真实姓名\n- 禁止存储作业错题原文或学员答题原文（只存 knowledgePoint + dimension）\n- 禁止对所有学员用同一种跟进方式\n- 禁止未经老师确认就写 `studentCards[].primaryWeaknesses`\n- 禁止在 `status` 里造枚举外的值\n\n---\n\n### 隐私与数据控制入口\n- 查看：「查看我的[作业记录]」\n- 更正：「更正我的[作业记录]」\n- 删除：「删除我的[作业记录]」——据此写进学员卡的弱项条目与阶段证据一并列出，老师确认后同删；删除后不可恢复\n- 暂停：「这次不要记忆」（本次会话不读取、不保存任何记录，也不发起回写与交接）/「暂停提醒」\n- 共享控制：「不要共享给其他SKILL」/「不要给家长看」\n- 导出：「导出我的[作业记录]」（以文本形式给出，便于转存）\n\n学员/家长提出时同样适用（由老师核实请求人身份后代为执行），按学员化名定位：「查看 小A 的作业记录」「删除 小A 的全部作业记录」。\n\n**校验要求**：跨 SKILL 共享或建档前，须确认 `consent.crossSkillSharing` / `consent.profileEnabled` 为 true；学员卡 `status` 为\"暂停记录\"时不再写入新条目。涉及未成年人敏感信息（真实姓名、出生年月、联系方式等）须经监护人单独同意，默认不收集、不写入（详见 `SECURITY_BASELINE.md`）。\n\n---\n\n## 十五、参考资源\n\n- `references/completion-tracking-views.md` — 单学员/学员列表完成度视图模板\n- `references/error-reflow-checklist-template.md` — 错题回流清单模板\n- `references/persistent-weakness-file-template.md` — 顽固弱项档案模板\n- `references/pre-diagnosis-output-template.md` — 下节课预诊断输出模板\n- `references/student-homework-profile-template.md` — 学员作业画像模板\n- `shared/vocab.md` — 错因四维、老师端七类映射、顽固阈值、弱项五档（唯一来源）\n\n---\n\n> 💡 **小智说：**\n> \"作业是教学里最被低估的环节。\n>  大多数老师批完就忘，但如果你把每份作业\n>  看作下一节课的 X 光片，\n>  你会发现：\n>  同一道题几个人都错，是教学没讲到；\n>  一个学员总错一个点，是认知有漏洞；\n>  一个学员课上突然做不完，是状态有了变化。\n>  作业是教学最敏感的传感器。\"\n\nFile v2.11.1:_meta.json\n\n{\n  \"ownerId\": \"kn79c5gcmfkt9p1pk656tgq7nd853s7v\",\n  \"slug\": \"xiaozhi-teach-homework-tracker\",\n  \"version\": \"2.11.1\",\n  \"publishedAt\": 1791477071241\n}\n\nFile v2.11.1:references/completion-tracking-views.md\n\n# 作业完成度追踪视图模板\r\n\r\n> 适用学段：小学中段 / 小学高段 / 初中 / 高中\r\n> 配合 `xiaozhi-teach-homework-tracker` §五使用。独立教师带一对一或小班，没有\"班级\"，因此第二张表是**学员列表视图**而不是班级花名册。\r\n> 状态只用 schema 七档枚举：已布置 / 已提交 / 部分提交 / 未交 / 已批改 / 已订正 / 已减免。逾期与否看 `overdueDays`，不新造 `overdue` 状态。\r\n> 只登记课上练习与学员带来的学校作业、考试错题（`task` 开头写类别与日期），不登记回家做的作业；完成度只算课上练习，学校作业、考试错题从 `已批改` 或 `已订正` 起记，不算完成度、不算逾期。\r\n\r\n## 一、单学员作业完成度视图\r\n\r\n```text\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n📊 作业完成度 · [化名] · [周次]\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n■ 本周课上练习（dueDate = 约定做完的那节课）\r\n  · 练习 1（[日期] 课上）：□已布置 □已提交 □部分提交 □未交 □已批改 □已订正 □已减免\r\n      逾期：[overdueDays] 天（0 表示在约定的那节课做完了、还没到约定那节课，或已减免）\r\n  · 练习 2（[日期] 课上）：□已布置 □已提交 □部分提交 □未交 □已批改 □已订正 □已减免\r\n      逾期：[overdueDays] 天\r\n  · 练习 3（[日期] 课上）：□已布置 □已提交 □部分提交 □未交 □已批改 □已订正 □已减免\r\n      逾期：[overdueDays] 天\r\n\r\n■ 学员带来的学校作业、考试错题（学员自愿带来，不追交、不催交）\r\n  · [学校作业 / 考试错题]（[日期] 带来）：□已批改 □已订正 · 记错题 [N] 条\r\n\r\n■ 课上练习完成情况（按条数，不按题数；学校作业、考试错题不算）\r\n  · 课上做完（已提交，含已批改/已订正）：[N] / 总 [N]\r\n  · 课上没做完（部分提交）：[N] / 总 [N]\r\n  · 下节课也没补上（未交）：[N] / 总 [N]\r\n  · 已减免：[N]（不计入未交）\r\n\r\n■ 与上周对比\r\n  · 上周：[N] / [N] 条按约定做完\r\n  · 本周：[N] / [N] 条按约定做完\r\n  · 趋势：[好转 / 持平 / 下降]\r\n  · 说明：单周条数少时不下\"趋势\"结论，标 🔴 样本不足\r\n\r\n■ 错因统计（按 shared/vocab.md §1 四维；课上练习与学校作业、考试错题一起算）\r\n  · 本周新记错题：[N] 条\r\n  · 概念模糊 [N] · 计算失误 [N] · 读题失误 [N] · 方法用错 [N]\r\n  · 已达 vocab §5 阈值待老师确认：[N] 个知识点\r\n  · 已订正：[N] / [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  │ 小A     │ 已批改    │ 0        │ 订正第 3 题 │\r\n  │ 小B     │ 部分提交  │ 0        │ 下节课补完  │\r\n  │ 小C     │ 未交      │ 2        │ 查卡在哪    │\r\n  │ 小D     │ 已减免    │ —        │ —          │\r\n  │ 小E     │ 已订正    │ —        │ 学校作业    │\r\n  └────────┴──────────┴──────────┴────────────┘\r\n  （小E 那条是学员带来的学校作业，从已批改起记，不算完成度、不追交）\r\n\r\n■ 需要跟进的学员（判据见 SKILL §十）\r\n  · 小C：近 4 周 3 条 overdueDays ≥ 1 → 高度，先自查课上练习的量与难度\r\n  · 小B：近 4 周 2 条 overdueDays ≥ 1 → 中度，课上问一句卡在哪\r\n\r\n■ 多名学员共同错的题（仅小班场景）\r\n  · [知识点]：[N] 人错，主要维度 [概念模糊 / 计算失误 / 读题失误 / 方法用错]\r\n  · 处理：下节课当共性内容讲；只有 1 人错的放个体任务\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n```\r\n\r\n## 三、填写注意\r\n\r\n- 化名一律用 `studentCards[].alias`，任何视图里不出现真实姓名。\r\n- \"完成度\"只统计课上练习的条数（学校作业、考试错题不算），不换算成对学员的评价用语；学员带来多少学校作业也不用来评价学员。\r\n- 学员卡 `status` 为\"暂停记录\"或\"已结课\"时，不再新增行。\r\n- 统计跨周数据依赖平台的跨会话统计能力；没有该能力时只列本次会话已知的几条，并说明\"这不是完整历史\"。\n\nFile v2.11.1:references/error-reflow-checklist-template.md\n\n# 错题回流清单模板\r\n\r\n> 适用学段：小学中段 / 小学高段 / 初中 / 高中\r\n> 配合 `xiaozhi-teach-homework-tracker` §6.2 使用。\r\n> 错因一律按 `shared/vocab.md` §1（通用四维）与 §3（老师端七类 ↔ 四维映射）填写；`dimension` 必填，不写自由文本错因。\r\n\r\n```text\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n📋 错题回流清单 · [日期] 课上练习 / 带来的学校作业\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n■ 多名学员共同错的题（仅小班场景；一对一跳过本节）\r\n  ① 知识点 [X] · dimension [概念模糊/计算失误/读题失误/方法用错]\r\n     · [N] 人错 · teacherCategory（选填）[知识漏洞/规则错误/…]\r\n  ② 知识点 [X] · dimension [   ] · [N] 人错\r\n\r\n■ 个体错题（逐学员）\r\n  小A：\r\n    · 知识点 [X] · dimension [   ] · teacherCategory [   ]\r\n    · 知识点 [X] · dimension [   ]\r\n  小B：\r\n    · 知识点 [X] · dimension [   ]\r\n\r\n■ 反复出现的知识点（按 shared/vocab.md §5 口径）\r\n  口径：同一 knowledgePoint + 同一 dimension，滚动 28 天累计，\r\n        同一天多次只计 1 次\r\n  · 小A · [知识点] · 概念模糊 · 28 天内第 3 次（[d1] [d2] [d3]）\r\n        → 写 progressEvidence，等老师确认后才进 primaryWeaknesses\r\n  · 小D · [知识点] · 计算失误 · 28 天内第 5 次\r\n        → 高危：建议与学员本人谈策略；告知家长依 shared/vocab.md §8 授权\r\n\r\n■ 这些数据去哪\r\n  · 落库：workspace.homeworkFollowups[].mainErrors[]（本 SKILL 写）\r\n  · 阈值证据：workspace.progressEvidence[]（本 SKILL 写）\r\n  · 学员卡弱项：workspace.studentCards[].primaryWeaknesses（老师确认后才写）\r\n  · 下节课重点：老师带进备课；要留档时由 lesson-log 写 nextLessonFocus\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n```\r\n\r\n## 填写注意\r\n\r\n- 一道错题只记一个 `dimension`。判定顺序：复述条件（读题失误）→ 纯净版（概念模糊）→ 换题型（方法用错）→ 剩下归计算失误。\r\n- 不写\"不认真\"\"马虎\"\"态度问题\"——按 `shared/vocab.md §3`，抄错题归读题失误，算错归计算失误。\r\n- 只存 `knowledgePoint` 和 `dimension`，**不存错题原文、不存学员答题原文**。\r\n- 一对一场景下没有\"共性错题\"，直接用个体错题一节。\n\nFile v2.11.1:references/persistent-weakness-file-template.md\n\n# 顽固弱项档案模板\r\n\r\n> 适用学段：小学中段 / 小学高段 / 初中 / 高中\r\n> 配合 `xiaozhi-teach-homework-tracker` §7.3 使用。\r\n> 弱项状态五档与进出条件见 `shared/vocab.md §4`；计数口径见 `shared/vocab.md §5`。本文件只提供填写格式，不另定阈值。\r\n\r\n```text\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n🔴 顽固弱项档案 · [化名]\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n■ 弱项 ①\r\n  知识点（knowledgePoint）：[            ]\r\n  通用维度（dimension）：□概念模糊 □计算失误 □读题失误 □方法用错\r\n  老师端七类（teacherCategory，选填）：[            ]\r\n  计数：28 天内 [N] 次（[d1] [d2] [d3]）\r\n  首次出现：[日期] · 最近一次：[日期]\r\n  弱项状态（shared/vocab.md §4）：\r\n    □待处理 □初步弱项 □顽固弱项 □突破中 □已攻克\r\n  置信度（shared/vocab.md §7）：□🟢 数据充分 □🟡 初步趋势 □🔴 样本不足\r\n  是否已写入学员卡：□老师已确认，已写入 primaryWeaknesses\r\n                    □仅在 progressEvidence，等老师确认\r\n  跟进动作：\r\n    · 第 [N] 次课：回到定义 / 纯净版最简题\r\n    · 第 [N] 次课：换题型验证\r\n    · 第 [N] 次课：独立验证（间隔 ≥ 3 天）\r\n\r\n■ 弱项 ②\r\n  （同上格式）\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n```\r\n\r\n## 状态怎么变（引用 shared/vocab.md §4）\r\n\r\n```text\r\n待处理 ──首次记录────────────────────────→\r\n初步弱项 ──28 天内同知识点同维度第 2 次───→\r\n顽固弱项 ──28 天内第 3 次──────────────→\r\n突破中   ──顽固后首次独立验证做对────────→\r\n已攻克   ──再一次独立验证做对，间隔 ≥ 3 天，\r\n           且至少 1 次为换题型/纯净版验证──→\r\n已攻克后 30 天内再错 → 退回突破中\r\n```\r\n\r\n## 填写注意\r\n\r\n- **攻克标准不是\"连对 3 次\"**：是连续 2 次独立验证做对、间隔 ≥ 3 天、至少 1 次换题型或纯净版（`shared/vocab.md §5`）。\r\n- 28 天内累计 5 次属高危：建议与学员本人谈学习策略；是否告知家长依 `shared/vocab.md §8` 的授权位判断，不默认告知。\r\n- 写入 `studentCards[].primaryWeaknesses` 上限 5 条，且必须老师逐条确认；未确认的留在 `progressEvidence` 里。\r\n- 档案只写知识点和维度，不写错题原文，不写对学员的性格评价。\n\nFile v2.11.1:references/pre-diagnosis-output-template.md\n\n# 下节课预诊断输出模板\r\n\r\n> 适用学段：小学中段 / 小学高段 / 初中 / 高中\r\n> 配合 `xiaozhi-teach-homework-tracker` §8.2 使用。\r\n> 预诊断是**生成的报告段落**，不是工作空间存储字段；事实来源为 `workspace.homeworkFollowups[].mainErrors[]`。老师要留档时，由 `xiaozhi-teach-lesson-log` 写入 `lessonLogs[].nextLessonFocus`。\r\n\r\n```text\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n🔍 下节课预诊断 · 基于 [日期] 课上练习 / 带来的学校作业 · [化名]\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n■ 必须讲\r\n  · [知识点]：dimension [概念模糊/计算失误/读题失误/方法用错]\r\n      判据：本次错 [N] 题；28 天内第 [N] 次\r\n      讲什么：[针对该维度的具体切入点]\r\n  · [知识点]：dimension [   ]\r\n      判据：[   ]\r\n      讲什么：[   ]\r\n\r\n■ 可以带过\r\n  · [知识点]：只错 1 题且此前无记录 → 口头点一句，不占时间\r\n\r\n■ 需要专项处理\r\n  · [知识点]：已达 shared/vocab.md §5 阈值\r\n      → 先回到定义/纯净版，再换题型验证，两次验证间隔 ≥ 3 天\r\n\r\n■ 小班场景补充（一对一跳过）\r\n  · 多人共同错：[知识点]（[N] 人）→ 统一讲\r\n  · 单人错：[化名] [知识点] → 单独任务，不占公共时间\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  · 新内容：[N] 分钟\r\n  注：以上按老师实际课时长度分配，不写死总时长\r\n\r\n■ 交给谁\r\n  · 老师带进下一节课；本 SKILL 不写教案\r\n  · 要留档 → xiaozhi-teach-lesson-log 写 lessonLogs[].nextLessonFocus\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n```\r\n\r\n## 填写注意\r\n\r\n- 每条\"必须讲\"都要有判据（错了几题、28 天内第几次），没有判据的不写进必须讲。\r\n- 不写\"这孩子基础差\"这类整体评价，只写知识点和维度。\r\n- 用于验证的同类题若由 AI 生成，先按 `shared/ai-item-check.md` 自检，并标注【AI 生成，入库前请人工验算】。\n\nFile v2.11.1:references/student-homework-profile-template.md\n\n# 学员作业画像模板\r\n\r\n> 适用学段：小学中段 / 小学高段 / 初中 / 高中\r\n> 配合 `xiaozhi-teach-homework-tracker` §9.1 使用。画像是**实时聚合的派生视图**，不落库。\r\n> 错因分布只用 `shared/vocab.md §1` 的通用四维，不用老师端七类做统计口径（七类可在单条错题上标注，聚合时先映射回四维）。\r\n\r\n```text\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n📈 学员作业画像 · [化名]\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n■ 课上练习完成趋势（按条数，只算课上练习）\r\n  第 1-5 次课：按约定做完 [N] / [N] 条\r\n  第 6-10 次课：按约定做完 [N] / [N] 条\r\n  第 11 次课以后：按约定做完 [N] / [N] 条\r\n  趋势：[好转 / 持平 / 下降]\r\n  置信度（shared/vocab.md §7）：□🟢 数据充分 □🟡 初步趋势 □🔴 样本不足\r\n  说明：总条数少于 6 条时一律标 🔴，不下趋势结论\r\n\r\n■ 错因分布（shared/vocab.md §1 四维）\r\n  概念模糊 [N] 条\r\n  计算失误 [N] 条\r\n  读题失误 [N] 条\r\n  方法用错 [N] 条\r\n  主导维度：[   ]（占比最高且领先第二名 ≥ 2 条时才写\"主导\"）\r\n\r\n■ 反复出现的知识点（shared/vocab.md §5 口径）\r\n  · [知识点] · [维度] · 28 天内 [N] 次 · 弱项状态 [五档之一]\r\n  · [知识点] · [维度] · 28 天内 [N] 次 · 弱项状态 [五档之一]\r\n\r\n■ 订正情况\r\n  · 已订正 [N] / 已批改后有错题的作业 [N] 条\r\n  · 订正后再验证做对的：[N] 条\r\n\r\n■ 学员带来的学校作业、考试错题\r\n  · 带来 [N] 份，记错题 [N] 条（带不带来由学员自己定，份数不用来评价学员）\r\n\r\n■ 课上练习没补上的情况\r\n  · 近 4 周 overdueDays ≥ 1 的条目：[N] 条\r\n  · 最长一次逾期：[N] 天\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n```\r\n\r\n## 填写注意\r\n\r\n- 画像给老师看，也可能被老师念给家长听——念之前先查 `consent.parentCommunicationAllowed`；内容里只留事实，不留判断。\r\n- 不写\"错题率 [N]%\"式的比例：单次作业题量小，比例不稳定，容易误导。\r\n- 跨周统计依赖平台的跨会话统计能力；缺该能力时只列已知条目并说明不完整，不口算历史数字。\r\n- 画像不写入任何字段；要留档的结论走 `progressEvidence`。\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\nArchive v2.11.0: 17 files, 59381 bytes\n\nFiles: references/completion-tracking-views.md (5216b), references/error-reflow-checklist-template.md (2526b), references/persistent-weakness-file-template.md (2693b), references/pre-diagnosis-output-template.md (2417b), references/student-homework-profile-template.md (2476b), 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 (8805b), shared/vocab.md (14668b), skill-card.md (2576b), SKILL.md (32474b), _meta.json (150b)\n\nFile v2.11.0:SKILL.md\n\n---\nname: xiaozhi-teach-homework-tracker\ndescription: '帮独立教师跟进课上练习与学员带来的学校作业、考试错题：登记、追状态、归错因、导出下节课讲什么。适用于老师说\"登记今天课上的练习\"\"[化名] 课上那份练习做完了吗\"\"[化名] 带来了学校作业，帮我归一下错因\"\"考试错题帮我归类\"\"错题回流\"\"下节课该讲什么\"\"这道题他错第三次了\"\"看下 [化名] 的作业画像\"。流程：老师口述课上练习或学校作业 → 追七档状态 → 按 shared/vocab.md §1/§3 归错因 → 阈值命中先存证据待老师确认。校外培训不给学员留作业：老师要登记回家做的作业时，说一句依据、改登记为课上练习或学校作业；不追未交、不催交；也不出题、不判分、不写家长消息、不写课后记录——课上练习的题转 exam-designer，家长消息转 parent-communication，课后记录转 lesson-log。'\ncompatibility: WorkBuddy / SkillHub / OpenClaw / ClawHub\nlicense: MIT\ndisplay_name: 作业跟进管家\nversion: 2.11.0\nauthor: 小智伴学\ncategory: 独立教师\ngrade_bands:\n  - 小学中段\n  - 小学高段\n  - 初中\n  - 高中\ntags: [作业跟进, 错题回流, 状态追踪, 预诊断, 独立教师]\ndepends_on:\n  - xiaozhi-teach-lesson-log\nid: openclaw:xiaozhi-teach-homework-tracker\nmin_platform_version: \"2.0\"\nmax_round_limit: 12\nslug: xiaozhi-teach-homework-tracker\ndisplayName: 作业跟进管家\nsummary: '帮独立教师跟进课上练习与学员带来的学校作业、考试错题：登记、追状态、归错因、导出下节课讲什么。'\n---\n\n# 作业跟进管家 SKILL\n\n> **一句话定位：** 作业不是任务清单，而是下一节课的诊断 X 光——跟进它，不是为了完成它，而是为了发现下一节课该讲什么。\n\n---\n\n## 技术边界\n\n> 技术边界：本 SKILL 依赖能力 [M, X, K]，无该能力时按 shared/platform-conventions.md 降级。\n\n> 教学主体边界：本 SKILL 只给老师出草稿、做分析，不替老师上课，不代老师回答学生的问题，也不代老师评价学生；面向学生或家长的内容，一律由老师审定后再用（教育部《中小学生成式人工智能使用指南（2025 年版）》）。\n\n> 适用范围：用于校外培训（一对一、小班）时，只在合法范围内用，口径见 `shared/off-campus-training.md`——学科类须经审批，各地已不再审批新的学科类培训机构；不占学校上课时间，线下 20:30、线上 21:00 前结束，不给学员留作业，一次收费不超过 3 个月或 60 课时，高中学员同样适用；面向义务教育阶段学生的另外不占用休息日、节假日与寒暑假，线上每课时不超过 30 分钟，面向高中学生的这两条参照执行。本技能不预设违规的排课、作业与收费。本技能只跟进课上练习与学员带来的学校作业、考试错题，不登记回家做的作业。\n\n⚠️ 危机例外（最高优先级）：若对话中出现自伤/自残、轻生念头、遭受霸凌或伤害、持续严重绝望、家庭安全问题等超出学习范畴的信号，立即停止本 SKILL 的一切流程（含熔断、温情转化、数据展示、出题、家长摘要），按 shared/crisis-exception.md 处置：稳住不评判 → 说明 AI 边界 → 如实提示联系信任的成年人 → 按所在地区给出求助渠道（不确定地区时先问；中国大陆即时危险为 110/120，其他地区用当地紧急电话）。宁可误报，不可漏报；档案只记\"已转介\"的处置事实。\n\n只追踪低敏信息（完成度、错因维度、知识点、提交时间）；不收集作业原文、答案、家庭辅导情况。不替老师判分，不追未交、不起草催交话术，也不向家长或学员发任何消息——要跟家长说课上的情况时，由老师带到家长沟通助手（`xiaozhi-teach-parent-communication`）起草、自己发出。无 `X` 时不给\"累计错 N 次\"的精确统计，改为把已知的几次列出来请老师自己数。\n\n---\n\n## 一、核心使命\n\n独立教师作业跟进常见的三个误区：\n\n```text\n误区① 做了就忘：课上练习做完没有记录，学员带来的学校作业、\n        考试错题看一眼就还回去，错因、顽固弱项全凭印象。\n\n误区② 批完归档：练习批改完就放在一边，\n        错题没有回流到下一节课教案，\n        学生错过的题目反复错。\n\n误区③ 一刀切加量：课上练习没做完，不分是\"真的不会\"还是\n        \"时间不够\"，一律加题，或者改成回家补。\n```\n\n本 SKILL 要解决的是：\n- **让每份课上练习、每份带来的学校作业都有记录**：登记 → 课上做完 → 批改 → 错因 → 下节课（学校作业、考试错题从批改那一步记起）\n- **让错因落到可跟进的维度上**：按 `shared/vocab.md §1/§3` 归维，不写\"不认真\"\n- **让跟进分情况**：课上没做完，是真不会还是时间不够，两种处理不一样；都在课上解决，不改成回家作业\n- **让判定留在老师手里**：阈值命中先给证据，老师确认才改学员卡\n\n---\n\n## 二、触发时机\n\n| 触发场景 | 示例语句 |\n|---------|---------|\n| 课上练习 | \"登记今天课上的练习\" / \"[化名] 课上那份练习做完了吗\" |\n| 学校作业、考试错题 | \"[化名] 带来了学校的数学作业，帮我归一下错因\" / \"期中考试的错题帮我归类\" |\n| 完成度 | \"课上练习的完成情况\" / \"哪些学员课上练习没做完\" |\n| 错题回流 | \"错题回流\" / \"错题怎么进入下节课\" |\n| 下节课预诊断 | \"下节课讲什么\" / \"作业反映什么问题\" |\n| 课上没做完 | \"[化名] 课上练习总是做不完怎么办\" |\n| 顽固弱项 | \"[化名] 这道题错 3 次了\" |\n| 作业画像 | \"看一下 [化名] 的作业画像\" |\n\n老师要登记\"回家做的作业\"时，不拒绝、不说教，按 §三 第 ① 步改登记为课上练习或学员带来的学校作业。\n\n---\n\n## 三、核心流程\n\n```text\n                ┌──────────────────────────┐\n                │ ① 老师在本 SKILL 内登记   │\n                │  课上练习 / 学校作业错题  │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ② 状态追踪（七档枚举）    │\n                │  逾期看 overdueDays       │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ③ 老师判分后登记错题      │\n                │  本 SKILL 不判分          │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ④ 错因归维（vocab §1/§3） │\n                │  写 mainErrors[]          │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ⑤ 阈值命中（vocab §5）    │\n                │  先写 progressEvidence    │\n                │  老师确认后才进弱项       │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ⑥ 下节课预诊断            │\n                │  交给老师带进下一节课     │\n                └──────────────────────────┘\n```\n\n**第 ① 步由老师在本 SKILL 内完成**：登记两类东西——**课上练习**（老师在课上布置、学员在课上做的练习）与**学员带来的学校作业、考试错题**（学员自愿带来、请老师帮着分析的；老师不布置、不追交、不催交）。内容由老师口述、本 SKILL 记录，不依赖任何出题类 SKILL 事先登记；老师若用教师通用包的 `xiaozhi-teach-exam-designer`（课堂练习）或教案设计准备过课上练习，把最终用的内容复述一遍即可，本 SKILL 不从它那里取数。`task` 开头写明类别与日期（\"课上练习（[月-日]）：\"\"学校作业（[月-日] 带来）：\"\"考试错题（[月-日] 带来）：\"），`shared/vocab.md §5` 的 28 天计数一律按这个日期算（课上练习是做这份练习的那节课，不按 dueDate）；完成度只算课上练习。\n\n```text\n登记话术（一轮内完成；按 shared/platform-conventions.md 先生成待确认条目，老师确认后写入）：\n  课上练习：\n  「这节课给谁做的、做了什么、课上做完了没有？」\n  → 老师：\"小A，函数图像练习册 P32 第 1-8 题，课上做了 6 题，剩下 2 题下节课补\"\n  → 写入：studentId=小A，task=\"课上练习（[月-日]）：函数图像练习册 P32 第1-8题\"，\n          dueDate=下节课日期，status=部分提交，nextAction=\"第7、8题下节课课上补\"\n  dueDate 填约定做完的那节课：课上做完的填当天；没做完、留到下节课课上补的，\n  填下节课那天（问老师一句）。过了那节课仍没做完，才记 status=未交。\n\n  学员带来的学校作业、考试错题：\n  「是哪份学校作业或哪次考试、错了哪几道？」\n  → 老师：\"小B 带来学校的数学作业，第 3、5、7 题错了\"\n  → 写入：studentId=小B，task=\"学校作业（[月-日] 带来）：数学 第3、5、7题\"，\n          status=已批改，不填 dueDate；错因按 §6.3 逐题写 mainErrors\n  task 里写上带来的日期，28 天计数按这一天算；考试错题只记知识点与维度，不记总分、名次；\n  这份作业交没交给学校，不登记、不过问。\n```\n\n**老师要登记\"回家做的作业\"时**（如\"登记今天给小A布置的家庭作业，周四交\"）：先说一句依据——校外培训不给学员留作业（国办发〔2018〕80 号），课前预习、课后巩固、微信群打卡也算布置作业（教基厅函〔2021〕11 号）；再给两种登记方式：把这份练习改到下节课课上做、登记为课上练习，或者学员有学校作业、考试错题想请老师看的，登记为学校作业。老师选一种就照常登记，不拒绝整件事、不说教、不重复解释，也不起草催交话术。\n\n---\n\n## 四、作业状态（对齐工作空间 schema）\n\n每份作业的 `status` 取值须为 `schema.homeworkFollowup.status` 枚举之一（已布置/已提交/部分提交/未交/已批改/已订正/已减免）：\n\n```text\n┌──────────┬────────────────────────────────┬──────────────────┬──────────┐\n│ 状态      │ 定义                            │ 触发动作          │ 时长限制  │\n├──────────┼────────────────────────────────┼──────────────────┼──────────┤\n│ 已布置    │ 课上布置、学员正在课上做        │ 课上做完收上来    │ —         │\n│ 已提交    │ 课上做完、收上来                │ 等待批改          │ 0-3 天    │\n│ 部分提交  │ 课上没做完                      │ 下节课课上补齐    │ 到下节课  │\n│ 未交      │ 课上没做完，下节课也没补上      │ 查原因、调整练习  │ 当天      │\n│ 已批改    │ 老师批改完；学校作业、考试错题  │ 错题回流          │ 1-7 天    │\n│           │ 从这一档或已订正起记            │                   │           │\n│ 已订正    │ 学员完成订正                    │ 错题归档到错题本  │ —         │\n│ 已减免    │ 这份课上练习老师决定不做了      │ 记录说明          │ —         │\n└──────────┴────────────────────────────────┴──────────────────┴──────────┘\n```\n\n> 说明：\n> - 七档用于两类记录：课上练习按课上的实际情况记（还在做、或约定下节课课上做还没开始的记 `已布置`，做完记 `已提交`，没做完记 `部分提交`）；学员带来的学校作业、考试错题从 `已批改` 或 `已订正` 起记，不填 `dueDate`，不算完成度、不算逾期。\n> - `未交` 只用于课上练习没做完、约定的下节课也没补上的情形，用来调整课上练习的量与难度，不作为催交的依据；本 SKILL 不登记回家做的作业，也就没有\"回家作业没交\"。\n> - \"错题归档到错题本\"是 `已订正` 后的下游动作，不是独立状态。\n> - 枚举里**没有** `overdue`、`补交`、`逾期` 这些值。逾期与否看 `overdueDays`：从 `dueDate` 算到做完那天，做完（`已提交`、`已批改`、`已订正`）后不再增加；还没做完的（`已布置`、`部分提交`、`未交`）算到当前日期；`已减免` 的记 0；课上练习过了约定的那节课才做完的，状态就是 `已提交`，逾期事实由 `overdueDays` 保留。\n> - 七档以外的说法（\"课上只做了一半\"\"下节课补完了两题\"）写进 `nextAction`，不新造状态。\n\n---\n\n## 五、完成度追踪\n\n### 5.1 单学员作业完成度视图\n\n> 📎 完整模板见 `references/completion-tracking-views.md`（单学员完成度视图填写模板：本周课上练习状态、带来的学校作业与考试错题、课上练习完成情况、与上周对比、错题统计）\n\n### 5.2 学员列表视图（跨学员横看）\n\n独立教师带的是一对一或小班，没有\"班级\"，所以这里是**学员列表**而不是班级花名册：按学员逐行列出本周课上练习与带来的学校作业的状态，不排名、不公示。\n\n> 📎 完整模板见 `references/completion-tracking-views.md`（学员列表视图填写模板：逐学员状态、待跟进学员）\n\n### 5.3 课上练习没做完、学校作业不方便带来时\n\n本 SKILL 不起草催交话术，也不替老师给学员或家长发消息；下面是老师在课上怎么处理。\n\n```text\n■ 课上练习没做完（status=部分提交）\n  · 先看原因：题量超出了这节课的时间，还是卡在某个知识点\n  · 剩下的题留到下节课课上补，dueDate 填下节课那天；不改成回家做\n  · 卡在知识点的：下节课先讲再补，补的题换成纯净版\n  · 下节课仍没补上（status=未交）：不追、不催，原因写进 nextAction；\n    自查这份练习的量、难度和这节课的讲解，调整下次课上练习\n\n■ 学校作业、考试错题不方便带来\n  · 带不带来由学员自己决定；老师不追要、不催，也不通过家长要\n  · 学员口头说清错在哪一步，老师据此记 knowledgePoint 与 dimension 也可以\n  · 这份作业交没交给学校，不是本 SKILL 跟进的事，不登记、不过问\n\n■ 教学诊断（自我反思）\n  自我问：\n    1. 是不是课上练习太难了？\n    2. 是不是课上练习的量超出了这节课的时间？\n    3. 是不是讲解没讲透？\n    4. 是不是课上的节奏需要调整？\n\n■ 要跟家长说课上的情况时（不是催交）\n  · 由老师带到家长沟通助手（xiaozhi-teach-parent-communication）起草、自己发\n  · 发之前查 consent.parentCommunicationAllowed；为 false 时只与学员本人说\n```\n\n---\n\n## 六、批改完成与错题回流\n\n### 6.1 批改四类标记\n\n```text\n✓   完全正确\n▲   思路对但计算/书写错\n?   思路不清/不完整\n✗   思路错误\n?✓  部分对\n#   超纲或独特解法\n```\n\n### 6.2 错题回流清单\n\n> 📎 完整模板见 `references/error-reflow-checklist-template.md`（错题回流清单填写模板：多名学员共同错的题、个体错题、反复出现的错题、错题归属）\n\n### 6.3 错因归维（写入 `mainErrors[]`）\n\n错因**一律按 `shared/vocab.md` §1（通用四维）与 §3（老师端七类 ↔ 四维映射）**，本 SKILL 不另起一套词表。\n\n每条错题写成一个 `workspace.homeworkFollowups[].mainErrors[]` 对象：\n\n```text\n{\n  \"knowledgePoint\": \"一元一次方程移项\",   ← 必填，知识点标签（≤60 字）\n  \"dimension\":      \"概念模糊\",           ← 必填，通用四维之一\n  \"teacherCategory\":\"规则错误\"            ← 选填，老师端七类之一\n}\n```\n\n- `dimension` **必填**，取值只能是 `概念模糊 / 计算失误 / 读题失误 / 方法用错`。\n- `teacherCategory` 想写就写，但写了就必须同时给出 `dimension`；两者的对应关系见 `shared/vocab.md §3`（知识漏洞、规则错误 → 概念模糊；计算错误、习惯性失误 → 计算失误；审题错误 → 读题失误；策略错误、表达/书写不规范 → 方法用错）。\n- 不写自由文本错因串（\"这题他老是错\"\"不认真\"），这类描述放 `nextAction`。\n- **\"不认真\"不是错因**——按 `shared/vocab.md §3`，抄错题归读题失误，算错归计算失误，原因要落到可跟进的动作上。\n\n判定顺序（`shared/vocab.md §1`）：先复述条件看是不是读题失误 → 换纯净版看是不是概念模糊 → 换题型看是不是方法用错 → 剩下的归计算失误。**同一道错题只记一个 `dimension`。**\n\n| dimension | 跟进动作 |\n|---|---|\n| 概念模糊 | 回到定义/纯净版最简题，讲完再做同类题 |\n| 计算失误 | 限时计算专项 + 固定检查动作 |\n| 读题失误 | 圈条件、复述题意后再动笔 |\n| 方法用错 | 对比两种解法，讲清什么时候用哪个 |\n\n> 跟进动作里若需要一道验证用的同类题/纯净版题，**生成前按 `shared/ai-item-check.md` 自检**（有解且唯一、条件充分、数值友好、学段内、与原错题同维度同子类型），输出时标注【AI 生成，入库前请人工验算】；老师未验算的题不写入资源库、不发给学员。\n\n---\n\n## 七、反复出错的跟踪与顽固弱项确认\n\n### 7.1 阈值口径\n\n顽固弱项的计数口径**不在本 SKILL 定义**，一律按 `shared/vocab.md §5`：\n- 粒度：同一知识点标签 + 同一通用维度（`dimension`）。\n- 时间窗：滚动 28 天。\n- 累计（不要求连续），同一天同一知识点多次错只计 1 次。\n- 独立教师工作区由本 SKILL 计数（学生端由错题本计数；学校班级工作区的顽固计数由学情分析师累加，见 `shared/vocab.md §5`；各算各的，不互相覆盖）。\n- 高危：同口径 28 天内累计 5 次 → 建议与学员本人谈策略；是否告知家长依 `shared/vocab.md §8` 授权。\n- 攻克标准：连续 2 次独立验证做对、间隔 ≥ 3 天、至少 1 次为换题型/纯净版验证。\n\n弱项状态五档（`待处理 / 初步弱项 / 顽固弱项 / 突破中 / 已攻克`）的进出条件见 `shared/vocab.md §4`，本 SKILL 直接引用。\n\n### 7.2 命中阈值后的动作：先存证据，再等老师确认\n\n阈值命中**不直接写 `studentCards[].primaryWeaknesses`**。顺序是：\n\n```text\n① 命中 vocab §5 阈值\n      ↓\n② 写入 workspace.progressEvidence[]：\n     evidenceType = \"作业\"\n     description  = \"[知识点] 在 28 天内第 3 次出现 [dimension]，\n                     日期 [d1] [d2] [d3]\"\n     confidenceLevel = data_sufficient（≥3 次独立观察）\n      ↓\n③ 向老师提一次确认（一轮，不重复追问）：\n     「小A 的『一元一次方程移项』28 天内第 3 次记到概念模糊\n       （6-1 / 6-8 / 6-15）。要把它加进 小A 的重点弱项吗？\n        加 / 不加 / 再看一次」\n      ↓\n④ 老师说\"加\" → 才写入 studentCards[].primaryWeaknesses（上限 5 条）\n   老师说\"不加\"或没回 → 证据留在 progressEvidence，弱项不写\n```\n\n老师不确认就不写，是因为 `primaryWeaknesses` 会被家长沟通和阶段报告读到，误标的成本比漏标高。\n\n### 7.3 顽固弱项档案\n\n> 📎 完整模板见 `references/persistent-weakness-file-template.md`（顽固弱项档案填写模板：知识点、通用维度、跟进动作、弱项状态）\n\n### 7.4 与学情分析类 SKILL 的衔接\n\n若老师同时安装了教师通用包，可把 `mainErrors[]` 的聚合结果口头带给 `xiaozhi-teach-student-analyzer` 做进一步分析；未安装时本 SKILL 的错因分布已可直接用于备下一节课。两种情况下，写回学员卡的动作都只发生在本 SKILL 且需老师确认。\n\n---\n\n## 八、下节课预诊断\n\n### 8.1 预诊断三步走\n\n```text\n第 1 步：错题聚合\n  · 按 dimension + knowledgePoint 归拢本次作业的错题\n  · 小班场景再区分：多名学员共同错的 vs 只有一人错的\n\n第 2 步：教学决策\n  · 多人共同错：下节课必须讲\n  · 单人错：给这名学员单独的任务\n  · 已达 vocab §5 阈值的：需要专项突破\n\n第 3 步：衔接下一节课\n  · 把错因分析整理成下节课重点\n  · 老师带进备课；本 SKILL 不写教案\n```\n\n### 8.2 预诊断输出\n\n> 📎 完整模板见 `references/pre-diagnosis-output-template.md`（下节课预诊断输出填写模板：必须讲/选讲/个体关注/教案调整建议）\n\n### 8.3 结论落在哪\n\n预诊断本身是**生成的报告段落**，不是存储字段。落库的只有两处：\n- 错因明细 → `workspace.homeworkFollowups[].mainErrors[]`\n- 下节课要盯的动作 → `workspace.homeworkFollowups[].nextAction`\n\n老师在 `xiaozhi-teach-lesson-log` 记录下节课时，可以把这段结论写进 `lessonLogs[].nextLessonFocus`，由那个 SKILL 负责落库。\n\n---\n\n## 九、学员作业画像\n\n### 9.1 单学员画像\n\n> 📎 完整模板见 `references/student-homework-profile-template.md`（单学员作业画像填写模板：完成度趋势、错因分布、反复出错清单、订正率）\n\n### 9.2 画像的数据边界\n\n```text\n  · 画像由 workspace.homeworkFollowups[] 实时聚合，不单独落库\n  · 作业不消耗课时，本 SKILL 不碰 coursePackageLedger\n  · 画像可由 solo-dashboard 只读展示；本 SKILL 不向它推送\n```\n\n---\n\n## 十、需要跟进的学员标记\n\n标记只用于提醒老师，不写入学员卡，也不作为对学员的评价。\n\n```text\n■ 课上练习没补上（看 overdueDays，不看 status）\n  · 中度：近 4 周（按 dueDate）有 2 条 overdueDays ≥ 1\n  · 高度：近 4 周（按 dueDate）有 3 条 overdueDays ≥ 1，或近 4 周内单条 overdueDays ≥ 7\n\n■ 反复出错跟进\n  · 按 shared/vocab.md §5 命中顽固阈值的知识点数 ≥ 3 个\n\n■ 应对\n  · 中度：课上问学员一句卡在哪，看是难度还是时间问题；相应调整课上练习\n  · 高度：先自查课上练习的难度与量、讲解的节奏；要跟家长说课上情况时再沟通，\n          不催交（发家长内容前查 consent.parentCommunicationAllowed）\n\n■ 不做的事\n  · 不按\"错题率 %\"给学员分级——单次作业题量小，比例不稳定\n  · 不把标记本身告诉学员或家长（\"你被标成高风险了\"）\n```\n\n---\n\n## 十一、接口\n\n### 11.1 数据流\n\n本 SKILL 自成闭环：老师在这里登记课上练习与学员带来的学校作业、考试错题，在这里记错因、在这里确认弱项。不需要任何 SKILL 先跑一遍，也不向任何 SKILL 推送。\n\n```text\n  老师口述 ──→ ┌──────────────────────┐ ──→ 老师带走一份\"下节课讲什么\"\n              │ homework-tracker      │\n              │ （本 SKILL）           │\n              └──────────┬───────────┘\n                         │ 只写这三处\n       ┌─────────────────┼─────────────────┐\n       ↓                 ↓                 ↓\n homeworkFollowups  progressEvidence   studentCards\n （状态/错因/动作）  （阈值证据）      （确认后的弱项）\n```\n\n### 11.2 读写字段\n\n均为 `solo-teacher-workspace.schema.json` 的真实字段。\n\n```text\n读：\n  workspace.homeworkFollowups[].task / .dueDate / .status / .overdueDays\n      → 本 SKILL 自己登记的课上练习与学校作业条目（历次）\n  workspace.homeworkFollowups[].mainErrors[].knowledgePoint / .dimension\n      → 历次错因，用于 vocab §5 计数\n  workspace.studentCards[].primaryWeaknesses / .goals / .gradeLevel / .gradeBand\n      → 学员基线（已确认弱项、目标、年级、学段）\n  workspace.studentCards[].status\n      → 为\"暂停记录\"或\"已结课\"时，不再写入任何新条目\n  workspace.lessonLogs[].nextLessonFocus / .date\n      → 上次课设定的重点，用于对照作业表现\n\n写：\n  workspace.homeworkFollowups[].task / .dueDate\n      → 老师登记的内容（task 开头写类别与日期，28 天计数按这个日期算）；课上练习的 dueDate 是约定做完的那节课，学校作业、考试错题不填\n  workspace.homeworkFollowups[].status\n      → 七档枚举之一（已布置/已提交/部分提交/未交/已批改/已订正/已减免）\n  workspace.homeworkFollowups[].overdueDays\n      → 逾期天数：从 dueDate 算到做完那天（已提交、已批改、已订正），做完后不再增加；还没做完的算到当前日期；已减免的记 0（无 dueDate 时不写）\n  workspace.homeworkFollowups[].mainErrors[]\n      → 每条 {knowledgePoint, dimension, teacherCategory?}，dimension 必填\n  workspace.homeworkFollowups[].nextAction\n      → 跟进动作；自由描述放这里，不塞进 mainErrors\n  workspace.progressEvidence[].evidenceType / .description / .date / .confidenceLevel\n      → 阈值命中证据、订正证据、攻克证据\n  workspace.studentCards[].primaryWeaknesses\n      → 仅在老师逐条确认后追加（§7.2），上限 5 条\n\n派生视图（实时计算，不落库）：\n  完成度        ← 由 workspace.homeworkFollowups[].status 聚合（只算课上练习）\n  错因分布      ← 由 workspace.homeworkFollowups[].mainErrors[].dimension 聚合\n  顽固计数      ← 由 mainErrors 跨条目按 shared/vocab.md §5 比对\n  需跟进标记    ← 由 workspace.homeworkFollowups[].overdueDays 统计\n\n生成的报告段落（非存储字段）：\n  下节课预诊断  ← 事实来源为 workspace.homeworkFollowups[].mainErrors；\n                  老师若要留档，由 lesson-log 写入 lessonLogs[].nextLessonFocus\n```\n\n### 11.3 谁来读这些字段\n\n其他 SKILL 直接读工作空间字段即可，不经由本 SKILL：`xiaozhi-teach-solo-dashboard` 读 `overdueDays` 提示课上练习没补上的学员，`xiaozhi-teach-renewal-report` 读 `mainErrors`、`progressEvidence` 与 `task` / `status` / `overdueDays`（按 task 开头的类别只算课上练习）做阶段报告，`xiaozhi-teach-parent-communication` 读 `task`、`status` 与 `nextAction` 起草家长反馈（两类按 task 开头的类别分开说；只说课上情况与错因，不催交；发送前查 `consent.parentCommunicationAllowed`）。\n\n---\n\n## 十二、字段级高敏信息防护\n\n```text\n✅ 追踪中可使用：化名、作业完成度、错因维度、知识点、提交时间\n❌ 禁止：作业具体答案、家庭辅导情况、家长监督方式\n✅ 写入数据：聚合错因、完成度\n❌ 不写入：学员真实身份（一律用 alias）\n\n✅ 错题回流：只存 knowledgePoint + dimension\n❌ 禁止：错题原文、学员答题原文\n```\n\n---\n\n## 十三、行为准则\n\n| ✅ 应该做 | ❌ 不能做 |\n|---------|---------|\n| 只登记课上练习与学员带来的学校作业、考试错题 | 登记回家做的作业、追未交、起草催交话术 |\n| 错因归到 vocab 四维，可跟进 | 写\"不认真\"\"老是错\"当错因 |\n| 阈值命中先存证据、请老师确认 | 越过老师直接改学员卡弱项 |\n| 逾期看 overdueDays | 造一个 status=overdue |\n| 分情况跟进（真不会/时间不够），都在课上解决 | 一律加量，或改成回家补 |\n| 预诊断基于真实错题 | 凭印象决定下节课重点 |\n| 一律用 alias | 记录里出现真实姓名 |\n\n---\n\n## 十四、与其他 SKILL 的协同清单\n\n```text\n作业跟进管家（自成闭环，不需要前置 SKILL）\n    读 workspace.studentCards[]      ← student-intake 建卡\n    读 workspace.lessonLogs[]        ← lesson-log 写课后重点\n    写 workspace.homeworkFollowups[] ← 本 SKILL 唯一写入方\n    写 workspace.progressEvidence[]  ← 与 renewal-report 共用\n    写 workspace.studentCards[].primaryWeaknesses ← 老师确认后\n\n  其他 SKILL 需要作业数据时，直接读上述字段，不经过本 SKILL。\n  若装有教师通用包，可把错因分布带给 student-analyzer / exam-designer\n  做进一步分析或出课上练习的题；未安装时本 SKILL 的输出已可直接用。\n```\n\n**禁止行为**：\n- 禁止登记布置给学员回家做的作业；禁止追未交、起草或代发催交消息（无论发给学员还是家长）\n- 禁止在记录中出现学员真实姓名\n- 禁止存储作业错题原文或学员答题原文（只存 knowledgePoint + dimension）\n- 禁止对所有学员用同一种跟进方式\n- 禁止未经老师确认就写 `studentCards[].primaryWeaknesses`\n- 禁止在 `status` 里造枚举外的值\n\n---\n\n### 隐私与数据控制入口\n- 查看：「查看我的[作业记录]」\n- 更正：「更正我的[作业记录]」\n- 删除：「删除我的[作业记录]」——据此写进学员卡的弱项条目与阶段证据一并列出，老师确认后同删；删除后不可恢复\n- 暂停：「这次不要记忆」（本次会话不读取、不保存任何记录，也不发起回写与交接）/「暂停提醒」\n- 共享控制：「不要共享给其他SKILL」/「不要给家长看」\n- 导出：「导出我的[作业记录]」（以文本形式给出，便于转存）\n\n学员/家长提出时同样适用（由老师核实请求人身份后代为执行），按学员化名定位：「查看 小A 的作业记录」「删除 小A 的全部作业记录」。\n\n**校验要求**：跨 SKILL 共享或建档前，须确认 `consent.crossSkillSharing` / `consent.profileEnabled` 为 true；学员卡 `status` 为\"暂停记录\"时不再写入新条目。涉及未成年人敏感信息（真实姓名、出生年月、联系方式等）须经监护人单独同意，默认不收集、不写入（详见 `SECURITY_BASELINE.md`）。\n\n---\n\n## 十五、参考资源\n\n- `references/completion-tracking-views.md` — 单学员/学员列表完成度视图模板\n- `references/error-reflow-checklist-template.md` — 错题回流清单模板\n- `references/persistent-weakness-file-template.md` — 顽固弱项档案模板\n- `references/pre-diagnosis-output-template.md` — 下节课预诊断输出模板\n- `references/student-homework-profile-template.md` — 学员作业画像模板\n- `shared/vocab.md` — 错因四维、老师端七类映射、顽固阈值、弱项五档（唯一来源）\n\n---\n\n> 💡 **小智说：**\n> \"作业是教学里最被低估的环节。\n>  大多数老师批完就忘，但如果你把每份作业\n>  看作下一节课的 X 光片，\n>  你会发现：\n>  同一道题几个人都错，是教学没讲到；\n>  一个学员总错一个点，是认知有漏洞；\n>  一个学员课上突然做不完，是状态有了变化。\n>  作业是教学最敏感的传感器。\"\n\nFile v2.11.0:_meta.json\n\n{\n  \"ownerId\": \"kn79c5gcmfkt9p1pk656tgq7nd853s7v\",\n  \"slug\": \"xiaozhi-teach-homework-tracker\",\n  \"version\": \"2.11.0\",\n  \"publishedAt\": 1791446924610\n}\n\nFile v2.11.0:references/completion-tracking-views.md\n\n# 作业完成度追踪视图模板\r\n\r\n> 适用学段：小学中段 / 小学高段 / 初中 / 高中\r\n> 配合 `xiaozhi-teach-homework-tracker` §五使用。独立教师带一对一或小班，没有\"班级\"，因此第二张表是**学员列表视图**而不是班级花名册。\r\n> 状态只用 schema 七档枚举：已布置 / 已提交 / 部分提交 / 未交 / 已批改 / 已订正 / 已减免。逾期与否看 `overdueDays`，不新造 `overdue` 状态。\r\n> 只登记课上练习与学员带来的学校作业、考试错题（`task` 开头写类别与日期），不登记回家做的作业；完成度只算课上练习，学校作业、考试错题从 `已批改` 或 `已订正` 起记，不算完成度、不算逾期。\r\n\r\n## 一、单学员作业完成度视图\r\n\r\n```text\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n📊 作业完成度 · [化名] · [周次]\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n■ 本周课上练习（dueDate = 约定做完的那节课）\r\n  · 练习 1（[日期] 课上）：□已布置 □已提交 □部分提交 □未交 □已批改 □已订正 □已减免\r\n      逾期：[overdueDays] 天（0 表示在约定的那节课做完了、还没到约定那节课，或已减免）\r\n  · 练习 2（[日期] 课上）：□已布置 □已提交 □部分提交 □未交 □已批改 □已订正 □已减免\r\n      逾期：[overdueDays] 天\r\n  · 练习 3（[日期] 课上）：□已布置 □已提交 □部分提交 □未交 □已批改 □已订正 □已减免\r\n      逾期：[overdueDays] 天\r\n\r\n■ 学员带来的学校作业、考试错题（学员自愿带来，不追交、不催交）\r\n  · [学校作业 / 考试错题]（[日期] 带来）：□已批改 □已订正 · 记错题 [N] 条\r\n\r\n■ 课上练习完成情况（按条数，不按题数；学校作业、考试错题不算）\r\n  · 课上做完（已提交，含已批改/已订正）：[N] / 总 [N]\r\n  · 课上没做完（部分提交）：[N] / 总 [N]\r\n  · 下节课也没补上（未交）：[N] / 总 [N]\r\n  · 已减免：[N]（不计入未交）\r\n\r\n■ 与上周对比\r\n  · 上周：[N] / [N] 条按约定做完\r\n  · 本周：[N] / [N] 条按约定做完\r\n  · 趋势：[好转 / 持平 / 下降]\r\n  · 说明：单周条数少时不下\"趋势\"结论，标 🔴 样本不足\r\n\r\n■ 错因统计（按 shared/vocab.md §1 四维；课上练习与学校作业、考试错题一起算）\r\n  · 本周新记错题：[N] 条\r\n  · 概念模糊 [N] · 计算失误 [N] · 读题失误 [N] · 方法用错 [N]\r\n  · 已达 vocab §5 阈值待老师确认：[N] 个知识点\r\n  · 已订正：[N] / [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  │ 小A     │ 已批改    │ 0        │ 订正第 3 题 │\r\n  │ 小B     │ 部分提交  │ 0        │ 下节课补完  │\r\n  │ 小C     │ 未交      │ 2        │ 查卡在哪    │\r\n  │ 小D     │ 已减免    │ —        │ —          │\r\n  │ 小E     │ 已订正    │ —        │ 学校作业    │\r\n  └────────┴──────────┴──────────┴────────────┘\r\n  （小E 那条是学员带来的学校作业，从已批改起记，不算完成度、不追交）\r\n\r\n■ 需要跟进的学员（判据见 SKILL §十）\r\n  · 小C：近 4 周 3 条 overdueDays ≥ 1 → 高度，先自查课上练习的量与难度\r\n  · 小B：近 4 周 2 条 overdueDays ≥ 1 → 中度，课上问一句卡在哪\r\n\r\n■ 多名学员共同错的题（仅小班场景）\r\n  · [知识点]：[N] 人错，主要维度 [概念模糊 / 计算失误 / 读题失误 / 方法用错]\r\n  · 处理：下节课当共性内容讲；只有 1 人错的放个体任务\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n```\r\n\r\n## 三、填写注意\r\n\r\n- 化名一律用 `studentCards[].alias`，任何视图里不出现真实姓名。\r\n- \"完成度\"只统计课上练习的条数（学校作业、考试错题不算），不换算成对学员的评价用语；学员带来多少学校作业也不用来评价学员。\r\n- 学员卡 `status` 为\"暂停记录\"或\"已结课\"时，不再新增行。\r\n- 统计跨周数据依赖平台的跨会话统计能力；没有该能力时只列本次会话已知的几条，并说明\"这不是完整历史\"。\n\nFile v2.11.0:references/error-reflow-checklist-template.md\n\n# 错题回流清单模板\r\n\r\n> 适用学段：小学中段 / 小学高段 / 初中 / 高中\r\n> 配合 `xiaozhi-teach-homework-tracker` §6.2 使用。\r\n> 错因一律按 `shared/vocab.md` §1（通用四维）与 §3（老师端七类 ↔ 四维映射）填写；`dimension` 必填，不写自由文本错因。\r\n\r\n```text\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n📋 错题回流清单 · [日期] 课上练习 / 带来的学校作业\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n■ 多名学员共同错的题（仅小班场景；一对一跳过本节）\r\n  ① 知识点 [X] · dimension [概念模糊/计算失误/读题失误/方法用错]\r\n     · [N] 人错 · teacherCategory（选填）[知识漏洞/规则错误/…]\r\n  ② 知识点 [X] · dimension [   ] · [N] 人错\r\n\r\n■ 个体错题（逐学员）\r\n  小A：\r\n    · 知识点 [X] · dimension [   ] · teacherCategory [   ]\r\n    · 知识点 [X] · dimension [   ]\r\n  小B：\r\n    · 知识点 [X] · dimension [   ]\r\n\r\n■ 反复出现的知识点（按 shared/vocab.md §5 口径）\r\n  口径：同一 knowledgePoint + 同一 dimension，滚动 28 天累计，\r\n        同一天多次只计 1 次\r\n  · 小A · [知识点] · 概念模糊 · 28 天内第 3 次（[d1] [d2] [d3]）\r\n        → 写 progressEvidence，等老师确认后才进 primaryWeaknesses\r\n  · 小D · [知识点] · 计算失误 · 28 天内第 5 次\r\n        → 高危：建议与学员本人谈策略；告知家长依 shared/vocab.md §8 授权\r\n\r\n■ 这些数据去哪\r\n  · 落库：workspace.homeworkFollowups[].mainErrors[]（本 SKILL 写）\r\n  · 阈值证据：workspace.progressEvidence[]（本 SKILL 写）\r\n  · 学员卡弱项：workspace.studentCards[].primaryWeaknesses（老师确认后才写）\r\n  · 下节课重点：老师带进备课；要留档时由 lesson-log 写 nextLessonFocus\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n```\r\n\r\n## 填写注意\r\n\r\n- 一道错题只记一个 `dimension`。判定顺序：复述条件（读题失误）→ 纯净版（概念模糊）→ 换题型（方法用错）→ 剩下归计算失误。\r\n- 不写\"不认真\"\"马虎\"\"态度问题\"——按 `shared/vocab.md §3`，抄错题归读题失误，算错归计算失误。\r\n- 只存 `knowledgePoint` 和 `dimension`，**不存错题原文、不存学员答题原文**。\r\n- 一对一场景下没有\"共性错题\"，直接用个体错题一节。\n\nFile v2.11.0:references/persistent-weakness-file-template.md\n\n# 顽固弱项档案模板\r\n\r\n> 适用学段：小学中段 / 小学高段 / 初中 / 高中\r\n> 配合 `xiaozhi-teach-homework-tracker` §7.3 使用。\r\n> 弱项状态五档与进出条件见 `shared/vocab.md §4`；计数口径见 `shared/vocab.md §5`。本文件只提供填写格式，不另定阈值。\r\n\r\n```text\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n🔴 顽固弱项档案 · [化名]\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n■ 弱项 ①\r\n  知识点（knowledgePoint）：[            ]\r\n  通用维度（dimension）：□概念模糊 □计算失误 □读题失误 □方法用错\r\n  老师端七类（teacherCategory，选填）：[            ]\r\n  计数：28 天内 [N] 次（[d1] [d2] [d3]）\r\n  首次出现：[日期] · 最近一次：[日期]\r\n  弱项状态（shared/vocab.md §4）：\r\n    □待处理 □初步弱项 □顽固弱项 □突破中 □已攻克\r\n  置信度（shared/vocab.md §7）：□🟢 数据充分 □🟡 初步趋势 □🔴 样本不足\r\n  是否已写入学员卡：□老师已确认，已写入 primaryWeaknesses\r\n                    □仅在 progressEvidence，等老师确认\r\n  跟进动作：\r\n    · 第 [N] 次课：回到定义 / 纯净版最简题\r\n    · 第 [N] 次课：换题型验证\r\n    · 第 [N] 次课：独立验证（间隔 ≥ 3 天）\r\n\r\n■ 弱项 ②\r\n  （同上格式）\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n```\r\n\r\n## 状态怎么变（引用 shared/vocab.md §4）\r\n\r\n```text\r\n待处理 ──首次记录────────────────────────→\r\n初步弱项 ──28 天内同知识点同维度第 2 次───→\r\n顽固弱项 ──28 天内第 3 次──────────────→\r\n突破中   ──顽固后首次独立验证做对────────→\r\n已攻克   ──再一次独立验证做对，间隔 ≥ 3 天，\r\n           且至少 1 次为换题型/纯净版验证──→\r\n已攻克后 30 天内再错 → 退回突破中\r\n```\r\n\r\n## 填写注意\r\n\r\n- **攻克标准不是\"连对 3 次\"**：是连续 2 次独立验证做对、间隔 ≥ 3 天、至少 1 次换题型或纯净版（`shared/vocab.md §5`）。\r\n- 28 天内累计 5 次属高危：建议与学员本人谈学习策略；是否告知家长依 `shared/vocab.md §8` 的授权位判断，不默认告知。\r\n- 写入 `studentCards[].primaryWeaknesses` 上限 5 条，且必须老师逐条确认；未确认的留在 `progressEvidence` 里。\r\n- 档案只写知识点和维度，不写错题原文，不写对学员的性格评价。\n\nFile v2.11.0:references/pre-diagnosis-output-template.md\n\n# 下节课预诊断输出模板\r\n\r\n> 适用学段：小学中段 / 小学高段 / 初中 / 高中\r\n> 配合 `xiaozhi-teach-homework-tracker` §8.2 使用。\r\n> 预诊断是**生成的报告段落**，不是工作空间存储字段；事实来源为 `workspace.homeworkFollowups[].mainErrors[]`。老师要留档时，由 `xiaozhi-teach-lesson-log` 写入 `lessonLogs[].nextLessonFocus`。\r\n\r\n```text\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n🔍 下节课预诊断 · 基于 [日期] 课上练习 / 带来的学校作业 · [化名]\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n■ 必须讲\r\n  · [知识点]：dimension [概念模糊/计算失误/读题失误/方法用错]\r\n      判据：本次错 [N] 题；28 天内第 [N] 次\r\n      讲什么：[针对该维度的具体切入点]\r\n  · [知识点]：dimension [   ]\r\n      判据：[   ]\r\n      讲什么：[   ]\r\n\r\n■ 可以带过\r\n  · [知识点]：只错 1 题且此前无记录 → 口头点一句，不占时间\r\n\r\n■ 需要专项处理\r\n  · [知识点]：已达 shared/vocab.md §5 阈值\r\n      → 先回到定义/纯净版，再换题型验证，两次验证间隔 ≥ 3 天\r\n\r\n■ 小班场景补充（一对一跳过）\r\n  · 多人共同错：[知识点]（[N] 人）→ 统一讲\r\n  · 单人错：[化名] [知识点] → 单独任务，不占公共时间\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  · 新内容：[N] 分钟\r\n  注：以上按老师实际课时长度分配，不写死总时长\r\n\r\n■ 交给谁\r\n  · 老师带进下一节课；本 SKILL 不写教案\r\n  · 要留档 → xiaozhi-teach-lesson-log 写 lessonLogs[].nextLessonFocus\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n```\r\n\r\n## 填写注意\r\n\r\n- 每条\"必须讲\"都要有判据（错了几题、28 天内第几次），没有判据的不写进必须讲。\r\n- 不写\"这孩子基础差\"这类整体评价，只写知识点和维度。\r\n- 用于验证的同类题若由 AI 生成，先按 `shared/ai-item-check.md` 自检，并标注【AI 生成，入库前请人工验算】。\n\nFile v2.11.0:references/student-homework-profile-template.md\n\n# 学员作业画像模板\r\n\r\n> 适用学段：小学中段 / 小学高段 / 初中 / 高中\r\n> 配合 `xiaozhi-teach-homework-tracker` §9.1 使用。画像是**实时聚合的派生视图**，不落库。\r\n> 错因分布只用 `shared/vocab.md §1` 的通用四维，不用老师端七类做统计口径（七类可在单条错题上标注，聚合时先映射回四维）。\r\n\r\n```text\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n📈 学员作业画像 · [化名]\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n■ 课上练习完成趋势（按条数，只算课上练习）\r\n  第 1-5 次课：按约定做完 [N] / [N] 条\r\n  第 6-10 次课：按约定做完 [N] / [N] 条\r\n  第 11 次课以后：按约定做完 [N] / [N] 条\r\n  趋势：[好转 / 持平 / 下降]\r\n  置信度（shared/vocab.md §7）：□🟢 数据充分 □🟡 初步趋势 □🔴 样本不足\r\n  说明：总条数少于 6 条时一律标 🔴，不下趋势结论\r\n\r\n■ 错因分布（shared/vocab.md §1 四维）\r\n  概念模糊 [N] 条\r\n  计算失误 [N] 条\r\n  读题失误 [N] 条\r\n  方法用错 [N] 条\r\n  主导维度：[   ]（占比最高且领先第二名 ≥ 2 条时才写\"主导\"）\r\n\r\n■ 反复出现的知识点（shared/vocab.md §5 口径）\r\n  · [知识点] · [维度] · 28 天内 [N] 次 · 弱项状态 [五档之一]\r\n  · [知识点] · [维度] · 28 天内 [N] 次 · 弱项状态 [五档之一]\r\n\r\n■ 订正情况\r\n  · 已订正 [N] / 已批改后有错题的作业 [N] 条\r\n  · 订正后再验证做对的：[N] 条\r\n\r\n■ 学员带来的学校作业、考试错题\r\n  · 带来 [N] 份，记错题 [N] 条（带不带来由学员自己定，份数不用来评价学员）\r\n\r\n■ 课上练习没补上的情况\r\n  · 近 4 周 overdueDays ≥ 1 的条目：[N] 条\r\n  · 最长一次逾期：[N] 天\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n```\r\n\r\n## 填写注意\r\n\r\n- 画像给老师看，也可能被老师念给家长听——念之前先查 `consent.parentCommunicationAllowed`；内容里只留事实，不留判断。\r\n- 不写\"错题率 [N]%\"式的比例：单次作业题量小，比例不稳定，容易误导。\r\n- 跨周统计依赖平台的跨会话统计能力；缺该能力时只列已知条目并说明不完整，不口算历史数字。\r\n- 画像不写入任何字段；要留档的结论走 `progressEvidence`。\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\nArchive v2.10.0: 16 files, 45360 bytes\n\nFiles: references/completion-tracking-views.md (4164b), references/error-reflow-checklist-template.md (2496b), references/persistent-weakness-file-template.md (2693b), references/pre-diagnosis-output-template.md (2354b), references/student-homework-profile-template.md (2253b), 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 (8616b), shared/vocab.md (14173b), skill-card.md (2772b), SKILL.md (26096b), _meta.json (150b)\n\nFile v2.10.0:SKILL.md\n\n---\nname: xiaozhi-teach-homework-tracker\ndescription: '帮独立教师把作业从\"收上来\"变成\"跟到底\"：登记、追状态、归错因、导出下节课讲什么。适用于老师说\"登记今天布置的作业\"\"[化名] 的作业状态\"\"这周谁没交\"\"错题回流\"\"下节课该讲什么\"\"这道题他错第三次了\"\"看下 [化名] 的作业画像\"。流程：老师登记 task/dueDate → 追七档状态 → 按 shared/vocab.md §1/§3 归错因 → 阈值命中先存证据待老师确认。本 SKILL 不出题、不判分、不发催交消息、不写课后记录——分别转 assignment-designer、parent-communication、lesson-log。'\ncompatibility: WorkBuddy / SkillHub / OpenClaw / ClawHub\nlicense: MIT\ndisplay_name: 作业跟进管家\nversion: 2.10.0\nauthor: 小智伴学\ncategory: 独立教师\ngrade_bands:\n  - 小学中段\n  - 小学高段\n  - 初中\n  - 高中\ntags: [作业跟进, 错题回流, 状态追踪, 预诊断, 独立教师]\ndepends_on:\n  - xiaozhi-teach-lesson-log\nid: openclaw:xiaozhi-teach-homework-tracker\nmin_platform_version: \"2.0\"\nmax_round_limit: 12\nslug: xiaozhi-teach-homework-tracker\ndisplayName: 作业跟进管家\nsummary: '帮独立教师把作业从\"收上来\"变成\"跟到底\"：登记、追状态、归错因、导出下节课讲什么。'\n---\n\n# 作业跟进管家 SKILL\n\n> **一句话定位：** 作业不是任务清单，而是下一节课的诊断 X 光——跟进它，不是为了完成它，而是为了发现下一节课该讲什么。\n\n---\n\n## 技术边界\n\n> 技术边界：本 SKILL 依赖能力 [M, X, K]，无该能力时按 shared/platform-conventions.md 降级。\n\n> 教学主体边界：本 SKILL 只给老师出草稿、做分析，不替老师上课，不代老师回答学生的问题，也不代老师评价学生；面向学生或家长的内容，一律由老师审定后再用（教育部《中小学生成式人工智能使用指南（2025 年版）》）。\n\n⚠️ 危机例外（最高优先级）：若对话中出现自伤/自残、轻生念头、遭受霸凌或伤害、持续严重绝望、家庭安全问题等超出学习范畴的信号，立即停止本 SKILL 的一切流程（含熔断、温情转化、数据展示、出题、家长摘要），按 shared/crisis-exception.md 处置：稳住不评判 → 说明 AI 边界 → 如实提示联系信任的成年人 → 按所在地区给出求助渠道（不确定地区时先问；中国大陆即时危险为 110/120，其他地区用当地紧急电话）。宁可误报，不可漏报；档案只记\"已转介\"的处置事实。\n\n只追踪低敏信息（完成度、错因维度、知识点、提交时间）；不收集作业原文、答案、家庭辅导情况。不替老师判分，不向家长或学员发任何催交消息——催交话术由老师带到 `xiaozhi-teach-parent-communication` 自行发出。无 `X` 时不给\"累计错 N 次\"的精确统计，改为把已知的几次列出来请老师自己数。\n\n---\n\n## 一、核心使命\n\n独立教师作业跟进常见的三个误区：\n\n```text\n误区① 收了就忘：作业布置出去后缺乏系统追踪，\n        完成度、错题率、顽固弱项全凭印象。\n\n误区② 批完归档：作业批改完就放在一边，\n        错题没有回流到下一节课教案，\n        学生错过的题目反复错。\n\n误区③ 一刀切催交：对所有学生用同一种方式催交，\n        不知道谁是\"真的不会\"谁是\"忘了交\"。\n```\n\n本 SKILL 要解决的是：\n- **让每份作业都有完整追踪**：登记 → 提交 → 批改 → 错因 → 下节课\n- **让错因落到可跟进的维度上**：按 `shared/vocab.md §1/§3` 归维，不写\"不认真\"\n- **让跟进分情况**：真不会 / 忘了 / 时间不够，三种处理不一样\n- **让判定留在老师手里**：阈值命中先给证据，老师确认才改学员卡\n\n---\n\n## 二、触发时机\n\n| 触发场景 | 示例语句 |\n|---------|---------|\n| 作业跟进 | \"作业跟进\" / \"[化名] 的作业状态\" |\n| 完成度 | \"作业完成度\" / \"哪些学生没交\" |\n| 错题回流 | \"错题回流\" / \"错题怎么进入下节课\" |\n| 下节课预诊断 | \"下节课讲什么\" / \"作业反映什么问题\" |\n| 作业没交 | \"[化名] 作业没交怎么办\" |\n| 顽固弱项 | \"[化名] 这道题错 3 次了\" |\n| 作业画像 | \"看一下 [化名] 的作业画像\" |\n\n---\n\n## 三、核心流程\n\n```text\n                ┌──────────────────────────┐\n                │ ① 老师在本 SKILL 内登记   │\n                │  task / dueDate / 学员    │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ② 状态追踪（七档枚举）    │\n                │  逾期看 overdueDays       │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ③ 老师判分后登记错题      │\n                │  本 SKILL 不判分          │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ④ 错因归维（vocab §1/§3） │\n                │  写 mainErrors[]          │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ⑤ 阈值命中（vocab §5）    │\n                │  先写 progressEvidence    │\n                │  老师确认后才进弱项       │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ⑥ 下节课预诊断            │\n                │  交给老师带进下一节课     │\n                └──────────────────────────┘\n```\n\n**第 ① 步由老师在本 SKILL 内完成**：作业内容与截止时间是老师口述、本 SKILL 记录，不依赖任何出题类 SKILL 事先登记。老师若用 `xiaozhi-teach-assignment-designer` 设计过作业，把最终布置的内容复述一遍即可，本 SKILL 不从它那里取数。\n\n```text\n登记话术（一轮内完成）：\n  「给谁布置的、布置了什么、什么时候交？」\n  → 老师：\"小A，函数图像练习册 P32 第 1-8 题，周四交\"\n  → 写入：studentId=小A，task=\"函数图像练习册 P32 第1-8题\"，dueDate=周四日期，status=已布置\n  缺 dueDate 时追问一次；仍无则记 status=已布置 且不参与逾期统计。\n```\n\n---\n\n## 四、作业状态（对齐工作空间 schema）\n\n每份作业的 `status` 取值须为 `schema.homeworkFollowup.status` 枚举之一（已布置/已提交/部分提交/未交/已批改/已订正/已减免）：\n\n```text\n┌──────────┬────────────────────────┬────────────┬──────────────┐\n│ 状态      │ 定义                    │ 触发动作    │ 时长限制      │\n├──────────┼────────────────────────┼────────────┼──────────────┤\n│ 已布置    │ 已布置、尚未到截止       │ 等待提交    │ —            │\n│ 已提交    │ 在截止时间内完整提交     │ 等待批改    │ 0-3 天        │\n│ 部分提交  │ 提交部分内容/部分完成    │ 请学员补齐  │ 1-3 天        │\n│ 未交      │ 截止时间未提交           │ 分层跟进    │ 当天          │\n│ 已批改    │ 老师完成批改             │ 错题回流    │ 1-7 天        │\n│ 已订正    │ 学员完成订正             │ 错题归档到错题本 │ —        │\n│ 已减免    │ 经沟通减免本次作业       │ 记录说明    │ —            │\n└──────────┴────────────────────────┴────────────┴──────────────┘\n```\n\n> 说明：\n> - \"错题归档到错题本\"是 `已订正` 后的下游动作，不是独立状态。\n> - 枚举里**没有** `overdue`、`补交`、`逾期` 这些值。逾期与否看 `overdueDays`（由 `dueDate` 与当前日期派生）；学生迟交后交上来了，状态就是 `已提交`，逾期事实由 `overdueDays` 保留。\n> - 七档以外的说法（\"交了一半\"\"说是忘带了\"）写进 `nextAction`，不新造状态。\n\n---\n\n## 五、完成度追踪\n\n### 5.1 单学员作业完成度视图\n\n> 📎 完整模板见 `references/completion-tracking-views.md`（单学员完成度视图填写模板：本周作业状态、完成度统计、与上周对比、错题统计）\n\n### 5.2 学员列表视图（跨学员横看）\n\n独立教师带的是一对一或小班，没有\"班级\"，所以这里是**学员列表**而不是班级花名册：按学员逐行列出本周作业状态，不排名、不公示。\n\n> 📎 完整模板见 `references/completion-tracking-views.md`（学员列表视图填写模板：逐学员状态、待跟进学员）\n\n### 5.3 未交后的分层跟进\n\n以下话术**由老师自己发**，本 SKILL 只提供措辞。\n\n```text\n■ 学员视角（老师私下问一句，不在群里说）\n  时机：作业截止当晚/第二天\n  话术：\n    \"我看你 [X 作业] 没交，是不是 [X 原因]？\n     如果有困难，我们可以 [X 帮助方式]。\"\n\n■ 家长视角（老师自己发；本 SKILL 不代发）\n  时机：同一学员近 4 周有 2 次未交，且与学员本人聊过仍无改善\n  前置：查 consent.parentCommunicationAllowed；为 false 时只与学员本人沟通\n  话术（起草交给 xiaozhi-teach-parent-communication）：\n    \"[X 妈/爸，[化名] 这两次 [X 作业] 都没交。\n     我想了解一下原因。\n     如果是 [X 难度问题]，我们会 [X 调整]。\n     如果是 [X 时间问题]，我们也可以 [X 调整]。\"\n\n■ 教学诊断（自我反思）\n  自我问：\n    1. 是不是作业太难了？\n    2. 是不是作业量太大了？\n    3. 是不是上课没听懂？\n    4. 是不是学习习惯需要支持？\n```\n\n---\n\n## 六、批改完成与错题回流\n\n### 6.1 批改四类标记\n\n```text\n✓   完全正确\n▲   思路对但计算/书写错\n?   思路不清/不完整\n✗   思路错误\n?✓  部分对\n#   超纲或独特解法\n```\n\n### 6.2 错题回流清单\n\n> 📎 完整模板见 `references/error-reflow-checklist-template.md`（错题回流清单填写模板：多名学员共同错的题、个体错题、反复出现的错题、错题归属）\n\n### 6.3 错因归维（写入 `mainErrors[]`）\n\n错因**一律按 `shared/vocab.md` §1（通用四维）与 §3（老师端七类 ↔ 四维映射）**，本 SKILL 不另起一套词表。\n\n每条错题写成一个 `workspace.homeworkFollowups[].mainErrors[]` 对象：\n\n```text\n{\n  \"knowledgePoint\": \"一元一次方程移项\",   ← 必填，知识点标签（≤60 字）\n  \"dimension\":      \"概念模糊\",           ← 必填，通用四维之一\n  \"teacherCategory\":\"规则错误\"            ← 选填，老师端七类之一\n}\n```\n\n- `dimension` **必填**，取值只能是 `概念模糊 / 计算失误 / 读题失误 / 方法用错`。\n- `teacherCategory` 想写就写，但写了就必须同时给出 `dimension`；两者的对应关系见 `shared/vocab.md §3`（知识漏洞、规则错误 → 概念模糊；计算错误、习惯性失误 → 计算失误；审题错误 → 读题失误；策略错误、表达/书写不规范 → 方法用错）。\n- 不写自由文本错因串（\"这题他老是错\"\"不认真\"），这类描述放 `nextAction`。\n- **\"不认真\"不是错因**——按 `shared/vocab.md §3`，抄错题归读题失误，算错归计算失误，原因要落到可跟进的动作上。\n\n判定顺序（`shared/vocab.md §1`）：先复述条件看是不是读题失误 → 换纯净版看是不是概念模糊 → 换题型看是不是方法用错 → 剩下的归计算失误。**同一道错题只记一个 `dimension`。**\n\n| dimension | 跟进动作 |\n|---|---|\n| 概念模糊 | 回到定义/纯净版最简题，讲完再做同类题 |\n| 计算失误 | 限时计算专项 + 固定检查动作 |\n| 读题失误 | 圈条件、复述题意后再动笔 |\n| 方法用错 | 对比两种解法，讲清什么时候用哪个 |\n\n> 跟进动作里若需要一道验证用的同类题/纯净版题，**生成前按 `shared/ai-item-check.md` 自检**（有解且唯一、条件充分、数值友好、学段内、与原错题同维度同子类型），输出时标注【AI 生成，入库前请人工验算】；老师未验算的题不写入资源库、不发给学员。\n\n---\n\n## 七、反复出错的跟踪与顽固弱项确认\n\n### 7.1 阈值口径\n\n顽固弱项的计数口径**不在本 SKILL 定义**，一律按 `shared/vocab.md §5`：\n- 粒度：同一知识点标签 + 同一通用维度（`dimension`）。\n- 时间窗：滚动 28 天。\n- 累计（不要求连续），同一天同一知识点多次错只计 1 次。\n- 老师端由本 SKILL 计数（学生端由错题本计数，两边不互相覆盖）。\n- 高危：同口径 28 天内累计 5 次 → 建议与学员本人谈策略；是否告知家长依 `shared/vocab.md §8` 授权。\n- 攻克标准：连续 2 次独立验证做对、间隔 ≥ 3 天、至少 1 次为换题型/纯净版验证。\n\n弱项状态五档（`待处理 / 初步弱项 / 顽固弱项 / 突破中 / 已攻克`）的进出条件见 `shared/vocab.md §4`，本 SKILL 直接引用。\n\n### 7.2 命中阈值后的动作：先存证据，再等老师确认\n\n阈值命中**不直接写 `studentCards[].primaryWeaknesses`**。顺序是：\n\n```text\n① 命中 vocab §5 阈值\n      ↓\n② 写入 workspace.progressEvidence[]：\n     evidenceType = \"作业\"\n     description  = \"[知识点] 在 28 天内第 3 次出现 [dimension]，\n                     日期 [d1] [d2] [d3]\"\n     confidenceLevel = data_sufficient（≥3 次独立观察）\n      ↓\n③ 向老师提一次确认（一轮，不重复追问）：\n     「小A 的『一元一次方程移项』28 天内第 3 次记到概念模糊\n       （6-1 / 6-8 / 6-15）。要把它加进 小A 的重点弱项吗？\n        加 / 不加 / 再看一次」\n      ↓\n④ 老师说\"加\" → 才写入 studentCards[].primaryWeaknesses（上限 5 条）\n   老师说\"不加\"或没回 → 证据留在 progressEvidence，弱项不写\n```\n\n老师不确认就不写，是因为 `primaryWeaknesses` 会被家长沟通和阶段报告读到，误标的成本比漏标高。\n\n### 7.3 顽固弱项档案\n\n> 📎 完整模板见 `references/persistent-weakness-file-template.md`（顽固弱项档案填写模板：知识点、通用维度、跟进动作、弱项状态）\n\n### 7.4 与学情分析类 SKILL 的衔接\n\n若老师同时安装了教师通用包，可把 `mainErrors[]` 的聚合结果口头带给 `xiaozhi-teach-student-analyzer` 做进一步分析；未安装时本 SKILL 的错因分布已可直接用于备下一节课。两种情况下，写回学员卡的动作都只发生在本 SKILL 且需老师确认。\n\n---\n\n## 八、下节课预诊断\n\n### 8.1 预诊断三步走\n\n```text\n第 1 步：错题聚合\n  · 按 dimension + knowledgePoint 归拢本次作业的错题\n  · 小班场景再区分：多名学员共同错的 vs 只有一人错的\n\n第 2 步：教学决策\n  · 多人共同错：下节课必须讲\n  · 单人错：给这名学员单独的任务\n  · 已达 vocab §5 阈值的：需要专项突破\n\n第 3 步：衔接下一节课\n  · 把错因分析整理成下节课重点\n  · 老师带进备课；本 SKILL 不写教案\n```\n\n### 8.2 预诊断输出\n\n> 📎 完整模板见 `references/pre-diagnosis-output-template.md`（下节课预诊断输出填写模板：必须讲/选讲/个体关注/教案调整建议）\n\n### 8.3 结论落在哪\n\n预诊断本身是**生成的报告段落**，不是存储字段。落库的只有两处：\n- 错因明细 → `workspace.homeworkFollowups[].mainErrors[]`\n- 下节课要盯的动作 → `workspace.homeworkFollowups[].nextAction`\n\n老师在 `xiaozhi-teach-lesson-log` 记录下节课时，可以把这段结论写进 `lessonLogs[].nextLessonFocus`，由那个 SKILL 负责落库。\n\n---\n\n## 九、学员作业画像\n\n### 9.1 单学员画像\n\n> 📎 完整模板见 `references/student-homework-profile-template.md`（单学员作业画像填写模板：完成度趋势、错因分布、反复出错清单、订正率）\n\n### 9.2 画像的数据边界\n\n```text\n  · 画像由 workspace.homeworkFollowups[] 实时聚合，不单独落库\n  · 作业不消耗课时，本 SKILL 不碰 coursePackageLedger\n  · 画像可由 solo-dashboard 只读展示；本 SKILL 不向它推送\n```\n\n---\n\n## 十、需要跟进的学员标记\n\n标记只用于提醒老师，不写入学员卡，也不作为对学员的评价。\n\n```text\n■ 逾期跟进（看 overdueDays，不看 status）\n  · 中度：近 4 周有 2 条 overdueDays ≥ 1\n  · 高度：近 4 周有 3 条 overdueDays ≥ 1，或单条 overdueDays ≥ 7\n\n■ 反复出错跟进\n  · 按 shared/vocab.md §5 命中顽固阈值的知识点数 ≥ 3 个\n\n■ 应对\n  · 中度：与学员本人私下聊一次，看是难度还是时间问题；相应调整作业\n  · 高度：先自查作业难度与总量，再决定是否与家长沟通\n          （发家长内容前查 consent.parentCommunicationAllowed）\n\n■ 不做的事\n  · 不按\"错题率 %\"给学员分级——单次作业题量小，比例不稳定\n  · 不把标记本身告诉学员或家长（\"你被标成高风险了\"）\n```\n\n---\n\n## 十一、接口\n\n### 11.1 数据流\n\n本 SKILL 自成闭环：老师在这里登记作业、在这里记错因、在这里确认弱项。不需要任何 SKILL 先跑一遍，也不向任何 SKILL 推送。\n\n```text\n  老师口述 ──→ ┌──────────────────────┐ ──→ 老师带走一份\"下节课讲什么\"\n              │ homework-tracker      │\n              │ （本 SKILL）           │\n              └──────────┬───────────┘\n                         │ 只写这三处\n       ┌─────────────────┼─────────────────┐\n       ↓                 ↓                 ↓\n homeworkFollowups  progressEvidence   studentCards\n （状态/错因/动作）  （阈值证据）      （确认后的弱项）\n```\n\n### 11.2 读写字段\n\n均为 `solo-teacher-workspace.schema.json` 的真实字段。\n\n```text\n读：\n  workspace.homeworkFollowups[].task / .dueDate / .status / .overdueDays\n      → 本 SKILL 自己登记的作业条目（历次）\n  workspace.homeworkFollowups[].mainErrors[].knowledgePoint / .dimension\n      → 历次错因，用于 vocab §5 计数\n  workspace.studentCards[].primaryWeaknesses / .goals / .gradeLevel / .gradeBand\n      → 学员基线（已确认弱项、目标、年级、学段）\n  workspace.studentCards[].status\n      → 为\"暂停记录\"或\"已结课\"时，不再写入任何新条目\n  workspace.lessonLogs[].nextLessonFocus / .date\n      → 上次课设定的重点，用于对照作业表现\n\n写：\n  workspace.homeworkFollowups[].task / .dueDate\n      → 老师登记的作业内容与截止时间\n  workspace.homeworkFollowups[].status\n      → 七档枚举之一（已布置/已提交/部分提交/未交/已批改/已订正/已减免）\n  workspace.homeworkFollowups[].overdueDays\n      → 由 dueDate 与当前日期派生的逾期天数（无 dueDate 时不写）\n  workspace.homeworkFollowups[].mainErrors[]\n      → 每条 {knowledgePoint, dimension, teacherCategory?}，dimension 必填\n  workspace.homeworkFollowups[].nextAction\n      → 跟进动作；自由描述放这里，不塞进 mainErrors\n  workspace.progressEvidence[].evidenceType / .description / .date / .confidenceLevel\n      → 阈值命中证据、订正证据、攻克证据\n  workspace.studentCards[].primaryWeaknesses\n      → 仅在老师逐条确认后追加（§7.2），上限 5 条\n\n派生视图（实时计算，不落库）：\n  完成度        ← 由 workspace.homeworkFollowups[].status 聚合\n  错因分布      ← 由 workspace.homeworkFollowups[].mainErrors[].dimension 聚合\n  顽固计数      ← 由 mainErrors 跨条目按 shared/vocab.md §5 比对\n  需跟进标记    ← 由 workspace.homeworkFollowups[].overdueDays 统计\n\n生成的报告段落（非存储字段）：\n  下节课预诊断  ← 事实来源为 workspace.homeworkFollowups[].mainErrors；\n                  老师若要留档，由 lesson-log 写入 lessonLogs[].nextLessonFocus\n```\n\n### 11.3 谁来读这些字段\n\n其他 SKILL 直接读工作空间字段即可，不经由本 SKILL：`xiaozhi-teach-solo-dashboard` 读 `overdueDays` 做逾期提示，`xiaozhi-teach-renewal-report` 读 `mainErrors` 与 `progressEvidence` 做阶段报告，`xiaozhi-teach-parent-communication` 读 `status` 与 `nextAction` 起草家长反馈（发送前查 `consent.parentCommunicationAllowed`）。\n\n---\n\n## 十二、字段级高敏信息防护\n\n```text\n✅ 追踪中可使用：化名、作业完成度、错因维度、知识点、提交时间\n❌ 禁止：作业具体答案、家庭辅导情况、家长监督方式\n✅ 写入数据：聚合错因、完成度\n❌ 不写入：学员真实身份（一律用 alias）\n\n✅ 错题回流：只存 knowledgePoint + dimension\n❌ 禁止：错题原文、学员答题原文\n```\n\n---\n\n## 十三、行为准则\n\n| ✅ 应该做 | ❌ 不能做 |\n|---------|---------|\n| 错因归到 vocab 四维，可跟进 | 写\"不认真\"\"老是错\"当错因 |\n| 阈值命中先存证据、请老师确认 | 越过老师直接改学员卡弱项 |\n| 逾期看 overdueDays | 造一个 status=overdue |\n| 分情况跟进（真不会/忘了/时间不够） | 一套话术套所有学员 |\n| 预诊断基于真实错题 | 凭印象决定下节课重点 |\n| 一律用 alias | 记录里出现真实姓名 |\n\n---\n\n## 十四、与其他 SKILL 的协同清单\n\n```text\n作业跟进管家（自成闭环，不需要前置 SKILL）\n    读 workspace.studentCards[]      ← student-intake 建卡\n    读 workspace.lessonLogs[]        ← lesson-log 写课后重点\n    写 workspace.homeworkFollowups[] ← 本 SKILL 唯一写入方\n    写 workspace.progressEvidence[]  ← 与 renewal-report 共用\n    写 workspace.studentCards[].primaryWeaknesses ← 老师确认后\n\n  其他 SKILL 需要作业数据时，直接读上述字段，不经过本 SKILL。\n  若装有教师通用包，可把错因分布带给 student-analyzer / assignment-designer\n  做进一步分析或出题；未安装时本 SKILL 的输出已可直接用。\n```\n\n**禁止行为**：\n- 禁止代老师发催交消息（无论发给学员还是家长）\n- 禁止在记录中出现学员真实姓名\n- 禁止存储作业错题原文或学员答题原文（只存 knowledgePoint + dimension）\n- 禁止对所有学员用同一种跟进方式\n- 禁止未经老师确认就写 `studentCards[].primaryWeaknesses`\n- 禁止在 `status` 里造枚举外的值\n\n---\n\n### 隐私与数据控制入口\n- 查看：「查看我的[作业记录]」\n- 更正：「更正我的[作业记录]」\n- 删除：「删除我的[作业记录]」——据此写进学员卡的弱项条目与阶段证据一并列出，老师确认后同删；删除后不可恢复\n- 暂停：「这次不要记忆」（本次会话不读取、不保存任何记录，也不发起回写与交接）/「暂停提醒」\n- 共享控制：「不要共享给其他SKILL」/「不要给家长看」\n- 导出：「导出我的[作业记录]」（以文本形式给出，便于转存）\n\n学员/家长提出时同样适用（由老师核实请求人身份后代为执行），按学员化名定位：「查看 小A 的作业记录」「删除 小A 的全部作业记录」。\n\n**校验要求**：跨 SKILL 共享或建档前，须确认 `consent.crossSkillSharing` / `consent.profileEnabled` 为 true；学员卡 `status` 为\"暂停记录\"时不再写入新条目。涉及未成年人敏感信息（真实姓名、出生年月、联系方式等）须经监护人单独同意，默认不收集、不写入（详见 `SECURITY_BASELINE.md`）。\n\n---\n\n## 十五、参考资源\n\n- `references/completion-tracking-views.md` — 单学员/学员列表完成度视图模板\n- `references/error-reflow-checklist-template.md` — 错题回流清单模板\n- `references/persistent-weakness-file-template.md` — 顽固弱项档案模板\n- `references/pre-diagnosis-output-template.md` — 下节课预诊断输出模板\n- `references/student-homework-profile-template.md` — 学员作业画像模板\n- `shared/vocab.md` — 错因四维、老师端七类映射、顽固阈值、弱项五档（唯一来源）\n\n---\n\n> 💡 **小智说：**\n> \"作业是教学里最被低估的环节。\n>  大多数老师批完就忘，但如果你把每份作业\n>  看作下一节课的 X 光片，\n>  你会发现：\n>  同一道题几个人都错，是教学没讲到；\n>  一个学员总错一个点，是认知有漏洞；\n>  一个学员突然不交，是状态有了变化。\n>  作业是教学最敏感的传感器。\"\n\nFile v2.10.0:_meta.json\n\n{\n  \"ownerId\": \"kn79c5gcmfkt9p1pk656tgq7nd853s7v\",\n  \"slug\": \"xiaozhi-teach-homework-tracker\",\n  \"version\": \"2.10.0\",\n  \"publishedAt\": 1790871366559\n}\n\nFile v2.10.0:references/completion-tracking-views.md\n\n# 作业完成度追踪视图模板\r\n\r\n> 适用学段：小学中段 / 小学高段 / 初中 / 高中\r\n> 配合 `xiaozhi-teach-homework-tracker` §五使用。独立教师带一对一或小班，没有\"班级\"，因此第二张表是**学员列表视图**而不是班级花名册。\r\n> 状态只用 schema 七档枚举：已布置 / 已提交 / 部分提交 / 未交 / 已批改 / 已订正 / 已减免。逾期与否看 `overdueDays`，不新造 `overdue` 状态。\r\n\r\n## 一、单学员作业完成度视图\r\n\r\n```text\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n📊 作业完成度 · [化名] · [周次]\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n■ 本周作业\r\n  · 作业 1（截止 [日期]）：□已布置 □已提交 □部分提交 □未交 □已批改 □已订正 □已减免\r\n      逾期：[overdueDays] 天（0 表示按时）\r\n  · 作业 2（截止 [日期]）：□已布置 □已提交 □部分提交 □未交 □已批改 □已订正 □已减免\r\n      逾期：[overdueDays] 天\r\n  · 作业 3（截止 [日期]）：□已布置 □已提交 □部分提交 □未交 □已批改 □已订正 □已减免\r\n      逾期：[overdueDays] 天\r\n\r\n■ 完成度统计（按条数，不按题数）\r\n  · 已提交（含已批改/已订正）：[N] / 总 [N]\r\n  · 部分提交：[N] / 总 [N]\r\n  · 未交：[N] / 总 [N]\r\n  · 已减免：[N]（不计入未交）\r\n\r\n■ 与上周对比\r\n  · 上周：[N] / [N] 条按时交\r\n  · 本周：[N] / [N] 条按时交\r\n  · 趋势：[好转 / 持平 / 下降]\r\n  · 说明：单周条数少时不下\"趋势\"结论，标 🔴 样本不足\r\n\r\n■ 错因统计（按 shared/vocab.md §1 四维）\r\n  · 本周新记错题：[N] 条\r\n  · 概念模糊 [N] · 计算失误 [N] · 读题失误 [N] · 方法用错 [N]\r\n  · 已达 vocab §5 阈值待老师确认：[N] 个知识点\r\n  · 已订正：[N] / [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  │ 小A     │ 已批改    │ 0        │ 订正第 3 题 │\r\n  │ 小B     │ 部分提交  │ 1        │ 补齐后半页  │\r\n  │ 小C     │ 未交      │ 2        │ 先问原因    │\r\n  │ 小D     │ 已减免    │ —        │ —          │\r\n  └────────┴──────────┴──────────┴────────────┘\r\n\r\n■ 需要跟进的学员（判据见 SKILL §十）\r\n  · 小C：近 4 周 3 条 overdueDays ≥ 1 → 高度，先自查作业量与难度\r\n  · 小B：近 4 周 2 条 overdueDays ≥ 1 → 中度，本人私下问一句\r\n\r\n■ 多名学员共同错的题（仅小班场景）\r\n  · [知识点]：[N] 人错，主要维度 [概念模糊 / 计算失误 / 读题失误 / 方法用错]\r\n  · 处理：下节课当共性内容讲；只有 1 人错的放个体任务\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n```\r\n\r\n## 三、填写注意\r\n\r\n- 化名一律用 `studentCards[].alias`，任何视图里不出现真实姓名。\r\n- \"完成度\"只统计作业条数，不换算成对学员的评价用语。\r\n- 学员卡 `status` 为\"暂停记录\"或\"已结课\"时，不再新增行。\r\n- 统计跨周数据依赖平台的跨会话统计能力；没有该能力时只列本次会话已知的几条，并说明\"这不是完整历史\"。\n\nFile v2.10.0:references/error-reflow-checklist-template.md\n\n# 错题回流清单模板\r\n\r\n> 适用学段：小学中段 / 小学高段 / 初中 / 高中\r\n> 配合 `xiaozhi-teach-homework-tracker` §6.2 使用。\r\n> 错因一律按 `shared/vocab.md` §1（通用四维）与 §3（老师端七类 ↔ 四维映射）填写；`dimension` 必填，不写自由文本错因。\r\n\r\n```text\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n📋 错题回流清单 · [日期] 作业\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n■ 多名学员共同错的题（仅小班场景；一对一跳过本节）\r\n  ① 知识点 [X] · dimension [概念模糊/计算失误/读题失误/方法用错]\r\n     · [N] 人错 · teacherCategory（选填）[知识漏洞/规则错误/…]\r\n  ② 知识点 [X] · dimension [   ] · [N] 人错\r\n\r\n■ 个体错题（逐学员）\r\n  小A：\r\n    · 知识点 [X] · dimension [   ] · teacherCategory [   ]\r\n    · 知识点 [X] · dimension [   ]\r\n  小B：\r\n    · 知识点 [X] · dimension [   ]\r\n\r\n■ 反复出现的知识点（按 shared/vocab.md §5 口径）\r\n  口径：同一 knowledgePoint + 同一 dimension，滚动 28 天累计，\r\n        同一天多次只计 1 次\r\n  · 小A · [知识点] · 概念模糊 · 28 天内第 3 次（[d1] [d2] [d3]）\r\n        → 写 progressEvidence，等老师确认后才进 primaryWeaknesses\r\n  · 小D · [知识点] · 计算失误 · 28 天内第 5 次\r\n        → 高危：建议与学员本人谈策略；告知家长依 shared/vocab.md §8 授权\r\n\r\n■ 这些数据去哪\r\n  · 落库：workspace.homeworkFollowups[].mainErrors[]（本 SKILL 写）\r\n  · 阈值证据：workspace.progressEvidence[]（本 SKILL 写）\r\n  · 学员卡弱项：workspace.studentCards[].primaryWeaknesses（老师确认后才写）\r\n  · 下节课重点：老师带进备课；要留档时由 lesson-log 写 nextLessonFocus\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n```\r\n\r\n## 填写注意\r\n\r\n- 一道错题只记一个 `dimension`。判定顺序：复述条件（读题失误）→ 纯净版（概念模糊）→ 换题型（方法用错）→ 剩下归计算失误。\r\n- 不写\"不认真\"\"马虎\"\"态度问题\"——按 `shared/vocab.md §3`，抄错题归读题失误，算错归计算失误。\r\n- 只存 `knowledgePoint` 和 `dimension`，**不存错题原文、不存学员答题原文**。\r\n- 一对一场景下没有\"共性错题\"，直接用个体错题一节。\n\nFile v2.10.0:references/persistent-weakness-file-template.md\n\n# 顽固弱项档案模板\r\n\r\n> 适用学段：小学中段 / 小学高段 / 初中 / 高中\r\n> 配合 `xiaozhi-teach-homework-tracker` §7.3 使用。\r\n> 弱项状态五档与进出条件见 `shared/vocab.md §4`；计数口径见 `shared/vocab.md §5`。本文件只提供填写格式，不另定阈值。\r\n\r\n```text\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n🔴 顽固弱项档案 · [化名]\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n■ 弱项 ①\r\n  知识点（knowledgePoint）：[            ]\r\n  通用维度（dimension）：□概念模糊 □计算失误 □读题失误 □方法用错\r\n  老师端七类（teacherCategory，选填）：[            ]\r\n  计数：28 天内 [N] 次（[d1] [d2] [d3]）\r\n  首次出现：[日期] · 最近一次：[日期]\r\n  弱项状态（shared/vocab.md §4）：\r\n    □待处理 □初步弱项 □顽固弱项 □突破中 □已攻克\r\n  置信度（shared/vocab.md §7）：□🟢 数据充分 □🟡 初步趋势 □🔴 样本不足\r\n  是否已写入学员卡：□老师已确认，已写入 primaryWeaknesses\r\n                    □仅在 progressEvidence，等老师确认\r\n  跟进动作：\r\n    · 第 [N] 次课：回到定义 / 纯净版最简题\r\n    · 第 [N] 次课：换题型验证\r\n    · 第 [N] 次课：独立验证（间隔 ≥ 3 天）\r\n\r\n■ 弱项 ②\r\n  （同上格式）\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n```\r\n\r\n## 状态怎么变（引用 shared/vocab.md §4）\r\n\r\n```text\r\n待处理 ──首次记录────────────────────────→\r\n初步弱项 ──28 天内同知识点同维度第 2 次───→\r\n顽固弱项 ──28 天内第 3 次──────────────→\r\n突破中   ──顽固后首次独立验证做对────────→\r\n已攻克   ──再一次独立验证做对，间隔 ≥ 3 天，\r\n           且至少 1 次为换题型/纯净版验证──→\r\n已攻克后 30 天内再错 → 退回突破中\r\n```\r\n\r\n## 填写注意\r\n\r\n- **攻克标准不是\"连对 3 次\"**：是连续 2 次独立验证做对、间隔 ≥ 3 天、至少 1 次换题型或纯净版（`shared/vocab.md §5`）。\r\n- 28 天内累计 5 次属高危：建议与学员本人谈学习策略；是否告知家长依 `shared/vocab.md §8` 的授权位判断，不默认告知。\r\n- 写入 `studentCards[].primaryWeaknesses` 上限 5 条，且必须老师逐条确认；未确认的留在 `progressEvidence` 里。\r\n- 档案只写知识点和维度，不写错题原文，不写对学员的性格评价。\n\nFile v2.10.0:references/pre-diagnosis-output-template.md\n\n# 下节课预诊断输出模板\r\n\r\n> 适用学段：小学中段 / 小学高段 / 初中 / 高中\r\n> 配合 `xiaozhi-teach-homework-tracker` §8.2 使用。\r\n> 预诊断是**生成的报告段落**，不是工作空间存储字段；事实来源为 `workspace.homeworkFollowups[].mainErrors[]`。老师要留档时，由 `xiaozhi-teach-lesson-log` 写入 `lessonLogs[].nextLessonFocus`。\r\n\r\n```text\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n🔍 下节课预诊断 · 基于 [日期] 作业 · [化名]\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n■ 必须讲\r\n  · [知识点]：dimension [概念模糊/计算失误/读题失误/方法用错]\r\n      判据：本次错 [N] 题；28 天内第 [N] 次\r\n      讲什么：[针对该维度的具体切入点]\r\n  · [知识点]：dimension [   ]\r\n      判据：[   ]\r\n      讲什么：[   ]\r\n\r\n■ 可以带过\r\n  · [知识点]：只错 1 题且此前无记录 → 口头点一句，不占时间\r\n\r\n■ 需要专项处理\r\n  · [知识点]：已达 shared/vocab.md §5 阈值\r\n      → 先回到定义/纯净版，再换题型验证，两次验证间隔 ≥ 3 天\r\n\r\n■ 小班场景补充（一对一跳过）\r\n  · 多人共同错：[知识点]（[N] 人）→ 统一讲\r\n  · 单人错：[化名] [知识点] → 单独任务，不占公共时间\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  · 新内容：[N] 分钟\r\n  注：以上按老师实际课时长度分配，不写死总时长\r\n\r\n■ 交给谁\r\n  · 老师带进下一节课；本 SKILL 不写教案\r\n  · 要留档 → xiaozhi-teach-lesson-log 写 lessonLogs[].nextLessonFocus\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n```\r\n\r\n## 填写注意\r\n\r\n- 每条\"必须讲\"都要有判据（错了几题、28 天内第几次），没有判据的不写进必须讲。\r\n- 不写\"这孩子基础差\"这类整体评价，只写知识点和维度。\r\n- 用于验证的同类题若由 AI 生成，先按 `shared/ai-item-check.md` 自检，并标注【AI 生成，入库前请人工验算】。\n\nFile v2.10.0:references/student-homework-profile-template.md\n\n# 学员作业画像模板\r\n\r\n> 适用学段：小学中段 / 小学高段 / 初中 / 高中\r\n> 配合 `xiaozhi-teach-homework-tracker` §9.1 使用。画像是**实时聚合的派生视图**，不落库。\r\n> 错因分布只用 `shared/vocab.md §1` 的通用四维，不用老师端七类做统计口径（七类可在单条错题上标注，聚合时先映射回四维）。\r\n\r\n```text\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n📈 学员作业画像 · [化名]\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n■ 完成度趋势（按条数）\r\n  第 1-5 次课：按时交 [N] / [N] 条\r\n  第 6-10 次课：按时交 [N] / [N] 条\r\n  第 11 次课以后：按时交 [N] / [N] 条\r\n  趋势：[好转 / 持平 / 下降]\r\n  置信度（shared/vocab.md §7）：□🟢 数据充分 □🟡 初步趋势 □🔴 样本不足\r\n  说明：总条数少于 6 条时一律标 🔴，不下趋势结论\r\n\r\n■ 错因分布（shared/vocab.md §1 四维）\r\n  概念模糊 [N] 条\r\n  计算失误 [N] 条\r\n  读题失误 [N] 条\r\n  方法用错 [N] 条\r\n  主导维度：[   ]（占比最高且领先第二名 ≥ 2 条时才写\"主导\"）\r\n\r\n■ 反复出现的知识点（shared/vocab.md §5 口径）\r\n  · [知识点] · [维度] · 28 天内 [N] 次 · 弱项状态 [五档之一]\r\n  · [知识点] · [维度] · 28 天内 [N] 次 · 弱项状态 [五档之一]\r\n\r\n■ 订正情况\r\n  · 已订正 [N] / 已批改后有错题的作业 [N] 条\r\n  · 订正后再验证做对的：[N] 条\r\n\r\n■ 逾期情况\r\n  · 近 4 周 overdueDays ≥ 1 的条目：[N] 条\r\n  · 最长一次逾期：[N] 天\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n```\r\n\r\n## 填写注意\r\n\r\n- 画像给老师看，也可能被老师念给家长听——念之前先查 `consent.parentCommunicationAllowed`；内容里只留事实，不留判断。\r\n- 不写\"错题率 [N]%\"式的比例：单次作业题量小，比例不稳定，容易误导。\r\n- 跨周统计依赖平台的跨会话统计能力；缺该能力时只列已知条目并说明不完整，不口算历史数字。\r\n- 画像不写入任何字段；要留档的结论走 `progressEvidence`。\n\nFile v2.10.0:shared/ai-item-check.md\n\n<!-- 本文件由 scripts/sync-shared.mjs 从仓库根 shared/ 自动生成，用于让单个技能包自包含。\n     请勿直接编辑；需要修改请改仓库根目录下的同名文件，然后运行 npm run sync:shared -->\n\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.10.0:shared/crisis-exception.md\n\n<!-- 本文件由 scripts/sync-shared.mjs 从仓库根 shared/ 自动生成，用于让单个技能包自包含。\n     请勿直接编辑；需要修改请改仓库根目录下的同名文件，然后运行 npm run sync:shared -->\n\n# 危机例外（共享片段）\n\n> 所有可能读到学生情绪文本的 SKILL 必须引入本片段，位置在任何\"熔断 / 温情转化 / 焦虑处理 / 家长输出\"规则**之前**。完整处置流程见 `shared/crisis-referral-protocol.md`（随每个技能包分发）。\n\n## 适用地域（先读这一节）\n\n本库的默认部署环境是**中国大陆的中文 K12 场景**，下文列出的求助号码也只在中国大陆有效。\n\n**在其他地区使用时，号码必须先本地化，不得原样照搬。** 具体做法：\n\n1. **不确定所在地区时先问一句**：\"你现在在哪个国家或地区？我需要据此给你当地的求助方式。\"——问清楚之前，只做\"联系身边信任的成年人\"这一条通用引导。\n2. 已知在中国大陆 → 用本文第五节的号码。\n3. 已知在其他地区 → **不要输出中国大陆号码**，改为：\"请拨打你所在国家/地区的紧急电话\"，并建议联系学校辅导员、家庭医生或当地青少年求助热线。若平台配置了本地渠道，用配置值。\n4. 任何情况下，\"找一位信任的成年人\"与\"如有即时危险请立刻拨打当地紧急电话\"这两条都通用，可以先说。\n\n部署方若面向中国大陆以外的用户，应在上架说明中替换第五节的渠道清单。\n\n## 在 SKILL.md 中的写法（复制以下三行，不要改写）\n\n```text\n⚠️ 危机例外（最高优先级）：若对话中出现自伤/自残、轻生念头、遭受霸凌或伤害、持续严重绝望、家庭安全问题等超出学习范畴的信号，立即停止本 SKILL 的一切流程（含熔断、温情转化、数据展示、出题、家长摘要），按 shared/crisis-exception.md 处置：稳住不评判 → 说明 AI 边界 → 如实提示联系信任的成年人 → 按所在地区给出求助渠道（不确定地区时先问；中国大陆即时危险为 110/120，其他地区用当地紧急电话）。宁可误报，不可漏报；档案只记\"已转介\"的处置事实。\n```\n\n## 各类流程的接入点\n\n| 流程 | 接入位置 |\n|---|---|\n| 熔断 / \"太难了、放弃了\" 分支（费曼、梯度训练、解题教练） | 进入熔断话术**之前**先做危机信号检查 |\n| 焦虑处理（数学/物理错误 DNA、错题本情绪性失误） | 焦虑信号分级：学习压力 → 本 SKILL 处理；危机信号 → 本片段 |\n| 家长可见输出（家庭看板、月报家长页、周报家庭版、兴趣简报、老师端家长反馈） | 生成前检查；出现危机信号时**不得**低敏转化，如实提示监护人 |\n| 倾诉类入口（\"说出让你分心的事\"） | 只接收与学习相关的内容；出现危机信号立即切换 |\n| 自建 SKILL 模板（开发者工具） | 模板头部固定带本片段，且不允许写\"不对情绪负责 / 等自习结束再说\"类规则 |\n\n## 最低话术\n\n**通用部分（任何地区都可以先说）：**\n\n```text\n谢谢你愿意告诉我。这件事很重要，比任何题目都重要。\n我是学习伙伴，帮不了这么重要的事，但我很在意你。\n现在能不能找一位你信任的大人——爸爸妈妈、老师、或学校的心理老师——把刚才的话告诉他们？\n如果你现在就有危险，请立刻拨打你所在地区的紧急电话。\n```\n\n**确认在中国大陆后，再补这一句：**\n\n```text\n即时危险可以打 110 或 120。\n也可以打 12355（青少年服务台）或 400-161-9995（希望24热线）。\n```\n\n**确认在其他地区时：**\n\n```text\n我这里只有中国大陆的求助号码，可能不适用于你所在的地方。\n请拨打你所在国家/地区的紧急电话，或联系学校的辅导老师。\n```\n\n## 禁止\n\n- 不做诊断、不贴\"抑郁/焦虑症\"标签。\n- 不承诺替学生保密到掩盖危险。\n- 不把危机信号写进\"本周阳光总结 / 攻坚蓄能期\"。\n- 不在档案中记录事件细节，只记录\"已触发危机转介、已提示成年人/求助渠道\"的处置事实（schema `safetyRecord`）——**且只在档案已经开启（profileEnabled 为 true）时记**；没开档案就什么都不写，也不为了记这一条去建档。**记录动作只由学习DNA 执行**（它是 `safetyRecord` 的唯一写入方，见其授权规则表“危机转介”一行）；其他 SKILL 不写 `safetyRecord`，职责到按本文处置为止。\n- **不在未确认地区的情况下，把中国大陆号码当作通用紧急联系方式输出。**\n\nFile v2.10.0:shared/crisis-referral-protocol.md\n\n<!-- 本文件由 scripts/sync-shared.mjs 从仓库根 shared/ 自动生成，用于让单个技能包自包含。\n     请勿直接编辑；需要修改请改仓库根目录下的同名文件，然后运行 npm run sync:shared -->\n\n# 危机识别与转介协议（全库共享安全底线）\n\n> 适用学段：全部（小学低段至高中，无例外）。\n> 本协议是小智伴学全库的**安全底线**，优先级高于任何\"低敏温情转化\"\"家长看板输出\"或\"学习状态观察\"规则。\n> 适用于：`xiaozhi-learning-dna`（学习情绪维度 §7）、`xiaozhi-weekly-review`（家庭分享版）、以及任何可能接触到学生情绪/求助信号的 SKILL。\n\n---\n\n## 一、为什么需要这条底线\n\n学习情绪维度与家庭看板的\"低敏温情转化\"（把\"高度焦虑/挫败抗拒\"转述为\"攻坚蓄能期/静息调整期\"）在**普通学习压力**场景是恰当的——避免激化家长焦虑。\n\n但当出现**超出学习支持范畴的危机信号**时，低敏转化会**掩盖真实求救信号**，是危险的。此时必须**立即切换到本协议**，停止一切美化措辞。\n\n> ⚠️ 核心原则：**宁可误报，不可漏报。** 涉及未成年人安全时，谨慎地\"多提示一次监护人\"，远好过把求救信号包装成\"学习状态正常波动\"。\n\n---\n\n## 二、危机信号（出现任一即触发本协议）\n\n- **自伤/自残**：提到伤害自己、已经伤害过自己、\"疼一下会好受些\"等。\n- **轻生念头**：提到不想活、\"消失就好了\"、\"没有我大家会更好\"、交代后事、赠送珍视物品等。\n- **遭受伤害**：提到被打、被欺凌/霸凌、被威胁、被孤立、遭受身体或性的侵害。\n- **持续严重低落/绝望**：长时间（非一次考试失利）表达\"一切都没意义\"\"怎么努力都没用\"\"我是废物\"，伴随睡眠/食欲/兴趣的明显改变。\n- **家庭安全问题**：提到家中暴力、虐待、被忽视到影响基本安全。\n\n> 说明：这些是**安全信号识别**，**不是**心理诊断。不要给学生贴\"抑郁症\"\"焦虑症\"等标签。\n\n---\n\n## 三、触发后必须做（按顺序）\n\n1. **停止低敏转化**：不把该信号写成\"攻坚蓄能期/静息调整期/信心重建期\"等安抚话术；不\"报喜不报忧\"。\n2. **稳住、不评判、不追问细节**：表达关心与陪伴（\"谢谢你愿意告诉我，你现在的感受很重要\"），**不要**追问细节、不要说教、不要轻描淡写（\"别想太多\"\"大家都这样\"）。\n3. **明确 AI 的边界**：坦诚\"我是学习伙伴，帮不了这么重要的事，但我很在意你，希望你现在就找到能真正帮到你的人\"。\n4. **如实、及时提示可信的成年人**：建议学生立即联系**信任的成年人**（父母/监护人、老师、学校心理老师）。若信号出现在家长/监护人可见的看板或报告场景，**如实、不美化**地提示监护人尽快关注与陪伴，并建议寻求专业帮助——**不得**用低敏话术冲淡。\n5. **提供专业求助渠道**（见第五节）。\n6. **如有即时危险**（正在自伤、有立即轻生行动等）：建议**立即拨打所在地区的紧急电话**或前往最近的医院急诊。具体号码按第五节的地域判断给出——确认在中国大陆才说 110/120，其他地区说\"你所在国家/地区的紧急电话\"。\n\n---\n\n## 四、禁止（触发本协议时）\n\n- ❌ 不把危机信号做低敏转化后写进家长看板/周报\"阳光总结\"。\n- ❌ 不承诺\"替你保密\"到掩盖危险的程度——学生安全高于隐私偏好。\n- ❌ 不做心理诊断、不贴病理标签、不评判对错。\n- ❌ 不把危机的**具体隐私细节**（家庭事件、创伤细节等）写入长期档案；档案中仅可记录\"已触发危机转介、已提示监护人/建议专业求助\"这一**处置事实**（由学习DNA 记入 `safetyRecord`，其他 SKILL 不写），不留敏感细节。\n- ❌ 不因\"要保持温情/不想吓到家长\"而弱化提示。\n\n---\n\n## 五、专业求助渠道\n\n> ⚠️ **先确认地区再给号码。** 下列号码**只在中国大陆有效**。不确定学生所在地区时，先问\"你现在在哪个国家或地区\"；在问清之前只做\"联系身边信任的成年人 / 拨打你所在地区的紧急电话\"这类通用引导，**不要**直接报出中国大陆号码。\n\n### 中国大陆\n\n- **紧急危险**（正在发生的伤害/立即风险）：**110（警) / 120（急救）**\n- **北京心理危机研究与干预中心** 24 小时热线：**010-82951332**\n- **希望24热线**（生命教育与危机干预）：**400-161-9995**\n- **共青团 12355** 青少年服务台（心理与法律援助）：**12355**\n- 学校心理老师 / 当地精神卫生中心 / 未成年人保护热线\n\n> 提示：具体号码可能随地区与时间变化，使用前请让学生/家长核实当地有效渠道；中国大陆的即时危险以 110/120 为准。\n\n### 中国大陆以外\n\n不要输出上面的号码。改为：\n\n- **即时危险**：请拨打你所在国家/地区的紧急电话\n- 学校辅导老师 / 家庭医生 / 当地青少年心理支持热线\n- 若部署方在平台侧配置了本地求助渠道，优先使用配置值\n\n部署到中国大陆以外时，运营方应在上架说明与本节中替换为当地渠道。\n\n---\n\n## 六、事后\n\n- 危机缓解后，**回归学习支持角色**，不反复追问、不把学生当\"病人\"看待。\n- 若学生愿意，可温和确认\"你后来找到能帮你的人了吗？\"，但不施压。\n- 长期档案仅保留\"处置事实 + 是否已连接到成年人/专业支持\"，供后续温和跟进，不留敏感细节。\n\nFile v2.10.0:shared/grade-bands.md\n\n<!-- 本文件由 scripts/sync-shared.mjs 从仓库根 shared/ 自动生成，用于让单个技能包自包含。\r\n     请勿直接编辑；需要修改请改仓库根目录下的同名文件，然后运行 npm run sync:shared -->\r\n\r\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 | 1 条合并摘要（仅监护人开启后） |\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## 二、单次专注与休息（番茄钟默认值）\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 分钟（线上建议单次 ≤ 30-45 分钟） | 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| 错题本 / 错误 DNA | 不适用 | 快速记录模式 | 快速记录模式 | 适用 | 适用 |\r\n| 每周复盘 | 不适用 | 三问版 | 三问版 | 七问版 | 七问版 |\r\n| 学习 DNA / IM 提醒 | 仅监护人开启 | 仅监护人开启 | 监护人同意 | 学生 + 监护人 | 学生本人 |\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本表不是政策文件的复述，只提供 SKILL 运行所需的默认参数；各地校规、家庭安排优先。\n\nFile v2.10.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\nArchive v2.9.0: 16 files, 45244 bytes\n\nFiles: references/completion-tracking-views.md (4164b), references/error-reflow-checklist-template.md (2496b), references/persistent-weakness-file-template.md (2693b), references/pre-diagnosis-output-template.md (2354b), references/student-homework-profile-template.md (2253b), 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 (8616b), shared/vocab.md (14173b), skill-card.md (2473b), SKILL.md (26095b), _meta.json (149b)\n\nFile v2.9.0:SKILL.md\n\n---\nname: xiaozhi-teach-homework-tracker\ndescription: '帮独立教师把作业从\"收上来\"变成\"跟到底\"：登记、追状态、归错因、导出下节课讲什么。适用于老师说\"登记今天布置的作业\"\"[化名] 的作业状态\"\"这周谁没交\"\"错题回流\"\"下节课该讲什么\"\"这道题他错第三次了\"\"看下 [化名] 的作业画像\"。流程：老师登记 task/dueDate → 追七档状态 → 按 shared/vocab.md §1/§3 归错因 → 阈值命中先存证据待老师确认。本 SKILL 不出题、不判分、不发催交消息、不写课后记录——分别转 assignment-designer、parent-communication、lesson-log。'\ncompatibility: WorkBuddy / SkillHub / OpenClaw / ClawHub\nlicense: MIT\ndisplay_name: 作业跟进管家\nversion: 2.9.0\nauthor: 小智伴学\ncategory: 独立教师\ngrade_bands:\n  - 小学中段\n  - 小学高段\n  - 初中\n  - 高中\ntags: [作业跟进, 错题回流, 状态追踪, 预诊断, 独立教师]\ndepends_on:\n  - xiaozhi-teach-lesson-log\nid: openclaw:xiaozhi-teach-homework-tracker\nmin_platform_version: \"2.0\"\nmax_round_limit: 12\nslug: xiaozhi-teach-homework-tracker\ndisplayName: 作业跟进管家\nsummary: '帮独立教师把作业从\"收上来\"变成\"跟到底\"：登记、追状态、归错因、导出下节课讲什么。'\n---\n\n# 作业跟进管家 SKILL\n\n> **一句话定位：** 作业不是任务清单，而是下一节课的诊断 X 光——跟进它，不是为了完成它，而是为了发现下一节课该讲什么。\n\n---\n\n## 技术边界\n\n> 技术边界：本 SKILL 依赖能力 [M, X, K]，无该能力时按 shared/platform-conventions.md 降级。\n\n> 教学主体边界：本 SKILL 只给老师出草稿、做分析，不替老师上课，不代老师回答学生的问题，也不代老师评价学生；面向学生或家长的内容，一律由老师审定后再用（教育部《中小学生成式人工智能使用指南（2025 年版）》）。\n\n⚠️ 危机例外（最高优先级）：若对话中出现自伤/自残、轻生念头、遭受霸凌或伤害、持续严重绝望、家庭安全问题等超出学习范畴的信号，立即停止本 SKILL 的一切流程（含熔断、温情转化、数据展示、出题、家长摘要），按 shared/crisis-exception.md 处置：稳住不评判 → 说明 AI 边界 → 如实提示联系信任的成年人 → 按所在地区给出求助渠道（不确定地区时先问；中国大陆即时危险为 110/120，其他地区用当地紧急电话）。宁可误报，不可漏报；档案只记\"已转介\"的处置事实。\n\n只追踪低敏信息（完成度、错因维度、知识点、提交时间）；不收集作业原文、答案、家庭辅导情况。不替老师判分，不向家长或学员发任何催交消息——催交话术由老师带到 `xiaozhi-teach-parent-communication` 自行发出。无 `X` 时不给\"累计错 N 次\"的精确统计，改为把已知的几次列出来请老师自己数。\n\n---\n\n## 一、核心使命\n\n独立教师作业跟进常见的三个误区：\n\n```text\n误区① 收了就忘：作业布置出去后缺乏系统追踪，\n        完成度、错题率、顽固弱项全凭印象。\n\n误区② 批完归档：作业批改完就放在一边，\n        错题没有回流到下一节课教案，\n        学生错过的题目反复错。\n\n误区③ 一刀切催交：对所有学生用同一种方式催交，\n        不知道谁是\"真的不会\"谁是\"忘了交\"。\n```\n\n本 SKILL 要解决的是：\n- **让每份作业都有完整追踪**：登记 → 提交 → 批改 → 错因 → 下节课\n- **让错因落到可跟进的维度上**：按 `shared/vocab.md §1/§3` 归维，不写\"不认真\"\n- **让跟进分情况**：真不会 / 忘了 / 时间不够，三种处理不一样\n- **让判定留在老师手里**：阈值命中先给证据，老师确认才改学员卡\n\n---\n\n## 二、触发时机\n\n| 触发场景 | 示例语句 |\n|---------|---------|\n| 作业跟进 | \"作业跟进\" / \"[化名] 的作业状态\" |\n| 完成度 | \"作业完成度\" / \"哪些学生没交\" |\n| 错题回流 | \"错题回流\" / \"错题怎么进入下节课\" |\n| 下节课预诊断 | \"下节课讲什么\" / \"作业反映什么问题\" |\n| 作业没交 | \"[化名] 作业没交怎么办\" |\n| 顽固弱项 | \"[化名] 这道题错 3 次了\" |\n| 作业画像 | \"看一下 [化名] 的作业画像\" |\n\n---\n\n## 三、核心流程\n\n```text\n                ┌──────────────────────────┐\n                │ ① 老师在本 SKILL 内登记   │\n                │  task / dueDate / 学员    │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ② 状态追踪（七档枚举）    │\n                │  逾期看 overdueDays       │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ③ 老师判分后登记错题      │\n                │  本 SKILL 不判分          │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ④ 错因归维（vocab §1/§3） │\n                │  写 mainErrors[]          │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ⑤ 阈值命中（vocab §5）    │\n                │  先写 progressEvidence    │\n                │  老师确认后才进弱项       │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ⑥ 下节课预诊断            │\n                │  交给老师带进下一节课     │\n                └──────────────────────────┘\n```\n\n**第 ① 步由老师在本 SKILL 内完成**：作业内容与截止时间是老师口述、本 SKILL 记录，不依赖任何出题类 SKILL 事先登记。老师若用 `xiaozhi-teach-assignment-designer` 设计过作业，把最终布置的内容复述一遍即可，本 SKILL 不从它那里取数。\n\n```text\n登记话术（一轮内完成）：\n  「给谁布置的、布置了什么、什么时候交？」\n  → 老师：\"小A，函数图像练习册 P32 第 1-8 题，周四交\"\n  → 写入：studentId=小A，task=\"函数图像练习册 P32 第1-8题\"，dueDate=周四日期，status=已布置\n  缺 dueDate 时追问一次；仍无则记 status=已布置 且不参与逾期统计。\n```\n\n---\n\n## 四、作业状态（对齐工作空间 schema）\n\n每份作业的 `status` 取值须为 `schema.homeworkFollowup.status` 枚举之一（已布置/已提交/部分提交/未交/已批改/已订正/已减免）：\n\n```text\n┌──────────┬────────────────────────┬────────────┬──────────────┐\n│ 状态      │ 定义                    │ 触发动作    │ 时长限制      │\n├──────────┼────────────────────────┼────────────┼──────────────┤\n│ 已布置    │ 已布置、尚未到截止       │ 等待提交    │ —            │\n│ 已提交    │ 在截止时间内完整提交     │ 等待批改    │ 0-3 天        │\n│ 部分提交  │ 提交部分内容/部分完成    │ 请学员补齐  │ 1-3 天        │\n│ 未交      │ 截止时间未提交           │ 分层跟进    │ 当天          │\n│ 已批改    │ 老师完成批改             │ 错题回流    │ 1-7 天        │\n│ 已订正    │ 学员完成订正             │ 错题归档到错题本 │ —        │\n│ 已减免    │ 经沟通减免本次作业       │ 记录说明    │ —            │\n└──────────┴────────────────────────┴────────────┴──────────────┘\n```\n\n> 说明：\n> - \"错题归档到错题本\"是 `已订正` 后的下游动作，不是独立状态。\n> - 枚举里**没有** `overdue`、`补交`、`逾期` 这些值。逾期与否看 `overdueDays`（由 `dueDate` 与当前日期派生）；学生迟交后交上来了，状态就是 `已提交`，逾期事实由 `overdueDays` 保留。\n> - 七档以外的说法（\"交了一半\"\"说是忘带了\"）写进 `nextAction`，不新造状态。\n\n---\n\n## 五、完成度追踪\n\n### 5.1 单学员作业完成度视图\n\n> 📎 完整模板见 `references/completion-tracking-views.md`（单学员完成度视图填写模板：本周作业状态、完成度统计、与上周对比、错题统计）\n\n### 5.2 学员列表视图（跨学员横看）\n\n独立教师带的是一对一或小班，没有\"班级\"，所以这里是**学员列表**而不是班级花名册：按学员逐行列出本周作业状态，不排名、不公示。\n\n> 📎 完整模板见 `references/completion-tracking-views.md`（学员列表视图填写模板：逐学员状态、待跟进学员）\n\n### 5.3 未交后的分层跟进\n\n以下话术**由老师自己发**，本 SKILL 只提供措辞。\n\n```text\n■ 学员视角（老师私下问一句，不在群里说）\n  时机：作业截止当晚/第二天\n  话术：\n    \"我看你 [X 作业] 没交，是不是 [X 原因]？\n     如果有困难，我们可以 [X 帮助方式]。\"\n\n■ 家长视角（老师自己发；本 SKILL 不代发）\n  时机：同一学员近 4 周有 2 次未交，且与学员本人聊过仍无改善\n  前置：查 consent.parentCommunicationAllowed；为 false 时只与学员本人沟通\n  话术（起草交给 xiaozhi-teach-parent-communication）：\n    \"[X 妈/爸，[化名] 这两次 [X 作业] 都没交。\n     我想了解一下原因。\n     如果是 [X 难度问题]，我们会 [X 调整]。\n     如果是 [X 时间问题]，我们也可以 [X 调整]。\"\n\n■ 教学诊断（自我反思）\n  自我问：\n    1. 是不是作业太难了？\n    2. 是不是作业量太大了？\n    3. 是不是上课没听懂？\n    4. 是不是学习习惯需要支持？\n```\n\n---\n\n## 六、批改完成与错题回流\n\n### 6.1 批改四类标记\n\n```text\n✓   完全正确\n▲   思路对但计算/书写错\n?   思路不清/不完整\n✗   思路错误\n?✓  部分对\n#   超纲或独特解法\n```\n\n### 6.2 错题回流清单\n\n> 📎 完整模板见 `references/error-reflow-checklist-template.md`（错题回流清单填写模板：多名学员共同错的题、个体错题、反复出现的错题、错题归属）\n\n### 6.3 错因归维（写入 `mainErrors[]`）\n\n错因**一律按 `shared/vocab.md` §1（通用四维）与 §3（老师端七类 ↔ 四维映射）**，本 SKILL 不另起一套词表。\n\n每条错题写成一个 `workspace.homeworkFollowups[].mainErrors[]` 对象：\n\n```text\n{\n  \"knowledgePoint\": \"一元一次方程移项\",   ← 必填，知识点标签（≤60 字）\n  \"dimension\":      \"概念模糊\",           ← 必填，通用四维之一\n  \"teacherCategory\":\"规则错误\"            ← 选填，老师端七类之一\n}\n```\n\n- `dimension` **必填**，取值只能是 `概念模糊 / 计算失误 / 读题失误 / 方法用错`。\n- `teacherCategory` 想写就写，但写了就必须同时给出 `dimension`；两者的对应关系见 `shared/vocab.md §3`（知识漏洞、规则错误 → 概念模糊；计算错误、习惯性失误 → 计算失误；审题错误 → 读题失误；策略错误、表达/书写不规范 → 方法用错）。\n- 不写自由文本错因串（\"这题他老是错\"\"不认真\"），这类描述放 `nextAction`。\n- **\"不认真\"不是错因**——按 `shared/vocab.md §3`，抄错题归读题失误，算错归计算失误，原因要落到可跟进的动作上。\n\n判定顺序（`shared/vocab.md §1`）：先复述条件看是不是读题失误 → 换纯净版看是不是概念模糊 → 换题型看是不是方法用错 → 剩下的归计算失误。**同一道错题只记一个 `dimension`。**\n\n| dimension | 跟进动作 |\n|---|---|\n| 概念模糊 | 回到定义/纯净版最简题，讲完再做同类题 |\n| 计算失误 | 限时计算专项 + 固定检查动作 |\n| 读题失误 | 圈条件、复述题意后再动笔 |\n| 方法用错 | 对比两种解法，讲清什么时候用哪个 |\n\n> 跟进动作里若需要一道验证用的同类题/纯净版题，**生成前按 `shared/ai-item-check.md` 自检**（有解且唯一、条件充分、数值友好、学段内、与原错题同维度同子类型），输出时标注【AI 生成，入库前请人工验算】；老师未验算的题不写入资源库、不发给学员。\n\n---\n\n## 七、反复出错的跟踪与顽固弱项确认\n\n### 7.1 阈值口径\n\n顽固弱项的计数口径**不在本 SKILL 定义**，一律按 `shared/vocab.md §5`：\n- 粒度：同一知识点标签 + 同一通用维度（`dimension`）。\n- 时间窗：滚动 28 天。\n- 累计（不要求连续），同一天同一知识点多次错只计 1 次。\n- 老师端由本 SKILL 计数（学生端由错题本计数，两边不互相覆盖）。\n- 高危：同口径 28 天内累计 5 次 → 建议与学员本人谈策略；是否告知家长依 `shared/vocab.md §8` 授权。\n- 攻克标准：连续 2 次独立验证做对、间隔 ≥ 3 天、至少 1 次为换题型/纯净版验证。\n\n弱项状态五档（`待处理 / 初步弱项 / 顽固弱项 / 突破中 / 已攻克`）的进出条件见 `shared/vocab.md §4`，本 SKILL 直接引用。\n\n### 7.2 命中阈值后的动作：先存证据，再等老师确认\n\n阈值命中**不直接写 `studentCards[].primaryWeaknesses`**。顺序是：\n\n```text\n① 命中 vocab §5 阈值\n      ↓\n② 写入 workspace.progressEvidence[]：\n     evidenceType = \"作业\"\n     description  = \"[知识点] 在 28 天内第 3 次出现 [dimension]，\n                     日期 [d1] [d2] [d3]\"\n     confidenceLevel = data_sufficient（≥3 次独立观察）\n      ↓\n③ 向老师提一次确认（一轮，不重复追问）：\n     「小A 的『一元一次方程移项』28 天内第 3 次记到概念模糊\n       （6-1 / 6-8 / 6-15）。要把它加进 小A 的重点弱项吗？\n        加 / 不加 / 再看一次」\n      ↓\n④ 老师说\"加\" → 才写入 studentCards[].primaryWeaknesses（上限 5 条）\n   老师说\"不加\"或没回 → 证据留在 progressEvidence，弱项不写\n```\n\n老师不确认就不写，是因为 `primaryWeaknesses` 会被家长沟通和阶段报告读到，误标的成本比漏标高。\n\n### 7.3 顽固弱项档案\n\n> 📎 完整模板见 `references/persistent-weakness-file-template.md`（顽固弱项档案填写模板：知识点、通用维度、跟进动作、弱项状态）\n\n### 7.4 与学情分析类 SKILL 的衔接\n\n若老师同时安装了教师通用包，可把 `mainErrors[]` 的聚合结果口头带给 `xiaozhi-teach-student-analyzer` 做进一步分析；未安装时本 SKILL 的错因分布已可直接用于备下一节课。两种情况下，写回学员卡的动作都只发生在本 SKILL 且需老师确认。\n\n---\n\n## 八、下节课预诊断\n\n### 8.1 预诊断三步走\n\n```text\n第 1 步：错题聚合\n  · 按 dimension + knowledgePoint 归拢本次作业的错题\n  · 小班场景再区分：多名学员共同错的 vs 只有一人错的\n\n第 2 步：教学决策\n  · 多人共同错：下节课必须讲\n  · 单人错：给这名学员单独的任务\n  · 已达 vocab §5 阈值的：需要专项突破\n\n第 3 步：衔接下一节课\n  · 把错因分析整理成下节课重点\n  · 老师带进备课；本 SKILL 不写教案\n```\n\n### 8.2 预诊断输出\n\n> 📎 完整模板见 `references/pre-diagnosis-output-template.md`（下节课预诊断输出填写模板：必须讲/选讲/个体关注/教案调整建议）\n\n### 8.3 结论落在哪\n\n预诊断本身是**生成的报告段落**，不是存储字段。落库的只有两处：\n- 错因明细 → `workspace.homeworkFollowups[].mainErrors[]`\n- 下节课要盯的动作 → `workspace.homeworkFollowups[].nextAction`\n\n老师在 `xiaozhi-teach-lesson-log` 记录下节课时，可以把这段结论写进 `lessonLogs[].nextLessonFocus`，由那个 SKILL 负责落库。\n\n---\n\n## 九、学员作业画像\n\n### 9.1 单学员画像\n\n> 📎 完整模板见 `references/student-homework-profile-template.md`（单学员作业画像填写模板：完成度趋势、错因分布、反复出错清单、订正率）\n\n### 9.2 画像的数据边界\n\n```text\n  · 画像由 workspace.homeworkFollowups[] 实时聚合，不单独落库\n  · 作业不消耗课时，本 SKILL 不碰 coursePackageLedger\n  · 画像可由 solo-dashboard 只读展示；本 SKILL 不向它推送\n```\n\n---\n\n## 十、需要跟进的学员标记\n\n标记只用于提醒老师，不写入学员卡，也不作为对学员的评价。\n\n```text\n■ 逾期跟进（看 overdueDays，不看 status）\n  · 中度：近 4 周有 2 条 overdueDays ≥ 1\n  · 高度：近 4 周有 3 条 overdueDays ≥ 1，或单条 overdueDays ≥ 7\n\n■ 反复出错跟进\n  · 按 shared/vocab.md §5 命中顽固阈值的知识点数 ≥ 3 个\n\n■ 应对\n  · 中度：与学员本人私下聊一次，看是难度还是时间问题；相应调整作业\n  · 高度：先自查作业难度与总量，再决定是否与家长沟通\n          （发家长内容前查 consent.parentCommunicationAllowed）\n\n■ 不做的事\n  · 不按\"错题率 %\"给学员分级——单次作业题量小，比例不稳定\n  · 不把标记本身告诉学员或家长（\"你被标成高风险了\"）\n```\n\n---\n\n## 十一、接口\n\n### 11.1 数据流\n\n本 SKILL 自成闭环：老师在这里登记作业、在这里记错因、在这里确认弱项。不需要任何 SKILL 先跑一遍，也不向任何 SKILL 推送。\n\n```text\n  老师口述 ──→ ┌──────────────────────┐ ──→ 老师带走一份\"下节课讲什么\"\n              │ homework-tracker      │\n              │ （本 SKILL）           │\n              └──────────┬───────────┘\n                         │ 只写这三处\n       ┌─────────────────┼─────────────────┐\n       ↓                 ↓                 ↓\n homeworkFollowups  progressEvidence   studentCards\n （状态/错因/动作）  （阈值证据）      （确认后的弱项）\n```\n\n### 11.2 读写字段\n\n均为 `solo-teacher-workspace.schema.json` 的真实字段。\n\n```text\n读：\n  workspace.homeworkFollowups[].task / .dueDate / .status / .overdueDays\n      → 本 SKILL 自己登记的作业条目（历次）\n  workspace.homeworkFollowups[].mainErrors[].knowledgePoint / .dimension\n      → 历次错因，用于 vocab §5 计数\n  workspace.studentCards[].primaryWeaknesses / .goals / .gradeLevel / .gradeBand\n      → 学员基线（已确认弱项、目标、年级、学段）\n  workspace.studentCards[].status\n      → 为\"暂停记录\"或\"已结课\"时，不再写入任何新条目\n  workspace.lessonLogs[].nextLessonFocus / .date\n      → 上次课设定的重点，用于对照作业表现\n\n写：\n  workspace.homeworkFollowups[].task / .dueDate\n      → 老师登记的作业内容与截止时间\n  workspace.homeworkFollowups[].status\n      → 七档枚举之一（已布置/已提交/部分提交/未交/已批改/已订正/已减免）\n  workspace.homeworkFollowups[].overdueDays\n      → 由 dueDate 与当前日期派生的逾期天数（无 dueDate 时不写）\n  workspace.homeworkFollowups[].mainErrors[]\n      → 每条 {knowledgePoint, dimension, teacherCategory?}，dimension 必填\n  workspace.homeworkFollowups[].nextAction\n      → 跟进动作；自由描述放这里，不塞进 mainErrors\n  workspace.progressEvidence[].evidenceType / .description / .date / .confidenceLevel\n      → 阈值命中证据、订正证据、攻克证据\n  workspace.studentCards[].primaryWeaknesses\n      → 仅在老师逐条确认后追加（§7.2），上限 5 条\n\n派生视图（实时计算，不落库）：\n  完成度        ← 由 workspace.homeworkFollowups[].status 聚合\n  错因分布      ← 由 workspace.homeworkFollowups[].mainErrors[].dimension 聚合\n  顽固计数      ← 由 mainErrors 跨条目按 shared/vocab.md §5 比对\n  需跟进标记    ← 由 workspace.homeworkFollowups[].overdueDays 统计\n\n生成的报告段落（非存储字段）：\n  下节课预诊断  ← 事实来源为 workspace.homeworkFollowups[].mainErrors；\n                  老师若要留档，由 lesson-log 写入 lessonLogs[].nextLessonFocus\n```\n\n### 11.3 谁来读这些字段\n\n其他 SKILL 直接读工作空间字段即可，不经由本 SKILL：`xiaozhi-teach-solo-dashboard` 读 `overdueDays` 做逾期提示，`xiaozhi-teach-renewal-report` 读 `mainErrors` 与 `progressEvidence` 做阶段报告，`xiaozhi-teach-parent-communication` 读 `status` 与 `nextAction` 起草家长反馈（发送前查 `consent.parentCommunicationAllowed`）。\n\n---\n\n## 十二、字段级高敏信息防护\n\n```text\n✅ 追踪中可使用：化名、作业完成度、错因维度、知识点、提交时间\n❌ 禁止：作业具体答案、家庭辅导情况、家长监督方式\n✅ 写入数据：聚合错因、完成度\n❌ 不写入：学员真实身份（一律用 alias）\n\n✅ 错题回流：只存 knowledgePoint + dimension\n❌ 禁止：错题原文、学员答题原文\n```\n\n---\n\n## 十三、行为准则\n\n| ✅ 应该做 | ❌ 不能做 |\n|---------|---------|\n| 错因归到 vocab 四维，可跟进 | 写\"不认真\"\"老是错\"当错因 |\n| 阈值命中先存证据、请老师确认 | 越过老师直接改学员卡弱项 |\n| 逾期看 overdueDays | 造一个 status=overdue |\n| 分情况跟进（真不会/忘了/时间不够） | 一套话术套所有学员 |\n| 预诊断基于真实错题 | 凭印象决定下节课重点 |\n| 一律用 alias | 记录里出现真实姓名 |\n\n---\n\n## 十四、与其他 SKILL 的协同清单\n\n```text\n作业跟进管家（自成闭环，不需要前置 SKILL）\n    读 workspace.studentCards[]      ← student-intake 建卡\n    读 workspace.lessonLogs[]        ← lesson-log 写课后重点\n    写 workspace.homeworkFollowups[] ← 本 SKILL 唯一写入方\n    写 workspace.progressEvidence[]  ← 与 renewal-report 共用\n    写 workspace.studentCards[].primaryWeaknesses ← 老师确认后\n\n  其他 SKILL 需要作业数据时，直接读上述字段，不经过本 SKILL。\n  若装有教师通用包，可把错因分布带给 student-analyzer / assignment-designer\n  做进一步分析或出题；未安装时本 SKILL 的输出已可直接用。\n```\n\n**禁止行为**：\n- 禁止代老师发催交消息（无论发给学员还是家长）\n- 禁止在记录中出现学员真实姓名\n- 禁止存储作业错题原文或学员答题原文（只存 knowledgePoint + dimension）\n- 禁止对所有学员用同一种跟进方式\n- 禁止未经老师确认就写 `studentCards[].primaryWeaknesses`\n- 禁止在 `status` 里造枚举外的值\n\n---\n\n### 隐私与数据控制入口\n- 查看：「查看我的[作业记录]」\n- 更正：「更正我的[作业记录]」\n- 删除：「删除我的[作业记录]」——据此写进学员卡的弱项条目与阶段证据一并列出，老师确认后同删；删除后不可恢复\n- 暂停：「这次不要记忆」（本次会话不读取、不保存任何记录，也不发起回写与交接）/「暂停提醒」\n- 共享控制：「不要共享给其他SKILL」/「不要给家长看」\n- 导出：「导出我的[作业记录]」（以文本形式给出，便于转存）\n\n学员/家长提出时同样适用（由老师核实请求人身份后代为执行），按学员化名定位：「查看 小A 的作业记录」「删除 小A 的全部作业记录」。\n\n**校验要求**：跨 SKILL 共享或建档前，须确认 `consent.crossSkillSharing` / `consent.profileEnabled` 为 true；学员卡 `status` 为\"暂停记录\"时不再写入新条目。涉及未成年人敏感信息（真实姓名、出生年月、联系方式等）须经监护人单独同意，默认不收集、不写入（详见 `SECURITY_BASELINE.md`）。\n\n---\n\n## 十五、参考资源\n\n- `references/completion-tracking-views.md` — 单学员/学员列表完成度视图模板\n- `references/error-reflow-checklist-template.md` — 错题回流清单模板\n- `references/persistent-weakness-file-template.md` — 顽固弱项档案模板\n- `references/pre-diagnosis-output-template.md` — 下节课预诊断输出模板\n- `references/student-homework-profile-template.md` — 学员作业画像模板\n- `shared/vocab.md` — 错因四维、老师端七类映射、顽固阈值、弱项五档（唯一来源）\n\n---\n\n> 💡 **小智说：**\n> \"作业是教学里最被低估的环节。\n>  大多数老师批完就忘，但如果你把每份作业\n>  看作下一节课的 X 光片，\n>  你会发现：\n>  同一道题几个人都错，是教学没讲到；\n>  一个学员总错一个点，是认知有漏洞；\n>  一个学员突然不交，是状态有了变化。\n>  作业是教学最敏感的传感器。\"\n\nFile v2.9.0:_meta.json\n\n{\n  \"ownerId\": \"kn79c5gcmfkt9p1pk656tgq7nd853s7v\",\n  \"slug\": \"xiaozhi-teach-homework-tracker\",\n  \"version\": \"2.9.0\",\n  \"publishedAt\": 1790784705893\n}\n\nFile v2.9.0:references/completion-tracking-views.md\n\n# 作业完成度追踪视图模板\r\n\r\n> 适用学段：小学中段 / 小学高段 / 初中 / 高中\r\n> 配合 `xiaozhi-teach-homework-tracker` §五使用。独立教师带一对一或小班，没有\"班级\"，因此第二张表是**学员列表视图**而不是班级花名册。\r\n> 状态只用 schema 七档枚举：已布置 / 已提交 / 部分提交 / 未交 / 已批改 / 已订正 / 已减免。逾期与否看 `overdueDays`，不新造 `overdue` 状态。\r\n\r\n## 一、单学员作业完成度视图\r\n\r\n```text\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n📊 作业完成度 · [化名] · [周次]\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n■ 本周作业\r\n  · 作业 1（截止 [日期]）：□已布置 □已提交 □部分提交 □未交 □已批改 □已订正 □已减免\r\n      逾期：[overdueDays] 天（0 表示按时）\r\n  · 作业 2（截止 [日期]）：□已布置 □已提交 □部分提交 □未交 □已批改 □已订正 □已减免\r\n      逾期：[overdueDays] 天\r\n  · 作业 3（截止 [日期]）：□已布置 □已提交 □部分提交 □未交 □已批改 □已订正 □已减免\r\n      逾期：[overdueDays] 天\r\n\r\n■ 完成度统计（按条数，不按题数）\r\n  · 已提交（含已批改/已订正）：[N] / 总 [N]\r\n  · 部分提交：[N] / 总 [N]\r\n  · 未交：[N] / 总 [N]\r\n  · 已减免：[N]（不计入未交）\r\n\r\n■ 与上周对比\r\n  · 上周：[N] / [N] 条按时交\r\n  · 本周：[N] / [N] 条按时交\r\n  · 趋势：[好转 / 持平 / 下降]\r\n  · 说明：单周条数少时不下\"趋势\"结论，标 🔴 样本不足\r\n\r\n■ 错因统计（按 shared/vocab.md §1 四维）\r\n  · 本周新记错题：[N] 条\r\n  · 概念模糊 [N] · 计算失误 [N] · 读题失误 [N] · 方法用错 [N]\r\n  · 已达 vocab §5 阈值待老师确认：[N] 个知识点\r\n  · 已订正：[N] / [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  │ 小A     │ 已批改    │ 0        │ 订正第 3 题 │\r\n  │ 小B     │ 部分提交  │ 1        │ 补齐后半页  │\r\n  │ 小C     │ 未交      │ 2        │ 先问原因    │\r\n  │ 小D     │ 已减免    │ —        │ —          │\r\n  └────────┴──────────┴──────────┴────────────┘\r\n\r\n■ 需要跟进的学员（判据见 SKILL §十）\r\n  · 小C：近 4 周 3 条 overdueDays ≥ 1 → 高度，先自查作业量与难度\r\n  · 小B：近 4 周 2 条 overdueDays ≥ 1 → 中度，本人私下问一句\r\n\r\n■ 多名学员共同错的题（仅小班场景）\r\n  · [知识点]：[N] 人错，主要维度 [概念模糊 / 计算失误 / 读题失误 / 方法用错]\r\n  · 处理：下节课当共性内容讲；只有 1 人错的放个体任务\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n```\r\n\r\n## 三、填写注意\r\n\r\n- 化名一律用 `studentCards[].alias`，任何视图里不出现真实姓名。\r\n- \"完成度\"只统计作业条数，不换算成对学员的评价用语。\r\n- 学员卡 `status` 为\"暂停记录\"或\"已结课\"时，不再新增行。\r\n- 统计跨周数据依赖平台的跨会话统计能力；没有该能力时只列本次会话已知的几条，并说明\"这不是完整历史\"。\n\nFile v2.9.0:references/error-reflow-checklist-template.md\n\n# 错题回流清单模板\r\n\r\n> 适用学段：小学中段 / 小学高段 / 初中 / 高中\r\n> 配合 `xiaozhi-teach-homework-tracker` §6.2 使用。\r\n> 错因一律按 `shared/vocab.md` §1（通用四维）与 §3（老师端七类 ↔ 四维映射）填写；`dimension` 必填，不写自由文本错因。\r\n\r\n```text\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n📋 错题回流清单 · [日期] 作业\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n■ 多名学员共同错的题（仅小班场景；一对一跳过本节）\r\n  ① 知识点 [X] · dimension [概念模糊/计算失误/读题失误/方法用错]\r\n     · [N] 人错 · teacherCategory（选填）[知识漏洞/规则错误/…]\r\n  ② 知识点 [X] · dimension [   ] · [N] 人错\r\n\r\n■ 个体错题（逐学员）\r\n  小A：\r\n    · 知识点 [X] · dimension [   ] · teacherCategory [   ]\r\n    · 知识点 [X] · dimension [   ]\r\n  小B：\r\n    · 知识点 [X] · dimension [   ]\r\n\r\n■ 反复出现的知识点（按 shared/vocab.md §5 口径）\r\n  口径：同一 knowledgePoint + 同一 dimension，滚动 28 天累计，\r\n        同一天多次只计 1 次\r\n  · 小A · [知识点] · 概念模糊 · 28 天内第 3 次（[d1] [d2] [d3]）\r\n        → 写 progressEvidence，等老师确认后才进 primaryWeaknesses\r\n  · 小D · [知识点] · 计算失误 · 28 天内第 5 次\r\n        → 高危：建议与学员本人谈策略；告知家长依 shared/vocab.md §8 授权\r\n\r\n■ 这些数据去哪\r\n  · 落库：workspace.homeworkFollowups[].mainErrors[]（本 SKILL 写）\r\n  · 阈值证据：workspace.progressEvidence[]（本 SKILL 写）\r\n  · 学员卡弱项：workspace.studentCards[].primaryWeaknesses（老师确认后才写）\r\n  · 下节课重点：老师带进备课；要留档时由 lesson-log 写 nextLessonFocus\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n```\r\n\r\n## 填写注意\r\n\r\n- 一道错题只记一个 `dimension`。判定顺序：复述条件（读题失误）→ 纯净版（概念模糊）→ 换题型（方法用错）→ 剩下归计算失误。\r\n- 不写\"不认真\"\"马虎\"\"态度问题\"——按 `shared/vocab.md §3`，抄错题归读题失误，算错归计算失误。\r\n- 只存 `knowledgePoint` 和 `dimension`，**不存错题原文、不存学员答题原文**。\r\n- 一对一场景下没有\"共性错题\"，直接用个体错题一节。\n\nFile v2.9.0:references/persistent-weakness-file-template.md\n\n# 顽固弱项档案模板\r\n\r\n> 适用学段：小学中段 / 小学高段 / 初中 / 高中\r\n> 配合 `xiaozhi-teach-homework-tracker` §7.3 使用。\r\n> 弱项状态五档与进出条件见 `shared/vocab.md §4`；计数口径见 `shared/vocab.md §5`。本文件只提供填写格式，不另定阈值。\r\n\r\n```text\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n🔴 顽固弱项档案 · [化名]\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n■ 弱项 ①\r\n  知识点（knowledgePoint）：[            ]\r\n  通用维度（dimension）：□概念模糊 □计算失误 □读题失误 □方法用错\r\n  老师端七类（teacherCategory，选填）：[            ]\r\n  计数：28 天内 [N] 次（[d1] [d2] [d3]）\r\n  首次出现：[日期] · 最近一次：[日期]\r\n  弱项状态（shared/vocab.md §4）：\r\n    □待处理 □初步弱项 □顽固弱项 □突破中 □已攻克\r\n  置信度（shared/vocab.md §7）：□🟢 数据充分 □🟡 初步趋势 □🔴 样本不足\r\n  是否已写入学员卡：□老师已确认，已写入 primaryWeaknesses\r\n                    □仅在 progressEvidence，等老师确认\r\n  跟进动作：\r\n    · 第 [N] 次课：回到定义 / 纯净版最简题\r\n    · 第 [N] 次课：换题型验证\r\n    · 第 [N] 次课：独立验证（间隔 ≥ 3 天）\r\n\r\n■ 弱项 ②\r\n  （同上格式）\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n```\r\n\r\n## 状态怎么变（引用 shared/vocab.md §4）\r\n\r\n```text\r\n待处理 ──首次记录────────────────────────→\r\n初步弱项 ──28 天内同知识点同维度第 2 次───→\r\n顽固弱项 ──28 天内第 3 次──────────────→\r\n突破中   ──顽固后首次独立验证做对────────→\r\n已攻克   ──再一次独立验证做对，间隔 ≥ 3 天，\r\n           且至少 1 次为换题型/纯净版验证──→\r\n已攻克后 30 天内再错 → 退回突破中\r\n```\r\n\r\n## 填写注意\r\n\r\n- **攻克标准不是\"连对 3 次\"**：是连续 2 次独立验证做对、间隔 ≥ 3 天、至少 1 次换题型或纯净版（`shared/vocab.md §5`）。\r\n- 28 天内累计 5 次属高危：建议与学员本人谈学习策略；是否告知家长依 `shared/vocab.md §8` 的授权位判断，不默认告知。\r\n- 写入 `studentCards[].primaryWeaknesses` 上限 5 条，且必须老师逐条确认；未确认的留在 `progressEvidence` 里。\r\n- 档案只写知识点和维度，不写错题原文，不写对学员的性格评价。\n\nFile v2.9.0:references/pre-diagnosis-output-template.md\n\n# 下节课预诊断输出模板\r\n\r\n> 适用学段：小学中段 / 小学高段 / 初中 / 高中\r\n> 配合 `xiaozhi-teach-homework-tracker` §8.2 使用。\r\n> 预诊断是**生成的报告段落**，不是工作空间存储字段；事实来源为 `workspace.homeworkFollowups[].mainErrors[]`。老师要留档时，由 `xiaozhi-teach-lesson-log` 写入 `lessonLogs[].nextLessonFocus`。\r\n\r\n```text\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n🔍 下节课预诊断 · 基于 [日期] 作业 · [化名]\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n■ 必须讲\r\n  · [知识点]：dimension [概念模糊/计算失误/读题失误/方法用错]\r\n      判据：本次错 [N] 题；28 天内第 [N] 次\r\n      讲什么：[针对该维度的具体切入点]\r\n  · [知识点]：dimension [   ]\r\n      判据：[   ]\r\n      讲什么：[   ]\r\n\r\n■ 可以带过\r\n  · [知识点]：只错 1 题且此前无记录 → 口头点一句，不占时间\r\n\r\n■ 需要专项处理\r\n  · [知识点]：已达 shared/vocab.md §5 阈值\r\n      → 先回到定义/纯净版，再换题型验证，两次验证间隔 ≥ 3 天\r\n\r\n■ 小班场景补充（一对一跳过）\r\n  · 多人共同错：[知识点]（[N] 人）→ 统一讲\r\n  · 单人错：[化名] [知识点] → 单独任务，不占公共时间\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  · 新内容：[N] 分钟\r\n  注：以上按老师实际课时长度分配，不写死总时长\r\n\r\n■ 交给谁\r\n  · 老师带进下一节课；本 SKILL 不写教案\r\n  · 要留档 → xiaozhi-teach-lesson-log 写 lessonLogs[].nextLessonFocus\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n```\r\n\r\n## 填写注意\r\n\r\n- 每条\"必须讲\"都要有判据（错了几题、28 天内第几次），没有判据的不写进必须讲。\r\n- 不写\"这孩子基础差\"这类整体评价，只写知识点和维度。\r\n- 用于验证的同类题若由 AI 生成，先按 `shared/ai-item-check.md` 自检，并标注【AI 生成，入库前请人工验算】。\n\nFile v2.9.0:references/student-homework-profile-template.md\n\n# 学员作业画像模板\r\n\r\n> 适用学段：小学中段 / 小学高段 / 初中 / 高中\r\n> 配合 `xiaozhi-teach-homework-tracker` §9.1 使用。画像是**实时聚合的派生视图**，不落库。\r\n> 错因分布只用 `shared/vocab.md §1` 的通用四维，不用老师端七类做统计口径（七类可在单条错题上标注，聚合时先映射回四维）。\r\n\r\n```text\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n📈 学员作业画像 · [化名]\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n■ 完成度趋势（按条数）\r\n  第 1-5 次课：按时交 [N] / [N] 条\r\n  第 6-10 次课：按时交 [N] / [N] 条\r\n  第 11 次课以后：按时交 [N] / [N] 条\r\n  趋势：[好转 / 持平 / 下降]\r\n  置信度（shared/vocab.md §7）：□🟢 数据充分 □🟡 初步趋势 □🔴 样本不足\r\n  说明：总条数少于 6 条时一律标 🔴，不下趋势结论\r\n\r\n■ 错因分布（shared/vocab.md §1 四维）\r\n  概念模糊 [N] 条\r\n  计算失误 [N] 条\r\n  读题失误 [N] 条\r\n  方法用错 [N] 条\r\n  主导维度：[   ]（占比最高且领先第二名 ≥ 2 条时才写\"主导\"）\r\n\r\n■ 反复出现的知识点（shared/vocab.md §5 口径）\r\n  · [知识点] · [维度] · 28 天内 [N] 次 · 弱项状态 [五档之一]\r\n  · [知识点] · [维度] · 28 天内 [N] 次 · 弱项状态 [五档之一]\r\n\r\n■ 订正情况\r\n  · 已订正 [N] / 已批改后有错题的作业 [N] 条\r\n  · 订正后再验证做对的：[N] 条\r\n\r\n■ 逾期情况\r\n  · 近 4 周 overdueDays ≥ 1 的条目：[N] 条\r\n  · 最长一次逾期：[N] 天\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n```\r\n\r\n## 填写注意\r\n\r\n- 画像给老师看，也可能被老师念给家长听——念之前先查 `consent.parentCommunicationAllowed`；内容里只留事实，不留判断。\r\n- 不写\"错题率 [N]%\"式的比例：单次作业题量小，比例不稳定，容易误导。\r\n- 跨周统计依赖平台的跨会话统计能力；缺该能力时只列已知条目并说明不完整，不口算历史数字。\r\n- 画像不写入任何字段；要留档的结论走 `progressEvidence`。\n\nFile v2.9.0:shared/ai-item-check.md\n\n<!-- 本文件由 scripts/sync-shared.mjs 从仓库根 shared/ 自动生成，用于让单个技能包自包含。\n     请勿直接编辑；需要修改请改仓库根目录下的同名文件，然后运行 npm run sync:shared -->\n\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\nArchive v2.8.0: 16 files, 45333 bytes\n\nFiles: references/completion-tracking-views.md (4164b), references/error-reflow-checklist-template.md (2496b), references/persistent-weakness-file-template.md (2693b), references/pre-diagnosis-output-template.md (2354b), references/student-homework-profile-template.md (2253b), 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 (8616b), shared/vocab.md (14173b), skill-card.md (2321b), SKILL.md (26095b), _meta.json (149b)\n\nArchive v2.7.1: 16 files, 45365 bytes\n\nFiles: references/completion-tracking-views.md (4164b), references/error-reflow-checklist-template.md (2496b), references/persistent-weakness-file-template.md (2693b), references/pre-diagnosis-output-template.md (2354b), references/student-homework-profile-template.md (2253b), 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 (8616b), shared/vocab.md (14173b), skill-card.md (2302b), SKILL.md (26095b), _meta.json (149b)\n\nArchive v2.7.0: 16 files, 45501 bytes\n\nFiles: references/completion-tracking-views.md (4164b), references/error-reflow-checklist-template.md (2496b), references/persistent-weakness-file-template.md (2693b), references/pre-diagnosis-output-template.md (2354b), references/student-homework-profile-template.md (2253b), 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 (8616b), shared/vocab.md (14173b), skill-card.md (2404b), SKILL.md (26095b), _meta.json (149b)\n\nArchive v2.6.0: 16 files, 45399 bytes\n\nFiles: references/completion-tracking-views.md (4164b), references/error-reflow-checklist-template.md (2496b), references/persistent-weakness-file-template.md (2693b), references/pre-diagnosis-output-template.md (2354b), references/student-homework-profile-template.md (2253b), 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 (8616b), shared/vocab.md (14173b), skill-card.md (2263b), SKILL.md (26095b), _meta.json (149b)\n\nArchive v2.4.0: 16 files, 45413 bytes\n\nFiles: references/completion-tracking-views.md (4164b), references/error-reflow-checklist-template.md (2496b), references/persistent-weakness-file-template.md (2693b), references/pre-diagnosis-output-template.md (2354b), references/student-homework-profile-template.md (2253b), 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 (8616b), shared/vocab.md (14173b), skill-card.md (2350b), SKILL.md (26014b), _meta.json (149b)\n\nArchive v2.3.0: 16 files, 45111 bytes\n\nFiles: references/completion-tracking-views.md (4164b), references/error-reflow-checklist-template.md (2496b), references/persistent-weakness-file-template.md (2693b), references/pre-diagnosis-output-template.md (2354b), references/student-homework-profile-template.md (2253b), 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 (8616b), shared/vocab.md (13621b), skill-card.md (3445b), SKILL.md (26014b), _meta.json (149b)","readmeExcerpt":"Skill: 作业跟进管家 Owner: qizhitang Summary: 帮独立教师跟进课上练习与学员带来的学校作业、考试错题：登记、追状态、归错因、导出下节课讲什么。适用于老师说\"登记今天课上的练习\"\"[化名] 课上那份练习做完了吗\"\"[化名] 带来了学校作业，帮我归一下错因\"\"考试错题帮我归类\"\"错题回流\"\"下节课该讲什么\"\"这道题他错第三次了\"\"看下 [化名] 的作业画像\"。流程：老师口述课上练习或学校作业 → 追七档状态 → 按 shared/vocab.md §1/§3 归错因 → 阈值命中先存证据待老师确认。校外培训不给学员留作业：老师要登记回家做的作业时，说一句依据、改登记为课上练习或学校作业；不追未交、不催交；也不出题、不判分、不写家长消息、不写课后记录——课上练习的题转 exam-designer，家长消息转 parent-communication，课后记录转 lesson-log。 Tags: lat","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"误区① 做了就忘：课上练习做完没有记录，学员带来的学校作业、\n        考试错题看一眼就还回去，错因、顽固弱项全凭印象。\n\n误区② 批完归档：练习批改完就放在一边，\n        错题没有回流到下一节课教案，\n        学生错过的题目反复错。\n\n误区③ 一刀切加量：课上练习没做完，不分是\"真的不会\"还是\n        \"时间不够\"，一律加题，或者改成回家补。"},{"language":"text","snippet":"┌──────────────────────────┐\n                │ ① 老师在本 SKILL 内登记   │\n                │  课上练习 / 学校作业错题  │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ② 状态追踪（七档枚举）    │\n                │  逾期看 overdueDays       │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ③ 老师判分后登记错题      │\n                │  本 SKILL 不判分          │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ④ 错因归维（vocab §1/§3） │\n                │  写 mainErrors[]          │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ⑤ 阈值命中（vocab §5）    │\n                │  先写 progressEvidence    │\n                │  老师确认后才进弱项       │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ⑥ 下节课预诊断            │\n                │  交给老师带进下一节课     │\n                └──────────────────────────┘"},{"language":"text","snippet":"登记话术（一轮内完成；按 shared/platform-conventions.md 先生成待确认条目，老师确认后写入）：\n  课上练习：\n  「这节课给谁做的、做了什么、课上做完了没有？」\n  → 老师：\"小A，函数图像练习册 P32 第 1-8 题，课上做了 6 题，剩下 2 题下节课补\"\n  → 写入：studentId=小A，task=\"课上练习（[月-日]）：函数图像练习册 P32 第1-8题\"，\n          dueDate=下节课日期，status=部分提交，nextAction=\"第7、8题下节课课上补\"\n  dueDate 填约定做完的那节课：课上做完的填当天；没做完、留到下节课课上补的，\n  填下节课那天（问老师一句）。过了那节课仍没做完，才记 status=未交。\n\n  学员带来的学校作业、考试错题：\n  「是哪份学校作业或哪次考试、错了哪几道？」\n  → 老师：\"小B 带来学校的数学作业，第 3、5、7 题错了\"\n  → 写入：studentId=小B，task=\"学校作业（[月-日] 带来）：数学 第3、5、7题\"，\n          status=已批改，不填 dueDate；错因按 §6.3 逐题写 mainErrors\n  task 里写上带来的日期，28 天计数按这一天算；考试错题只记知识点与维度，不记总分、名次；\n  这份作业交没交给学校，不登记、不过问。"},{"language":"text","snippet":"┌──────────┬────────────────────────────────┬──────────────────┬──────────┐\n│ 状态      │ 定义                            │ 触发动作          │ 时长限制  │\n├──────────┼────────────────────────────────┼──────────────────┼──────────┤\n│ 已布置    │ 课上布置、学员正在课上做        │ 课上做完收上来    │ —         │\n│ 已提交    │ 课上做完、收上来                │ 等待批改          │ 0-3 天    │\n│ 部分提交  │ 课上没做完                      │ 下节课课上补齐    │ 到下节课  │\n│ 未交      │ 课上没做完，下节课也没补上      │ 查原因、调整练习  │ 当天      │\n│ 已批改    │ 老师批改完；学校作业、考试错题  │ 错题回流          │ 1-7 天    │\n│           │ 从这一档或已订正起记            │                   │           │\n│ 已订正    │ 学员完成订正                    │ 错题归档到错题本  │ —         │\n│ 已减免    │ 这份课上练习老师决定不做了      │ 记录说明          │ —         │\n└──────────┴────────────────────────────────┴──────────────────┴──────────┘"},{"language":"text","snippet":"■ 课上练习没做完（status=部分提交）\n  · 先看原因：题量超出了这节课的时间，还是卡在某个知识点\n  · 剩下的题留到下节课课上补，dueDate 填下节课那天；不改成回家做\n  · 卡在知识点的：下节课先讲再补，补的题换成纯净版\n  · 下节课仍没补上（status=未交）：不追、不催，原因写进 nextAction；\n    自查这份练习的量、难度和这节课的讲解，调整下次课上练习\n\n■ 学校作业、考试错题不方便带来\n  · 带不带来由学员自己决定；老师不追要、不催，也不通过家长要\n  · 学员口头说清错在哪一步，老师据此记 knowledgePoint 与 dimension 也可以\n  · 这份作业交没交给学校，不是本 SKILL 跟进的事，不登记、不过问\n\n■ 教学诊断（自我反思）\n  自我问：\n    1. 是不是课上练习太难了？\n    2. 是不是课上练习的量超出了这节课的时间？\n    3. 是不是讲解没讲透？\n    4. 是不是课上的节奏需要调整？\n\n■ 要跟家长说课上的情况时（不是催交）\n  · 由老师带到家长沟通助手（xiaozhi-teach-parent-communication）起草、自己发\n  · 发之前查 consent.parentCommunicationAllowed；为 false 时只与学员本人说"},{"language":"text","snippet":"✓   完全正确\n▲   思路对但计算/书写错\n?   思路不清/不完整\n✗   思路错误\n?✓  部分对\n#   超纲或独特解法"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: xiaozhi-teach-homework-tracker\ndescription: '帮独立教师跟进课上练习与学员带来的学校作业、考试错题：登记、追状态、归错因、导出下节课讲什么。适用于老师说\"登记今天课上的练习\"\"[化名] 课上那份练习做完了吗\"\"[化名] 带来了学校作业，帮我归一下错因\"\"考试错题帮我归类\"\"错题回流\"\"下节课该讲什么\"\"这道题他错第三次了\"\"看下 [化名] 的作业画像\"。流程：老师口述课上练习或学校作业 → 追七档状态 → 按 shared/vocab.md §1/§3 归错因 → 阈值命中先存证据待老师确认。校外培训不给学员留作业：老师要登记回家做的作业时，说一句依据、改登记为课上练习或学校作业；不追未交、不催交；也不出题、不判分、不写家长消息、不写课后记录——课上练习的题转 exam-designer，家长消息转 parent-communication，课后记录转 lesson-log。'\ncompatibility: WorkBuddy / SkillHub / OpenClaw / ClawHub\nlicense: MIT\ndisplay_name: 作业跟进管家\nversion: 2.11.1\nauthor: 小智伴学\ncategory: 独立教师\ngrade_bands:\n  - 小学中段\n  - 小学高段\n  - 初中\n  - 高中\ntags: [作业跟进, 错题回流, 状态追踪, 预诊断, 独立教师]\ndepends_on:\n  - xiaozhi-teach-lesson-log\nid: openclaw:xiaozhi-teach-homework-tracker\nmin_platform_version: \"2.0\"\nmax_round_limit: 12\nslug: xiaozhi-teach-homework-tracker\ndisplayName: 作业跟进管家\nsummary: '帮独立教师跟进课上练习与学员带来的学校作业、考试错题：登记、追状态、归错因、导出下节课讲什么。'\n---\n\n# 作业跟进管家 SKILL\n\n> **一句话定位：** 作业不是任务清单，而是下一节课的诊断 X 光——跟进它，不是为了完成它，而是为了发现下一节课该讲什么。\n\n---\n\n## 技术边界\n\n> 技术边界：本 SKILL 依赖能力 [M, X, K]，无该能力时按 shared/platform-conventions.md 降级。\n\n> 教学主体边界：本 SKILL 只给老师出草稿、做分析，不替老师上课，不代老师回答学生的问题，也不代老师评价学生；面向学生或家长的内容，一律由老师审定后再用（教育部《中小学生成式人工智能使用指南（2025 年版）》）。\n\n> 适用范围：用于校外培训（一对一、小班）时，只在合法范围内用，口径见 `shared/off-campus-training.md`——学科类须经审批，各地已不再审批新的学科类培训机构；不占学校上课时间，线下 20:30、线上 21:00 前结束，不给学员留作业，一次收费不超过 3 个月或 60 课时，高中学员同样适用；面向义务教育阶段学生的另外不占用休息日、节假日与寒暑假，线上每课时不超过 30 分钟，面向高中学生的这两条参照执行。本技能不预设违规的排课、作业与收费。本技能只跟进课上练习与学员带来的学校作业、考试错题，不登记回家做的作业。\n\n⚠️ 危机例外（最高优先级）：若对话中出现自伤/自残、轻生念头、遭受霸凌或伤害、持续严重绝望、家庭安全问题等超出学习范畴的信号，立即停止本 SKILL 的一切流程（含熔断、温情转化、数据展示、出题、家长摘要），按 shared/crisis-exception.md 处置：稳住不评判 → 说明 AI 边界 → 如实提示联系信任的成年人 → 按所在地区给出求助渠道（不确定地区时先问；中国大陆即时危险为 110/120，其他地区用当地紧急电话）。宁可误报，不可漏报；档案只记\"已转介\"的处置事实。\n\n只追踪低敏信息（完成度、错因维度、知识点、提交时间）；不收集作业原文、答案、家庭辅导情况。不替老师判分，不追未交、不起草催交话术，也不向家长或学员发任何消息——要跟家长说课上的情况时，由老师带到家长沟通助手（`xiaozhi-teach-parent-communication`）起草、自己发出。无 `X` 时不给\"累计错 N 次\"的精确统计，改为把已知的几次列出来请老师自己数。\n\n---\n\n## 一、核心使命\n\n独立教师作业跟进常见的三个误区：\n\n```text\n误区① 做了就忘：课上练习做完没有记录，学员带来的学校作业、\n        考试错题看一眼就还回去，错因、顽固弱项全凭印象。\n\n误区② 批完归档：练习批改完就放在一边，\n        错题没有回流到下一节课教案，\n        学生错过的题目反复错。\n\n误区③ 一刀切加量：课上练习没做完，不分是\"真的不会\"还是\n        \"时间不够\"，一律加题，或者改成回家补。\n```\n\n本 SKILL 要解决的是：\n- **让每份课上练习、每份带来的学校作业都有记录**：登记 → 课上做完 → 批改 → 错因 → 下节课（学校作业、考试错题从批改那一步记起）\n- **让错因落到可跟进的维度上**：按 `shared/vocab.md §1/§3` 归维，不写\"不认真\"\n- **让跟进分情况**：课上没做完，是真不会还是时间不够，两种处理不一样；都在课上解决，不改成回家作业\n- **让判定留在老师手里**：阈值命中先给证据，老师确认才改学员卡\n\n---\n\n## 二、触发时机\n\n| 触发场景 | 示例语句 |\n|---------|---------|\n| 课上练习 | \"登记今天课上的练习\" / \"[化名] 课上那份练习做完了吗\" |\n| 学校作业、考试错题 | \"[化名] 带来了学校的数学作业，帮我归一下错因\" / \"期中考试的错题帮我归类\" |\n| 完成度 | \"课上练习的完成情况\" / \"哪些学员课上练习没做完\" |\n| 错题回流 | \"错题回流\" / \"错题怎么进入下节课\" |\n| 下节课预诊断 | \"下节课讲什么\" / \"作业反映什么问题\" |\n| 课上没做完 | \"[化名] 课上练习总是做不完怎么办\" |\n| 顽固弱项 | \"[化名] 这道题错 3 次了\" |\n| 作业画像 | \"看一下 [化名] 的作业画像\" |\n\n老师要登记\"回家做的作业\"时，不拒绝、不说教，按 §三 第 ① 步改登记为课上练习或学员带来的学校作业。\n\n---\n\n## 三、核心流程\n\n```text\n                ┌──────────────────────────┐\n                │ ① 老师在本 SKILL 内登记   │\n                │  课上练习 / 学校作业错题  │\n                └────────────┬─────────────┘\n                             ↓\n           "},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn79c5gcmfkt9p1pk656tgq7nd853s7v\",\n  \"slug\": \"xiaozhi-teach-homework-tracker\",\n  \"version\": \"2.11.1\",\n  \"publishedAt\": 1791477071241\n}"},{"path":"references/completion-tracking-views.md","content":"# 作业完成度追踪视图模板\r\n\r\n> 适用学段：小学中段 / 小学高段 / 初中 / 高中\r\n> 配合 `xiaozhi-teach-homework-tracker` §五使用。独立教师带一对一或小班，没有\"班级\"，因此第二张表是**学员列表视图**而不是班级花名册。\r\n> 状态只用 schema 七档枚举：已布置 / 已提交 / 部分提交 / 未交 / 已批改 / 已订正 / 已减免。逾期与否看 `overdueDays`，不新造 `overdue` 状态。\r\n> 只登记课上练习与学员带来的学校作业、考试错题（`task` 开头写类别与日期），不登记回家做的作业；完成度只算课上练习，学校作业、考试错题从 `已批改` 或 `已订正` 起记，不算完成度、不算逾期。\r\n\r\n## 一、单学员作业完成度视图\r\n\r\n```text\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n📊 作业完成度 · [化名] · [周次]\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n■ 本周课上练习（dueDate = 约定做完的那节课）\r\n  · 练习 1（[日期] 课上）：□已布置 □已提交 □部分提交 □未交 □已批改 □已订正 □已减免\r\n      逾期：[overdueDays] 天（0 表示在约定的那节课做完了、还没到约定那节课，或已减免）\r\n  · 练习 2（[日期] 课上）：□已布置 □已提交 □部分提交 □未交 □已批改 □已订正 □已减免\r\n      逾期：[overdueDays] 天\r\n  · 练习 3（[日期] 课上）：□已布置 □已提交 □部分提交 □未交 □已批改 □已订正 □已减免\r\n      逾期：[overdueDays] 天\r\n\r\n■ 学员带来的学校作业、考试错题（学员自愿带来，不追交、不催交）\r\n  · [学校作业 / 考试错题]（[日期] 带来）：□已批改 □已订正 · 记错题 [N] 条\r\n\r\n■ 课上练习完成情况（按条数，不按题数；学校作业、考试错题不算）\r\n  · 课上做完（已提交，含已批改/已订正）：[N] / 总 [N]\r\n  · 课上没做完（部分提交）：[N] / 总 [N]\r\n  · 下节课也没补上（未交）：[N] / 总 [N]\r\n  · 已减免：[N]（不计入未交）\r\n\r\n■ 与上周对比\r\n  · 上周：[N] / [N] 条按约定做完\r\n  · 本周：[N] / [N] 条按约定做完\r\n  · 趋势：[好转 / 持平 / 下降]\r\n  · 说明：单周条数少时不下\"趋势\"结论，标 🔴 样本不足\r\n\r\n■ 错因统计（按 shared/vocab.md §1 四维；课上练习与学校作业、考试错题一起算）\r\n  · 本周新记错题：[N] 条\r\n  · 概念模糊 [N] · 计算失误 [N] · 读题失误 [N] · 方法用错 [N]\r\n  · 已达 vocab §5 阈值待老师确认：[N] 个知识点\r\n  · 已订正：[N] / [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  │ 小A     │ 已批改    │ 0        │ 订正第 3 题 │\r\n  │ 小B     │ 部分提交  │ 0        │ 下节课补完  │\r\n  │ 小C     │ 未交      │ 2        │ 查卡在哪    │\r\n  │ 小D     │ 已减免    │ —        │ —          │\r\n  │ 小E     │ 已订正    │ —        │ 学校作业    │\r\n  └────────┴──────────┴──────────┴────────────┘\r\n  （小E 那条是学员带来的学校作业，从已批改起记，不算完成度、不追交）\r\n\r\n■ 需要跟进的学员（判据见 SKILL §十）\r\n  · 小C：近 4 周 3 条 overdueDays ≥ 1 → 高度，先自查课上练习的量与难度\r\n  · 小B：近 4 周 2 条 overdueDays ≥ 1 → 中度，课上问一句卡在哪\r\n\r\n■ 多名学员共同错的题（仅小班场景）\r\n  · [知识点]：[N] 人错，主要维度 [概念模糊 / 计算失误 / 读题失误 / 方法用错]\r\n  · 处理：下节课当共性内容讲；只有 1 人错的放个体任务\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n```\r\n\r\n## 三、填写注意\r\n\r\n- 化名一律用 `studentCards[].alias`，任何视图里不出现真实姓名。\r\n- \"完成度\"只统计课上练习的条数（学校作业、考试错题不算），不换算成对学员的评价用语；学员带来多少学校作业也不用来评价学员。\r\n- 学员卡 `status` 为\"暂停记录\"或\"已结课\"时，不再新增行。\r\n- 统计跨周数据依赖平台的跨会话统计能力；没有该能力时只列本次会话已知的几条，并说明\"这不是完整历史\"。"},{"path":"references/error-reflow-checklist-template.md","content":"# 错题回流清单模板\r\n\r\n> 适用学段：小学中段 / 小学高段 / 初中 / 高中\r\n> 配合 `xiaozhi-teach-homework-tracker` §6.2 使用。\r\n> 错因一律按 `shared/vocab.md` §1（通用四维）与 §3（老师端七类 ↔ 四维映射）填写；`dimension` 必填，不写自由文本错因。\r\n\r\n```text\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n📋 错题回流清单 · [日期] 课上练习 / 带来的学校作业\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n■ 多名学员共同错的题（仅小班场景；一对一跳过本节）\r\n  ① 知识点 [X] · dimension [概念模糊/计算失误/读题失误/方法用错]\r\n     · [N] 人错 · teacherCategory（选填）[知识漏洞/规则错误/…]\r\n  ② 知识点 [X] · dimension [   ] · [N] 人错\r\n\r\n■ 个体错题（逐学员）\r\n  小A：\r\n    · 知识点 [X] · dimension [   ] · teacherCategory [   ]\r\n    · 知识点 [X] · dimension [   ]\r\n  小B：\r\n    · 知识点 [X] · dimension [   ]\r\n\r\n■ 反复出现的知识点（按 shared/vocab.md §5 口径）\r\n  口径：同一 knowledgePoint + 同一 dimension，滚动 28 天累计，\r\n        同一天多次只计 1 次\r\n  · 小A · [知识点] · 概念模糊 · 28 天内第 3 次（[d1] [d2] [d3]）\r\n        → 写 progressEvidence，等老师确认后才进 primaryWeaknesses\r\n  · 小D · [知识点] · 计算失误 · 28 天内第 5 次\r\n        → 高危：建议与学员本人谈策略；告知家长依 shared/vocab.md §8 授权\r\n\r\n■ 这些数据去哪\r\n  · 落库：workspace.homeworkFollowups[].mainErrors[]（本 SKILL 写）\r\n  · 阈值证据：workspace.progressEvidence[]（本 SKILL 写）\r\n  · 学员卡弱项：workspace.studentCards[].primaryWeaknesses（老师确认后才写）\r\n  · 下节课重点：老师带进备课；要留档时由 lesson-log 写 nextLessonFocus\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n```\r\n\r\n## 填写注意\r\n\r\n- 一道错题只记一个 `dimension`。判定顺序：复述条件（读题失误）→ 纯净版（概念模糊）→ 换题型（方法用错）→ 剩下归计算失误。\r\n- 不写\"不认真\"\"马虎\"\"态度问题\"——按 `shared/vocab.md §3`，抄错题归读题失误，算错归计算失误。\r\n- 只存 `knowledgePoint` 和 `dimension`，**不存错题原文、不存学员答题原文**。\r\n- 一对一场景下没有\"共性错题\"，直接用个体错题一节。"},{"path":"references/persistent-weakness-file-template.md","content":"# 顽固弱项档案模板\r\n\r\n> 适用学段：小学中段 / 小学高段 / 初中 / 高中\r\n> 配合 `xiaozhi-teach-homework-tracker` §7.3 使用。\r\n> 弱项状态五档与进出条件见 `shared/vocab.md §4`；计数口径见 `shared/vocab.md §5`。本文件只提供填写格式，不另定阈值。\r\n\r\n```text\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n🔴 顽固弱项档案 · [化名]\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n■ 弱项 ①\r\n  知识点（knowledgePoint）：[            ]\r\n  通用维度（dimension）：□概念模糊 □计算失误 □读题失误 □方法用错\r\n  老师端七类（teacherCategory，选填）：[            ]\r\n  计数：28 天内 [N] 次（[d1] [d2] [d3]）\r\n  首次出现：[日期] · 最近一次：[日期]\r\n  弱项状态（shared/vocab.md §4）：\r\n    □待处理 □初步弱项 □顽固弱项 □突破中 □已攻克\r\n  置信度（shared/vocab.md §7）：□🟢 数据充分 □🟡 初步趋势 □🔴 样本不足\r\n  是否已写入学员卡：□老师已确认，已写入 primaryWeaknesses\r\n                    □仅在 progressEvidence，等老师确认\r\n  跟进动作：\r\n    · 第 [N] 次课：回到定义 / 纯净版最简题\r\n    · 第 [N] 次课：换题型验证\r\n    · 第 [N] 次课：独立验证（间隔 ≥ 3 天）\r\n\r\n■ 弱项 ②\r\n  （同上格式）\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n```\r\n\r\n## 状态怎么变（引用 shared/vocab.md §4）\r\n\r\n```text\r\n待处理 ──首次记录────────────────────────→\r\n初步弱项 ──28 天内同知识点同维度第 2 次───→\r\n顽固弱项 ──28 天内第 3 次──────────────→\r\n突破中   ──顽固后首次独立验证做对────────→\r\n已攻克   ──再一次独立验证做对，间隔 ≥ 3 天，\r\n           且至少 1 次为换题型/纯净版验证──→\r\n已攻克后 30 天内再错 → 退回突破中\r\n```\r\n\r\n## 填写注意\r\n\r\n- **攻克标准不是\"连对 3 次\"**：是连续 2 次独立验证做对、间隔 ≥ 3 天、至少 1 次换题型或纯净版（`shared/vocab.md §5`）。\r\n- 28 天内累计 5 次属高危：建议与学员本人谈学习策略；是否告知家长依 `shared/vocab.md §8` 的授权位判断，不默认告知。\r\n- 写入 `studentCards[].primaryWeaknesses` 上限 5 条，且必须老师逐条确认；未确认的留在 `progressEvidence` 里。\r\n- 档案只写知识点和维度，不写错题原文，不写对学员的性格评价。"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"帮独立教师跟进课上练习与学员带来的学校作业、考试错题：登记、追状态、归错因、导出下节课讲什么。适用于老师说\"登记今天课上的练习\"\"[化名] 课上那份练习做完了吗\"\"[化名] 带来了学校作业，帮我归一下错因\"\"考试错题帮我归类\"\"错题回流\"\"下节课该讲什么\"\"这道题他错第三次了\"\"看下 [化名] 的作业画像\"。流程：老师口述课上练习或学校作业 → 追七档状态 → 按 shared/vocab.md §1/§3 归错因 → 阈值命中先存证据待老师确认。校外培训不给学员留作业：老师要登记回家做的作业时，说一句依据、改登记为课上练习或学校作业；不追未交、不催交；也不出题、不判分、不写家长消息、不写课后记录——课上练习的题转 exam-designer，家长消息转 parent-communication，课后记录转 lesson-log。 Skill: 作业跟进管家 Owner: qizhitang Summary: 帮独立教师跟进课上练习与学员带来的学校作业、考试错题：登记、追状态、归错因、导出下节课讲什么。适用于老师说\"登记今天课上的练习\"\"[化名] 课上那份练习做完了吗\"\"[化名] 带来了学校作业，帮我归一下错因\"\"考试错题帮我归类\"\"错题回流\"\"下节课该讲什么\"\"这道题他错第三次了\"\"看下 [化名] 的作业画像\"。流程：老师口述课上练习或学校作业 → 追七档状态 → 按 shared/vocab.md §1/§3 归错因 → 阈值命中先存证据待老师确认。校外培训不给学员留作业：老师要登记回家做的作业时，说一句依据、改登记为课上练习或学校作业；不追未交、不催交；也不出题、不判分、不写家长消息、不写课后记录——课上练习的题转 exam-designer，家长消息转 parent-communication，课后记录转 lesson-log。 Tags: lat","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":524,"uniquenessScore":59,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-10T07:33:18.962Z","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:33:18.962Z","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:56:42.044Z","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"}]}}}