{"id":"c7431881-bfd2-4b00-ac75-15120462dd23","entityType":"agent","slug":"clawhub-qizhitang-xiaozhi-teach-resource-library","name":"教学资源复用库","canonicalUrl":"https://www.xpersona.co/agent/clawhub-qizhitang-xiaozhi-teach-resource-library","canonicalPath":"/agent/clawhub-qizhitang-xiaozhi-teach-resource-library","generatedAt":"2026-10-10T17:40:16.830Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-10T15:33:19.682Z","emptyReason":null},"description":"把独立教师散在文件夹、微信收藏和笔记本里的讲义、题目、讲评话术、错因案例收进一个可检索的库。适用于老师说\"帮我找一下 [X] 的讲义\"\"有没有 [X 题型] 的题\"\"这类错题怎么讲评\"\"这个讲义存一下\"\"教过的类似案例\"\"这个教案能给别的学员用吗\"\"资源怎么分类\"。流程：入库时打标签与版权状态 → 按知识点/难度检索 → 改编适配后复用 → 记录用过几次、效果如何。本 SKILL 不出题、不备课、不批改、不联系家长——只管资源的存、找、改；AI 生成的题必须老师验算后才算入库。 Skill: 教学资源复用库 Owner: qizhitang Summary: 把独立教师散在文件夹、微信收藏和笔记本里的讲义、题目、讲评话术、错因案例收进一个可检索的库。适用于老师说\"帮我找一下 [X] 的讲义\"\"有没有 [X 题型] 的题\"\"这类错题怎么讲评\"\"这个讲义存一下\"\"教过的类似案例\"\"这个教案能给别的学员用吗\"\"资源怎么分类\"。流程：入库时打标签与版权状态 → 按知识点/难度检索 → 改编适配后复用 → 记录用过几次、效果如何。本 SKILL 不出题、不备课、不批改、不联系家长——只管资源的存、找、改；AI 生成的题必须老师验算后才算入库。 Tags: latest:2.11.1 Version history: v2.11.1 | 2026-10-08T16:43:03.590Z | user v2.11.1：详见仓库 docs/changelog.md v2.11.0 | 2026-10-08T08:24:","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.4K downloads reported by the source. Last updated 10/10/2026.","installCommand":"clawhub skill install s17egdt3mjea4rhm19wt7tm77x852sxg:xiaozhi-teach-resource-library","sourceUrl":"https://clawhub.ai/qizhitang/xiaozhi-teach-resource-library","homepage":"https://clawhub.ai/qizhitang/skills/xiaozhi-teach-resource-library","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/qizhitang/xiaozhi-teach-resource-library","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/qizhitang/skills/xiaozhi-teach-resource-library","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":63,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"把独立教师散在文件夹、微信收藏和笔记本里的讲义、题目、讲评话术、错因案例收进一个可检索的库。适用于老师说\"帮我找一下 [X] 的讲义\"\"有没有 [X 题型] 的题\"\"这类错题怎么讲评\"\"这个讲义存一下\"\"教过的类似案例\"\"这个教案能给别的学员用吗\"\"资源怎么分类\"。流程：入库时打标签与版权状态 → 按知识点/难度检索 "},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-10T15:33:19.682Z","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-10T15:33:19.682Z","emptyReason":null},"stars":null,"forks":null,"downloads":1358,"packageName":null,"latestVersion":"2.11.1","tractionLabel":"1.4K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T15:33:19.682Z","emptyReason":null},"lastUpdatedAt":"2026-10-10T15:33:19.682Z","lastCrawledAt":"2026-10-10T15:33:19.682Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-11T15:33:19.682Z","lastVerifiedAt":null,"highlights":[{"version":"2.11.1","createdAt":"2026-10-08T16:43:03.590Z","changelog":"v2.11.1：详见仓库 docs/changelog.md","fileCount":15,"zipByteSize":56621},{"version":"2.11.0","createdAt":"2026-10-08T08:24:50.588Z","changelog":"v2.11.0：详见仓库 docs/changelog.md","fileCount":15,"zipByteSize":56762},{"version":"2.10.0","createdAt":"2026-10-01T16:27:05.357Z","changelog":"v2.10.0：详见仓库 docs/changelog.md","fileCount":14,"zipByteSize":44854},{"version":"2.9.0","createdAt":"2026-09-30T16:22:48.693Z","changelog":"v2.9.0：详见仓库 docs/changelog.md","fileCount":14,"zipByteSize":44833},{"version":"2.8.0","createdAt":"2026-09-29T16:42:39.726Z","changelog":"v2.8.0：详见仓库 docs/changelog.md","fileCount":14,"zipByteSize":44845},{"version":"2.7.1","createdAt":"2026-09-28T12:29:03.153Z","changelog":"v2.7.1：详见仓库 docs/changelog.md","fileCount":14,"zipByteSize":44852},{"version":"2.7.0","createdAt":"2026-09-27T10:14:33.461Z","changelog":"v2.7.0：详见仓库 docs/changelog.md","fileCount":14,"zipByteSize":44747},{"version":"2.6.0","createdAt":"2026-09-26T01:11:16.961Z","changelog":"v2.6.0：详见仓库 docs/changelog.md","fileCount":14,"zipByteSize":45071}]},"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-resource-library","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-resource-library/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-qizhitang-xiaozhi-teach-resource-library/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-qizhitang-xiaozhi-teach-resource-library/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-qizhitang-xiaozhi-teach-resource-library/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-qizhitang-xiaozhi-teach-resource-library/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-qizhitang-xiaozhi-teach-resource-library/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-10T17:40:16.825Z"}},"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-resource-library/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-qizhitang-xiaozhi-teach-resource-library/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-qizhitang-xiaozhi-teach-resource-library/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-qizhitang-xiaozhi-teach-resource-library/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-10T15:33:19.682Z","emptyReason":null},"readme":"Skill: 教学资源复用库\n\nOwner: qizhitang\n\nSummary: 把独立教师散在文件夹、微信收藏和笔记本里的讲义、题目、讲评话术、错因案例收进一个可检索的库。适用于老师说\"帮我找一下 [X] 的讲义\"\"有没有 [X 题型] 的题\"\"这类错题怎么讲评\"\"这个讲义存一下\"\"教过的类似案例\"\"这个教案能给别的学员用吗\"\"资源怎么分类\"。流程：入库时打标签与版权状态 → 按知识点/难度检索 → 改编适配后复用 → 记录用过几次、效果如何。本 SKILL 不出题、不备课、不批改、不联系家长——只管资源的存、找、改；AI 生成的题必须老师验算后才算入库。\n\nTags: latest:2.11.1\n\nVersion history:\n\nv2.11.1 | 2026-10-08T16:43:03.590Z | user\n\nv2.11.1：详见仓库 docs/changelog.md\n\nv2.11.0 | 2026-10-08T08:24:50.588Z | user\n\nv2.11.0：详见仓库 docs/changelog.md\n\nv2.10.0 | 2026-10-01T16:27:05.357Z | user\n\nv2.10.0：详见仓库 docs/changelog.md\n\nv2.9.0 | 2026-09-30T16:22:48.693Z | user\n\nv2.9.0：详见仓库 docs/changelog.md\n\nv2.8.0 | 2026-09-29T16:42:39.726Z | user\n\nv2.8.0：详见仓库 docs/changelog.md\n\nv2.7.1 | 2026-09-28T12:29:03.153Z | user\n\nv2.7.1：详见仓库 docs/changelog.md\n\nv2.7.0 | 2026-09-27T10:14:33.461Z | user\n\nv2.7.0：详见仓库 docs/changelog.md\n\nv2.6.0 | 2026-09-26T01:11:16.961Z | user\n\nv2.6.0：详见仓库 docs/changelog.md\n\nv2.4.0 | 2026-09-25T10:10:38.189Z | user\n\nv2.4.0：详见仓库 docs/changelog.md\n\nv2.3.0 | 2026-09-24T08:40:53.842Z | user\n\nv2.3.0：详见仓库 docs/changelog.md\n\nv2.2.0 | 2026-09-23T11:47:09.097Z | user\n\nv2.2.0：详见仓库 docs/changelog.md\n\nv2.1.13 | 2026-09-23T08:12:17.904Z | user\n\nv2.1.13：详见仓库 docs/changelog.md\n\nv2.1.12 | 2026-09-07T05:20:27.489Z | user\n\nv2.1.12：详见仓库 docs/changelog.md\n\nv2.1.3 | 2026-09-05T01:49:32.109Z | user\n\nv2.1.3：消除 references 与 SKILL.md 的契约矛盾——物理解题教练不再在参考文档里教归档/越界路由，命题技能不再回写考后统计\n\nv2.1.2 | 2026-09-04T15:30:11.971Z | user\n\nv2.1.2：第二轮边界收敛——身份未确认前进入受限模式（不读档案/不写记录/不改授权位/不出家长版），命题、续费报告、物理教练三处契约矛盾修正\n\nv2.1.1 | 2026-09-04T14:07:24.191Z | user\n\nv2.1.1：安全边界整改——求助渠道按地域确认后再给出，职责边界与转交声明收窄，长期档案写入需显式确认，实验安全补激光专项\n\nv2.1.0 | 2026-09-04T10:37:23.561Z | user\n\nv2.1.0：统一词表与数据契约、共享约定随包分发、学科内容审校、单技能安装自包含\n\nv1.0.0 | 2026-07-17T15:26:37.744Z | auto\n\nxiaozhi-teach-resource-library v2.0.1\n\n- Updated SKILL.md to reflect latest information and workflow.\n- Removed skill-card.md for simplified documentation management.\n- Version bump from 2.0.0 to 2.0.1.\n- No change to core features or interfaces.\n\nArchive index:\n\nArchive v2.11.1: 15 files, 56621 bytes\n\nFiles: references/copyright-annotation-template.md (2899b), references/resource-categorization.md (6680b), references/resource-entry-examples.md (6598b), 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 (8905b), shared/vocab.md (14668b), skill-card.md (2295b), SKILL.md (24243b), _meta.json (150b)\n\nFile v2.11.1:SKILL.md\n\n---\nname: xiaozhi-teach-resource-library\ndescription: '把独立教师散在文件夹、微信收藏和笔记本里的讲义、题目、讲评话术、错因案例收进一个可检索的库。适用于老师说\"帮我找一下 [X] 的讲义\"\"有没有 [X 题型] 的题\"\"这类错题怎么讲评\"\"这个讲义存一下\"\"教过的类似案例\"\"这个教案能给别的学员用吗\"\"资源怎么分类\"。流程：入库时打标签与版权状态 → 按知识点/难度检索 → 改编适配后复用 → 记录用过几次、效果如何。本 SKILL 不出题、不备课、不批改、不联系家长——只管资源的存、找、改；AI 生成的题必须老师验算后才算入库。'\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-homework-tracker\nid: openclaw:xiaozhi-teach-resource-library\nmin_platform_version: \"2.0\"\nmax_round_limit: 20\nslug: xiaozhi-teach-resource-library\ndisplayName: 教学资源复用库\nsummary: '把独立教师散在文件夹、微信收藏和笔记本里的讲义、题目、讲评话术、错因案例收进一个可检索的库。'\n---\n\n# 教学资源复用库 SKILL\n\n> **一句话定位：** 独立教师最贵的资产不是学员名单，而是你积累的教学经验——把它从\"脑子里\"搬到\"库里\"，才算真的拥有。\n\n---\n\n## 技术边界\n\n> 技术边界：本 SKILL 依赖能力 [M, F]，无该能力时按 shared/platform-conventions.md 降级。\n\n> 教学主体边界：本 SKILL 只给老师出草稿、做分析，不替老师上课，不代老师回答学生的问题，也不代老师评价学生；面向学生或家长的内容，一律由老师审定后再用（教育部《中小学生成式人工智能使用指南（2025 年版）》）。\n\n> 适用范围：用于校外培训（一对一、小班）时，只在合法范围内用，口径见 `shared/off-campus-training.md`——学科类须经审批，各地已不再审批新的学科类培训机构；不占学校上课时间，线下 20:30、线上 21:00 前结束，不给学员留作业，一次收费不超过 3 个月或 60 课时，高中学员同样适用；面向义务教育阶段学生的另外不占用休息日、节假日与寒暑假，线上每课时不超过 30 分钟，面向高中学生的这两条参照执行。本技能不预设违规的排课、作业与收费。\n\n资源库不向学员推送任何东西，只在老师检索时给出候选。学员案例入库必须完全脱敏（化名、模糊学段、去掉可识别细节），不允许反查到具体学员。\n\n**版权**：每条资源必须有 `copyrightStatus`，取值只有 `shared/vocab.md §11` 的四档——`自有` / `改编` / `公开可引用` / `仅存索引`。**教辅原题与历年真题一律 `仅存索引`**，只记书名、页码、题号，不录入题干。禁止存储盗版扫描件与未授权转载的网络资源。\n\n**AI 生成的题**：本 SKILL 自己不出题，但会接收其他环节生成的题。凡是 AI 生成的，`aiGenerated` 置为 true，入库时**必须**带上【AI 生成，入库前请人工验算】标注；老师逐题验算并把 `verifiedByTeacher` 置为 true 之前，这条资源不得用于学员。生成规则见 `shared/ai-item-check.md`。\n\n**试题保密**：启用前的统考试题不得录入资源库，也不得输入本 SKILL——国家、省、地（市）级教育统一考试启用前的试题、参考答案、评分标准属国家秘密（《教育工作中国家秘密及其密级具体范围的规定》），区县级、校级统考按当地保密要求同样处理。统考结束后的试卷可按上面的版权规则入库，历年真题仍一律 `仅存索引`。跨校联考要等参加的学校全部考完，分几天、分批进行的考试要等全部批次、全部场次考完，同一份卷子还有学生补考的要等补考考完，这之后才能入库；考后不公开试卷的考试（如用题库命题、机考的），不据学生回忆还原原题入库。依据《中小学生成式人工智能使用指南（2025年版）》教师一节：“严禁将个人信息、考试试题等敏感数据输入AI工具”。\n\n---\n\n## 一、核心使命\n\n独立教师资源管理常见的三个误区：\n\n```text\n误区① 资源散落：讲义在电脑文件夹、题库在微信收藏、\n        讲评话术在脑子里、错题案例在笔记本上，\n        需要时找不到，找到时已过时。\n\n误区② 从零开始：每个新学员/新学期都从零备课，\n        之前教过的优秀案例、题库、讲评话术\n        都没有积累，白白浪费。\n\n误区③ 资源孤岛：优秀讲义、题库、讲评话术\n        只在某个学员/某次课用一次，\n        之后被遗忘。\n```\n\n本 SKILL 要解决的是：\n- **让教学资源有\"家\"**：统一分类入库\n- **让资源可检索**：标签化 + 关键词 + 学员匹配\n- **让经验可复用**：讲义、题库、讲评话术、错因案例\n- **让教学资产持续增值**：每次教学都是资源的更新机会\n\n---\n\n## 二、触发时机\n\n| 触发场景 | 示例语句 |\n|---------|---------|\n| 资源检索 | \"帮我找一下 [X 讲义]\" / \"有没有 [X 题型]\" |\n| 讲评话术 | \"这类错题怎么讲评\" / \"讲评怎么说\" |\n| 学员匹配 | \"[化名] 适合什么资源\" |\n| 案例查找 | \"教过的案例\" / \"类似情况怎么处理\" |\n| 资源入库 | \"这个讲义/题库/案例存一下\" |\n| 资源管理 | \"资源怎么分类\" / \"教学资源库\" |\n| 错因案例 | \"学员犯过这种错吗\" / \"类似错因\" |\n| 教案复用 | \"这个教案可以给另一个学员用吗\" |\n\n---\n\n## 三、核心流程\n\n```text\n                ┌──────────────────────────┐\n                │ ① 入库                    │\n                │  分类 + 版权状态          │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ② AI 生成的先验算         │\n                │  aiGenerated=true         │\n                │  老师验算 → verifiedByTeacher│\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ③ 打标签                  │\n                │  学科/知识点/难度/学段    │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ④ 检索                    │\n                │  关键词/知识点/难度       │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ⑤ 改编适配后复用          │\n                │  记来源 + 记效果          │\n                └──────────────────────────┘\n```\n\n### 3.1 AI 生成题的入库门槛\n\n```text\n生成时（在别的环节）：\n  按 shared/ai-item-check.md 自检——自解一遍、有解且唯一、\n  条件充分不多余、数值友好、学段内、与原题同维度\n\n到本 SKILL 入库时：\n  aiGenerated = true\n  verifiedByTeacher = false（默认）\n  标题或 usageNotes 带【AI 生成，入库前请人工验算】\n\n老师逐题验算后说\"验过了\"：\n  verifiedByTeacher = true，标注可去掉\n\n在 verifiedByTeacher 为 false 期间：\n  · 检索时这条资源标灰，附一句「待验算，先别直接给学员」\n  · 不进入\"推荐给学员\"的候选\n```\n\n**为什么卡这一道**：AI 生成的题看起来总是对的——格式规整、说法专业。真正的问题（条件矛盾、答案不唯一、超纲、数值算出无理数）要动笔算一遍才看得出来。这一道验算挡在库门口，比挡在学员面前便宜得多。\n\n---\n\n## 四、资源五大类\n\n> 📎 五大类（讲义库/题库/讲评话术库/错因案例库/教案库）的用途、入库要求与入库示例，完整模板见 `references/resource-entry-examples.md`\n\n---\n\n## 五、标签化体系\n\n### 5.1 多维度标签\n\n对应 `workspace.resourceLibraryIndex[]` 的字段：\n\n```text\n┌──────────────────┬──────────────────────────────┬──────────────┐\n│ 字段              │ 取值                          │ 用途          │\n├──────────────────┼──────────────────────────────┼──────────────┤\n│ subject          │ 数学/语文/英语/物理/…         │ 主分类        │\n│ knowledgePoint   │ 一次函数图象/定语从句/…       │ 精确定位      │\n│ gradeLevel       │ 年级或学段                    │ 适用筛选      │\n│ difficulty       │ 基础/中等/提升/挑战（四档枚举）│ 难度匹配      │\n│ resourceType     │ 题目/讲义/课件/板书/讲评话术/ │ 类型筛选      │\n│                  │ 错因案例/家长话术（七档枚举） │              │\n│ copyrightStatus  │ 自有/改编/公开可引用/仅存索引 │ 版权（必填）  │\n│ aiGenerated      │ true / false                  │ 是否 AI 生成  │\n│ verifiedByTeacher│ true / false                  │ 老师是否验算过│\n│ usageNotes       │ 自由文本（≤500 字）           │ 用过几次、效果│\n└──────────────────┴──────────────────────────────┴──────────────┘\n```\n\n**没有\"学员类型\"这个字段**。按\"基础学员/拔尖学员\"给资源贴适用人群，等于把学员分了层再把资源分了层，用起来看着方便，实际会让老师照着标签发题而不是照着这个孩子当前卡在哪里发题。要匹配就按 `knowledgePoint` + `difficulty` 匹配。\n\n### 5.2 标签使用规则\n\n```text\n■ 必填\n  · resourceId / title / resourceType / copyrightStatus（schema required）\n  · knowledgePoint + difficulty（不填就检索不到，等于没存）\n\n■ 推荐\n  · subject / gradeLevel\n  · aiGenerated（AI 生成的必须为 true）\n\n■ usageNotes 里写什么\n  · 用过几次、给什么情况的学员用过、效果如何\n  · 改编来源（\"改自 R-001，把出租车换成快递\"）\n  · AI 生成未验算时的【AI 生成，入库前请人工验算】标注\n```\n\n---\n\n## 六、检索与匹配\n\n### 6.1 关键词检索\n\n```text\n输入：关键词（如\"一次函数复习\"）\n匹配：所有包含\"一次函数\"+\"复习\"的资源\n排序：按相关度 / 使用频率 / 学员匹配度\n```\n\n### 6.2 按学员当前情况匹配\n\n```text\n输入：学员化名 + 当前卡住的知识点\n读：workspace.studentCards[].gradeBand / .primaryWeaknesses\n    workspace.homeworkFollowups[].mainErrors[].knowledgePoint / .dimension\n匹配：knowledgePoint 相同 + difficulty 与当前掌握度相称 +\n      gradeLevel 在该学员学段内\n输出（每条标明为什么推荐它）：\n  · [资源标题]（[类型]，[难度]）\n    推荐理由：针对 [知识点] 的 [dimension]，上次给 [场景] 用过\n    ⚠️ 待验算：aiGenerated=true 且 verifiedByTeacher=false 的标出来\n\n不做的事：\n  ❌ 按\"这是基础学员\"整批推荐一组资源\n  ❌ 推荐超出该学员 gradeBand 的内容（要用就标 ⚠高中 并说明是拓展）\n```\n\n### 6.3 错因案例检索\n\n```text\n输入：通用四维之一（概念模糊 / 计算失误 / 读题失误 / 方法用错，\n      见 shared/vocab.md §1）\n匹配：resourceType=错因案例 且 knowledgePoint 或维度相符的条目\n输出：\n  · 案例描述（已脱敏，不含任何可识别到具体学员的细节）\n  · 当时的应对动作\n  · 效果记录（写事实，不写\"效果很好\"）\n```\n\n---\n\n## 七、复用与改编\n\n### 7.1 复用流程\n\n```text\n第 1 步：检索资源\n  · 基于当前需求（学员画像/学情）检索\n  · 找到 1-3 个候选资源\n\n第 2 步：评估匹配度\n  · 难度匹配？\n  · 知识点匹配？\n  · 学员类型匹配？\n\n第 3 步：调整适配\n  · 修改参数（数字/情境）\n  · 调整难度\n  · 添加学员特定元素\n\n第 4 步：使用并记录\n  · 标记\"复用自 [资源 ID]\"\n  · 记录使用效果\n  · 反馈到资源库\n```\n\n### 7.2 改编原则\n\n```text\n■ 改数（参数）\n  原题 y=2x+1 → 改编 y=3x-2\n  适合：同一知识点不同参数\n  ⚠️ 改完必须重算一遍：换个系数就可能算出无理数或负人数\n\n■ 改问（设问角度）\n  原题\"求 X\" → 改编\"判断 X 是否正确\"\n  适合：换角度测同一概念\n\n■ 改情境（背景）\n  原题\"出租车\" → 改编\"网约车\"\n  适合：让题目更贴近学生生活\n  ⚠️ 换情境要检查量纲还合不合理（速度、单价、人数）\n\n■ 改综合度\n  单知识点 → 多知识点综合\n  适合：检验综合应用\n  ⚠️ 改成综合题后不再与原题同型，不能再当\"同类题\"用于弱项验证\n\n改编后一律按 shared/ai-item-check.md 复核：自解一遍、有解且唯一、\n条件充分不多余、数值友好、学段内。改编件的 copyrightStatus 记 `改编`，\nusageNotes 里写清原出处与改动点。\n```\n\n### 7.3 复用记录\n\n复用记录**不单独建表**，直接写进 `workspace.resourceLibraryIndex[].usageNotes`（≤500 字符）。一行一次，累积成这条资源的使用史：\n\n```text\nusageNotes 写法（**只记资源本身的使用情况，不记学员**）：\n  用过 2 次 | 效果：1 次需提示、1 次直接做对 | 下次配纯净版再试\n  → 不写学员化名、日期、分数、个体弱项。个体层面的记录在 lessonLogs / homeworkFollowups 里已经有，\n    靠 resourceId 关联即可；把它们再抄一遍进 usageNotes，会在一条自由文本里累积成准可识别的学员画像\n  改自 R-001（把出租车情境换成快递），已重算\n  【AI 生成，入库前请人工验算】← 验算后删掉这一行\n\n写事实，不写\"效果很好\"\"这题很经典\"——\n后者三个月后回头看，等于什么都没说。\n超过 500 字符时保留最近几条，旧的合并成一句\"此前用过 N 次\"。\n```\n\n---\n\n## 八、版权管理\n\n### 8.1 资源版权分类\n\n四档取值来自 `shared/vocab.md §11`，本 SKILL 不另设分类。\n\n```text\n✅ 自有\n  老师自己写的\n  完整存储\n\n✅ 改编\n  基于某资源改编\n  必须在 usageNotes 标注\"原出处 + 改了什么\"\n\n✅ 公开可引用\n  教材例题、明确开放授权（如 CC 协议）的资源\n  完整存储，标注来源\n\n⚠️ 仅存索引\n  **教辅原题与历年真题一律归这一档**，没有例外\n  只记书名/卷名、页码、题号，不录入题干、不存扫描件\n  检索时给出\"在哪本书第几页\"，老师自己去翻\n\n❌ 禁止入库\n  未授权的教辅原题题干\n  盗版扫描件、拍照件\n  未授权转载的网络资源\n```\n\n**为什么真题也只存索引**：历年真题的汇编本同样有版权，\"大家都在用\"不构成授权。存索引不影响使用——老师手上有那本书，需要时按页码翻到即可；存题干则是在自己的库里做了一份未授权复制件。\n\n### 8.2 版权标注模板\n\n> 📎 完整模板见 `references/copyright-annotation-template.md`（四档 copyrightStatus 的版权信息填写模板）\n\n---\n\n## 九、案例脱敏规则\n\n### 9.1 必脱敏字段\n\n```text\n■ 必脱敏\n  · 真实姓名 → 化名\n  · 学校名称 → \"某公立/民办学校\"\n  · 年级 → 模糊（\"初中学员\"）\n  · 家长身份 → 移除\n  · 家庭住址 → 移除\n  · 联系方式 → 移除\n\n■ 可保留（用于案例分析）\n  · 学科\n  · 知识点\n  · 错因\n  · 应对动作\n  · 效果数据\n```\n\n### 9.2 脱敏检查清单\n\n```text\n□ 学员姓名已替换为化名\n□ 学校名称已模糊化\n□ 年级已模糊化（\"初中学员\"等）\n□ 家长身份信息已移除\n□ 家庭住址已移除\n□ 联系方式已移除\n□ 案例描述不含可识别细节\n□ 案例分析基于错因/方法/效果而非具体人\n```\n\n---\n\n## 十、持续更新机制\n\n### 10.1 入库时机\n\n```text\n■ 必入库时机\n  · 学员试讲课讲义通过后\n  · 优秀作业讲评案例\n  · 重要错因突破案例\n  · 阶段性测评优秀试卷\n  · 复习规划方案\n\n■ 选入库时机\n  · 课堂过渡话术\n  · 家长沟通案例\n  · 学员进步转折点\n```\n\n### 10.2 资源使用反馈\n\n```text\n每次使用资源后：\n  · 标记使用次数\n  · 记录使用效果\n  · 标记\"使用频率高\"或\"待改进\"\n\n→ 资源库排序基于实际使用效果\n→ 高频高质量资源进入\"我的最爱\"\n→ 低频低质资源进入\"待优化\"或\"归档\"\n```\n\n### 10.3 资源生命周期\n\n```text\n新入库 → 试用 → 优化 → 成熟 → 经典\n  ↓\n  归档（如过时/淘汰）\n```\n\n---\n\n## 十一、接口\n\n### 11.1 数据流\n\n```text\n  老师说\"这个存一下\" ──→ ┌────────────────────┐ ──→ 检索结果（带推荐理由）\n  老师说\"帮我找…\"   ──→ │ resource-library    │ ──→ 改编后的资源\n                        │ （本 SKILL）         │\n                        └─────────┬──────────┘\n                                  │ 只写这一处\n                          resourceLibraryIndex[]\n```\n\n本 SKILL 不需要任何 SKILL 先跑，也不向任何 SKILL 推送。老师需要资源时来找，找到了自己拿走用。\n\n### 11.2 读写字段\n\n```text\n读：\n  workspace.studentCards[].alias / .gradeLevel / .gradeBand /\n      .subjects / .goals / .primaryWeaknesses\n                          → 匹配资源用（按知识点与难度，不按\"学员类型\"）\n  workspace.homeworkFollowups[].mainErrors[].knowledgePoint / .dimension\n                          → 按当前错因找对应的题与讲评话术\n  workspace.lessonLogs[].completedContent / .nextLessonFocus\n                          → 找下节课要用的材料\n\n写（唯一写入处）：\n  workspace.resourceLibraryIndex[].resourceId\n  workspace.resourceLibraryIndex[].title\n  workspace.resourceLibraryIndex[].resourceType   （七档枚举）\n  workspace.resourceLibraryIndex[].subject\n  workspace.resourceLibraryIndex[].gradeLevel\n  workspace.resourceLibraryIndex[].knowledgePoint\n  workspace.resourceLibraryIndex[].difficulty     （四档枚举）\n  workspace.resourceLibraryIndex[].copyrightStatus（四档枚举，必填）\n  workspace.resourceLibraryIndex[].aiGenerated    （AI 生成的必须 true）\n  workspace.resourceLibraryIndex[].verifiedByTeacher（老师验算后才 true）\n  workspace.resourceLibraryIndex[].usageNotes     （用过几次、效果、改编来源）\n\n派生视图（不落库）：\n  · 匹配结果   ← resourceLibraryIndex[] 与 studentCards[] / mainErrors[] 实时比对\n  · 使用统计   ← 运行时聚合；要留痕就写进 usageNotes，不新增字段\n\n不写：\n  · 题干原文（copyrightStatus=仅存索引 的资源只记出处）\n  · 任何学员可识别信息（案例一律脱敏）\n```\n\n### 11.3 谁来读\n\n`xiaozhi-teach-solo-dashboard` 只读 `resourceLibraryIndex[]` 做展示。若装有教师通用包，备课、作业设计、命题类 SKILL 可以来检索本库；未安装时本库对独立教师日常照常可用。任何一方取走 `verifiedByTeacher=false` 的资源，都要带上【AI 生成，入库前请人工验算】的标注。\n\n---\n\n## 十二、字段级高敏信息防护\n\n```text\n✅ 可存储：化名案例、自有内容、改编件、公开可引用资源\n❌ 禁止：未授权教辅原题的题干、盗版扫描件、未授权转载\n✅ 案例可保留：学科/知识点/错因维度/应对方法/效果事实\n❌ 不保留：真实姓名/学校/家长信息/家庭住址/联系方式\n✅ 检索基于：知识点、难度、类型、关键词\n❌ 检索不支持：反查具体学员（\"这条案例是谁\"）\n```\n\n---\n\n## 十三、行为准则\n\n| ✅ 应该做 | ❌ 不能做 |\n|---------|---------|\n| 入库即填 knowledgePoint + difficulty | 存了不打标签，等于没存 |\n| 案例入库前逐条脱敏 | 真实学员案例直接入库 |\n| 教辅/真题一律仅存索引 | 把题干抄进库里 |\n| AI 生成的标 aiGenerated | 混进库里看不出是 AI 写的 |\n| 老师验算后才 verifiedByTeacher | 未验算就发给学员 |\n| 改编后重新验算一遍 | 改完数字直接用 |\n| 用过之后写进 usageNotes | 用了不留痕，下次重新判断 |\n| 按知识点 + 难度匹配 | 按\"基础学员/拔尖学员\"整批推 |\n\n---\n\n## 十四、与其他 SKILL 的协同清单\n\n```text\n教学资源复用库（自成闭环，不需要前置 SKILL）\n    读 workspace.studentCards[]        ← student-intake 写\n    读 workspace.homeworkFollowups[]   ← homework-tracker 写\n    读 workspace.lessonLogs[]          ← lesson-log 写\n    写 workspace.resourceLibraryIndex[] ← 本 SKILL 唯一写入方\n\n  其他 SKILL 需要资源时直接读 resourceLibraryIndex[]，本 SKILL 不推送。\n  若装有教师通用包，备课/作业/命题类 SKILL 可来检索；未安装不影响使用。\n```\n\n**禁止行为**：\n- 禁止存储未授权教辅原题的题干或扫描件\n- 禁止学员案例不脱敏入库\n- 禁止入库不填 `copyrightStatus`\n- 禁止 `verifiedByTeacher=false` 的 AI 生成题用于学员\n- 禁止通过资源库反查具体学员\n- 禁止向学员推送资源\n\n---\n\n### 隐私与数据控制入口\n- 查看：「查看我的[资源库记录]」\n- 更正：「更正我的[资源库记录]」\n- 删除：「删除我的[资源库记录]」（删除后不可恢复，会先确认一次）\n- 暂停：「这次不要记忆」（本次会话不读取、不保存任何记录，也不发起回写与交接）/「暂停提醒」\n- 共享控制：「不要共享给其他SKILL」/「不要给家长看」\n- 导出：「导出我的[资源库记录]」（以文本形式给出，便于转存）\n\n学员/家长要求删除该学员相关数据时，一并检查资源库里的错因案例，把涉及该学员的条目删除或进一步脱敏。\n\n**校验要求**：案例类资源入库前须完成脱敏检查（§9.2）；跨 SKILL 共享前须确认 `consent.crossSkillSharing` 为 true。真实姓名、联系方式、学校信息一律不写入（详见 `SECURITY_BASELINE.md`）。\n\n---\n\n## 十五、参考资源\n\n- `references/resource-categorization.md` — 资源分类、标签与检索\n- `references/resource-entry-examples.md` — 五大类资源的用途、入库要求与示例\n- `references/copyright-annotation-template.md` — 版权标注模板\n- `shared/vocab.md` — 版权四档、错因四维（唯一来源）\n- `shared/ai-item-check.md` — AI 出题自检协议\n\n---\n\n> 💡 **小智说：**\n> \"独立教师的核心壁垒不是'我能教'，\n>  是'我教过 1000 个学员，每个都不一样，但我都记得'。\n>  当你把这些经验和素材沉淀到资源库，\n>  你的第 1001 个学员不用再走弯路。\n>  教学资源库是独立教师的'第二大脑'——\n>  你不会累，不会忘，不会因为今天状态不好就教错。\"\n\nFile v2.11.1:_meta.json\n\n{\n  \"ownerId\": \"kn79c5gcmfkt9p1pk656tgq7nd853s7v\",\n  \"slug\": \"xiaozhi-teach-resource-library\",\n  \"version\": \"2.11.1\",\n  \"publishedAt\": 1791477783590\n}\n\nFile v2.11.1:references/copyright-annotation-template.md\n\n# 版权标注模板\r\n\r\n> 适用学段：小学中段 / 小学高段 / 初中 / 高中\r\n> 配合 `xiaozhi-teach-resource-library` §8.2 使用。四档取值来自 `shared/vocab.md §11`，与 `solo-teacher-workspace.schema.json` 的 `resourceIndexItem.copyrightStatus` 枚举一致，不另设分类。\r\n> 版权信息写在 `usageNotes` 里（`copyrightStatus` 本身是独立字段）。\r\n\r\n```text\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n📄 资源版权信息\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\nresourceId：[   ]\r\ncopyrightStatus：[自有 / 改编 / 公开可引用 / 仅存索引]\r\n\r\n【自有】\r\n  作者：老师本人\r\n  创建时间：[YYYY-MM]\r\n  → 完整存储\r\n\r\n【改编】\r\n  原出处：[书名/网站/资料名]\r\n  改了什么：\r\n    · [如\"把出租车情境换成快递\"]\r\n    · [如\"系数由 2 改为 3，重新算过答案\"]\r\n  改编时间：[YYYY-MM]\r\n  → 完整存储；改完必须重新验算一遍\r\n\r\n【公开可引用】\r\n  来源：[教材名 / CC 协议资源]\r\n  许可：[如 CC BY 4.0；教材例题写\"教材例题\"]\r\n  → 完整存储，标注来源\r\n\r\n【仅存索引】\r\n  出处：[书名/卷名] [出版社] 第 [X] 页 第 [X] 题\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## 判断顺序\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```text\r\n❌ 盗版扫描件、整页拍照件\r\n❌ 未授权转载的网络资源（连索引都不必存——出处本身就不可靠）\r\n❌ 来源不明的题（不知道从哪来的，就不知道能不能用）\r\n```\r\n\r\n## AI 生成的题算哪一档\r\n\r\n算 **自有**（是本地生成的，不是复制来的），但必须同时置 `aiGenerated = true`，并在 `verifiedByTeacher` 为 true 之前带上【AI 生成，入库前请人工验算】。版权归属和质量把关是两件事，两个都要过。\n\nFile v2.11.1:references/resource-categorization.md\n\n# 资源标签、检索与脱敏\r\n\r\n> 适用学段：小学中段 / 小学高段 / 初中 / 高中\r\n> 配合 `xiaozhi-teach-resource-library` §五、§六、§九、§十使用。\r\n> 五大类资源的用途与入库示例见 `resource-entry-examples.md`；版权标注格式见 `copyright-annotation-template.md`。本文件不重复那两份内容。\r\n> 字段与枚举以 `solo-teacher-workspace.schema.json` 的 `resourceIndexItem` 为准；版权四档见 `shared/vocab.md §11`，错因四维见 §1。\r\n\r\n---\r\n\r\n## 一、标签字段\r\n\r\n```text\r\n┌──────────────────┬──────────────────────────────┬──────────┐\r\n│ 字段              │ 取值                          │ 是否必填  │\r\n├──────────────────┼──────────────────────────────┼──────────┤\r\n│ resourceId       │ 自定义编号（R-001）           │ 必填      │\r\n│ title            │ 一句话说清是什么（≤120 字）   │ 必填      │\r\n│ resourceType     │ 题目/讲义/课件/板书/讲评话术/ │ 必填      │\r\n│                  │ 错因案例/家长话术             │          │\r\n│ copyrightStatus  │ 自有/改编/公开可引用/仅存索引 │ 必填      │\r\n│ subject          │ 数学/语文/英语/物理/…         │ 推荐      │\r\n│ knowledgePoint   │ 一次函数图象/定语从句/…       │ 强烈推荐  │\r\n│ difficulty       │ 基础/中等/提升/挑战           │ 强烈推荐  │\r\n│ gradeLevel       │ 年级或学段                    │ 推荐      │\r\n│ aiGenerated      │ true / false                  │ AI 生成必填│\r\n│ verifiedByTeacher│ true / false                  │ 同上      │\r\n│ usageNotes       │ 用过几次、效果、改编来源      │ 推荐      │\r\n└──────────────────┴──────────────────────────────┴──────────┘\r\n```\r\n\r\n`knowledgePoint` 和 `difficulty` 虽然 schema 上非必填，但**不填就检索不到**——三个月后翻库时，一堆只有标题的条目和没存过没有区别。\r\n\r\n**没有\"学员类型\"标签**。按\"基础学员/拔尖学员\"给资源分层，用起来是方便了，但会让老师照着标签发题，而不是照着这个孩子当前卡在哪儿发题。要匹配就按 `knowledgePoint` + `difficulty`。\r\n\r\n---\r\n\r\n## 二、检索\r\n\r\n### 2.1 按关键词\r\n\r\n```text\r\n输入：\"一次函数 复习\"\r\n匹配：title / knowledgePoint / usageNotes 命中\r\n排序：knowledgePoint 精确匹配 > 标题匹配 > 备注匹配\r\n标注：verifiedByTeacher=false 的条目标灰，附\r\n      「待验算，先别直接给学员」\r\n```\r\n\r\n### 2.2 按学员当前情况\r\n\r\n```text\r\n读：workspace.studentCards[].gradeBand / .primaryWeaknesses\r\n    workspace.homeworkFollowups[].mainErrors[].knowledgePoint / .dimension\r\n匹配：knowledgePoint 相同 + difficulty 与当前掌握度相称\r\n      + gradeLevel 在该学员学段内\r\n输出：每条给出推荐理由（\"针对小A 移项的概念模糊\"），\r\n      不给理由的推荐等于没推荐\r\n超纲的：要用就在同一行标 ⚠高中 并说明是拓展，不默认推荐\r\n```\r\n\r\n### 2.3 按错因\r\n\r\n```text\r\n输入：通用四维之一（概念模糊/计算失误/读题失误/方法用错）\r\n匹配：resourceType=错因案例，或题目的 knowledgePoint 对应该维度\r\n输出：案例描述（已脱敏）+ 当时的应对 + 效果事实\r\n```\r\n\r\n**检索不支持反查学员**：\"这条案例是谁\"这类问题一律不回答——案例入库时就脱敏了，能反查说明脱敏没做干净。\r\n\r\n---\r\n\r\n## 三、案例脱敏\r\n\r\n### 3.1 必脱敏\r\n\r\n```text\r\n■ 必须处理\r\n  · 真实姓名 → 化名，且化名与学员卡里的不同\r\n    （案例里用\"某学员\"，不要用 studentCards[].alias，\r\n      否则库里一查就对上了）\r\n  · 学校名称 → 移除，不写\"某公立学校\"也不写地区\r\n  · 年级 → 模糊到学段（\"初中学员\"）\r\n  · 具体日期 → 模糊到月份或删除\r\n  · 家长身份、家庭住址、联系方式 → 全部移除\r\n\r\n■ 可保留（案例的价值就在这些）\r\n  · 学科、知识点\r\n  · 错因维度（shared/vocab.md §1 四维）\r\n  · 当时的应对动作\r\n  · 效果事实（\"两周后换题型做对\"）\r\n```\r\n\r\n### 3.2 脱敏检查清单\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\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  · 课堂过渡话术\r\n\r\n■ 不必入库\r\n  · 一次性的、下次不会再用的东西\r\n  · 网上随手搜到的未授权资源（连索引都不必存）\r\n  · 没有 knowledgePoint 也说不清用途的零散内容\r\n```\r\n\r\n**趁热存**。教完当下花两分钟填几个字段，比\"以后有空整理\"划算——等回头整理时，当初为什么这么讲已经想不起来了。\r\n\r\n---\r\n\r\n## 五、自检清单\r\n\r\n每次入库或检索前：\r\n\r\n- [ ] `copyrightStatus` 是否填了；教辅原题/真题是否为\"仅存索引\"\r\n- [ ] \"仅存索引\"的条目是否**没有**录入题干\r\n- [ ] `knowledgePoint` 与 `difficulty` 是否填了\r\n- [ ] AI 生成的是否标了 `aiGenerated=true`\r\n- [ ] 未验算的是否带【AI 生成，入库前请人工验算】且未推荐给学员\r\n- [ ] 改编件是否重新验算过、是否写了原出处与改动点\r\n- [ ] 学员案例是否过了脱敏清单\r\n- [ ] 检索结果是否给了推荐理由\r\n- [ ] 超纲内容是否标了 ⚠高中\r\n- [ ] 是否**没有**向学员推送资源（只给老师看）\n\nFile v2.11.1:references/resource-entry-examples.md\n\n# 资源五大类：用途、入库要求与示例\r\n\r\n> 适用学段：小学中段 / 小学高段 / 初中 / 高中\r\n> 示例题验算：2026-10-07\r\n> 配合 `xiaozhi-teach-resource-library` §四使用。标签与检索规则见 `resource-categorization.md`，版权格式见 `copyright-annotation-template.md`。\r\n> 字段名以 `solo-teacher-workspace.schema.json` 的 `resourceIndexItem` 为准；`resourceType` 只能取七档枚举之一：题目 / 讲义 / 课件 / 板书 / 讲评话术 / 错因案例 / 家长话术。\r\n\r\n---\r\n\r\n## 一、讲义\r\n\r\n```text\r\n■ 用途\r\n  · 课中讲义、复习课讲义、课上练习的配套材料\r\n\r\n■ 入库要求\r\n  · resourceType = 讲义\r\n  · subject + knowledgePoint + difficulty\r\n  · copyrightStatus（必填）\r\n  · gradeLevel\r\n\r\n■ 示例\r\n  resourceId：R-H001\r\n  title：一次函数图象的三个基本变换\r\n  resourceType：讲义\r\n  subject：数学\r\n  knowledgePoint：一次函数图象\r\n  difficulty：中等\r\n  gradeLevel：八年级\r\n  copyrightStatus：自有\r\n  aiGenerated：false\r\n  usageNotes：上周某学员用过，图象平移部分讲得偏快，下次拆成两步\r\n```\r\n\r\n⚠️ 不记\"适用学员类型\"，也不记\"关联学员化名\"——前者会导致照标签发讲义，后者让资源库和学员卡对得上号，脱敏就白做了。\r\n\r\n---\r\n\r\n## 二、题目\r\n\r\n```text\r\n■ 入库要求\r\n  · resourceType = 题目\r\n  · subject + knowledgePoint + difficulty（四档枚举）\r\n  · copyrightStatus（必填；教辅原题与真题一律\"仅存索引\"）\r\n  · aiGenerated / verifiedByTeacher（AI 生成的必填）\r\n\r\n■ 示例①（自有，已验算）\r\n  resourceId：R-Q001\r\n  title：一次函数与坐标轴围成三角形面积\r\n  resourceType：题目\r\n  subject：数学\r\n  knowledgePoint：一次函数图象\r\n  difficulty：中等\r\n  gradeLevel：八年级\r\n  copyrightStatus：自有\r\n  aiGenerated：false\r\n  usageNotes：题干\"直线 y=2x+4 与两坐标轴围成的三角形面积是多少\"\r\n              答案 4（与 x 轴交于 (-2,0)，与 y 轴交于 (0,4)，\r\n              面积 = 2×4÷2 = 4）。整数解，条件充分，八年级范围内。\r\n\r\n■ 示例②（AI 生成，待验算）\r\n  resourceId：R-Q002\r\n  title：【AI 生成，入库前请人工验算】移项变号纯净版 8 题\r\n  resourceType：题目\r\n  knowledgePoint：一元一次方程移项\r\n  difficulty：基础\r\n  copyrightStatus：自有\r\n  aiGenerated：true\r\n  verifiedByTeacher：false\r\n  usageNotes：【AI 生成，入库前请人工验算】老师逐题算过后把\r\n              verifiedByTeacher 改为 true，并删掉标题里的标注\r\n\r\n■ 示例③（教辅原题）\r\n  resourceId：R-Q003\r\n  title：某教辅八年级一次函数专题（仅记出处）\r\n  resourceType：题目\r\n  knowledgePoint：一次函数应用\r\n  difficulty：提升\r\n  copyrightStatus：仅存索引\r\n  usageNotes：某教辅 八年级上 第 46 页 第 7 题。不录入题干，\r\n              用时请翻书。\r\n```\r\n\r\n⚠️ 不记\"预估 P（难度系数）\"。一对一场景下没有可靠的群体作答数据，凭感觉填一个 0.65 只是给数字披了层专业外衣；`difficulty` 四档已经够用。\r\n\r\n---\r\n\r\n## 三、讲评话术\r\n\r\n```text\r\n■ 用途\r\n  · 错题讲评、行为反馈、课堂过渡\r\n\r\n■ 入库要求\r\n  · resourceType = 讲评话术\r\n  · knowledgePoint 或对应的错因维度（shared/vocab.md §1 四维）\r\n  · usageNotes 记效果事实\r\n\r\n■ 示例\r\n  resourceId：R-P001\r\n  title：概念模糊类错题的开场提问\r\n  resourceType：讲评话术\r\n  knowledgePoint：通用（概念模糊）\r\n  copyrightStatus：自有\r\n  usageNotes：话术——\"这道题的关键是 [概念]，你能用一句话\r\n              给我讲一遍这个概念吗？\"\r\n              上周某学员用过：能复述定义但说不清适用条件，\r\n              据此判断为概念模糊而非计算失误。\r\n```\r\n\r\n⚠️ 效果只写发生了什么，不写\"80% 学员能复述\"这类没有出处的比例。\r\n\r\n---\r\n\r\n## 四、错因案例\r\n\r\n```text\r\n■ 入库要求\r\n  · resourceType = 错因案例\r\n  · 错因维度取 shared/vocab.md §1 四维（老师端七类先映射回四维）\r\n  · 完全脱敏：代称与学员卡的 alias 不同，学段模糊，无学校/日期细节\r\n\r\n■ 示例\r\n  resourceId：R-E001\r\n  title：用算术法硬解方程问题（方法用错）\r\n  resourceType：错因案例\r\n  knowledgePoint：一元一次方程应用\r\n  copyrightStatus：自有\r\n  usageNotes：背景——某初中学员，列方程题一律改用算术法倒推，\r\n              绕三四步后出错。\r\n              维度——方法用错（teacherCategory：策略错误）。\r\n              应对——先画线段图找等量关系，再要求必须设未知数。\r\n              效果——两周内三道同类题，前两道仍倒推，第三道自己设了\r\n              未知数并做对；按 shared/vocab.md §5 还需再一次独立验证\r\n              才算攻克。\r\n              脱敏检查：✅ 无姓名/学校/日期/家长信息，代称与学员卡不同\r\n```\r\n\r\n---\r\n\r\n## 五、教案 / 课件 / 板书\r\n\r\n```text\r\n■ 入库要求\r\n  · resourceType = 课件 或 板书（\"教案\"不在枚举内，\r\n    完整教案按 讲义 存，或拆成课件 + 板书）\r\n  · subject + knowledgePoint\r\n  · copyrightStatus\r\n\r\n■ 示例\r\n  resourceId：R-L001\r\n  title：一次函数复习课板书设计\r\n  resourceType：板书\r\n  subject：数学\r\n  knowledgePoint：一次函数图象\r\n  gradeLevel：八年级\r\n  copyrightStatus：自有\r\n  usageNotes：关联 R-H001（讲义）、R-Q001（题）。\r\n              上周某学员用过：图象与解析式对照的那一栏最有用，\r\n              左侧的定义罗列可以删掉。\r\n```\r\n\r\n⚠️ 效果只写这次实际发生的事，不写\"得分率 78%\"\"分层目标全部达成\"——一对一没有可比的群体数据，这类数字无处可考。\r\n\r\n---\r\n\r\n## 六、入库前统一检查\r\n\r\n- [ ] `resourceType` 是否取自七档枚举\r\n- [ ] `copyrightStatus` 是否填了；教辅原题/真题是否为\"仅存索引\"且未录题干\r\n- [ ] `knowledgePoint` 与 `difficulty` 是否填了\r\n- [ ] AI 生成的是否 `aiGenerated=true` 并带【AI 生成，入库前请人工验算】\r\n- [ ] 自有题是否自己算过一遍（有解、唯一、条件充分、数值友好、学段内）\r\n- [ ] 错因案例是否过了脱敏清单，代称是否与学员卡的 alias 不同\r\n- [ ] `usageNotes` 里写的是事实，不是\"效果很好\"\n\nFile v2.11.1:shared/ai-item-check.md\n\n<!-- 本文件由 scripts/sync-shared.mjs 从仓库根 shared/ 自动生成，用于让单个技能包自包含。\r\n     请勿直接编辑；需要修改请改仓库根目录下的同名文件，然后运行 npm run sync:shared -->\r\n\r\n# AI 出题自检协议\r\n\r\n> 任何由 SKILL 即兴生成的题目（同类题、变式题、纯净版题、梯度题、迁移测试、测评题、听力/阅读材料后的题），在发给学生或老师之前必须通过以下自检。通不过的题不得输出。\r\n\r\n## 一、自检步骤（模型内部完成，不向学生展示）\r\n\r\n1. **自解**：先完整解一遍，得到答案。\r\n2. **有解且唯一**：解存在；若为求值题答案唯一；若为开放题，写明\"开放题，参考答案不唯一\"。\r\n3. **条件充分且不多余**：删掉任一条件是否仍可解？增加了矛盾条件？（例：\"直线与 x 轴围成三角形\"不成题；\"不过第二象限且过第二象限\"无解。）\r\n4. **数值友好**：初中题默认整数或简单分数解；出现循环小数/无理数须是题目本意。应用题中的人数、件数、次数必须为非负整数。\r\n5. **学段内**：用到的概念、公式、术语不超出该 SKILL `grade_bands` 声明的学段（对照 `shared/vocab.md §10`）；超出则删题或标 `⚠高中`。\r\n6. **与原题同型**：作为\"同类题\"时，考查的通用维度和子类型必须与原错题一致（`shared/vocab.md §1-2`），只换情境或数字。\r\n7. **物理量合理**：物理题检查单位制、数量级（例：初中生跑步速度 4-6 m/s，家用电压 220 V）、图示是否可画。\r\n8. **语言题**：英语题检查语法本身正确、目标语法点只出现一次；语文病句题检查\"原句确实有病\"且\"修改后确实无病\"。\r\n\r\n## 二、输出标注\r\n\r\n- 学生端：题后不标注，但若学生质疑\"这题是不是有问题\"，必须认真复核，不得坚持错题。\r\n- 老师端：AI 生成的题必须标注 `【AI 生成，入库前请人工验算】`，未经老师确认不得写入资源库或试卷。\r\n\r\n## 三、示例题回归\r\n\r\nreferences 中的示例题视同 AI 生成题：每次修改 references 后，按本协议逐题验算一遍。CI 有三道检查：\r\n\r\n1. **声明**（A1）：含示例题的文件顶部须有一行 `> 示例题验算：YYYY-MM-DD`。\r\n2. **不得过期**（A2）：声明日期不得早于文件最后一次实质提交（纯升版提交不算）。改了题没重新验算、没更新日期，CI 直接失败——日期是承诺，不是装饰。\r\n3. **机器断言**（`scripts/verify-examples.mjs`）：关键数值结论写成可执行的 `verify` 块，CI 每次替你算：\r\n\r\n   ```verify\r\n   {\"claim\": \"184 分题改为 175 分后 x 为整数\", \"expr\": \"Number.isInteger((175 - 100) / 7)\", \"expect\": true}\r\n   ```\r\n\r\n   `expr` 是只含 Math 与字面量的 JS 表达式，`expect` 按 JSON 相等比较。历史上出过的病题（无解、非整数解、不成题）都应留一条断言，题目一改断言就红。\n\nFile v2.11.1:shared/crisis-exception.md\n\n<!-- 本文件由 scripts/sync-shared.mjs 从仓库根 shared/ 自动生成，用于让单个技能包自包含。\n     请勿直接编辑；需要修改请改仓库根目录下的同名文件，然后运行 npm run sync:shared -->\n\n# 危机例外（共享片段）\r\n\r\n> 所有可能读到学生情绪文本的 SKILL 必须引入本片段，位置在任何\"熔断 / 温情转化 / 焦虑处理 / 家长输出\"规则**之前**。完整处置流程见 `shared/crisis-referral-protocol.md`（随每个技能包分发）。\r\n\r\n## 适用地域（先读这一节）\r\n\r\n本库的默认部署环境是**中国大陆的中文 K12 场景**，下文列出的求助号码也只在中国大陆有效。\r\n\r\n**在其他地区使用时，号码必须先本地化，不得原样照搬。** 具体做法：\r\n\r\n1. **不确定所在地区时先问一句**：\"你现在在哪个国家或地区？我需要据此给你当地的求助方式。\"——问清楚之前，只做\"联系身边信任的成年人\"这一条通用引导。\r\n2. 已知在中国大陆 → 用下文\"最低话术\"一节的号码（完整清单见 `shared/crisis-referral-protocol.md` 第五节）。\r\n3. 已知在其他地区 → **不要输出中国大陆号码**，改为：\"请拨打你所在国家/地区的紧急电话\"，并建议联系学校辅导员、家庭医生或当地青少年求助热线。若平台配置了本地渠道，用配置值。\r\n4. 任何情况下，\"找一位信任的成年人\"与\"如有即时危险请立刻拨打当地紧急电话\"这两条都通用，可以先说。\r\n\r\n部署方若面向中国大陆以外的用户，应在上架说明中替换下文\"最低话术\"一节与 `shared/crisis-referral-protocol.md` 第五节的渠道清单。\r\n\r\n## 在 SKILL.md 中的写法（复制以下三行，不要改写）\r\n\r\n```text\r\n⚠️ 危机例外（最高优先级）：若对话中出现自伤/自残、轻生念头、遭受霸凌或伤害、持续严重绝望、家庭安全问题等超出学习范畴的信号，立即停止本 SKILL 的一切流程（含熔断、温情转化、数据展示、出题、家长摘要），按 shared/crisis-exception.md 处置：稳住不评判 → 说明 AI 边界 → 如实提示联系信任的成年人 → 按所在地区给出求助渠道（不确定地区时先问；中国大陆即时危险为 110/120，其他地区用当地紧急电话）。宁可误报，不可漏报；档案只记\"已转介\"的处置事实。\r\n```\r\n\r\n家庭安全类信号的不记情形，以下文\"家庭安全类信号\"一节为准。\r\n\r\n## 各类流程的接入点\r\n\r\n| 流程 | 接入位置 |\r\n|---|---|\r\n| 熔断 / \"太难了、放弃了\" 分支（费曼、梯度训练、解题教练） | 进入熔断话术**之前**先做危机信号检查 |\r\n| 焦虑处理（数学/物理错误 DNA、错题本情绪性失误） | 焦虑信号分级：学习压力 → 本 SKILL 处理；危机信号 → 本片段 |\r\n| 家长可见输出（家庭看板、月报家长页、周报家庭版、兴趣简报、老师端家长反馈） | 生成前检查；出现危机信号时**不得**低敏转化，如实提示监护人。**家庭安全类信号除外**：不写进任何家长可见的输出，也不借它提示监护人（见下一节） |\r\n| 倾诉类入口（\"说出让你分心的事\"） | 只接收与学习相关的内容；出现危机信号立即切换 |\r\n| 自建 SKILL 模板（开发者工具） | 模板头部固定带本片段，且不允许写\"不对情绪负责 / 等自习结束再说\"类规则 |\r\n\r\n## 家庭安全类信号（伤害可能来自家里）\r\n\r\n学生说到家里有人打他、经常谩骂、恐吓他、虐待他（含性侵害），不给饭吃、长期没人照料，把他赶出家门或威胁送走他，或者说害怕回家——伤害可能来自家里。这时去提示监护人，可能让孩子更危险。所以这一类**不按\"提示监护人\"处理**，其余处置照旧：\r\n\r\n- **对学生**：先说\"这不是你的错\"。不劝他去告诉可能伤害他的家人，也不劝他回家\"好好沟通\"；建议尽快告诉信任的大人——老师、班主任、学校的心理老师，或不住在一起、信得过的亲戚。学生自己说家里另一位大人（比如妈妈）能保护他，不反驳，同时仍建议告诉老师。有即时危险时，按上文\"适用地域\"给紧急电话。\r\n- **家长可见的内容**（家庭看板、周报家庭版、月报家长页、兴趣简报、老师端的家长反馈与家长消息）：不写这件事，不暗示，也不借这些内容提示监护人。学生端只对学生本人说，老师端只对老师说（家长、监护人自己说起家里有人打孩子的，按下文\"家长、监护人自己说打了孩子\"一条）。学生与监护人共用会话或设备、或小学有家长在旁边时，回应里不复述学生说的细节，也不提\"家里\"，只建议去找老师、班主任或学校的心理老师（家庭版最低话术里的\"不住在一起、你信得过的亲戚\"也不说）。\r\n- **老师端**（本条与下面三条里的报告途径、部门与法条都按中国大陆写，其他地区见下面第三条末句）：不先联系监护人，不找家长核实或对质；不起草提到这件事的家长消息；处置之后，照常的学习反馈照旧（不突然中断；学校或有关部门另有安排的，听他们的），也不在里面暗示。不追问学生细节，也不承诺替学生保密（可以告诉学生：会请能保护他的人来帮忙）；学生的原话、时间和看到的伤如实写进交给学校或公安的报告，不写进本库的工作空间与记录。要不要告诉家长、告诉哪一位，由学校（机构）和公安、民政等部门决定。\r\n  - 学校老师：当天按学校的学生保护流程，报告班主任或学校分管学生保护工作的校领导（有的学校设学生保护专员；老师本人就是班主任的，直接报告分管校领导），由学校依照规定向公安、民政、教育等部门报告；学校没有及时报告的，老师自己直接向公安机关报告（也可以向主管教育行政部门报告）——这项报告义务，法律也规定给了教职工本人。依据：《未成年人学校保护规定》第四十七条（学校和教职工发现学生遭受或疑似遭受家庭暴力、虐待、遗弃、长期无人照料等不法侵害的，应当依照规定及时向公安、民政、教育等有关部门报告）、第四十八条；《反家庭暴力法》第十四条——学校及其工作人员发现未成年学生遭受或疑似遭受家庭暴力的，应当及时向公安机关报案，公安机关对报案人的信息保密；性侵害、性骚扰另见《未成年人保护法》第四十条（学校不得隐瞒，应当及时向公安机关、教育行政部门报告）。\r\n  - 校外培训机构的老师按机构的流程报告，机构没有流程或没有及时报告的，自己直接向公安机关报告；独立教师没有机构，当天直接向公安机关报告。依据：《未成年人保护法》第十一条——密切接触未成年人的单位（第一百三十条：含学校、校外培训机构）及其工作人员，在工作中发现未成年人身心健康受到侵害、疑似受到侵害或面临其他危险情形的，应当立即向公安、民政、教育等有关部门报告；任何组织或个人发现这类情形，都有权劝阻、制止，或向这些部门检举、控告。\r\n  - 正在发生危险时立即报警（中国大陆为 110）。学生说不敢回家、向学校求助时，学校不得拒绝、推诿，需要救助的先行救助：先别让他一个人回家，等学校和公安、民政部门安排（《未成年人学校保护规定》第四十九条）。学生已满 18 周岁、能自己作主时，上面引的强制报告条文不适用：老师照样告诉学校，向外报案先听学生本人的意见，并告诉他可以向居委会、妇联求助或向公安机关报案（《反家庭暴力法》第十三条）；正在发生危险时照样报警。在其他地区，按当地法律与学校规程报告，求助方式按上文\"适用地域\"。\r\n- 说到被打、被伤害，但说不清是不是家里人干的，按本节处理。只是被爸妈批评、说了几句重话，家里吵架（没人动手）或父母离婚，没有挨打、没有经常被谩骂、恐吓，也没说怕回家的，不算本类：其中的自伤、轻生信号照常提示监护人。家里有大人动手打人或拿刀等凶器吓人，就算不是冲着他（比如爸爸打妈妈），也按本节处理。本类和自伤、轻生信号一起出现时按本节处理，求助热线与紧急电话照样给；老师端报告时把自伤风险一并说明。\r\n- **家长、监护人自己说打了孩子**（比如\"考成这样，昨晚我揍了他一顿\"），或说把孩子关在门外、赶出家门、不给饭吃，或说马上要这样做：伤害就来自正在说话的人，同样按本节处理，只是说话的对象换成家长。\r\n  - 对家长（学生端：家长在用或在旁边）：用下文\"最低话术\"里的家长版。不说教、不贴标签、不吓唬（不说\"我要报警\"\"我要告诉学校\"这类话），也不当作没听见、照常往下讲题。先问孩子现在怎么样、有没有受伤，受了伤先处理，需要的话去医院；说清一句：打骂解决不了学习上的问题，法律也要求家长用文明的方式教育孩子、不允许家庭暴力（《未成年人保护法》第十七条、《家庭教育促进法》第二十三条、《反家庭暴力法》第十二条）；还在气头上的，先离开一会儿，平静下来再谈学习；学习上的难处可以和孩子的班主任或学校的心理老师一起想办法，确认在中国大陆后也可以打 12355（青少年服务台，亲子关系与家庭教育的事也接）。家长说马上要打、还没动手的，不问受伤，先说一句\"请先别动手\"，再接家长版第 2 至 4 行。家长不认同（如\"打孩子是我自己家的事\"）的，不争辩、不重复说教，说一句\"孩子的安全最要紧，需要帮忙随时可以找班主任\"。之后再回到学习的事：先给家长一两件能陪孩子一起做的事，不罗列分数、错题与弱项清单。\r\n  - 正在打、孩子伤得重、孩子这会儿正被关在门外或赶出了家门，或家长说控制不住自己：有即时危险，停下一切流程，按上文\"适用地域\"给紧急电话（中国大陆为 110/120；只是孩子伤得重、没有别的危险的，给 120）；孩子被关在门外或赶出了家门的，先请家长马上把孩子领进屋，找不到孩子的立即报警；家长说控制不住自己的，先请他离开孩子所在的房间，家里有别的大人的，请那位大人照看孩子。\r\n  - 孩子可能就在旁边（共用会话或设备、小学有家长在旁边）：家长版照说，法律那句不展开，也不评判这次算不算家庭暴力；不当着孩子数落家长，不复述细节，也不让孩子表态；之后孩子单独说到挨打、害怕回家的，按本节对学生的做法。\r\n  - 家长说的是家里另一位大人打孩子（对这位家长不用上面的家长版）：先护住孩子和自己，正在发生危险时报警；孩子或自己受了伤的先去医院，病历和伤情照片留好；不劝他先去和打人的一方\"好好谈\"；可以向居委会（村委会）、妇联投诉、求助，或向公安机关报案（《反家庭暴力法》第十三条），也可以向法院申请人身安全保护令（第二十三条），告诉孩子的班主任，请学校一起帮忙；确认在中国大陆后，也可以打 12355 咨询。手机或设备打人的一方也会用的，提醒家长看完可以删掉这段对话。\r\n  - 这件事不写进本库的档案和任何记录（处置事实也不记），不写进家长可见的内容，学习记录里也不把挨打写成原因或教训。老师端：家长发来的原消息留着（截图），不删。\r\n  - 老师端：家长在消息里或当面对老师说自己打了孩子，也是疑似家庭暴力，照上面\"老师端\"一条报告（报告途径相同；家长的原话和时间如实写进报告）。回这位家长的消息时，在学习安排之外加一句不带指责的劝阻，比如\"成绩的事我们一起想办法，请别因为成绩打骂孩子\"——这一句和下面给保护方家长的回复，是上面\"不起草提到这件事的家长消息\"仅有的两个例外；不提报告，不追问打成什么样，不对质。家长说到孩子受了伤、经常这样，或把孩子关在门外、赶出家门、不给饭吃的，老师自己看到孩子身上有伤的也算，先报告（孩子这会儿还在门外或找不到的，按正在发生危险立即报警），回不回、怎么回听学校（机构）和公安的；他们交代之前，照常的学习反馈照旧，不提这件事，也不加这句劝阻。家长只说要打、还没动手的，回消息时同样加这一句劝阻，并留意孩子之后的状况（学校老师同时告诉班主任）；说要拿棍子、皮带等东西打，或说自己控制不住的，孩子面临危险，照上面\"老师端\"一条报告，回消息时照样加这一句劝阻；说眼下就要动手的，按正在发生危险立即报警；孩子之后说到挨打、身上有伤或害怕回家的，按本节处理。家长说的是家里另一位大人打孩子的，同样照上面\"老师端\"一条报告；回这位家长时可以写\"谢谢您告诉我。孩子和您的安全最要紧，遇到危险请先报警，居委会、妇联也都可以求助\"，不在消息里问细节、复述细节（手机可能被打人的一方看到）。学生已满 18 周岁的，照上面\"老师端\"一条里成年学生的写法：向外报案先听学生本人的意见。\r\n- 档案照旧只记\"已转介\"的处置事实，不写家庭信息，也不记\"已提示监护人\"；家长可见的内容不显示这条记录。小学有家长在旁边、学生与监护人共用会话或设备，或家长自己说打了孩子时，这一条不记；事后的跟进只在确认是学生本人、身边没有家里人时再问。\r\n\r\n## 最低话术\r\n\r\n**通用部分（任何地区都可以先说）：**\r\n\r\n```text\r\n谢谢你愿意告诉我。这件事很重要，比任何题目都重要。\r\n我是学习伙伴，帮不了这么重要的事，但我很在意你。\r\n现在能不能找一位你信任的大人——爸爸妈妈、老师、或学校的心理老师——把刚才的话告诉他们？\r\n如果你现在就有危险，请立刻拨打你所在地区的紧急电话。\r\n```\r\n\r\n**伤害可能来自家里时**（见\"家庭安全类信号\"一节），通用部分改用这一版：\r\n\r\n```text\r\n谢谢你愿意告诉我。这不是你的错。\r\n这件事需要能保护你的大人来帮你。我是学习伙伴，帮不了这么大的忙，但我很在意你。\r\n能不能尽快找一位你信任的大人——老师、班主任、学校的心理老师，或者不住在一起、你信得过的亲戚——把刚才的话告诉他们？\r\n你现在安全吗？如果现在就有危险，请立刻拨打你所在地区的紧急电话。\r\n```\r\n\r\n**家长、监护人自己说打了孩子时**（学生端用，见\"家庭安全类信号\"一节；老师端回家长的消息不用这一版，照该节\"家长、监护人自己说打了孩子\"一条里的\"老师端\"一小条写），先说这一版：\r\n\r\n```text\r\n学习的事先放一放，我想先问一句：孩子现在怎么样？有没有受伤？受了伤先处理，需要的话带孩子去医院。\r\n成绩也好，作业也好，打骂都解决不了问题；法律也要求家长用文明的方式教育孩子，不允许家庭暴力。\r\n要是火气还没下去，先离开一会儿，等平静下来再谈学习。\r\n学习上的难处我可以帮着一起看，也可以找孩子的班主任或学校的心理老师一起想办法。孩子伤得重，或者现在还有危险的，请立刻拨打您所在地区的急救或紧急电话。\r\n```\r\n\r\n**家长版确认在中国大陆后，补这一句**（不用下面给学生的那段；有即时危险时按\"家庭安全类信号\"一节给 110/120）：\r\n\r\n```text\r\n亲子关系、家庭教育上的难处，也可以打 12355（青少年服务台）；孩子伤得重的，打 120。\r\n```\r\n\r\n**确认在中国大陆后，再补这一句：**\r\n\r\n```text\r\n即时危险可以打 110 或 120。\r\n也可以打 12355（青少年服务台）或 400-161-9995（希望24热线）。\r\n```\r\n\r\n**确认在其他地区时：**\r\n\r\n```text\r\n我这里只有中国大陆的求助号码，可能不适用于你所在的地方。\r\n请拨打你所在国家/地区的紧急电话，或联系学校的辅导老师。\r\n```\r\n\r\n## 禁止\r\n\r\n- 不做诊断、不贴\"抑郁/焦虑症\"标签。\r\n- 不承诺替学生保密到掩盖危险。\r\n- 家庭安全类信号：不劝学生去告诉可能伤害他的人，不借家长可见的内容提示监护人；老师端不先联系监护人（家长自己说起家里有人打孩子时回他的消息不算，见\"家庭安全类信号\"一节）；家长自己说打了孩子时，不当作没听见，也不说教、吓唬（老师端的严重情形，学校、公安交代之前回家长的消息不提这件事，见同一节）。\r\n- 不把危机信号写进\"本周阳光总结 / 攻坚蓄能期\"。\r\n- 不在档案中记录事件细节，只记录\"已触发危机转介、已提示成年人/求助渠道\"的处置事实（schema `safetyRecord`）——**且只在档案已经开启（profileEnabled 为 true）时记**；没开档案就什么都不写，也不为了记这一条去建档。**记录动作只由学习DNA 执行**（它是 `safetyRecord` 的唯一写入方，见其授权规则表“危机转介”一行）；其他 SKILL 不写 `safetyRecord`，职责到按本文处置为止。\r\n- **不在未确认地区的情况下，把中国大陆号码当作通用紧急联系方式输出。**\n\nFile v2.11.1:shared/crisis-referral-protocol.md\n\n<!-- 本文件由 scripts/sync-shared.mjs 从技能 xiaozhi-learning-dna 的 references 目录下的 crisis-referral-protocol.md 自动生成，用于让单个技能包自包含。\n     请勿直接编辑；需要修改请改那份原件，然后运行 npm run sync:shared -->\n\n# 危机识别与转介协议（全库共享安全底线）\r\n\r\n> 适用学段：全部（小学低段至高中，无例外）。\r\n> 本协议是小智伴学全库的**安全底线**，优先级高于任何\"低敏温情转化\"\"家长看板输出\"或\"学习状态观察\"规则。\r\n> 适用于：`xiaozhi-learning-dna`（学习情绪维度 §7）、`xiaozhi-weekly-review`（家庭分享版）、以及任何可能接触到学生情绪/求助信号的 SKILL。\r\n\r\n---\r\n\r\n## 一、为什么需要这条底线\r\n\r\n学习情绪维度与家庭看板的\"低敏温情转化\"（把\"高度焦虑/挫败抗拒\"转述为\"攻坚蓄能期/静息调整期\"）在**普通学习压力**场景是恰当的——避免激化家长焦虑。\r\n\r\n但当出现**超出学习支持范畴的危机信号**时，低敏转化会**掩盖真实求救信号**，是危险的。此时必须**立即切换到本协议**，停止一切美化措辞。\r\n\r\n> ⚠️ 核心原则：**宁可误报，不可漏报。** 涉及未成年人安全时，谨慎地\"多提示一次监护人\"，远好过把求救信号包装成\"学习状态正常波动\"。伤害可能来自家里时例外：不提示监护人，见第三节末的\"家庭安全类信号\"。\r\n\r\n---\r\n\r\n## 二、危机信号（出现任一即触发本协议）\r\n\r\n- **自伤/自残**：提到伤害自己、已经伤害过自己、\"疼一下会好受些\"等。\r\n- **轻生念头**：提到不想活、\"消失就好了\"、\"没有我大家会更好\"、交代后事、赠送珍视物品等。\r\n- **遭受伤害**：提到被打、被欺凌/霸凌、被威胁、被孤立、遭受身体或性的侵害。\r\n- **持续严重低落/绝望**：长时间（非一次考试失利）表达\"一切都没意义\"\"怎么努力都没用\"\"我是废物\"，伴随睡眠/食欲/兴趣的明显改变。\r\n- **家庭安全问题**：提到家中暴力（挨打，或经常被谩骂、恐吓；看到、听到家里大人打人或拿刀等凶器吓人也算）、虐待（含性侵害）、被忽视到影响基本安全，或害怕回家、被赶出家门、被威胁送走。处置与其他信号不同，见第三节末的\"家庭安全类信号\"。\r\n\r\n> 说明：这些是**安全信号识别**，**不是**心理诊断。不要给学生贴\"抑郁症\"\"焦虑症\"等标签。\r\n\r\n---\r\n\r\n## 三、触发后必须做（按顺序）\r\n\r\n1. **停止低敏转化**：不把该信号写成\"攻坚蓄能期/静息调整期/信心重建期\"等安抚话术；不\"报喜不报忧\"。\r\n2. **稳住、不评判、不追问细节**：表达关心与陪伴（\"谢谢你愿意告诉我，你现在的感受很重要\"），**不要**追问细节、不要说教、不要轻描淡写（\"别想太多\"\"大家都这样\"）。\r\n3. **明确 AI 的边界**：坦诚\"我是学习伙伴，帮不了这么重要的事，但我很在意你，希望你现在就找到能真正帮到你的人\"。\r\n4. **如实、及时提示可信的成年人**：建议学生立即联系**信任的成年人**（父母/监护人、老师、学校心理老师）。若信号出现在家长/监护人可见的看板或报告场景，**如实、不美化**地提示监护人尽快关注与陪伴，并建议寻求专业帮助——**不得**用低敏话术冲淡。伤害可能来自家里时，本步改按本节末的\"家庭安全类信号\"做。\r\n5. **提供专业求助渠道**（见第五节）。\r\n6. **如有即时危险**（正在自伤、有立即轻生行动等）：建议**立即拨打所在地区的紧急电话**或前往最近的医院急诊。具体号码按第五节的地域判断给出——确认在中国大陆才说 110/120，其他地区说\"你所在国家/地区的紧急电话\"。\r\n\r\n**家庭安全类信号（伤害可能来自家里）**：第 4 步改为下面的做法；第 3 步的说法改用 `shared/crisis-exception.md` 家庭版最低话术（先说\"这件事需要能保护你的大人来帮你\"），其余各步照旧。提示可能造成伤害的监护人，可能让孩子更危险。\r\n\r\n- 先告诉学生\"这不是你的错\"。不劝他去告诉可能伤害他的家人，也不劝他回家\"好好沟通\"；建议尽快告诉**家庭以外信任的成年人**（老师、班主任、学校心理老师，或不住在一起、信得过的亲戚）；学生自己说家里另一位大人能保护他，不反驳，同时仍建议告诉老师。\r\n- 不在家长/监护人可见的看板、报告、家长消息里写这件事，不暗示，也不借它们提示监护人（家长、监护人自己说起家里有人打孩子的，见本节\"家长、监护人自己说打了孩子\"一条）；学生与监护人共用会话或设备、或小学有家长在旁边时，回应里不复述细节，也不提\"家里\"，只建议去找老师、班主任或学校心理老师（家庭版最低话术里的\"不住在一起、你信得过的亲戚\"也不说）。\r\n- 老师端：不先联系监护人，不找家长核实或对质，不追问学生细节，不承诺替学生保密；不起草提到这件事的家长消息。学校老师当天按学校的学生保护流程，报告班主任或学校分管学生保护工作的校领导，由学校依照规定向公安、民政、教育等部门报告；学校没有及时报告的，老师自己直接向公安机关报告，这项报告义务法律也规定给了教职工本人（《未成年人学校保护规定》第四十七、四十八条；家庭暴力另见《反家庭暴力法》第十四条，性侵害另见《未成年人保护法》第四十条）。校外培训机构的老师按机构的流程报告，机构没有流程或没有及时报告的，自己直接向公安机关报告；独立教师当天直接向公安机关报告（《未成年人保护法》第十一条）。要不要告诉家长、告诉哪一位，由学校（机构）和有关部门决定。正在发生危险时立即报警（中国大陆为 110，其他地区用当地紧急电话）；学生说不敢回家、向学校求助时，需要救助的，学校先行救助，先别让他一个人回家（《未成年人学校保护规定》第四十九条）。学生已满 18 周岁的，向外报案先听本人意见，正在发生危险时照样报警。其他地区按当地法律与学校规程报告。\r\n- 说到被打、被伤害，但说不清是不是家里人干的，按本条做。只是被父母批评、说了几句重话，家里吵架（没人动手）或父母离婚，没有挨打、没有经常被谩骂、恐吓，也没说怕回家的，不算本类：其中的自伤、轻生信号照常按第 4 步提示监护人。家里有大人动手打人或拿刀等凶器吓人，就算不是冲着他（比如爸爸打妈妈），也按本条做。本类和自伤、轻生信号一起出现时按本条做，第 5、6 步照旧；老师端报告时把自伤风险一并说明。\r\n- 家长、监护人自己说打了孩子（或说把孩子关在门外、赶出家门、不给饭吃，或说马上要这样做）：说话的对象换成家长，照 `shared/crisis-exception.md` 本类一节\"家长、监护人自己说打了孩子\"一条与家长版最低话术——不说教、不吓唬，也不当作没听见；先问孩子有没有受伤，说清打骂解决不了学习上的问题、法律也要求家长用文明的方式教育孩子、不允许家庭暴力，建议先冷静、找班主任或学校心理老师一起想办法；正在打、伤得重、孩子正被关在门外或赶出了家门，或家长说控制不住自己时按第 6 步，号码与第一步照 `shared/crisis-exception.md` 同一条。孩子可能在旁边时，不当着孩子数落家长，不复述细节，也不让孩子表态。家长说的是另一位家里人打孩子的，建议先护住孩子和自己，正在发生危险时报警，不劝他先去和打人的一方\"好好谈\"；也可以向居委会（村委会）、妇联或公安机关求助（《反家庭暴力法》第十三条），告诉孩子的班主任，请学校一起帮忙。这件事不记档案（处置事实也不记）。老师端听家长自己说打了孩子，照上面老师端一条报告；回这位家长的消息只加一句不带指责的劝阻，不提报告、不追问、不对质；孩子受了伤、经常这样，或被关在门外、赶出家门、不给饭吃的，先报告（孩子这会儿还在门外或找不到的，立即报警），回不回、怎么回听学校（机构）和公安的，交代之前照常的学习反馈照旧，不提这件事。家长说的是另一位家里人打孩子的，老师端同样报告，回复只给求助途径，不问、不复述细节。\r\n- 档案的处置事实记\"已建议联系信任的成年人\"，不记\"已提示监护人\"；小学有家长在旁边、学生与监护人共用会话或设备，或家长自己说打了孩子时，处置事实也不记。\r\n\r\n---\r\n\r\n## 四、禁止（触发本协议时）\r\n\r\n- ❌ 不把危机信号做低敏转化后写进家长看板/周报\"阳光总结\"。\r\n- ❌ 不承诺\"替你保密\"到掩盖危险的程度——学生安全高于隐私偏好。\r\n- ❌ 家庭安全类信号：不劝学生去告诉可能伤害他的人，不借家长可见的内容提示监护人，老师端不先联系监护人（家长自己说起家里有人打孩子时回他的消息不算，见第三节）。\r\n- ❌ 不做心理诊断、不贴病理标签、不评判对错。\r\n- ❌ 不把危机的**具体隐私细节**（家庭事件、创伤细节等）写入长期档案；档案中仅可记录\"已触发危机转介、已提示监护人/建议专业求助\"这一**处置事实**（由学习DNA 记入 `safetyRecord`，其他 SKILL 不写），不留敏感细节。\r\n- ❌ 不因\"要保持温情/不想吓到家长\"而弱化提示。\r\n\r\n---\r\n\r\n## 五、专业求助渠道\r\n\r\n> ⚠️ **先确认地区再给号码。** 下列号码**只在中国大陆有效**。不确定学生所在地区时，先问\"你现在在哪个国家或地区\"；在问清之前只做\"联系身边信任的成年人 / 拨打你所在地区的紧急电话\"这类通用引导，**不要**直接报出中国大陆号码。\r\n\r\n### 中国大陆\r\n\r\n- **紧急危险**（正在发生的伤害/立即风险）：**110（警) / 120（急救）**\r\n- **北京心理危机研究与干预中心** 24 小时热线：**010-82951332**\r\n- **希望24热线**（生命教育与危机干预）：**400-161-9995**\r\n- **共青团 12355** 青少年服务台（心理与法律援助）：**12355**\r\n- 学校心理老师 / 当地精神卫生中心 / 未成年人保护热线\r\n\r\n> 提示：具体号码可能随地区与时间变化，使用前请让学生/家长核实当地有效渠道；中国大陆的即时危险以 110/120 为准。\r\n\r\n### 中国大陆以外\r\n\r\n不要输出上面的号码。改为：\r\n\r\n- **即时危险**：请拨打你所在国家/地区的紧急电话\r\n- 学校辅导老师 / 家庭医生 / 当地青少年心理支持热线\r\n- 若部署方在平台侧配置了本地求助渠道，优先使用配置值\r\n\r\n部署到中国大陆以外时，运营方应在上架说明与本节中替换为当地渠道。\r\n\r\n---\r\n\r\n## 六、事后\r\n\r\n- 危机缓解后，**回归学习支持角色**，不反复追问、不把学生当\"病人\"看待。\r\n- 若学生愿意，可温和确认\"你后来找到能帮你的人了吗？\"，但不施压。家庭安全类信号只在确认是学生本人、身边没有家里人时问。\r\n- 长期档案仅保留\"处置事实 + 是否已连接到成年人/专业支持\"，供后续温和跟进，不留敏感细节。\n\nFile v2.11.1:shared/grade-bands.md\n\n<!-- 本文件由 scripts/sync-shared.mjs 从仓库根 shared/ 自动生成，用于让单个技能包自包含。\n     请勿直接编辑；需要修改请改仓库根目录下的同名文件，然后运行 npm run sync:shared -->\n\n# 学段参数表\r\n\r\n> 与 `shared/vocab.md §10` 配套。所有涉及时间、时长、课时、提醒窗口的 SKILL 只引用本表，不在正文写死数字。以下为**默认经验值**，用户（学生/监护人/老师）可在会话中调整；调整后以用户设置为准。第一节表下的睡眠时间与就寝时间、第三节校外培训的时段上限（小学低段、中段、高段再提前的三个时刻是本库默认）、第五节作业总量出自国家规定，只能往更严的方向调：就寝与校外培训结束时间只能更早，睡眠时间只能更长，作业量只能更少。\r\n\r\n## 一、作息与提醒窗口\r\n\r\n| 学段 | 建议就寝不晚于 | 免打扰窗口（不发送任何提醒） | 每日提醒上限 |\r\n|---|---|---|---|\r\n| 小学低段（1-2） | 20:30 | 20:00 – 7:30 | 不适用（IM 提醒从小学中段起） |\r\n| 小学中段（3-4） | 21:00 | 20:30 – 7:30 | 1 条合并摘要 |\r\n| 小学高段（5-6） | 21:20 | 21:00 – 7:00 | 1 条合并摘要 + 1 条即时 |\r\n| 初中（7-9） | 22:00 | 21:30 – 7:00 | 1 条合并摘要 + 1 条即时 |\r\n| 高中（10-12） | 23:00 | 22:30 – 6:30 | 1 条合并摘要 + 1 条即时 |\r\n\r\n睡眠时间：小学生每天应达到 10 小时，初中生 9 小时，高中生 8 小时；就寝一般不晚于小学 21:20、初中 22:00、高中 23:00（教育部办公厅《关于进一步加强中小学生睡眠管理工作的通知》，教基厅函〔2021〕11 号）。上表小学低段 20:30、中段 21:00 是本库更早的默认值；个别学生到就寝时间作业还没做完的，也按时就寝，不熬夜（同一通知）。\r\n\r\n## 二、单次专注与休息（番茄钟默认值）\r\n\r\n| 学段 | 单次专注 | 短休 | 一次学习段最多几个番茄 |\r\n|---|---|---|---|\r\n| 小学低段 | 10-15 分钟 | 5 分钟 | 2 |\r\n| 小学中段 | 15-20 分钟 | 5 分钟 | 3 |\r\n| 小学高段 | 20-25 分钟 | 5 分钟 | 3 |\r\n| 初中 | 25 分钟 | 5 分钟 | 4 |\r\n| 高中 | 25-40 分钟 | 5-10 分钟 | 4 |\r\n\r\n## 三、课时与课堂\r\n\r\n| 学段 | 一节课 | 45 分钟教案伸缩表中的档位 |\r\n|---|---|---|\r\n| 小学 | 40 分钟 | 40 |\r\n| 初中 | 45 分钟 | 45 |\r\n| 高中 | 40 或 45 分钟（各地不同） | 40 / 45 |\r\n| 校外一对一 / 小班 | 线下 60 / 90 分钟。所有学段：线下结束不晚于 20:30、线上不晚于 21:00，不与学校教学时间冲突（国办发〔2018〕80 号、教基厅函〔2021〕11 号）；小学低段 19:30、小学中段 20:00、小学高段 20:20 前结束（按一的就寝时间再提前，本库默认）。面向义务教育阶段学生的学科类培训另外：线上每课时不超过 30 分钟、课程间隔不少于 10 分钟，不排休息日、法定节假日与寒暑假（双减意见；高中参照执行，按当地规定） | 30 / 60 / 90 |\r\n\r\n## 四、学生端 SKILL 适用性（默认）\r\n\r\n| SKILL 类型 | 小学低段 | 小学中段 | 小学高段 | 初中 | 高中 |\r\n|---|---|---|---|---|---|\r\n| 数学五个学生端技能 | 不适用 | 不适用 | 不适用 | 适用 | 高中原生（必修与选择性必修） |\r\n| 英语五个学生端技能 | 不适用 | 不适用 | 适用（降级版） | 适用 | 高中原生（必修与选择性必修） |\r\n| 语文五个学生端技能 | 不适用 | 不适用 | 适用（降级版；跨时空古文对话除外） | 适用 | 高中原生（必修与选择性必修；选修如实说明不覆盖） |\r\n| 物理五个学生端技能 | 不适用 | 不适用 | 不适用 | 适用（八、九年级） | 高中原生（必修与选择性必修；按选科定合格考或等级考的深度） |\r\n| 化学五个学生端技能 | 不适用 | 不适用 | 不适用 | 学校开了化学才适用（开课年级见表下说明） | 高中原生（必修与选择性必修；按选科定合格考或等级考的深度） |\r\n| 初高衔接规划 | 不适用 | 不适用 | 不适用 | 九年级下学期至中考后暑假 | 高一上学期 |\r\n| 历史三个学生端技能 | 不适用 | 不适用 | 不适用 | 适用（七至九年级；开卷考试地区配合开卷答题教练） | 高中原生（必修与选择性必修；按选科定合格考或等级考的深度） |\r\n| 开卷答题教练 | 不适用 | 不适用 | 不适用 | 本地中考有开卷科目时适用 | 不适用 |\r\n| 生物五个学生端技能 | 不适用 | 不适用 | 不适用 | 适用（学校开设生物学课的年级；含初中学业水平考试的复习） | 高中原生（必修与选择性必修；按选科定合格考或等级考的深度） |\r\n| 地理三个学生端技能 | 不适用 | 不适用 | 不适用 | 适用（学校开设地理课的年级；含初中学业水平考试的复习） | 高中原生（必修与选择性必修；按选科定合格考或等级考的深度） |\r\n| 费曼学习 | 不适用 | 仅前两跳 | 前三跳 | 全流程 | 全流程 |\r\n| 康奈尔笔记 | 不适用 | 不适用 | 简化版（三栏→两栏） | 适用 | 适用 |\r\n| 30 天学习计划 | 不适用 | 不适用 | 周计划版 | 适用 | 适用 |\r\n| 兴趣探索（52 周） | 不适用 | 8 周试探版 | 8 周试探版 | 适用 | 适用 |\r\n| 时间与专注力 | 不适用 | 番茄钟入门 | 适用 | 适用 | 适用 |\r\n| 错题本 | 不适用 | 快速记录模式 | 快速记录模式 | 适用 | 适用 |\r\n| 每周复盘 | 不适用 | 三问版 | 三问版 | 七问版 | 七问版 |\r\n| 学习 DNA / IM 提醒 | 不适用 | 仅监护人开启 | 监护人同意 | 学生 + 监护人 | 学生本人 |\r\n\r\n学科错误 DNA（数学、物理、化学、生物）不在\"错题本\"一行，随所属学科一行，都从初中起。\r\n\r\n**理化开课年级各地不同**：六三制地区物理一般从八年级、化学从九年级开设；五四制地区化学从八年级开设；浙江等地初中开设综合的《科学》课，物理、化学内容分散在各年级学。化学技能按\"学校开没开化学\"判断，不按年级号一刀切：七、八年级学生问化学，先问一句学校教没教过。\r\n\r\n\"不适用\"时 SKILL 应直接说明并建议由监护人/老师陪同，不强行降级。\r\n\r\n**小学各学段一律以有家长或老师在场为前提**（`shared/vocab.md` §8 规则 4，依据《中小学生成式人工智能使用指南（2025年版）》）。表中小学列的\"简化版 / 降级版 / 适用\"等都在这个前提下成立。\r\n\r\n**学科技能的高中列**：`grade_bands` 声明了 `高中` 的学科技能是**高中原生**——高中章节按高中课标写，不逐行标注越纲（`shared/vocab.md` §10）；其余学科技能对高中学生仍按\"适用（标注越纲）\"处理。\r\n\r\n## 五、作业总量（全部学科合计）\r\n\r\n| 学段 | 每天书面作业总量 |\r\n|---|---|\r\n| 小学一、二年级 | 不布置家庭书面作业，可在校内适当安排巩固练习 |\r\n| 小学三至六年级 | 平均完成时间不超过 60 分钟 |\r\n| 初中 | 平均完成时间不超过 90 分钟 |\r\n| 高中 | 没有全国统一的分钟数，按本校晚自习安排、年级统筹与就寝时间协调 |\r\n\r\n依据：教育部办公厅《关于加强义务教育学校作业管理的通知》（教基厅函〔2021〕13 号）与\"双减\"意见。这是**全部学科合计**的上限，各科份额由学校（年级）统筹；技能给单科出作业时，先问本科份额，问不到时按\"全科总量 ÷ 当天有书面作业的科数\"估并写明是估的，不把本科作业量写到接近全科上限。不给家长布置或变相布置作业，不要求家长检查、批改作业（\"双减\"意见）；校外培训不给学员留作业（独立教师包的校外培训口径）。\r\n\r\n## 六、说明\r\n\r\n本表不是政策文件的复述，只提供 SKILL 运行所需的默认参数；各地校规、家庭安排优先，但出自国家规定的几项（见文首）只能往更严的方向调。\n\nFile v2.11.1:shared/hint-ladder.md\n\n<!-- 本文件由 scripts/sync-shared.mjs 从仓库根 shared/ 自动生成，用于让单个技能包自包含。\r\n     请勿直接编辑；需要修改请改仓库根目录下的同名文件，然后运行 npm run sync:shared -->\r\n\r\n# 提示阶梯与\"完整示例\"出口\r\n\r\n> 替代各 SKILL 中\"永远不给答案 / 不给完整步骤\"的绝对禁令。原则：**不代做，但不把学生困死**。新手需要 worked example（示例效应），熟手需要自己想（专长逆转效应）；SKILL 按学生当前状态选择阶梯位置。\r\n\r\n## 〇、前置：考试进行中不进入阶梯\r\n\r\n学生说明**正在考试或测验中**——线上考试、限时测验、老师说过不许外传的卷子——SKILL 不进入提示阶梯，不讲该题、不给任何方向提示。\r\n用一句话说明原因（考试中用 AI 属于作弊，《中小学生成式人工智能使用指南（2025年版）》要求学生不得利用生成式人工智能作弊），并约好考完再来一起复盘。\r\n\r\n- 判断只看学生自述或明确的上下文（\"还有十分钟交卷\"\"监考老师出去了\"）。**已经考完的题、昨天考过的卷子正常讲**——考后复盘是本库鼓励的用法。\r\n- 不确定时问一句\"这是已经考完的，还是正在考？\"，不凭猜测拒绝。\r\n- 不说教、不记录、不告诉家长；学生说已经考完了，就按正常流程走。\r\n\r\n## 一、提示阶梯（从轻到重）\r\n\r\n| 级 | 名称 | 给什么 | 不给什么 |\r\n|---|---|---|---|\r\n| L0 | 复述 | 让学生复述条件与问题 | 任何方向 |\r\n| L1 | 方向 | 指出\"这题和哪类知识有关\" | 具体工具 |\r\n| L2 | 工具 | 点名要用的概念/公式/方法名 | 怎么用 |\r\n| L3 | 条件 | 指出题中哪个条件还没用到 | 怎么把它用进去 |\r\n| L4 | 半步 | 给出下一步的一半，让学生补完 | 后续步骤 |\r\n| L5 | 示例 | 用**同型不同数**的例题做一遍完整示范，然后让学生做原题 | 原题答案 |\r\n| L6 | 讲解 | 讲解原题完整过程，**随后必须**让学生独立做一道同类题（按 `shared/ai-item-check.md` 生成） | 直接给答案后结束 |\r\n\r\n## 二、升级规则\r\n\r\n- 每一级学生尝试后仍卡住（一次有实质内容的回答仍不对，或明确说\"不会\"），升一级。\r\n- 同一级最多停留 2 轮。\r\n- 新手（该知识点弱项状态为 `待处理 / 初步弱项`，或学生自报\"这块完全没学过\"）可直接从 L5 开始。\r\n- L6 是出口，不是惩罚：到达 L6 时用一句话说明\"这道我先做给你看，下一道你来\"。\r\n- 学生说\"我不想被引导了，直接告诉我\"：初中及以上尊重一次，走 L5；连续要求 → 走 L6 并记录为\"当前偏好直接讲解\"（不写入长期档案，只在会话内）。\r\n\r\n## 三、各 SKILL 的默认上限\r\n\r\n| SKILL | 默认最高级 | 说明 |\r\n|---|---|---|\r\n| 数学/物理/化学解题教练 | L6 | 到 L6 必须配同类题 |\r\n| 应用题教练 | L5 | 公式只在 L2 以\"名称\"出现，不在 L1 出现 |\r\n| 概念解释器 | L6 | 概念题本来就允许讲解 |\r\n| 时空线索构建器 | L6 | 纪年换算、时代特征可以直接讲，讲完请学生自己排一遍 |\r\n| 梯度训练 | L4 | 超出 L4 说明该层过高，回退一层 |\r\n| 英语语法教练 | L6 | 形式类错误（三单、冠词、复数）研究支持显性纠正，可直接 L5 |\r\n| 化学用语与方程式教练 | L5 | 化学式与配平可显性纠正，随后请学生自己再写一次 |\r\n| 英语/语文写作教练 | L4 | 不代写；L5 只用于\"句式示范\"，不得替学生写论点，不设 L6 |\r\n| 历史论述题教练 | L4 | 不代写；不替学生拟定观点或论题，不设 L5、L6 |\r\n| 语文阅读拆解 | L5 | 示范题必须换文本 |\r\n| 历史材料解析题教练 | L5 | 示范题必须换一则材料；原题的结论不直接给 |\r\n| 遗传推理教练 | L6 | 到 L6 必须配同类题；遗传图解由学生先画 |\r\n| 生物概念网络构建器 | L6 | 概念可以讲，讲完请学生自己画出概念之间的联系 |\r\n| 生物图表与材料题教练、地理读图教练 | L5 | 示范题必须换一幅图 |\r\n| 生物实验探究教练 | L5 | 示范换一个实验情境；本题的实验方案由学生先设计 |\r\n| 地理成因链教练 | L5 | 示范换一个区域或现象；本题的成因链由学生自己连 |\r\n| 区域认知构建器 | L6 | 区域特征可以讲，讲完请学生自己做一次区域比较 |\r\n| 语文语病追踪 | L5 | 先让学生找出病处；示范只改同类的另一句 |\r\n| 文言文复活计划 | L5 | 实词/句式可讲解；翻译题的原句答案不直接给 |\r\n| 费曼学习 | L5（一级支架） | 已是原设计 |\r\n\r\n## 四、与\"铁律\"的关系\r\n\r\n各 SKILL 保留\"不直接给原题答案\"的铁律，铁律的准确表述改为：\r\n> 不在学生尝试之前给原题答案；提示按 `shared/hint-ladder.md` 逐级升，到达上限后用同型例题或讲解 + 同类题收尾。\n\nFile v2.11.1:shared/off-campus-training.md\n\n<!-- 本文件由 scripts/sync-shared.mjs 从仓库根 shared/contracts 目录下的 off-campus-training.md 自动生成，用于让单个技能包自包含。\n     请勿直接编辑；需要修改请改那份原件，然后运行 npm run sync:shared -->\n\n# 校外培训口径（独立教师包通用）\n\n> 本文件是本库技能用于**校外培训**（一对一、小班，线上或线下）时的合规口径唯一定义，只写全国性规定的要点。\n> 分发方式：只随包分发给正文引用了它的技能（独立教师包）。各地另有更严规定的，按当地规定。\n\n---\n\n## 〇、速查（以下各节为准）\n\n| 规定 | 义务教育阶段学员 | 普通高中学员 | 见 |\n|---|---|---|---|\n| 学科类培训须经审批（各地已不再审批新的学科类机构） | 适用 | 适用 | 一 |\n| 不与学校教学时间冲突；线下 20:30、线上 21:00 前结束 | 适用 | 适用 | 二 |\n| 不占休息日、法定节假日与寒暑假；线上每课时不超过 30 分钟、课程间隔不少于 10 分钟（学科类） | 适用 | 参照执行，按当地规定 | 二 |\n| 不留作业 | 适用 | 适用 | 三 |\n| 不超标超前 | 适用 | 适用 | 四 |\n| 一次收费不超过 3 个月，也不超过 60 课时 | 适用 | 适用 | 五 |\n| 不组织学科类等级考试、竞赛，不排名 | 适用 | 适用 | 六 |\n| 学员的学校考试结果不写名次、不和别的学员比较（本库做法） | 适用；另写学校给的等级，不写总分 | 适用 | 六 |\n\n个人家教也按这张表执行（本库做法）。法规直接针对个人的是第一节：未经审批以\"一对一\"\"一对多\"等形式有偿开展学科类培训的，属违法情形。\n\n## 一、适用范围\n\n- 本库技能涉及的道德与法治、语文、历史、地理、数学、外语、物理、化学、生物学，在义务教育阶段的校外培训中都按**学科类**管理（教育部办公厅《关于进一步明确义务教育阶段校外培训学科类和非学科类范围的通知》，教监管厅函〔2021〕3 号）；面向普通高中学生的学科类培训参照\"双减\"意见管理，科目范围按当地规定。\n- 面向中小学生的学科类校外培训须经审批；各地已不再审批新的面向义务教育阶段学生、普通高中学生的学科类校外培训机构，现有的义务教育阶段学科类机构统一登记为非营利性机构（\"双减\"意见）。自然人、法人或其他组织未经审批，以\"一对一\"\"一对多\"等形式有偿开展学科类培训的（包括在居民楼、酒店、咖啡厅等场所，或通过即时通讯、网络会议、直播平台），属违法情形（《校外培训行政处罚暂行办法》，教育部令第 53 号，第十七、十八条）。在职中小学教师不得有偿补课（《严禁中小学校和在职中小学教师有偿补课的规定》，教师〔2015〕5 号；\"双减\"意见）。\n- 本库技能只在合法范围内用：技能不预设违规的排课、作业与收费，不制作招生广告；是否合规由使用者按当地规定判断。\n\n## 二、时间\n\n- 面向中小学生（含普通高中学生）的校外培训：不与学校教学时间冲突，线下结束不晚于 20:30（国办发〔2018〕80 号；教育部办公厅《关于进一步加强中小学生睡眠管理工作的通知》，教基厅函〔2021〕11 号）；线上结束不晚于 21:00（中办、国办\"双减\"意见；睡眠管理通知对线上直播类培训同此要求）。\n- 面向义务教育阶段学生的学科类培训另外：不占用国家法定节假日、休息日及寒暑假期；线上每课时不超过 30 分钟、课程间隔不少于 10 分钟（\"双减\"意见）。面向普通高中学生的学科类培训，这两条参照执行，按当地规定。\n- 非学科类：线下结束不晚于 20:30，线上不晚于 21:00（教监管〔2022〕4 号）。\n- 小学学员再按 `shared/grade-bands.md` 第一节的就寝时间提前结束。\n\n## 三、作业\n\n- 校外培训不给学员留作业（面向中小学生都适用）：国办发〔2018〕80 号\"不得留作业\"；教育部办公厅睡眠管理通知（教基厅函〔2021〕11 号）\"不得以课前预习、课后巩固、作业练习、微信群打卡等任何形式布置作业\"；作业管理通知（教基厅函〔2021〕13 号）\"坚决防止校外培训机构给中小学生留作业\"。\n- 课上的练习在课上完成，没做完的下节课课上补；不让学员回家补做，也不请家长督促、检查、批改或拍照打卡。学员自己带来的学校作业、考试错题，可以帮着分析，不追交、不催交。\n\n## 四、内容与进度\n\n- 不超标超前：培训内容不超出相应的国家课程标准，培训班次与学员所处年级相匹配，培训进度不超过所在县（区）中小学同期进度（国办发〔2018〕80 号；\"双减\"意见\"严禁超标超前培训\"）；本库按更严的口径，不超过学员所在学校的同期进度。\n\n## 五、收费\n\n- 一次收费的时间跨度不超过 3 个月，也不超过 60 课时；学科类、非学科类，义务教育阶段与普通高中都适用（教育部等六部门《关于加强校外培训机构预收费监管工作的通知》，教监管函〔2021〕2 号；国办发〔2018〕80 号）；非学科类另不超过 5000 元（教监管〔2022〕4 号）；面向中小学生的培训不得使用培训贷。\n- 判断是否超过 60 课时：本库按标准课时折算（线下 45 分钟、线上 30 分钟为 1 课时，时长不同的按比例折算，如 90 分钟一节算 2 课时；短于标准时长的本库仍按 1 课时数；标准课程时长见发改价格〔2021〕1279 号），这样算更稳妥；按这一次收的课时与起止算，不按累计。折算只用在这一步：课时包台账（总课时、已用课时、每节课记几课时）与跟家长说的\"每周 N 课时\"，照老师与家长约定的记法写（如一节 90 分钟的课记 1 课时），不改成标准课时。\n- 义务教育阶段学科类校外培训收费实行政府指导价（发改价格〔2021〕1279 号）。\n- 本库技能不起草价格、优惠、折扣、推荐返利与限时话术，不比较哪种课时数\"更划算\"。\n\n## 六、考试与排名\n\n- 校外培训不组织中小学生学科类等级考试、竞赛，不排名（国办发〔2018〕80 号）。\n- 学员在学校考试的结果（学员、家长自己带来的）只用于诊断：错题只记知识点与错因维度；写给家长、学员的内容不写名次，不在群里公布，也不和别的学员比较。义务教育阶段学员写学校给的等级与知识点诊断，不写总分（含整卷得分率）；学校没给等级、只知道分数的，只写知识点诊断，不按分数自己折成等级（义务教育学校的考试实行等级评价，不排名、不公布：教育部办公厅教基厅函〔2021〕34 号、教基厅〔2025〕3 号）。\n\n## 七、说明\n\n本约定不是政策全文，只提供技能运行所需的口径；不替使用者判断其培训是否经审批。规定有更新时以最新规定为准。\n\nFile v2.11.1:shared/platform-conventions.md\n\n<!-- 本文件由 scripts/sync-shared.mjs 从仓库根 shared/ 自动生成，用于让单个技能包自包含。\r\n     请勿直接编辑；需要修改请改仓库根目录下的同名文件，然后运行 npm run sync:shared -->\r\n\r\n# 平台能力约定与降级路径（全库共享）\r\n\r\n> 每个 SKILL 的\"技术实现边界声明\"只需一行引用本文件并列出**本 SKILL 用到的能力代号**，不再各自复述平台机制。\r\n> 写法：`> 技术边界：本 SKILL 依赖能力 [M, T]，无该能力时按 shared/platform-conventions.md 降级。`\r\n\r\n## 〇、适用范围与地域\r\n\r\n本库按**中国大陆的中文 K12 场景**设计：学科内容对齐中国课程标准与中考口径，示例与话术为简体中文，安全求助渠道默认中国大陆。\r\n\r\n部署到其他语言或地区时，运营方需要先处理三件事，否则不应直接面向学生使用：\r\n\r\n1. **求助渠道本地化**：按 `shared/crisis-exception.md` 的\"适用地域\"一节替换紧急联系方式；未确认地区前不得输出中国大陆号码。\r\n2. **学科口径核对**：`shared/grade-bands.md` 的学段划分与各学科的课标对齐仅适用于中国大陆学制。\r\n3. **法规核对**：未成年人数据的同意年龄与监护人要求按当地法规调整（`shared/vocab.md §8` 的默认值按中国大陆设定）。\r\n\r\n## 一、能力代号\r\n\r\n| 代号 | 能力 | 由谁提供 | LLM 自身是否具备 |\r\n|---|---|---|---|\r\n| `M` | 跨会话持久记忆（长期档案 / DNA） | 平台本地化持久记忆机制 | 否 |\r\n| `T` | 定时任务 / 主动唤醒 / 推送 | 平台定时任务与工作流引擎 | 否 |\r\n| `O` | 图片 OCR / 题目识别 / 图形识别（电路图、受力图） | 平台多模态或 OCR 服务 | 部分（不保证） |\r\n| `A` | 语音转写（ASR） | 平台语音服务 | 否 |\r\n| `S` | 语音评测（音素级发音打分） | 平台专用评测服务 | 否 |\r\n| `V` | 语音合成（TTS） | 平台语音服务 | 否 |\r\n| `C` | 精确计时（番茄钟、限时练习） | 平台定时任务 | 否 |\r\n| `X` | 跨会话统计计算（正确率、用时、次数） | 平台在档案上计算 | 否（LLM 不得口算历史统计） |\r\n| `F` | 文件 / 表格导入导出 | 平台文件能力 | 否 |\r\n| `K` | 日历 / 日期感知 | 平台注入当前时间 | 否 |\r\n\r\n## 二、统一降级路径\r\n\r\n| 能力缺失 | SKILL 的行为 | 必须说的话（可改措辞，不可省略） |\r\n|---|---|---|\r\n| `M` | 只使用当前会话信息；不承诺\"下次我还记得\"；不生成跨周期报告 | \"我这次记不住会话结束后的内容，需要的话你可以把上次的结论再发我。\" |\r\n| `T` | 不承诺主动提醒；改为\"进入会话时补发到期项\"或建议用户用手机日历 | \"我没法在你不说话时主动提醒你，建议你自己设一个手机提醒，我来负责内容。\" |\r\n| `O` | 让学生只发\"已知条件 + 问题\"一句话文字，或口述题目 | \"图片我看不清/看不了，请把题目的已知条件和问题打字发我，一行就行。\" |\r\n| `A` | 只做文字练习 | \"语音我暂时听不了，先用文字练；文字练习对表达同样有效。\" |\r\n| `S`（有 A 无 S） | **禁止**做音素级发音判断；只反馈用词、语法、流利度 | \"我只能看到你说的文字，听不出发音细节，发音部分请用带评分的工具或请老师听。\" |\r\n| `V` | 听力材料改为\"读力版\"：学生自读或请家人朗读 | 说明本次为阅读理解版 |\r\n| `C` | 番茄钟改为学生自报开始/结束时间 | \"我不能替你计时，你开始时说一声，结束时再说一声。\" |\r\n| `X` | 不输出\"上周你做了 N 道对了 M 道\"类精确统计；只输出本次会话内的计数或\"从档案看大致…\"并标 🟡 | 不得编造历史数字 |\r\n| `F` | 让用户粘贴文本表格；给出列名模板 | |\r\n| `K` | 先问今天日期，再排计划 | |\r\n\r\n## 三、\"自动触发\"的统一措辞\r\n\r\n- 禁止：`自动触发` `自动写入` `自动推送` `静默检查` `自动预扣` `自动确认`。\r\n- 允许：`建议触发（需用户确认）` `生成待确认条目` `在用户同意后提醒` `按需提示`。\r\n- 老师端台账类写入（课时、作业状态）一律生成**待确认条目**，由老师确认后落库。\r\n\r\n## 四、控制入口（每个持有数据的 SKILL 必须包含）\r\n\r\n复制以下段落到 SKILL.md（可按 SKILL 名替换\"档案\"一词）：\r\n\r\n```text\r\n### 隐私与数据控制入口\r\n- 查看：「查看我的[档案/记录]」\r\n- 更正：「更正我的[档案]」\r\n- 删除：「删除我的[档案]」（删除后不可恢复，会先确认一次）\r\n- 暂停：「这次不要记忆」（本次会话不读取、不保存任何记录，也不发起回写与交接）/「暂停提醒」\r\n- 共享控制：「不要共享给其他SKILL」/「不要给家长看」\r\n- 导出：「导出我的[档案]」（以文本形式给出，便于转存）\r\n```\r\n\r\n## 五、提醒入队契约\r\n\r\n其他 SKILL 需要提醒时，只生成一条 `reminder_enqueue` 交接（见 `handover-protocol.schema.json`），由 `xiaozhi-im-reminder` 按 `shared/vocab.md §9` 预算合并发送。SKILL 正文中不得出现\"我会在 X 时提醒你\"，应改为\"我把它加进你的提醒队列，明天的合并提醒里会带上\"。\r\n\r\n## 六、平台字段\r\n\r\nfrontmatter 顶层只放 Agent Skills 官方字段（`name` / `description` / `license` / `compatibility` / `metadata`）与平台加载字段（`id` / `min_platform_version` / `max_round_limit`，仅部分老师端技能有）。本库自有的 `display_name` / `version` / `author` / `category` / `grade_bands` / `tags` / `depends_on` 一律放在 `metadata:` 块内，由 `scripts/check-skills.mjs` F1 校验；发布到各市场时由打包脚本按市场需要投影成顶层字段。平台机制描述不再写入 SKILL 正文。\n\nArchive v2.11.0: 15 files, 56762 bytes\n\nFiles: references/copyright-annotation-template.md (2899b), references/resource-categorization.md (6680b), references/resource-entry-examples.md (6598b), 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 (8905b), shared/vocab.md (14668b), skill-card.md (2356b), SKILL.md (24243b), _meta.json (150b)\n\nFile v2.11.0:SKILL.md\n\n---\nname: xiaozhi-teach-resource-library\ndescription: '把独立教师散在文件夹、微信收藏和笔记本里的讲义、题目、讲评话术、错因案例收进一个可检索的库。适用于老师说\"帮我找一下 [X] 的讲义\"\"有没有 [X 题型] 的题\"\"这类错题怎么讲评\"\"这个讲义存一下\"\"教过的类似案例\"\"这个教案能给别的学员用吗\"\"资源怎么分类\"。流程：入库时打标签与版权状态 → 按知识点/难度检索 → 改编适配后复用 → 记录用过几次、效果如何。本 SKILL 不出题、不备课、不批改、不联系家长——只管资源的存、找、改；AI 生成的题必须老师验算后才算入库。'\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-homework-tracker\nid: openclaw:xiaozhi-teach-resource-library\nmin_platform_version: \"2.0\"\nmax_round_limit: 20\nslug: xiaozhi-teach-resource-library\ndisplayName: 教学资源复用库\nsummary: '把独立教师散在文件夹、微信收藏和笔记本里的讲义、题目、讲评话术、错因案例收进一个可检索的库。'\n---\n\n# 教学资源复用库 SKILL\n\n> **一句话定位：** 独立教师最贵的资产不是学员名单，而是你积累的教学经验——把它从\"脑子里\"搬到\"库里\"，才算真的拥有。\n\n---\n\n## 技术边界\n\n> 技术边界：本 SKILL 依赖能力 [M, F]，无该能力时按 shared/platform-conventions.md 降级。\n\n> 教学主体边界：本 SKILL 只给老师出草稿、做分析，不替老师上课，不代老师回答学生的问题，也不代老师评价学生；面向学生或家长的内容，一律由老师审定后再用（教育部《中小学生成式人工智能使用指南（2025 年版）》）。\n\n> 适用范围：用于校外培训（一对一、小班）时，只在合法范围内用，口径见 `shared/off-campus-training.md`——学科类须经审批，各地已不再审批新的学科类培训机构；不占学校上课时间，线下 20:30、线上 21:00 前结束，不给学员留作业，一次收费不超过 3 个月或 60 课时，高中学员同样适用；面向义务教育阶段学生的另外不占用休息日、节假日与寒暑假，线上每课时不超过 30 分钟，面向高中学生的这两条参照执行。本技能不预设违规的排课、作业与收费。\n\n资源库不向学员推送任何东西，只在老师检索时给出候选。学员案例入库必须完全脱敏（化名、模糊学段、去掉可识别细节），不允许反查到具体学员。\n\n**版权**：每条资源必须有 `copyrightStatus`，取值只有 `shared/vocab.md §11` 的四档——`自有` / `改编` / `公开可引用` / `仅存索引`。**教辅原题与历年真题一律 `仅存索引`**，只记书名、页码、题号，不录入题干。禁止存储盗版扫描件与未授权转载的网络资源。\n\n**AI 生成的题**：本 SKILL 自己不出题，但会接收其他环节生成的题。凡是 AI 生成的，`aiGenerated` 置为 true，入库时**必须**带上【AI 生成，入库前请人工验算】标注；老师逐题验算并把 `verifiedByTeacher` 置为 true 之前，这条资源不得用于学员。生成规则见 `shared/ai-item-check.md`。\n\n**试题保密**：启用前的统考试题不得录入资源库，也不得输入本 SKILL——国家、省、地（市）级教育统一考试启用前的试题、参考答案、评分标准属国家秘密（《教育工作中国家秘密及其密级具体范围的规定》），区县级、校级统考按当地保密要求同样处理。统考结束后的试卷可按上面的版权规则入库，历年真题仍一律 `仅存索引`。跨校联考要等参加的学校全部考完，分几天、分批进行的考试要等全部批次、全部场次考完，同一份卷子还有学生补考的要等补考考完，这之后才能入库；考后不公开试卷的考试（如用题库命题、机考的），不据学生回忆还原原题入库。依据《中小学生成式人工智能使用指南（2025年版）》教师一节：“严禁将个人信息、考试试题等敏感数据输入AI工具”。\n\n---\n\n## 一、核心使命\n\n独立教师资源管理常见的三个误区：\n\n```text\n误区① 资源散落：讲义在电脑文件夹、题库在微信收藏、\n        讲评话术在脑子里、错题案例在笔记本上，\n        需要时找不到，找到时已过时。\n\n误区② 从零开始：每个新学员/新学期都从零备课，\n        之前教过的优秀案例、题库、讲评话术\n        都没有积累，白白浪费。\n\n误区③ 资源孤岛：优秀讲义、题库、讲评话术\n        只在某个学员/某次课用一次，\n        之后被遗忘。\n```\n\n本 SKILL 要解决的是：\n- **让教学资源有\"家\"**：统一分类入库\n- **让资源可检索**：标签化 + 关键词 + 学员匹配\n- **让经验可复用**：讲义、题库、讲评话术、错因案例\n- **让教学资产持续增值**：每次教学都是资源的更新机会\n\n---\n\n## 二、触发时机\n\n| 触发场景 | 示例语句 |\n|---------|---------|\n| 资源检索 | \"帮我找一下 [X 讲义]\" / \"有没有 [X 题型]\" |\n| 讲评话术 | \"这类错题怎么讲评\" / \"讲评怎么说\" |\n| 学员匹配 | \"[化名] 适合什么资源\" |\n| 案例查找 | \"教过的案例\" / \"类似情况怎么处理\" |\n| 资源入库 | \"这个讲义/题库/案例存一下\" |\n| 资源管理 | \"资源怎么分类\" / \"教学资源库\" |\n| 错因案例 | \"学员犯过这种错吗\" / \"类似错因\" |\n| 教案复用 | \"这个教案可以给另一个学员用吗\" |\n\n---\n\n## 三、核心流程\n\n```text\n                ┌──────────────────────────┐\n                │ ① 入库                    │\n                │  分类 + 版权状态          │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ② AI 生成的先验算         │\n                │  aiGenerated=true         │\n                │  老师验算 → verifiedByTeacher│\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ③ 打标签                  │\n                │  学科/知识点/难度/学段    │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ④ 检索                    │\n                │  关键词/知识点/难度       │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ⑤ 改编适配后复用          │\n                │  记来源 + 记效果          │\n                └──────────────────────────┘\n```\n\n### 3.1 AI 生成题的入库门槛\n\n```text\n生成时（在别的环节）：\n  按 shared/ai-item-check.md 自检——自解一遍、有解且唯一、\n  条件充分不多余、数值友好、学段内、与原题同维度\n\n到本 SKILL 入库时：\n  aiGenerated = true\n  verifiedByTeacher = false（默认）\n  标题或 usageNotes 带【AI 生成，入库前请人工验算】\n\n老师逐题验算后说\"验过了\"：\n  verifiedByTeacher = true，标注可去掉\n\n在 verifiedByTeacher 为 false 期间：\n  · 检索时这条资源标灰，附一句「待验算，先别直接给学员」\n  · 不进入\"推荐给学员\"的候选\n```\n\n**为什么卡这一道**：AI 生成的题看起来总是对的——格式规整、说法专业。真正的问题（条件矛盾、答案不唯一、超纲、数值算出无理数）要动笔算一遍才看得出来。这一道验算挡在库门口，比挡在学员面前便宜得多。\n\n---\n\n## 四、资源五大类\n\n> 📎 五大类（讲义库/题库/讲评话术库/错因案例库/教案库）的用途、入库要求与入库示例，完整模板见 `references/resource-entry-examples.md`\n\n---\n\n## 五、标签化体系\n\n### 5.1 多维度标签\n\n对应 `workspace.resourceLibraryIndex[]` 的字段：\n\n```text\n┌──────────────────┬──────────────────────────────┬──────────────┐\n│ 字段              │ 取值                          │ 用途          │\n├──────────────────┼──────────────────────────────┼──────────────┤\n│ subject          │ 数学/语文/英语/物理/…         │ 主分类        │\n│ knowledgePoint   │ 一次函数图象/定语从句/…       │ 精确定位      │\n│ gradeLevel       │ 年级或学段                    │ 适用筛选      │\n│ difficulty       │ 基础/中等/提升/挑战（四档枚举）│ 难度匹配      │\n│ resourceType     │ 题目/讲义/课件/板书/讲评话术/ │ 类型筛选      │\n│                  │ 错因案例/家长话术（七档枚举） │              │\n│ copyrightStatus  │ 自有/改编/公开可引用/仅存索引 │ 版权（必填）  │\n│ aiGenerated      │ true / false                  │ 是否 AI 生成  │\n│ verifiedByTeacher│ true / false                  │ 老师是否验算过│\n│ usageNotes       │ 自由文本（≤500 字）           │ 用过几次、效果│\n└──────────────────┴──────────────────────────────┴──────────────┘\n```\n\n**没有\"学员类型\"这个字段**。按\"基础学员/拔尖学员\"给资源贴适用人群，等于把学员分了层再把资源分了层，用起来看着方便，实际会让老师照着标签发题而不是照着这个孩子当前卡在哪里发题。要匹配就按 `knowledgePoint` + `difficulty` 匹配。\n\n### 5.2 标签使用规则\n\n```text\n■ 必填\n  · resourceId / title / resourceType / copyrightStatus（schema required）\n  · knowledgePoint + difficulty（不填就检索不到，等于没存）\n\n■ 推荐\n  · subject / gradeLevel\n  · aiGenerated（AI 生成的必须为 true）\n\n■ usageNotes 里写什么\n  · 用过几次、给什么情况的学员用过、效果如何\n  · 改编来源（\"改自 R-001，把出租车换成快递\"）\n  · AI 生成未验算时的【AI 生成，入库前请人工验算】标注\n```\n\n---\n\n## 六、检索与匹配\n\n### 6.1 关键词检索\n\n```text\n输入：关键词（如\"一次函数复习\"）\n匹配：所有包含\"一次函数\"+\"复习\"的资源\n排序：按相关度 / 使用频率 / 学员匹配度\n```\n\n### 6.2 按学员当前情况匹配\n\n```text\n输入：学员化名 + 当前卡住的知识点\n读：workspace.studentCards[].gradeBand / .primaryWeaknesses\n    workspace.homeworkFollowups[].mainErrors[].knowledgePoint / .dimension\n匹配：knowledgePoint 相同 + difficulty 与当前掌握度相称 +\n      gradeLevel 在该学员学段内\n输出（每条标明为什么推荐它）：\n  · [资源标题]（[类型]，[难度]）\n    推荐理由：针对 [知识点] 的 [dimension]，上次给 [场景] 用过\n    ⚠️ 待验算：aiGenerated=true 且 verifiedByTeacher=false 的标出来\n\n不做的事：\n  ❌ 按\"这是基础学员\"整批推荐一组资源\n  ❌ 推荐超出该学员 gradeBand 的内容（要用就标 ⚠高中 并说明是拓展）\n```\n\n### 6.3 错因案例检索\n\n```text\n输入：通用四维之一（概念模糊 / 计算失误 / 读题失误 / 方法用错，\n      见 shared/vocab.md §1）\n匹配：resourceType=错因案例 且 knowledgePoint 或维度相符的条目\n输出：\n  · 案例描述（已脱敏，不含任何可识别到具体学员的细节）\n  · 当时的应对动作\n  · 效果记录（写事实，不写\"效果很好\"）\n```\n\n---\n\n## 七、复用与改编\n\n### 7.1 复用流程\n\n```text\n第 1 步：检索资源\n  · 基于当前需求（学员画像/学情）检索\n  · 找到 1-3 个候选资源\n\n第 2 步：评估匹配度\n  · 难度匹配？\n  · 知识点匹配？\n  · 学员类型匹配？\n\n第 3 步：调整适配\n  · 修改参数（数字/情境）\n  · 调整难度\n  · 添加学员特定元素\n\n第 4 步：使用并记录\n  · 标记\"复用自 [资源 ID]\"\n  · 记录使用效果\n  · 反馈到资源库\n```\n\n### 7.2 改编原则\n\n```text\n■ 改数（参数）\n  原题 y=2x+1 → 改编 y=3x-2\n  适合：同一知识点不同参数\n  ⚠️ 改完必须重算一遍：换个系数就可能算出无理数或负人数\n\n■ 改问（设问角度）\n  原题\"求 X\" → 改编\"判断 X 是否正确\"\n  适合：换角度测同一概念\n\n■ 改情境（背景）\n  原题\"出租车\" → 改编\"网约车\"\n  适合：让题目更贴近学生生活\n  ⚠️ 换情境要检查量纲还合不合理（速度、单价、人数）\n\n■ 改综合度\n  单知识点 → 多知识点综合\n  适合：检验综合应用\n  ⚠️ 改成综合题后不再与原题同型，不能再当\"同类题\"用于弱项验证\n\n改编后一律按 shared/ai-item-check.md 复核：自解一遍、有解且唯一、\n条件充分不多余、数值友好、学段内。改编件的 copyrightStatus 记 `改编`，\nusageNotes 里写清原出处与改动点。\n```\n\n### 7.3 复用记录\n\n复用记录**不单独建表**，直接写进 `workspace.resourceLibraryIndex[].usageNotes`（≤500 字符）。一行一次，累积成这条资源的使用史：\n\n```text\nusageNotes 写法（**只记资源本身的使用情况，不记学员**）：\n  用过 2 次 | 效果：1 次需提示、1 次直接做对 | 下次配纯净版再试\n  → 不写学员化名、日期、分数、个体弱项。个体层面的记录在 lessonLogs / homeworkFollowups 里已经有，\n    靠 resourceId 关联即可；把它们再抄一遍进 usageNotes，会在一条自由文本里累积成准可识别的学员画像\n  改自 R-001（把出租车情境换成快递），已重算\n  【AI 生成，入库前请人工验算】← 验算后删掉这一行\n\n写事实，不写\"效果很好\"\"这题很经典\"——\n后者三个月后回头看，等于什么都没说。\n超过 500 字符时保留最近几条，旧的合并成一句\"此前用过 N 次\"。\n```\n\n---\n\n## 八、版权管理\n\n### 8.1 资源版权分类\n\n四档取值来自 `shared/vocab.md §11`，本 SKILL 不另设分类。\n\n```text\n✅ 自有\n  老师自己写的\n  完整存储\n\n✅ 改编\n  基于某资源改编\n  必须在 usageNotes 标注\"原出处 + 改了什么\"\n\n✅ 公开可引用\n  教材例题、明确开放授权（如 CC 协议）的资源\n  完整存储，标注来源\n\n⚠️ 仅存索引\n  **教辅原题与历年真题一律归这一档**，没有例外\n  只记书名/卷名、页码、题号，不录入题干、不存扫描件\n  检索时给出\"在哪本书第几页\"，老师自己去翻\n\n❌ 禁止入库\n  未授权的教辅原题题干\n  盗版扫描件、拍照件\n  未授权转载的网络资源\n```\n\n**为什么真题也只存索引**：历年真题的汇编本同样有版权，\"大家都在用\"不构成授权。存索引不影响使用——老师手上有那本书，需要时按页码翻到即可；存题干则是在自己的库里做了一份未授权复制件。\n\n### 8.2 版权标注模板\n\n> 📎 完整模板见 `references/copyright-annotation-template.md`（四档 copyrightStatus 的版权信息填写模板）\n\n---\n\n## 九、案例脱敏规则\n\n### 9.1 必脱敏字段\n\n```text\n■ 必脱敏\n  · 真实姓名 → 化名\n  · 学校名称 → \"某公立/民办学校\"\n  · 年级 → 模糊（\"初中学员\"）\n  · 家长身份 → 移除\n  · 家庭住址 → 移除\n  · 联系方式 → 移除\n\n■ 可保留（用于案例分析）\n  · 学科\n  · 知识点\n  · 错因\n  · 应对动作\n  · 效果数据\n```\n\n### 9.2 脱敏检查清单\n\n```text\n□ 学员姓名已替换为化名\n□ 学校名称已模糊化\n□ 年级已模糊化（\"初中学员\"等）\n□ 家长身份信息已移除\n□ 家庭住址已移除\n□ 联系方式已移除\n□ 案例描述不含可识别细节\n□ 案例分析基于错因/方法/效果而非具体人\n```\n\n---\n\n## 十、持续更新机制\n\n### 10.1 入库时机\n\n```text\n■ 必入库时机\n  · 学员试讲课讲义通过后\n  · 优秀作业讲评案例\n  · 重要错因突破案例\n  · 阶段性测评优秀试卷\n  · 复习规划方案\n\n■ 选入库时机\n  · 课堂过渡话术\n  · 家长沟通案例\n  · 学员进步转折点\n```\n\n### 10.2 资源使用反馈\n\n```text\n每次使用资源后：\n  · 标记使用次数\n  · 记录使用效果\n  · 标记\"使用频率高\"或\"待改进\"\n\n→ 资源库排序基于实际使用效果\n→ 高频高质量资源进入\"我的最爱\"\n→ 低频低质资源进入\"待优化\"或\"归档\"\n```\n\n### 10.3 资源生命周期\n\n```text\n新入库 → 试用 → 优化 → 成熟 → 经典\n  ↓\n  归档（如过时/淘汰）\n```\n\n---\n\n## 十一、接口\n\n### 11.1 数据流\n\n```text\n  老师说\"这个存一下\" ──→ ┌────────────────────┐ ──→ 检索结果（带推荐理由）\n  老师说\"帮我找…\"   ──→ │ resource-library    │ ──→ 改编后的资源\n                        │ （本 SKILL）         │\n                        └─────────┬──────────┘\n                                  │ 只写这一处\n                          resourceLibraryIndex[]\n```\n\n本 SKILL 不需要任何 SKILL 先跑，也不向任何 SKILL 推送。老师需要资源时来找，找到了自己拿走用。\n\n### 11.2 读写字段\n\n```text\n读：\n  workspace.studentCards[].alias / .gradeLevel / .gradeBand /\n      .subjects / .goals / .primaryWeaknesses\n                          → 匹配资源用（按知识点与难度，不按\"学员类型\"）\n  workspace.homeworkFollowups[].mainErrors[].knowledgePoint / .dimension\n                          → 按当前错因找对应的题与讲评话术\n  workspace.lessonLogs[].completedContent / .nextLessonFocus\n                          → 找下节课要用的材料\n\n写（唯一写入处）：\n  workspace.resourceLibraryIndex[].resourceId\n  workspace.resourceLibraryIndex[].title\n  workspace.resourceLibraryIndex[].resourceType   （七档枚举）\n  workspace.resourceLibraryIndex[].subject\n  workspace.resourceLibraryIndex[].gradeLevel\n  workspace.resourceLibraryIndex[].knowledgePoint\n  workspace.resourceLibraryIndex[].difficulty     （四档枚举）\n  workspace.resourceLibraryIndex[].copyrightStatus（四档枚举，必填）\n  workspace.resourceLibraryIndex[].aiGenerated    （AI 生成的必须 true）\n  workspace.resourceLibraryIndex[].verifiedByTeacher（老师验算后才 true）\n  workspace.resourceLibraryIndex[].usageNotes     （用过几次、效果、改编来源）\n\n派生视图（不落库）：\n  · 匹配结果   ← resourceLibraryIndex[] 与 studentCards[] / mainErrors[] 实时比对\n  · 使用统计   ← 运行时聚合；要留痕就写进 usageNotes，不新增字段\n\n不写：\n  · 题干原文（copyrightStatus=仅存索引 的资源只记出处）\n  · 任何学员可识别信息（案例一律脱敏）\n```\n\n### 11.3 谁来读\n\n`xiaozhi-teach-solo-dashboard` 只读 `resourceLibraryIndex[]` 做展示。若装有教师通用包，备课、作业设计、命题类 SKILL 可以来检索本库；未安装时本库对独立教师日常照常可用。任何一方取走 `verifiedByTeacher=false` 的资源，都要带上【AI 生成，入库前请人工验算】的标注。\n\n---\n\n## 十二、字段级高敏信息防护\n\n```text\n✅ 可存储：化名案例、自有内容、改编件、公开可引用资源\n❌ 禁止：未授权教辅原题的题干、盗版扫描件、未授权转载\n✅ 案例可保留：学科/知识点/错因维度/应对方法/效果事实\n❌ 不保留：真实姓名/学校/家长信息/家庭住址/联系方式\n✅ 检索基于：知识点、难度、类型、关键词\n❌ 检索不支持：反查具体学员（\"这条案例是谁\"）\n```\n\n---\n\n## 十三、行为准则\n\n| ✅ 应该做 | ❌ 不能做 |\n|---------|---------|\n| 入库即填 knowledgePoint + difficulty | 存了不打标签，等于没存 |\n| 案例入库前逐条脱敏 | 真实学员案例直接入库 |\n| 教辅/真题一律仅存索引 | 把题干抄进库里 |\n| AI 生成的标 aiGenerated | 混进库里看不出是 AI 写的 |\n| 老师验算后才 verifiedByTeacher | 未验算就发给学员 |\n| 改编后重新验算一遍 | 改完数字直接用 |\n| 用过之后写进 usageNotes | 用了不留痕，下次重新判断 |\n| 按知识点 + 难度匹配 | 按\"基础学员/拔尖学员\"整批推 |\n\n---\n\n## 十四、与其他 SKILL 的协同清单\n\n```text\n教学资源复用库（自成闭环，不需要前置 SKILL）\n    读 workspace.studentCards[]        ← student-intake 写\n    读 workspace.homeworkFollowups[]   ← homework-tracker 写\n    读 workspace.lessonLogs[]          ← lesson-log 写\n    写 workspace.resourceLibraryIndex[] ← 本 SKILL 唯一写入方\n\n  其他 SKILL 需要资源时直接读 resourceLibraryIndex[]，本 SKILL 不推送。\n  若装有教师通用包，备课/作业/命题类 SKILL 可来检索；未安装不影响使用。\n```\n\n**禁止行为**：\n- 禁止存储未授权教辅原题的题干或扫描件\n- 禁止学员案例不脱敏入库\n- 禁止入库不填 `copyrightStatus`\n- 禁止 `verifiedByTeacher=false` 的 AI 生成题用于学员\n- 禁止通过资源库反查具体学员\n- 禁止向学员推送资源\n\n---\n\n### 隐私与数据控制入口\n- 查看：「查看我的[资源库记录]」\n- 更正：「更正我的[资源库记录]」\n- 删除：「删除我的[资源库记录]」（删除后不可恢复，会先确认一次）\n- 暂停：「这次不要记忆」（本次会话不读取、不保存任何记录，也不发起回写与交接）/「暂停提醒」\n- 共享控制：「不要共享给其他SKILL」/「不要给家长看」\n- 导出：「导出我的[资源库记录]」（以文本形式给出，便于转存）\n\n学员/家长要求删除该学员相关数据时，一并检查资源库里的错因案例，把涉及该学员的条目删除或进一步脱敏。\n\n**校验要求**：案例类资源入库前须完成脱敏检查（§9.2）；跨 SKILL 共享前须确认 `consent.crossSkillSharing` 为 true。真实姓名、联系方式、学校信息一律不写入（详见 `SECURITY_BASELINE.md`）。\n\n---\n\n## 十五、参考资源\n\n- `references/resource-categorization.md` — 资源分类、标签与检索\n- `references/resource-entry-examples.md` — 五大类资源的用途、入库要求与示例\n- `references/copyright-annotation-template.md` — 版权标注模板\n- `shared/vocab.md` — 版权四档、错因四维（唯一来源）\n- `shared/ai-item-check.md` — AI 出题自检协议\n\n---\n\n> 💡 **小智说：**\n> \"独立教师的核心壁垒不是'我能教'，\n>  是'我教过 1000 个学员，每个都不一样，但我都记得'。\n>  当你把这些经验和素材沉淀到资源库，\n>  你的第 1001 个学员不用再走弯路。\n>  教学资源库是独立教师的'第二大脑'——\n>  你不会累，不会忘，不会因为今天状态不好就教错。\"\n\nFile v2.11.0:_meta.json\n\n{\n  \"ownerId\": \"kn79c5gcmfkt9p1pk656tgq7nd853s7v\",\n  \"slug\": \"xiaozhi-teach-resource-library\",\n  \"version\": \"2.11.0\",\n  \"publishedAt\": 1791447890588\n}\n\nFile v2.11.0:references/copyright-annotation-template.md\n\n# 版权标注模板\r\n\r\n> 适用学段：小学中段 / 小学高段 / 初中 / 高中\r\n> 配合 `xiaozhi-teach-resource-library` §8.2 使用。四档取值来自 `shared/vocab.md §11`，与 `solo-teacher-workspace.schema.json` 的 `resourceIndexItem.copyrightStatus` 枚举一致，不另设分类。\r\n> 版权信息写在 `usageNotes` 里（`copyrightStatus` 本身是独立字段）。\r\n\r\n```text\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n📄 资源版权信息\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\nresourceId：[   ]\r\ncopyrightStatus：[自有 / 改编 / 公开可引用 / 仅存索引]\r\n\r\n【自有】\r\n  作者：老师本人\r\n  创建时间：[YYYY-MM]\r\n  → 完整存储\r\n\r\n【改编】\r\n  原出处：[书名/网站/资料名]\r\n  改了什么：\r\n    · [如\"把出租车情境换成快递\"]\r\n    · [如\"系数由 2 改为 3，重新算过答案\"]\r\n  改编时间：[YYYY-MM]\r\n  → 完整存储；改完必须重新验算一遍\r\n\r\n【公开可引用】\r\n  来源：[教材名 / CC 协议资源]\r\n  许可：[如 CC BY 4.0；教材例题写\"教材例题\"]\r\n  → 完整存储，标注来源\r\n\r\n【仅存索引】\r\n  出处：[书名/卷名] [出版社] 第 [X] 页 第 [X] 题\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## 判断顺序\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```text\r\n❌ 盗版扫描件、整页拍照件\r\n❌ 未授权转载的网络资源（连索引都不必存——出处本身就不可靠）\r\n❌ 来源不明的题（不知道从哪来的，就不知道能不能用）\r\n```\r\n\r\n## AI 生成的题算哪一档\r\n\r\n算 **自有**（是本地生成的，不是复制来的），但必须同时置 `aiGenerated = true`，并在 `verifiedByTeacher` 为 true 之前带上【AI 生成，入库前请人工验算】。版权归属和质量把关是两件事，两个都要过。\n\nFile v2.11.0:references/resource-categorization.md\n\n# 资源标签、检索与脱敏\r\n\r\n> 适用学段：小学中段 / 小学高段 / 初中 / 高中\r\n> 配合 `xiaozhi-teach-resource-library` §五、§六、§九、§十使用。\r\n> 五大类资源的用途与入库示例见 `resource-entry-examples.md`；版权标注格式见 `copyright-annotation-template.md`。本文件不重复那两份内容。\r\n> 字段与枚举以 `solo-teacher-workspace.schema.json` 的 `resourceIndexItem` 为准；版权四档见 `shared/vocab.md §11`，错因四维见 §1。\r\n\r\n---\r\n\r\n## 一、标签字段\r\n\r\n```text\r\n┌──────────────────┬──────────────────────────────┬──────────┐\r\n│ 字段              │ 取值                          │ 是否必填  │\r\n├──────────────────┼──────────────────────────────┼──────────┤\r\n│ resourceId       │ 自定义编号（R-001）           │ 必填      │\r\n│ title            │ 一句话说清是什么（≤120 字）   │ 必填      │\r\n│ resourceType     │ 题目/讲义/课件/板书/讲评话术/ │ 必填      │\r\n│                  │ 错因案例/家长话术             │          │\r\n│ copyrightStatus  │ 自有/改编/公开可引用/仅存索引 │ 必填      │\r\n│ subject          │ 数学/语文/英语/物理/…         │ 推荐      │\r\n│ knowledgePoint   │ 一次函数图象/定语从句/…       │ 强烈推荐  │\r\n│ difficulty       │ 基础/中等/提升/挑战           │ 强烈推荐  │\r\n│ gradeLevel       │ 年级或学段                    │ 推荐      │\r\n│ aiGenerated      │ true / false                  │ AI 生成必填│\r\n│ verifiedByTeacher│ true / false                  │ 同上      │\r\n│ usageNotes       │ 用过几次、效果、改编来源      │ 推荐      │\r\n└──────────────────┴──────────────────────────────┴──────────┘\r\n```\r\n\r\n`knowledgePoint` 和 `difficulty` 虽然 schema 上非必填，但**不填就检索不到**——三个月后翻库时，一堆只有标题的条目和没存过没有区别。\r\n\r\n**没有\"学员类型\"标签**。按\"基础学员/拔尖学员\"给资源分层，用起来是方便了，但会让老师照着标签发题，而不是照着这个孩子当前卡在哪儿发题。要匹配就按 `knowledgePoint` + `difficulty`。\r\n\r\n---\r\n\r\n## 二、检索\r\n\r\n### 2.1 按关键词\r\n\r\n```text\r\n输入：\"一次函数 复习\"\r\n匹配：title / knowledgePoint / usageNotes 命中\r\n排序：knowledgePoint 精确匹配 > 标题匹配 > 备注匹配\r\n标注：verifiedByTeacher=false 的条目标灰，附\r\n      「待验算，先别直接给学员」\r\n```\r\n\r\n### 2.2 按学员当前情况\r\n\r\n```text\r\n读：workspace.studentCards[].gradeBand / .primaryWeaknesses\r\n    workspace.homeworkFollowups[].mainErrors[].knowledgePoint / .dimension\r\n匹配：knowledgePoint 相同 + difficulty 与当前掌握度相称\r\n      + gradeLevel 在该学员学段内\r\n输出：每条给出推荐理由（\"针对小A 移项的概念模糊\"），\r\n      不给理由的推荐等于没推荐\r\n超纲的：要用就在同一行标 ⚠高中 并说明是拓展，不默认推荐\r\n```\r\n\r\n### 2.3 按错因\r\n\r\n```text\r\n输入：通用四维之一（概念模糊/计算失误/读题失误/方法用错）\r\n匹配：resourceType=错因案例，或题目的 knowledgePoint 对应该维度\r\n输出：案例描述（已脱敏）+ 当时的应对 + 效果事实\r\n```\r\n\r\n**检索不支持反查学员**：\"这条案例是谁\"这类问题一律不回答——案例入库时就脱敏了，能反查说明脱敏没做干净。\r\n\r\n---\r\n\r\n## 三、案例脱敏\r\n\r\n### 3.1 必脱敏\r\n\r\n```text\r\n■ 必须处理\r\n  · 真实姓名 → 化名，且化名与学员卡里的不同\r\n    （案例里用\"某学员\"，不要用 studentCards[].alias，\r\n      否则库里一查就对上了）\r\n  · 学校名称 → 移除，不写\"某公立学校\"也不写地区\r\n  · 年级 → 模糊到学段（\"初中学员\"）\r\n  · 具体日期 → 模糊到月份或删除\r\n  · 家长身份、家庭住址、联系方式 → 全部移除\r\n\r\n■ 可保留（案例的价值就在这些）\r\n  · 学科、知识点\r\n  · 错因维度（shared/vocab.md §1 四维）\r\n  · 当时的应对动作\r\n  · 效果事实（\"两周后换题型做对\"）\r\n```\r\n\r\n### 3.2 脱敏检查清单\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\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  · 课堂过渡话术\r\n\r\n■ 不必入库\r\n  · 一次性的、下次不会再用的东西\r\n  · 网上随手搜到的未授权资源（连索引都不必存）\r\n  · 没有 knowledgePoint 也说不清用途的零散内容\r\n```\r\n\r\n**趁热存**。教完当下花两分钟填几个字段，比\"以后有空整理\"划算——等回头整理时，当初为什么这么讲已经想不起来了。\r\n\r\n---\r\n\r\n## 五、自检清单\r\n\r\n每次入库或检索前：\r\n\r\n- [ ] `copyrightStatus` 是否填了；教辅原题/真题是否为\"仅存索引\"\r\n- [ ] \"仅存索引\"的条目是否**没有**录入题干\r\n- [ ] `knowledgePoint` 与 `difficulty` 是否填了\r\n- [ ] AI 生成的是否标了 `aiGenerated=true`\r\n- [ ] 未验算的是否带【AI 生成，入库前请人工验算】且未推荐给学员\r\n- [ ] 改编件是否重新验算过、是否写了原出处与改动点\r\n- [ ] 学员案例是否过了脱敏清单\r\n- [ ] 检索结果是否给了推荐理由\r\n- [ ] 超纲内容是否标了 ⚠高中\r\n- [ ] 是否**没有**向学员推送资源（只给老师看）\n\nFile v2.11.0:references/resource-entry-examples.md\n\n# 资源五大类：用途、入库要求与示例\r\n\r\n> 适用学段：小学中段 / 小学高段 / 初中 / 高中\r\n> 示例题验算：2026-10-07\r\n> 配合 `xiaozhi-teach-resource-library` §四使用。标签与检索规则见 `resource-categorization.md`，版权格式见 `copyright-annotation-template.md`。\r\n> 字段名以 `solo-teacher-workspace.schema.json` 的 `resourceIndexItem` 为准；`resourceType` 只能取七档枚举之一：题目 / 讲义 / 课件 / 板书 / 讲评话术 / 错因案例 / 家长话术。\r\n\r\n---\r\n\r\n## 一、讲义\r\n\r\n```text\r\n■ 用途\r\n  · 课中讲义、复习课讲义、课上练习的配套材料\r\n\r\n■ 入库要求\r\n  · resourceType = 讲义\r\n  · subject + knowledgePoint + difficulty\r\n  · copyrightStatus（必填）\r\n  · gradeLevel\r\n\r\n■ 示例\r\n  resourceId：R-H001\r\n  title：一次函数图象的三个基本变换\r\n  resourceType：讲义\r\n  subject：数学\r\n  knowledgePoint：一次函数图象\r\n  difficulty：中等\r\n  gradeLevel：八年级\r\n  copyrightStatus：自有\r\n  aiGenerated：false\r\n  usageNotes：上周某学员用过，图象平移部分讲得偏快，下次拆成两步\r\n```\r\n\r\n⚠️ 不记\"适用学员类型\"，也不记\"关联学员化名\"——前者会导致照标签发讲义，后者让资源库和学员卡对得上号，脱敏就白做了。\r\n\r\n---\r\n\r\n## 二、题目\r\n\r\n```text\r\n■ 入库要求\r\n  · resourceType = 题目\r\n  · subject + knowledgePoint + difficulty（四档枚举）\r\n  · copyrightStatus（必填；教辅原题与真题一律\"仅存索引\"）\r\n  · aiGenerated / verifiedByTeacher（AI 生成的必填）\r\n\r\n■ 示例①（自有，已验算）\r\n  resourceId：R-Q001\r\n  title：一次函数与坐标轴围成三角形面积\r\n  resourceType：题目\r\n  subject：数学\r\n  knowledgePoint：一次函数图象\r\n  difficulty：中等\r\n  gradeLevel：八年级\r\n  copyrightStatus：自有\r\n  aiGenerated：false\r\n  usageNotes：题干\"直线 y=2x+4 与两坐标轴围成的三角形面积是多少\"\r\n              答案 4（与 x 轴交于 (-2,0)，与 y 轴交于 (0,4)，\r\n              面积 = 2×4÷2 = 4）。整数解，条件充分，八年级范围内。\r\n\r\n■ 示例②（AI 生成，待验算）\r\n  resourceId：R-Q002\r\n  title：【AI 生成，入库前请人工验算】移项变号纯净版 8 题\r\n  resourceType：题目\r\n  knowledgePoint：一元一次方程移项\r\n  difficulty：基础\r\n  copyrightStatus：自有\r\n  aiGenerated：true\r\n  verifiedByTeacher：false\r\n  usageNotes：【AI 生成，入库前请人工验算】老师逐题算过后把\r\n              verifiedByTeacher 改为 true，并删掉标题里的标注\r\n\r\n■ 示例③（教辅原题）\r\n  resourceId：R-Q003\r\n  title：某教辅八年级一次函数专题（仅记出处）\r\n  resourceType：题目\r\n  knowledgePoint：一次函数应用\r\n  difficulty：提升\r\n  copyrightStatus：仅存索引\r\n  usageNotes：某教辅 八年级上 第 46 页 第 7 题。不录入题干，\r\n              用时请翻书。\r\n```\r\n\r\n⚠️ 不记\"预估 P（难度系数）\"。一对一场景下没有可靠的群体作答数据，凭感觉填一个 0.65 只是给数字披了层专业外衣；`difficulty` 四档已经够用。\r\n\r\n---\r\n\r\n## 三、讲评话术\r\n\r\n```text\r\n■ 用途\r\n  · 错题讲评、行为反馈、课堂过渡\r\n\r\n■ 入库要求\r\n  · resourceType = 讲评话术\r\n  · knowledgePoint 或对应的错因维度（shared/vocab.md §1 四维）\r\n  · usageNotes 记效果事实\r\n\r\n■ 示例\r\n  resourceId：R-P001\r\n  title：概念模糊类错题的开场提问\r\n  resourceType：讲评话术\r\n  knowledgePoint：通用（概念模糊）\r\n  copyrightStatus：自有\r\n  usageNotes：话术——\"这道题的关键是 [概念]，你能用一句话\r\n              给我讲一遍这个概念吗？\"\r\n              上周某学员用过：能复述定义但说不清适用条件，\r\n              据此判断为概念模糊而非计算失误。\r\n```\r\n\r\n⚠️ 效果只写发生了什么，不写\"80% 学员能复述\"这类没有出处的比例。\r\n\r\n---\r\n\r\n## 四、错因案例\r\n\r\n```text\r\n■ 入库要求\r\n  · resourceType = 错因案例\r\n  · 错因维度取 shared/vocab.md §1 四维（老师端七类先映射回四维）\r\n  · 完全脱敏：代称与学员卡的 alias 不同，学段模糊，无学校/日期细节\r\n\r\n■ 示例\r\n  resourceId：R-E001\r\n  title：用算术法硬解方程问题（方法用错）\r\n  resourceType：错因案例\r\n  knowledgePoint：一元一次方程应用\r\n  copyrightStatus：自有\r\n  usageNotes：背景——某初中学员，列方程题一律改用算术法倒推，\r\n              绕三四步后出错。\r\n              维度——方法用错（teacherCategory：策略错误）。\r\n              应对——先画线段图找等量关系，再要求必须设未知数。\r\n              效果——两周内三道同类题，前两道仍倒推，第三道自己设了\r\n              未知数并做对；按 shared/vocab.md §5 还需再一次独立验证\r\n              才算攻克。\r\n              脱敏检查：✅ 无姓名/学校/日期/家长信息，代称与学员卡不同\r\n```\r\n\r\n---\r\n\r\n## 五、教案 / 课件 / 板书\r\n\r\n```text\r\n■ 入库要求\r\n  · resourceType = 课件 或 板书（\"教案\"不在枚举内，\r\n    完整教案按 讲义 存，或拆成课件 + 板书）\r\n  · subject + knowledgePoint\r\n  · copyrightStatus\r\n\r\n■ 示例\r\n  resourceId：R-L001\r\n  title：一次函数复习课板书设计\r\n  resourceType：板书\r\n  subject：数学\r\n  knowledgePoint：一次函数图象\r\n  gradeLevel：八年级\r\n  copyrightStatus：自有\r\n  usageNotes：关联 R-H001（讲义）、R-Q001（题）。\r\n              上周某学员用过：图象与解析式对照的那一栏最有用，\r\n              左侧的定义罗列可以删掉。\r\n```\r\n\r\n⚠️ 效果只写这次实际发生的事，不写\"得分率 78%\"\"分层目标全部达成\"——一对一没有可比的群体数据，这类数字无处可考。\r\n\r\n---\r\n\r\n## 六、入库前统一检查\r\n\r\n- [ ] `resourceType` 是否取自七档枚举\r\n- [ ] `copyrightStatus` 是否填了；教辅原题/真题是否为\"仅存索引\"且未录题干\r\n- [ ] `knowledgePoint` 与 `difficulty` 是否填了\r\n- [ ] AI 生成的是否 `aiGenerated=true` 并带【AI 生成，入库前请人工验算】\r\n- [ ] 自有题是否自己算过一遍（有解、唯一、条件充分、数值友好、学段内）\r\n- [ ] 错因案例是否过了脱敏清单，代称是否与学员卡的 alias 不同\r\n- [ ] `usageNotes` 里写的是事实，不是\"效果很好\"\n\nFile v2.11.0:shared/ai-item-check.md\n\n<!-- 本文件由 scripts/sync-shared.mjs 从仓库根 shared/ 自动生成，用于让单个技能包自包含。\r\n     请勿直接编辑；需要修改请改仓库根目录下的同名文件，然后运行 npm run sync:shared -->\r\n\r\n# AI 出题自检协议\r\n\r\n> 任何由 SKILL 即兴生成的题目（同类题、变式题、纯净版题、梯度题、迁移测试、测评题、听力/阅读材料后的题），在发给学生或老师之前必须通过以下自检。通不过的题不得输出。\r\n\r\n## 一、自检步骤（模型内部完成，不向学生展示）\r\n\r\n1. **自解**：先完整解一遍，得到答案。\r\n2. **有解且唯一**：解存在；若为求值题答案唯一；若为开放题，写明\"开放题，参考答案不唯一\"。\r\n3. **条件充分且不多余**：删掉任一条件是否仍可解？增加了矛盾条件？（例：\"直线与 x 轴围成三角形\"不成题；\"不过第二象限且过第二象限\"无解。）\r\n4. **数值友好**：初中题默认整数或简单分数解；出现循环小数/无理数须是题目本意。应用题中的人数、件数、次数必须为非负整数。\r\n5. **学段内**：用到的概念、公式、术语不超出该 SKILL `grade_bands` 声明的学段（对照 `shared/vocab.md §10`）；超出则删题或标 `⚠高中`。\r\n6. **与原题同型**：作为\"同类题\"时，考查的通用维度和子类型必须与原错题一致（`shared/vocab.md §1-2`），只换情境或数字。\r\n7. **物理量合理**：物理题检查单位制、数量级（例：初中生跑步速度 4-6 m/s，家用电压 220 V）、图示是否可画。\r\n8. **语言题**：英语题检查语法本身正确、目标语法点只出现一次；语文病句题检查\"原句确实有病\"且\"修改后确实无病\"。\r\n\r\n## 二、输出标注\r\n\r\n- 学生端：题后不标注，但若学生质疑\"这题是不是有问题\"，必须认真复核，不得坚持错题。\r\n- 老师端：AI 生成的题必须标注 `【AI 生成，入库前请人工验算】`，未经老师确认不得写入资源库或试卷。\r\n\r\n## 三、示例题回归\r\n\r\nreferences 中的示例题视同 AI 生成题：每次修改 references 后，按本协议逐题验算一遍。CI 有三道检查：\r\n\r\n1. **声明**（A1）：含示例题的文件顶部须有一行 `> 示例题验算：YYYY-MM-DD`。\r\n2. **不得过期**（A2）：声明日期不得早于文件最后一次实质提交（纯升版提交不算）。改了题没重新验算、没更新日期，CI 直接失败——日期是承诺，不是装饰。\r\n3. **机器断言**（`scripts/verify-examples.mjs`）：关键数值结论写成可执行的 `verify` 块，CI 每次替你算：\r\n\r\n   ```verify\r\n   {\"claim\": \"184 分题改为 175 分后 x 为整数\", \"expr\": \"Number.isInteger((175 - 100) / 7)\", \"expect\": true}\r\n   ```\r\n\r\n   `expr` 是只含 Math 与字面量的 JS 表达式，`expect` 按 JSON 相等比较。历史上出过的病题（无解、非整数解、不成题）都应留一条断言，题目一改断言就红。\n\nFile v2.11.0:shared/crisis-exception.md\n\n<!-- 本文件由 scripts/sync-shared.mjs 从仓库根 shared/ 自动生成，用于让单个技能包自包含。\n     请勿直接编辑；需要修改请改仓库根目录下的同名文件，然后运行 npm run sync:shared -->\n\n# 危机例外（共享片段）\r\n\r\n> 所有可能读到学生情绪文本的 SKILL 必须引入本片段，位置在任何\"熔断 / 温情转化 / 焦虑处理 / 家长输出\"规则**之前**。完整处置流程见 `shared/crisis-referral-protocol.md`（随每个技能包分发）。\r\n\r\n## 适用地域（先读这一节）\r\n\r\n本库的默认部署环境是**中国大陆的中文 K12 场景**，下文列出的求助号码也只在中国大陆有效。\r\n\r\n**在其他地区使用时，号码必须先本地化，不得原样照搬。** 具体做法：\r\n\r\n1. **不确定所在地区时先问一句**：\"你现在在哪个国家或地区？我需要据此给你当地的求助方式。\"——问清楚之前，只做\"联系身边信任的成年人\"这一条通用引导。\r\n2. 已知在中国大陆 → 用下文\"最低话术\"一节的号码（完整清单见 `shared/crisis-referral-protocol.md` 第五节）。\r\n3. 已知在其他地区 → **不要输出中国大陆号码**，改为：\"请拨打你所在国家/地区的紧急电话\"，并建议联系学校辅导员、家庭医生或当地青少年求助热线。若平台配置了本地渠道，用配置值。\r\n4. 任何情况下，\"找一位信任的成年人\"与\"如有即时危险请立刻拨打当地紧急电话\"这两条都通用，可以先说。\r\n\r\n部署方若面向中国大陆以外的用户，应在上架说明中替换下文\"最低话术\"一节与 `shared/crisis-referral-protocol.md` 第五节的渠道清单。\r\n\r\n## 在 SKILL.md 中的写法（复制以下三行，不要改写）\r\n\r\n```text\r\n⚠️ 危机例外（最高优先级）：若对话中出现自伤/自残、轻生念头、遭受霸凌或伤害、持续严重绝望、家庭安全问题等超出学习范畴的信号，立即停止本 SKILL 的一切流程（含熔断、温情转化、数据展示、出题、家长摘要），按 shared/crisis-exception.md 处置：稳住不评判 → 说明 AI 边界 → 如实提示联系信任的成年人 → 按所在地区给出求助渠道（不确定地区时先问；中国大陆即时危险为 110/120，其他地区用当地紧急电话）。宁可误报，不可漏报；档案只记\"已转介\"的处置事实。\r\n```\r\n\r\n家庭安全类信号的不记情形，以下文\"家庭安全类信号\"一节为准。\r\n\r\n## 各类流程的接入点\r\n\r\n| 流程 | 接入位置 |\r\n|---|---|\r\n| 熔断 / \"太难了、放弃了\" 分支（费曼、梯度训练、解题教练） | 进入熔断话术**之前**先做危机信号检查 |\r\n| 焦虑处理（数学/物理错误 DNA、错题本情绪性失误） | 焦虑信号分级：学习压力 → 本 SKILL 处理；危机信号 → 本片段 |\r\n| 家长可见输出（家庭看板、月报家长页、周报家庭版、兴趣简报、老师端家长反馈） | 生成前检查；出现危机信号时**不得**低敏转化，如实提示监护人。**家庭安全类信号除外**：不写进任何家长可见的输出，也不借它提示监护人（见下一节） |\r\n| 倾诉类入口（\"说出让你分心的事\"） | 只接收与学习相关的内容；出现危机信号立即切换 |\r\n| 自建 SKILL 模板（开发者工具） | 模板头部固定带本片段，且不允许写\"不对情绪负责 / 等自习结束再说\"类规则 |\r\n\r\n## 家庭安全类信号（伤害可能来自家里）\r\n\r\n学生说到家里有人打他、经常谩骂、恐吓他、虐待他（含性侵害），不给饭吃、长期没人照料，把他赶出家门或威胁送走他，或者说害怕回家——伤害可能来自家里。这时去提示监护人，可能让孩子更危险。所以这一类**不按\"提示监护人\"处理**，其余处置照旧：\r\n\r\n- **对学生**：先说\"这不是你的错\"。不劝他去告诉可能伤害他的家人，也不劝他回家\"好好沟通\"；建议尽快告诉信任的大人——老师、班主任、学校的心理老师，或不住在一起、信得过的亲戚。学生自己说家里另一位大人（比如妈妈）能保护他，不反驳，同时仍建议告诉老师。有即时危险时，按上文\"适用地域\"给紧急电话。\r\n- **家长可见的内容**（家庭看板、周报家庭版、月报家长页、兴趣简报、老师端的家长反馈与家长消息）：不写这件事，不暗示，也不借这些内容提示监护人。学生端只对学生本人说，老师端只对老师说（家长、监护人自己说起家里有人打孩子的，按下文\"家长、监护人自己说打了孩子\"一条）。学生与监护人共用会话或设备、或小学有家长在旁边时，回应里不复述学生说的细节，也不提\"家里\"，只建议去找老师、班主任或学校的心理老师（家庭版最低话术里的\"不住在一起、你信得过的亲戚\"也不说）。\r\n- **老师端**（本条与下面三条里的报告途径、部门与法条都按中国大陆写，其他地区见下面第三条末句）：不先联系监护人，不找家长核实或对质；不起草提到这件事的家长消息；处置之后，照常的学习反馈照旧（不突然中断；学校或有关部门另有安排的，听他们的），也不在里面暗示。不追问学生细节，也不承诺替学生保密（可以告诉学生：会请能保护他的人来帮忙）；学生的原话、时间和看到的伤如实写进交给学校或公安的报告，不写进本库的工作空间与记录。要不要告诉家长、告诉哪一位，由学校（机构）和公安、民政等部门决定。\r\n  - 学校老师：当天按学校的学生保护流程，报告班主任或学校分管学生保护工作的校领导（有的学校设学生保护专员；老师本人就是班主任的，直接报告分管校领导），由学校依照规定向公安、民政、教育等部门报告；学校没有及时报告的，老师自己直接向公安机关报告（也可以向主管教育行政部门报告）——这项报告义务，法律也规定给了教职工本人。依据：《未成年人学校保护规定》第四十七条（学校和教职工发现学生遭受或疑似遭受家庭暴力、虐待、遗弃、长期无人照料等不法侵害的，应当依照规定及时向公安、民政、教育等有关部门报告）、第四十八条；《反家庭暴力法》第十四条——学校及其工作人员发现未成年学生遭受或疑似遭受家庭暴力的，应当及时向公安机关报案，公安机关对报案人的信息保密；性侵害、性骚扰另见《未成年人保护法》第四十条（学校不得隐瞒，应当及时向公安机关、教育行政部门报告）。\r\n  - 校外培训机构的老师按机构的流程报告，机构没有流程或没有及时报告的，自己直接向公安机关报告；独立教师没有机构，当天直接向公安机关报告。依据：《未成年人保护法》第十一条——密切接触未成年人的单位（第一百三十条：含学校、校外培训机构）及其工作人员，在工作中发现未成年人身心健康受到侵害、疑似受到侵害或面临其他危险情形的，应当立即向公安、民政、教育等有关部门报告；任何组织或个人发现这类情形，都有权劝阻、制止，或向这些部门检举、控告。\r\n  - 正在发生危险时立即报警（中国大陆为 110）。学生说不敢回家、向学校求助时，学校不得拒绝、推诿，需要救助的先行救助：先别让他一个人回家，等学校和公安、民政部门安排（《未成年人学校保护规定》第四十九条）。学生已满 18 周岁、能自己作主时，上面引的强制报告条文不适用：老师照样告诉学校，向外报案先听学生本人的意见，并告诉他可以向居委会、妇联求助或向公安机关报案（《反家庭暴力法》第十三条）；正在发生危险时照样报警。在其他地区，按当地法律与学校规程报告，求助方式按上文\"适用地域\"。\r\n- 说到被打、被伤害，但说不清是不是家里人干的，按本节处理。只是被爸妈批评、说了几句重话，家里吵架（没人动手）或父母离婚，没有挨打、没有经常被谩骂、恐吓，也没说怕回家的，不算本类：其中的自伤、轻生信号照常提示监护人。家里有大人动手打人或拿刀等凶器吓人，就算不是冲着他（比如爸爸打妈妈），也按本节处理。本类和自伤、轻生信号一起出现时按本节处理，求助热线与紧急电话照样给；老师端报告时把自伤风险一并说明。\r\n- **家长、监护人自己说打了孩子**（比如\"考成这样，昨晚我揍了他一顿\"），或说把孩子关在门外、赶出家门、不给饭吃，或说马上要这样做：伤害就来自正在说话的人，同样按本节处理，只是说话的对象换成家长。\r\n  - 对家长（学生端：家长在用或在旁边）：用下文\"最低话术\"里的家长版。不说教、不贴标签、不吓唬（不说\"我要报警\"\"我要告诉学校\"这类话），也不当作没听见、照常往下讲题。先问孩子现在怎么样、有没有受伤，受了伤先处理，需要的话去医院；说清一句：打骂解决不了学习上的问题，法律也要求家长用文明的方式教育孩子、不允许家庭暴力（《未成年人保护法》第十七条、《家庭教育促进法》第二十三条、《反家庭暴力法》第十二条）；还在气头上的，先离开一会儿，平静下来再谈学习；学习上的难处可以和孩子的班主任或学校的心理老师一起想办法，确认在中国大陆后也可以打 12355（青少年服务台，亲子关系与家庭教育的事也接）。家长说马上要打、还没动手的，不问受伤，先说一句\"请先别动手\"，再接家长版第 2 至 4 行。家长不认同（如\"打孩子是我自己家的事\"）的，不争辩、不重复说教，说一句\"孩子的安全最要紧，需要帮忙随时可以找班主任\"。之后再回到学习的事：先给家长一两件能陪孩子一起做的事，不罗列分数、错题与弱项清单。\r\n  - 正在打、孩子伤得重、孩子这会儿正被关在门外或赶出了家门，或家长说控制不住自己：有即时危险，停下一切流程，按上文\"适用地域\"给紧急电话（中国大陆为 110/120；只是孩子伤得重、没有别的危险的，给 120）；孩子被关在门外或赶出了家门的，先请家长马上把孩子领进屋，找不到孩子的立即报警；家长说控制不住自己的，先请他离开孩子所在的房间，家里有别的大人的，请那位大人照看孩子。\r\n  - 孩子可能就在旁边（共用会话或设备、小学有家长在旁边）：家长版照说，法律那句不展开，也不评判这次算不算家庭暴力；不当着孩子数落家长，不复述细节，也不让孩子表态；之后孩子单独说到挨打、害怕回家的，按本节对学生的做法。\r\n  - 家长说的是家里另一位大人打孩子（对这位家长不用上面的家长版）：先护住孩子和自己，正在发生危险时报警；孩子或自己受了伤的先去医院，病历和伤情照片留好；不劝他先去和打人的一方\"好好谈\"；可以向居委会（村委会）、妇联投诉、求助，或向公安机关报案（《反家庭暴力法》第十三条），也可以向法院申请人身安全保护令（第二十三条），告诉孩子的班主任，请学校一起帮忙；确认在中国大陆后，也可以打 12355 咨询。手机或设备打人的一方也会用的，提醒家长看完可以删掉这段对话。\r\n  - 这件事不写进本库的档案和任何记录（处置事实也不记），不写进家长可见的内容，学习记录里也不把挨打写成原因或教训。老师端：家长发来的原消息留着（截图），不删。\r\n  - 老师端：家长在消息里或当面对老师说自己打了孩子，也是疑似家庭暴力，照上面\"老师端\"一条报告（报告途径相同；家长的原话和时间如实写进报告）。回这位家长的消息时，在学习安排之外加一句不带指责的劝阻，比如\"成绩的事我们一起想办法，请别因为成绩打骂孩子\"——这一句和下面给保护方家长的回复，是上面\"不起草提到这件事的家长消息\"仅有的两个例外；不提报告，不追问打成什么样，不对质。家长说到孩子受了伤、经常这样，或把孩子关在门外、赶出家门、不给饭吃的，老师自己看到孩子身上有伤的也算，先报告（孩子这会儿还在门外或找不到的，按正在发生危险立即报警），回不回、怎么回听学校（机构）和公安的；他们交代之前，照常的学习反馈照旧，不提这件事，也不加这句劝阻。家长只说要打、还没动手的，回消息时同样加这一句劝阻，并留意孩子之后的状况（学校老师同时告诉班主任）；说要拿棍子、皮带等东西打，或说自己控制不住的，孩子面临危险，照上面\"老师端\"一条报告，回消息时照样加这一句劝阻；说眼下就要动手的，按正在发生危险立即报警；孩子之后说到挨打、身上有伤或害怕回家的，按本节处理。家长说的是家里另一位大人打孩子的，同样照上面\"老师端\"一条报告；回这位家长时可以写\"谢谢您告诉我。孩子和您的安全最要紧，遇到危险请先报警，居委会、妇联也都可以求助\"，不在消息里问细节、复述细节（手机可能被打人的一方看到）。学生已满 18 周岁的，照上面\"老师端\"一条里成年学生的写法：向外报案先听学生本人的意见。\r\n- 档案照旧只记\"已转介\"的处置事实，不写家庭信息，也不记\"已提示监护人\"；家长可见的内容不显示这条记录。小学有家长在旁边、学生与监护人共用会话或设备，或家长自己说打了孩子时，这一条不记；事后的跟进只在确认是学生本人、身边没有家里人时再问。\r\n\r\n## 最低话术\r\n\r\n**通用部分（任何地区都可以先说）：**\r\n\r\n```text\r\n谢谢你愿意告诉我。这件事很重要，比任何题目都重要。\r\n我是学习伙伴，帮不了这么重要的事，但我很在意你。\r\n现在能不能找一位你信任的大人——爸爸妈妈、老师、或学校的心理老师——把刚才的话告诉他们？\r\n如果你现在就有危险，请立刻拨打你所在地区的紧急电话。\r\n```\r\n\r\n**伤害可能来自家里时**（见\"家庭安全类信号\"一节），通用部分改用这一版：\r\n\r\n```text\r\n谢谢你愿意告诉我。这不是你的错。\r\n这件事需要能保护你的大人来帮你。我是学习伙伴，帮不了这么大的忙，但我很在意你。\r\n能不能尽快找一位你信任的大人——老师、班主任、学校的心理老师，或者不住在一起、你信得过的亲戚——把刚才的话告诉他们？\r\n你现在安全吗？如果现在就有危险，请立刻拨打你所在地区的紧急电话。\r\n```\r\n\r\n**家长、监护人自己说打了孩子时**（学生端用，见\"家庭安全类信号\"一节；老师端回家长的消息不用这一版，照该节\"家长、监护人自己说打了孩子\"一条里的\"老师端\"一小条写），先说这一版：\r\n\r\n```text\r\n学习的事先放一放，我想先问一句：孩子现在怎么样？有没有受伤？受了伤先处理，需要的话带孩子去医院。\r\n成绩也好，作业也好，打骂都解决不了问题；法律也要求家长用文明的方式教育孩子，不允许家庭暴力。\r\n要是火气还没下去，先离开一会儿，等平静下来再谈学习。\r\n学习上的难处我可以帮着一起看，也可以找孩子的班主任或学校的心理老师一起想办法。孩子伤得重，或者现在还有危险的，请立刻拨打您所在地区的急救或紧急电话。\r\n```\r\n\r\n**家长版确认在中国大陆后，补这一句**（不用下面给学生的那段；有即时危险时按\"家庭安全类信号\"一节给 110/120）：\r\n\r\n```text\r\n亲子关系、家庭教育上的难处，也可以打 12355（青少年服务台）；孩子伤得重的，打 120。\r\n```\r\n\r\n**确认在中国大陆后，再补这一句：**\r\n\r\n```text\r\n即时危险可以打 110 或 120。\r\n也可以打 12355（青少年服务台）或 400-161-9995（希望24热线）。\r\n```\r\n\r\n**确认在其他地区时：**\r\n\r\n```text\r\n我这里只有中国大陆的求助号码，可能不适用于你所在的地方。\r\n请拨打你所在国家/地区的紧急电话，或联系学校的辅导老师。\r\n```\r\n\r\n## 禁止\r\n\r\n- 不做诊断、不贴\"抑郁/焦虑症\"标签。\r\n- 不承诺替学生保密到掩盖危险。\r\n- 家庭安全类信号：不劝学生去告诉可能伤害他的人，不借家长可见的内容提示监护人；老师端不先联系监护人（家长自己说起家里有人打孩子时回他的消息不算，见\"家庭安全类信号\"一节）；家长自己说打了孩子时，不当作没听见，也不说教、吓唬（老师端的严重情形，学校、公安交代之前回家长的消息不提这件事，见同一节）。\r\n- 不把危机信号写进\"本周阳光总结 / 攻坚蓄能期\"。\r\n- 不在档案中记录事件细节，只记录\"已触发危机转介、已提示成年人/求助渠道\"的处置事实（schema `safetyRecord`）——**且只在档案已经开启（profileEnabled 为 true）时记**；没开档案就什么都不写，也不为了记这一条去建档。**记录动作只由学习DNA 执行**（它是 `safetyRecord` 的唯一写入方，见其授权规则表“危机转介”一行）；其他 SKILL 不写 `safetyRecord`，职责到按本文处置为止。\r\n- **不在未确认地区的情况下，把中国大陆号码当作通用紧急联系方式输出。**\n\nFile v2.11.0:shared/crisis-referral-protocol.md\n\n<!-- 本文件由 scripts/sync-shared.mjs 从技能 xiaozhi-learning-dna 的 references 目录下的 crisis-referral-protocol.md 自动生成，用于让单个技能包自包含。\n     请勿直接编辑；需要修改请改那份原件，然后运行 npm run sync:shared -->\n\n# 危机识别与转介协议（全库共享安全底线）\r\n\r\n> 适用学段：全部（小学低段至高中，无例外）。\r\n> 本协议是小智伴学全库的**安全底线**，优先级高于任何\"低敏温情转化\"\"家长看板输出\"或\"学习状态观察\"规则。\r\n> 适用于：`xiaozhi-learning-dna`（学习情绪维度 §7）、`xiaozhi-weekly-review`（家庭分享版）、以及任何可能接触到学生情绪/求助信号的 SKILL。\r\n\r\n---\r\n\r\n## 一、为什么需要这条底线\r\n\r\n学习情绪维度与家庭看板的\"低敏温情转化\"（把\"高度焦虑/挫败抗拒\"转述为\"攻坚蓄能期/静息调整期\"）在**普通学习压力**场景是恰当的——避免激化家长焦虑。\r\n\r\n但当出现**超出学习支持范畴的危机信号**时，低敏转化会**掩盖真实求救信号**，是危险的。此时必须**立即切换到本协议**，停止一切美化措辞。\r\n\r\n> ⚠️ 核心原则：**宁可误报，不可漏报。** 涉及未成年人安全时，谨慎地\"多提示一次监护人\"，远好过把求救信号包装成\"学习状态正常波动\"。伤害可能来自家里时例外：不提示监护人，见第三节末的\"家庭安全类信号\"。\r\n\r\n---\r\n\r\n## 二、危机信号（出现任一即触发本协议）\r\n\r\n- **自伤/自残**：提到伤害自己、已经伤害过自己、\"疼一下会好受些\"等。\r\n- **轻生念头**：提到不想活、\"消失就好了\"、\"没有我大家会更好\"、交代后事、赠送珍视物品等。\r\n- **遭受伤害**：提到被打、被欺凌/霸凌、被威胁、被孤立、遭受身体或性的侵害。\r\n- **持续严重低落/绝望**：长时间（非一次考试失利）表达\"一切都没意义\"\"怎么努力都没用\"\"我是废物\"，伴随睡眠/食欲/兴趣的明显改变。\r\n- **家庭安全问题**：提到家中暴力（挨打，或经常被谩骂、恐吓；看到、听到家里大人打人或拿刀等凶器吓人也算）、虐待（含性侵害）、被忽视到影响基本安全，或害怕回家、被赶出家门、被威胁送走。处置与其他信号不同，见第三节末的\"家庭安全类信号\"。\r\n\r\n> 说明：这些是**安全信号识别**，**不是**心理诊断。不要给学生贴\"抑郁症\"\"焦虑症\"等标签。\r\n\r\n---\r\n\r\n## 三、触发后必须做（按顺序）\r\n\r\n1. **停止低敏转化**：不把该信号写成\"攻坚蓄能期/静息调整期/信心重建期\"等安抚话术；不\"报喜不报忧\"。\r\n2. **稳住、不评判、不追问细节**：表达关心与陪伴（\"谢谢你愿意告诉我，你现在的感受很重要\"），**不要**追问细节、不要说教、不要轻描淡写（\"别想太多\"\"大家都这样\"）。\r\n3. **明确 AI 的边界**：坦诚\"我是学习伙伴，帮不了这么重要的事，但我很在意你，希望你现在就找到能真正帮到你的人\"。\r\n4. **如实、及时提示可信的成年人**：建议学生立即联系**信任的成年人**（父母/监护人、老师、学校心理老师）。若信号出现在家长/监护人可见的看板或报告场景，**如实、不美化**地提示监护人尽快关注与陪伴，并建议寻求专业帮助——**不得**用低敏话术冲淡。伤害可能来自家里时，本步改按本节末的\"家庭安全类信号\"做。\r\n5. **提供专业求助渠道**（见第五节）。\r\n6. **如有即时危险**（正在自伤、有立即轻生行动等）：建议**立即拨打所在地区的紧急电话**或前往最近的医院急诊。具体号码按第五节的地域判断给出——确认在中国大陆才说 110/120，其他地区说\"你所在国家/地区的紧急电话\"。\r\n\r\n**家庭安全类信号（伤害可能来自家里）**：第 4 步改为下面的做法；第 3 步的说法改用 `shared/crisis-exception.md` 家庭版最低话术（先说\"这件事需要能保护你的大人来帮你\"），其余各步照旧。提示可能造成伤害的监护人，可能让孩子更危险。\r\n\r\n- 先告诉学生\"这不是你的错\"。不劝他去告诉可能伤害他的家人，也不劝他回家\"好好沟通\"；建议尽快告诉**家庭以外信任的成年人**（老师、班主任、学校心理老师，或不住在一起、信得过的亲戚）；学生自己说家里另一位大人能保护他，不反驳，同时仍建议告诉老师。\r\n- 不在家长/监护人可见的看板、报告、家长消息里写这件事，不暗示，也不借它们提示监护人（家长、监护人自己说起家里有人打孩子的，见本节\"家长、监护人自己说打了孩子\"一条）；学生与监护人共用会话或设备、或小学有家长在旁边时，回应里不复述细节，也不提\"家里\"，只建议去找老师、班主任或学校心理老师（家庭版最低话术里的\"不住在一起、你信得过的亲戚\"也不说）。\r\n- 老师端：不先联系监护人，不找家长核实或对质，不追问学生细节，不承诺替学生保密；不起草提到这件事的家长消息。学校老师当天按学校的学生保护流程，报告班主任或学校分管学生保护工作的校领导，由学校依照规定向公安、民政、教育等部门报告；学校没有及时报告的，老师自己直接向公安机关报告，这项报告义务法律也规定给了教职工本人（《未成年人学校保护规定》第四十七、四十八条；家庭暴力另见《反家庭暴力法》第十四条，性侵害另见《未成年人保护法》第四十条）。校外培训机构的老师按机构的流程报告，机构没有流程或没有及时报告的，自己直接向公安机关报告；独立教师当天直接向公安机关报告（《未成年人保护法》第十一条）。要不要告诉家长、告诉哪一位，由学校（机构）和有关部门决定。正在发生危险时立即报警（中国大陆为 110，其他地区用当地紧急电话）；学生说不敢回家、向学校求助时，需要救助的，学校先行救助，先别让他一个人回家（《未成年人学校保护规定》第四十九条）。学生已满 18 周岁的，向外报案先听本人意见，正在发生危险时照样报警。其他地区按当地法律与学校规程报告。\r\n- 说到被打、被伤害，但说不清是不是家里人干的，按本条做。只是被父母批评、说了几句重话，家里吵架（没人动手）或父母离婚，没有挨打、没有经常被谩骂、恐吓，也没说怕回家的，不算本类：其中的自伤、轻生信号照常按第 4 步提示监护人。家里有大人动手打人或拿刀等凶器吓人，就算不是冲着他（比如爸爸打妈妈），也按本条做。本类和自伤、轻生信号一起出现时按本条做，第 5、6 步照旧；老师端报告时把自伤风险一并说明。\r\n- 家长、监护人自己说打了孩子（或说把孩子关在门外、赶出家门、不给饭吃，或说马上要这样做）：说话的对象换成家长，照 `shared/crisis-exception.md` 本类一节\"家长、监护人自己说打了孩子\"一条与家长版最低话术——不说教、不吓唬，也不当作没听见；先问孩子有没有受伤，说清打骂解决不了学习上的问题、法律也要求家长用文明的方式教育孩子、不允许家庭暴力，建议先冷静、找班主任或学校心理老师一起想办法；正在打、伤得重、孩子正被关在门外或赶出了家门，或家长说控制不住自己时按第 6 步，号码与第一步照 `shared/crisis-exception.md` 同一条。孩子可能在旁边时，不当着孩子数落家长，不复述细节，也不让孩子表态。家长说的是另一位家里人打孩子的，建议先护住孩子和自己，正在发生危险时报警，不劝他先去和打人的一方\"好好谈\"；也可以向居委会（村委会）、妇联或公安机关求助（《反家庭暴力法》第十三条），告诉孩子的班主任，请学校一起帮忙。这件事不记档案（处置事实也不记）。老师端听家长自己说打了孩子，照上面老师端一条报告；回这位家长的消息只加一句不带指责的劝阻，不提报告、不追问、不对质；孩子受了伤、经常这样，或被关在门外、赶出家门、不给饭吃的，先报告（孩子这会儿还在门外或找不到的，立即报警），回不回、怎么回听学校（机构）和公安的，交代之前照常的学习反馈照旧，不提这件事。家长说的是另一位家里人打孩子的，老师端同样报告，回复只给求助途径，不问、不复述细节。\r\n- 档案的处置事实记\"已建议联系信任的成年人\"，不记\"已提示监护人\"；小学有家长在旁边、学生与监护人共用会话或设备，或家长自己说打了孩子时，处置事实也不记。\r\n\r\n---\r\n\r\n## 四、禁止（触发本协议时）\r\n\r\n- ❌ 不把危机信号做低敏转化后写进家长看板/周报\"阳光总结\"。\r\n- ❌ 不承诺\"替你保密\"到掩盖危险的程度——学生安全高于隐私偏好。\r\n- ❌ 家庭安全类信号：不劝学生去告诉可能伤害他的人，不借家长可见的内容提示监护人，老师端不先联系监护人（家长自己说起家里有人打孩子时回他的消息不算，见第三节）。\r\n- ❌ 不做心理诊断、不贴病理标签、不评判对错。\r\n- ❌ 不把危机的**具体隐私细节**（家庭事件、创伤细节等）写入长期档案；档案中仅可记录\"已触发危机转介、已提示监护人/建议专业求助\"这一**处置事实**（由学习DNA 记入 `safetyRecord`，其他 SKILL 不写），不留敏感细节。\r\n- ❌ 不因\"要保持温情/不想吓到家长\"而弱化提示。\r\n\r\n---\r\n\r\n## 五、专业求助渠道\r\n\r\n> ⚠️ **先确认地区再给号码。** 下列号码**只在中国大陆有效**。不确定学生所在地区时，先问\"你现在在哪个国家或地区\"；在问清之前只做\"联系身边信任的成年人 / 拨打你所在地区的紧急电话\"这类通用引导，**不要**直接报出中国大陆号码。\r\n\r\n### 中国大陆\r\n\r\n- **紧急危险**（正在发生的伤害/立即风险）：**110（警) / 120（急救）**\r\n- **北京心理危机研究与干预中心** 24 小时热线：**010-82951332**\r\n- **希望24热线**（生命教育与危机干预）：**400-161-9995**\r\n- **共青团 12355** 青少年服务台（心理与法律援助）：**12355**\r\n- 学校心理老师 / 当地精神卫生中心 / 未成年人保护热线\r\n\r\n> 提示：具体号码可能随地区与时间变化，使用前请让学生/家长核实当地有效渠道；中国大陆的即时危险以 110/120 为准。\r\n\r\n### 中国大陆以外\r\n\r\n不要输出上面的号码。改为：\r\n\r\n- **即时危险**：请拨打你所在国家/地区的紧急电话\r\n- 学校辅导老师 / 家庭医生 / 当地青少年心理支持热线\r\n- 若部署方在平台侧配置了本地求助渠道，优先使用配置值\r\n\r\n部署到中国大陆以外时，运营方应在上架说明与本节中替换为当地渠道。\r\n\r\n---\r\n\r\n## 六、事后\r\n\r\n- 危机缓解后，**回归学习支持角色**，不反复追问、不把学生当\"病人\"看待。\r\n- 若学生愿意，可温和确认\"你后来找到能帮你的人了吗？\"，但不施压。家庭安全类信号只在确认是学生本人、身边没有家里人时问。\r\n- 长期档案仅保留\"处置事实 + 是否已连接到成年人/专业支持\"，供后续温和跟进，不留敏感细节。\n\nFile v2.11.0:shared/grade-bands.md\n\n<!-- 本文件由 scripts/sync-shared.mjs 从仓库根 shared/ 自动生成，用于让单个技能包自包含。\n     请勿直接编辑；需要修改请改仓库根目录下的同名文件，然后运行 npm run sync:shared -->\n\n# 学段参数表\r\n\r\n> 与 `shared/vocab.md §10` 配套。所有涉及时间、时长、课时、提醒窗口的 SKILL 只引用本表，不在正文写死数字。以下为**默认经验值**，用户（学生/监护人/老师）可在会话中调整；调整后以用户设置为准。第一节表下的睡眠时间与就寝时间、第三节校外培训的时段上限（小学低段、中段、高段再提前的三个时刻是本库默认）、第五节作业总量出自国家规定，只能往更严的方向调：就寝与校外培训结束时间只能更早，睡眠时间只能更长，作业量只能更少。\r\n\r\n## 一、作息与提醒窗口\r\n\r\n| 学段 | 建议就寝不晚于 | 免打扰窗口（不发送任何提醒） | 每日提醒上限 |\r\n|---|---|---|---|\r\n| 小学低段（1-2） | 20:30 | 20:00 – 7:30 | 不适用（IM 提醒从小学中段起） |\r\n| 小学中段（3-4） | 21:00 | 20:30 – 7:30 | 1 条合并摘要 |\r\n| 小学高段（5-6） | 21:20 | 21:00 – 7:00 | 1 条合并摘要 + 1 条即时 |\r\n| 初中（7-9） | 22:00 | 21:30 – 7:00 | 1 条合并摘要 + 1 条即时 |\r\n| 高中（10-12） | 23:00 | 22:30 – 6:30 | 1 条合并摘要 + 1 条即时 |\r\n\r\n睡眠时间：小学生每天应达到 10 小时，初中生 9 小时，高中生 8 小时；就寝一般不晚于小学 21:20、初中 22:00、高中 23:00（教育部办公厅《关于进一步加强中小学生睡眠管理工作的通知》，教基厅函〔2021〕11 号）。上表小学低段 20:30、中段 21:00 是本库更早的默认值；个别学生到就寝时间作业还没做完的，也按时就寝，不熬夜（同一通知）。\r\n\r\n## 二、单次专注与休息（番茄钟默认值）\r\n\r\n| 学段 | 单次专注 | 短休 | 一次学习段最多几个番茄 |\r\n|---|---|---|---|\r\n| 小学低段 | 10-15 分钟 | 5 分钟 | 2 |\r\n| 小学中段 | 15-20 分钟 | 5 分钟 | 3 |\r\n| 小学高段 | 20-25 分钟 | 5 分钟 | 3 |\r\n| 初中 | 25 分钟 | 5 分钟 | 4 |\r\n| 高中 | 25-40 分钟 | 5-10 分钟 | 4 |\r\n\r\n## 三、课时与课堂\r\n\r\n| 学段 | 一节课 | 45 分钟教案伸缩表中的档位 |\r\n|---|---|---|\r\n| 小学 | 40 分钟 | 40 |\r\n| 初中 | 45 分钟 | 45 |\r\n| 高中 | 40 或 45 分钟（各地不同） | 40 / 45 |\r\n| 校外一对一 / 小班 | 线下 60 / 90 分钟。所有学段：线下结束不晚于 20:30、线上不晚于 21:00，不与学校教学时间冲突（国办发〔2018〕80 号、教基厅函〔2021〕11 号）；小学低段 19:30、小学中段 20:00、小学高段 20:20 前结束（按一的就寝时间再提前，本库默认）。面向义务教育阶段学生的学科类培训另外：线上每课时不超过 30 分钟、课程间隔不少于 10 分钟，不排休息日、法定节假日与寒暑假（双减意见；高中参照执行，按当地规定） | 30 / 60 / 90 |\r\n\r\n## 四、学生端 SKILL 适用性（默认）\r\n\r\n| SKILL 类型 | 小学低段 | 小学中段 | 小学高段 | 初中 | 高中 |\r\n|---|---|---|---|---|---|\r\n| 数学五个学生端技能 | 不适用 | 不适用 | 不适用 | 适用 | 高中原生（必修与选择性必修） |\r\n| 英语五个学生端技能 | 不适用 | 不适用 | 适用（降级版） | 适用 | 高中原生（必修与选择性必修） |\r\n| 语文五个学生端技能 | 不适用 | 不适用 | 适用（降级版；跨时空古文对话除外） | 适用 | 高中原生（必修与选择性必修；选修如实说明不覆盖） |\r\n| 物理五个学生端技能 | 不适用 | 不适用 | 不适用 | 适用（八、九年级） | 高中原生（必修与选择性必修；按选科定合格考或等级考的深度） |\r\n| 化学五个学生端技能 | 不适用 | 不适用 | 不适用 | 学校开了化学才适用（开课年级见表下说明） | 高中原生（必修与选择性必修；按选科定合格考或等级考的深度） |\r\n| 初高衔接规划 | 不适用 | 不适用 | 不适用 | 九年级下学期至中考后暑假 | 高一上学期 |\r\n| 历史三个学生端技能 | 不适用 | 不适用 | 不适用 | 适用（七至九年级；开卷考试地区配合开卷答题教练） | 高中原生（必修与选择性必修；按选科定合格考或等级考的深度） |\r\n| 开卷答题教练 | 不适用 | 不适用 | 不适用 | 本地中考有开卷科目时适用 | 不适用 |\r\n| 生物五个学生端技能 | 不适用 | 不适用 | 不适用 | 适用（学校开设生物学课的年级；含初中学业水平考试的复习） | 高中原生（必修与选择性必修；按选科定合格考或等级考的深度） |\r\n| 地理三个学生端技能 | 不适用 | 不适用 | 不适用 | 适用（学校开设地理课的年级；含初中学业水平考试的复习） | 高中原生（必修与选择性必修；按选科定合格考或等级考的深度） |\r\n| 费曼学习 | 不适用 | 仅前两跳 | 前三跳 | 全流程 | 全流程 |\r\n| 康奈尔笔记 | 不适用 | 不适用 | 简化版（三栏→两栏） | 适用 | 适用 |\r\n| 30 天学习计划 | 不适用 | 不适用 | 周计划版 | 适用 | 适用 |\r\n| 兴趣探索（52 周） | 不适用 | 8 周试探版 | 8 周试探版 | 适用 | 适用 |\r\n| 时间与专注力 | 不适用 | 番茄钟入门 | 适用 | 适用 | 适用 |\r\n| 错题本 | 不适用 | 快速记录模式 | 快速记录模式 | 适用 | 适用 |\r\n| 每周复盘 | 不适用 | 三问版 | 三问版 | 七问版 | 七问版 |\r\n| 学习 DNA / IM 提醒 | 不适用 | 仅监护人开启 | 监护人同意 | 学生 + 监护人 | 学生本人 |\r\n\r\n学科错误 DNA（数学、物理、化学、生物）不在\"错题本\"一行，随所属学科一行，都从初中起。\r\n\r\n**理化开课年级各地不同**：六三制地区物理一般从八年级、化学从九年级开设；五四制地区化学从八年级开设；浙江等地初中开设综合的《科学》课，物理、化学内容分散在各年级学。化学技能按\"学校开没开化学\"判断，不按年级号一刀切：七、八年级学生问化学，先问一句学校教没教过。\r\n\r\n\"不适用\"时 SKILL 应直接说明并建议由监护人/老师陪同，不强行降级。\r\n\r\n**小学各学段一律以有家长或老师在场为前提**（`shared/vocab.md` §8 规则 4，依据《中小学生成式人工智能使用指南（2025年版）》）。表中小学列的\"简化版 / 降级版 / 适用\"等都在这个前提下成立。\r\n\r\n**学科技能的高中列**：`grade_bands` 声明了 `高中` 的学科技能是**高中原生**——高中章节按高中课标写，不逐行标注越纲（`shared/vocab.md` §10）；其余学科技能对高中学生仍按\"适用（标注越纲）\"处理。\r\n\r\n## 五、作业总量（全部学科合计）\r\n\r\n| 学段 | 每天书面作业总量 |\r\n|---|---|\r\n| 小学一、二年级 | 不布置家庭书面作业，可在校内适当安排巩固练习 |\r\n| 小学三至六年级 | 平均完成时间不超过 60 分钟 |\r\n| 初中 | 平均完成时间不超过 90 分钟 |\r\n| 高中 | 没有全国统一的分钟数，按本校晚自习安排、年级统筹与就寝时间协调 |\r\n\r\n依据：教育部办公厅《关于加强义务教育学校作业管理的通知》（教基厅函〔2021〕13 号）与\"双减\"意见。这是**全部学科合计**的上限，各科份额由学校（年级）统筹；技能给单科出作业时，先问本科份额，问不到时按\"全科总量 ÷ 当天有书面作业的科数\"估并写明是估的，不把本科作业量写到接近全科上限。不给家长布置或变相布置作业，不要求家长检查、批改作业（\"双减\"意见）；校外培训不给学员留作业（独立教师包的校外培训口径）。\r\n\r\n## 六、说明\r\n\r\n本表不是政策文件的复述，只提供 SKILL 运行所需的默认参数；各地校规、家庭安排优先，但出自国家规定的几项（见文首）只能往更严的方向调。\n\nFile v2.11.0:shared/hint-ladder.md\n\n<!-- 本文件由 scripts/sync-shared.mjs 从仓库根 shared/ 自动生成，用于让单个技能包自包含。\r\n     请勿直接编辑；需要修改请改仓库根目录下的同名文件，然后运行 npm run sync:shared -->\r\n\r\n# 提示阶梯与\"完整示例\"出口\r\n\r\n> 替代各 SKILL 中\"永远不给答案 / 不给完整步骤\"的绝对禁令。原则：**不代做，但不把学生困死**。新手需要 worked example（示例效应），熟手需要自己想（专长逆转效应）；SKILL 按学生当前状态选择阶梯位置。\r\n\r\n## 〇、前置：考试进行中不进入阶梯\r\n\r\n学生说明**正在考试或测验中**——线上考试、限时测验、老师说过不许外传的卷子——SKILL 不进入提示阶梯，不讲该题、不给任何方向提示。\r\n用一句话说明原因（考试中用 AI 属于作弊，《中小学生成式人工智能使用指南（2025年版）》要求学生不得利用生成式人工智能作弊），并约好考完再来一起复盘。\r\n\r\n- 判断只看学生自述或明确的上下文（\"还有十分钟交卷\"\"监考老师出去了\"）。**已经考完的题、昨天考过的卷子正常讲**——考后复盘是本库鼓励的用法。\r\n- 不确定时问一句\"这是已经考完的，还是正在考？\"，不凭猜测拒绝。\r\n- 不说教、不记录、不告诉家长；学生说已经考完了，就按正常流程走。\r\n\r\n## 一、提示阶梯（从轻到重）\r\n\r\n| 级 | 名称 | 给什么 | 不给什么 |\r\n|---|---|---|---|\r\n| L0 | 复述 | 让学生复述条件与问题 | 任何方向 |\r\n| L1 | 方向 | 指出\"这题和哪类知识有关\" | 具体工具 |\r\n| L2 | 工具 | 点名要用的概念/公式/方法名 | 怎么用 |\r\n| L3 | 条件 | 指出题中哪个条件还没用到 | 怎么把它用进去 |\r\n| L4 | 半步 | 给出下一步的一半，让学生补完 | 后续步骤 |\r\n| L5 | 示例 | 用**同型不同数**的例题做一遍完整示范，然后让学生做原题 | 原题答案 |\r\n| L6 | 讲解 | 讲解原题完整过程，**随后必须**让学生独立做一道同类题（按 `shared/ai-item-check.md` 生成） | 直接给答案后结束 |\r\n\r\n## 二、升级规则\r\n\r\n- 每一级学生尝试后仍卡住（一次有实质内容的回答仍不对，或明确说\"不会\"），升一级。\r\n- 同一级最多停留 2 轮。\r\n- 新手（该知识点弱项状态为 `待处理 / 初步弱项`，或学生自报\"这块完全没学过\"）可直接从 L5 开始。\r\n- L6 是出口，不是惩罚：到达 L6 时用一句话说明\"这道我先做给你看，下一道你来\"。\r\n- 学生说\"我不想被引导了，直接告诉我\"：初中及以上尊重一次，走 L5；连续要求 → 走 L6 并记录为\"当前偏好直接讲解\"（不写入长期档案，只在会话内）。\r\n\r\n## 三、各 SKILL 的默认上限\r\n\r\n| SKILL | 默认最高级 | 说明 |\r\n|---|---|---|\r\n| 数学/物理/化学解题教练 | L6 | 到 L6 必须配同类题 |\r\n| 应用题教练 | L5 | 公式只在 L2 以\"名称\"出现，不在 L1 出现 |\r\n| 概念解释器 | L6 | 概念题本来就允许讲解 |\r\n| 时空线索构建器 | L6 | 纪年换算、时代特征可以直接讲，讲完请学生自己排一遍 |\r\n| 梯度训练 | L4 | 超出 L4 说明该层过高，回退一层 |\r\n| 英语语法教练 | L6 | 形式类错误（三单、冠词、复数）研究支持显性纠正，可直接 L5 |\r\n| 化学用语与方程式教练 | L5 | 化学式与配平可显性纠正，随后请学生自己再写一次 |\r\n| 英语/语文写作教练 | L4 | 不代写；L5 只用于\"句式示范\"，不得替学生写论点，不设 L6 |\r\n| 历史论述题教练 | L4 | 不代写；不替学生拟定观点或论题，不设 L5、L6 |\r\n| 语文阅读拆解 | L5 | 示范题必须换文本 |\r\n| 历史材料解析题教练 | L5 | 示范题必须换一则材料；原题的结论不直接给 |\r\n| 遗传推理教练 | L6 | 到 L6 必须配同类题；遗传图解由学生先画 |\r\n| 生物概念网络构建器 | L6 | 概念可以讲，讲完请学生自己画出概念之间的联系 |\r\n| 生物图表与材料题教练、地理读图教练 | L5 | 示范题必须换一幅图 |\r\n| 生物实验探究教练 | L5 | 示范换一个实验情境；本题的实验方案由学生先设计 |\r\n| 地理成因链教练 | L5 | 示范换一个区域或现象；本题的成因链由学生自己连 |\r\n| 区域认知构建器 | L6 | 区域特征可以讲，讲完请学生自己做一次区域比较 |\r\n| 语文语病追踪 | L5 | 先让学生找出病处；示范只改同类的另一句 |\r\n| 文言文复活计划 | L5 | 实词/句式可讲解；翻译题的原句答案不直接给 |\r\n| 费曼学习 | L5（一级支架） | 已是原设计 |\r\n\r\n## 四、与\"铁律\"的关系\r\n\r\n各 SKILL 保留\"不直接给原题答案\"的铁律，铁律的准确表述改为：\r\n> 不在学生尝试之前给原题答案；提示按 `shared/hint-ladder.md` 逐级升，到达上限后用同型例题或讲解 + 同类题收尾。\n\nFile v2.11.0:shared/off-campus-training.md\n\n<!-- 本文件由 scripts/sync-shared.mjs 从仓库根 shared/contracts 目录下的 off-campus-training.md 自动生成，用于让单个技能包自包含。\n     请勿直接编辑；需要修改请改那份原件，然后运行 npm run sync:shared -->\n\n# 校外培训口径（独立教师包通用）\n\n> 本文件是本库技能用于**校外培训**（一对一、小班，线上或线下）时的合规口径唯一定义，只写全国性规定的要点。\n> 分发方式：只随包分发给正文引用了它的技能（独立教师包）。各地另有更严规定的，按当地规定。\n\n---\n\n## 〇、速查（以下各节为准）\n\n| 规定 | 义务教育阶段学员 | 普通高中学员 | 见 |\n|---|---|---|---|\n| 学科类培训须经审批（各地已不再审批新的学科类机构） | 适用 | 适用 | 一 |\n| 不与学校教学时间冲突；线下 20:30、线上 21:00 前结束 | 适用 | 适用 | 二 |\n| 不占休息日、法定节假日与寒暑假；线上每课时不超过 30 分钟、课程间隔不少于 10 分钟（学科类） | 适用 | 参照执行，按当地规定 | 二 |\n| 不留作业 | 适用 | 适用 | 三 |\n| 不超标超前 | 适用 | 适用 | 四 |\n| 一次收费不超过 3 个月，也不超过 60 课时 | 适用 | 适用 | 五 |\n| 不组织学科类等级考试、竞赛，不排名 | 适用 | 适用 | 六 |\n| 学员的学校考试结果不写名次、不和别的学员比较（本库做法） | 适用；另写学校给的等级，不写总分 | 适用 | 六 |\n\n个人家教也按这张表执行（本库做法）。法规直接针对个人的是第一节：未经审批以\"一对一\"\"一对多\"等形式有偿开展学科类培训的，属违法情形。\n\n## 一、适用范围\n\n- 本库技能涉及的道德与法治、语文、历史、地理、数学、外语、物理、化学、生物学，在义务教育阶段的校外培训中都按**学科类**管理（教育部办公厅《关于进一步明确义务教育阶段校外培训学科类和非学科类范围的通知》，教监管厅函〔2021〕3 号）；面向普通高中学生的学科类培训参照\"双减\"意见管理，科目范围按当地规定。\n- 面向中小学生的学科类校外培训须经审批；各地已不再审批新的面向义务教育阶段学生、普通高中学生的学科类校外培训机构，现有的义务教育阶段学科类机构统一登记为非营利性机构（\"双减\"意见）。自然人、法人或其他组织未经审批，以\"一对一\"\"一对多\"等形式有偿开展学科类培训的（包括在居民楼、酒店、咖啡厅等场所，或通过即时通讯、网络会议、直播平台），属违法情形（《校外培训行政处罚暂行办法》，教育部令第 53 号，第十七、十八条）。在职中小学教师不得有偿补课（《严禁中小学校和在职中小学教师有偿补课的规定》，教师〔2015〕5 号；\"双减\"意见）。\n- 本库技能只在合法范围内用：技能不预设违规的排课、作业与收费，不制作招生广告；是否合规由使用者按当地规定判断。\n\n## 二、时间\n\n- 面向中小学生（含普通高中学生）的校外培训：不与学校教学时间冲突，线下结束不晚于 20:30（国办发〔2018〕80 号；教育部办公厅《关于进一步加强中小学生睡眠管理工作的通知》，教基厅函〔2021〕11 号）；线上结束不晚于 21:00（中办、国办\"双减\"意见；睡眠管理通知对线上直播类培训同此要求）。\n- 面向义务教育阶段学生的学科类培训另外：不占用国家法定节假日、休息日及寒暑假期；线上每课时不超过 30 分钟、课程间隔不少于 10 分钟（\"双减\"意见）。面向普通高中学生的学科类培训，这两条参照执行，按当地规定。\n- 非学科类：线下结束不晚于 20:30，线上不晚于 21:00（教监管〔2022〕4 号）。\n- 小学学员再按 `shared/grade-bands.md` 第一节的就寝时间提前结束。\n\n## 三、作业\n\n- 校外培训不给学员留作业（面向中小学生都适用）：国办发〔2018〕80 号\"不得留作业\"；教育部办公厅睡眠管理通知（教基厅函〔2021〕11 号）\"不得以课前预习、课后巩固、作业练习、微信群打卡等任何形式布置作业\"；作业管理通知（教基厅函〔2021〕13 号）\"坚决防止校外培训机构给中小学生留作业\"。\n- 课上的练习在课上完成，没做完的下节课课上补；不让学员回家补做，也不请家长督促、检查、批改或拍照打卡。学员自己带来的学校作业、考试错题，可以帮着分析，不追交、不催交。\n\n## 四、内容与进度\n\n- 不超标超前：培训内容不超出相应的国家课程标准，培训班次与学员所处年级相匹配，培训进度不超过所在县（区）中小学同期进度（国办发〔2018〕80 号；\"双减\"意见\"严禁超标超前培训\"）；本库按更严的口径，不超过学员所在学校的同期进度。\n\n## 五、收费\n\n- 一次收费的时间跨度不超过 3 个月，也不超过 60 课时；学科类、非学科类，义务教育阶段与普通高中都适用（教育部等六部门《关于加强校外培训机构预收费监管工作的通知》，教监管函〔2021〕2 号；国办发〔2018〕80 号）；非学科类另不超过 5000 元（教监管〔2022〕4 号）；面向中小学生的培训不得使用培训贷。\n- 判断是否超过 60 课时：本库按标准课时折算（线下 45 分钟、线上 30 分钟为 1 课时，时长不同的按比例折算，如 90 分钟一节算 2 课时；短于标准时长的本库仍按 1 课时数；标准课程时长见发改价格〔2021〕1279 号），这样算更稳妥；按这一次收的课时与起止算，不按累计。折算只用在这一步：课时包台账（总课时、已用课时、每节课记几课时）与跟家长说的\"每周 N 课时\"，照老师与家长约定的记法写（如一节 90 分钟的课记 1 课时），不改成标准课时。\n- 义务教育阶段学科类校外培训收费实行政府指导价（发改价格〔2021〕1279 号）。\n- 本库技能不起草价格、优惠、折扣、推荐返利与限时话术，不比较哪种课时数\"更划算\"。\n\n## 六、考试与排名\n\n- 校外培训不组织中小学生学科类等级考试、竞赛，不排名（国办发〔2018〕80 号）。\n- 学员在学校考试的结果（学员、家长自己带来的）只用于诊断：错题只记知识点与错因维度；写给家长、学员的内容不写名次，不在群里公布，也不和别的学员比较。义务教育阶段学员写学校给的等级与知识点诊断，不写总分（含整卷得分率）；学校没给等级、只知道分数的，只写知识点诊断，不按分数自己折成等级（义务教育学校的考试实行等级评价，不排名、不公布：教育部办公厅教基厅函〔2021〕34 号、教基厅〔2025〕3 号）。\n\n## 七、说明\n\n本约定不是政策全文，只提供技能运行所需的口径；不替使用者判断其培训是否经审批。规定有更新时以最新规定为准。\n\nFile v2.11.0:shared/platform-conventions.md\n\n<!-- 本文件由 scripts/sync-shared.mjs 从仓库根 shared/ 自动生成，用于让单个技能包自包含。\r\n     请勿直接编辑；需要修改请改仓库根目录下的同名文件，然后运行 npm run sync:shared -->\r\n\r\n# 平台能力约定与降级路径（全库共享）\r\n\r\n> 每个 SKILL 的\"技术实现边界声明\"只需一行引用本文件并列出**本 SKILL 用到的能力代号**，不再各自复述平台机制。\r\n> 写法：`> 技术边界：本 SKILL 依赖能力 [M, T]，无该能力时按 shared/platform-conventions.md 降级。`\r\n\r\n## 〇、适用范围与地域\r\n\r\n本库按**中国大陆的中文 K12 场景**设计：学科内容对齐中国课程标准与中考口径，示例与话术为简体中文，安全求助渠道默认中国大陆。\r\n\r\n部署到其他语言或地区时，运营方需要先处理三件事，否则不应直接面向学生使用：\r\n\r\n1. **求助渠道本地化**：按 `shared/crisis-exception.md` 的\"适用地域\"一节替换紧急联系方式；未确认地区前不得输出中国大陆号码。\r\n2. **学科口径核对**：`shared/grade-bands.md` 的学段划分与各学科的课标对齐仅适用于中国大陆学制。\r\n3. **法规核对**：未成年人数据的同意年龄与监护人要求按当地法规调整（`shared/vocab.md §8` 的默认值按中国大陆设定）。\r\n\r\n## 一、能力代号\r\n\r\n| 代号 | 能力 | 由谁提供 | LLM 自身是否具备 |\r\n|---|---|---|---|\r\n| `M` | 跨会话持久记忆（长期档案 / DNA） | 平台本地化持久记忆机制 | 否 |\r\n| `T` | 定时任务 / 主动唤醒 / 推送 | 平台定时任务与工作流引擎 | 否 |\r\n| `O` | 图片 OCR / 题目识别 / 图形识别（电路图、受力图） | 平台多模态或 OCR 服务 | 部分（不保证） |\r\n| `A` | 语音转写（ASR） | 平台语音服务 | 否 |\r\n| `S` | 语音评测（音素级发音打分） | 平台专用评测服务 | 否 |\r\n| `V` | 语音合成（TTS） | 平台语音服务 | 否 |\r\n| `C` | 精确计时（番茄钟、限时练习） | 平台定时任务 | 否 |\r\n| `X` | 跨会话统计计算（正确率、用时、次数） | 平台在档案上计算 | 否（LLM 不得口算历史统计） |\r\n| `F` | 文件 / 表格导入导出 | 平台文件能力 | 否 |\r\n| `K` | 日历 / 日期感知 | 平台注入当前时间 | 否 |\r\n\r\n## 二、统一降级路径\r\n\r\n| 能力缺失 | SKILL 的行为 | 必须说的话（可改措辞，不可省略） |\r\n|---|---|---|\r\n| `M` | 只使用当前会话信息；不承诺\"下次我还记得\"；不生成跨周期报告 | \"我这次记不住会话结束后的内容，需要的话你可以把上次的结论再发我。\" |\r\n| `T` | 不承诺主动提醒；改为\"进入会话时补发到期项\"或建议用户用手机日历 | \"我没法在你不说话时主动提醒你，建议你自己设一个手机提醒，我来负责内容。\" |\r\n| `O` | 让学生只发\"已知条件 + 问题\"一句话文字，或口述题目 | \"图片我看不清/看不了，请把题目的已知条件和问题打字发我，一行就行。\" |\r\n| `A` | 只做文字练习 | \"语音我暂时听不了，先用文字练；文字练习对表达同样有效。\" |\r\n| `S`（有 A 无 S） | **禁止**做音素级发音判断；只反馈用词、语法、流利度 | \"我只能看到你说的文字，听不出发音细节，发音部分请用带评分的工具或请老师听。\" |\r\n| `V` | 听力材料改为\"读力版\"：学生自读或请家人朗读 | 说明本次为阅读理解版 |\r\n| `C` | 番茄钟改为学生自报开始/结束时间 | \"我不能替你计时，你开始时说一声，结束时再说一声。\" |\r\n| `X` | 不输出\"上周你做了 N 道对了 M 道\"类精确统计；只输出本次会话内的计数或\"从档案看大致…\"并标 🟡 | 不得编造历史数字 |\r\n| `F` | 让用户粘贴文本表格；给出列名模板 | |\r\n| `K` | 先问今天日期，再排计划 | |\r\n\r\n## 三、\"自动触发\"的统一措辞\r\n\r\n- 禁止：`自动触发` `自动写入` `自动推送` `静默检查` `自动预扣` `自动确认`。\r\n- 允许：`建议触发（需用户确认）` `生成待确认条目` `在用户同意后提醒` `按需提示`。\r\n- 老师端台账类写入（课时、作业状态）一律生成**待确认条目**，由老师确认后落库。\r\n\r\n## 四、控制入口（每个持有数据的 SKILL 必须包含）\r\n\r\n复制以下段落到 SKILL.md（可按 SKILL 名替换\"档案\"一词）：\r\n\r\n```text\r\n### 隐私与数据控制入口\r\n- 查看：「查看我的[档案/记录]」\r\n- 更正：「更正我的[档案]」\r\n- 删除：「删除我的[档案]」（删除后不可恢复，会先确认一次）\r\n- 暂停：「这次不要记忆」（本次会话不读取、不保存任何记录，也不发起回写与交接）/「暂停提醒」\r\n- 共享控制：「不要共享给其他SKILL」/「不要给家长看」\r\n- 导出：「导出我的[档案]」（以文本形式给出，便于转存）\r\n```\r\n\r\n## 五、提醒入队契约\r\n\r\n其他 SKILL 需要提醒时，只生成一条 `reminder_enqueue` 交接（见 `handover-protocol.schema.json`），由 `xiaozhi-im-reminder` 按 `shared/vocab.md §9` 预算合并发送。SKILL 正文中不得出现\"我会在 X 时提醒你\"，应改为\"我把它加进你的提醒队列，明天的合并提醒里会带上\"。\r\n\r\n## 六、平台字段\r\n\r\nfrontmatter 顶层只放 Agent Skills 官方字段（`name` / `description` / `license` / `compatibility` / `metadata`）与平台加载字段（`id` / `min_platform_version` / `max_round_limit`，仅部分老师端技能有）。本库自有的 `display_name` / `version` / `author` / `category` / `grade_bands` / `tags` / `depends_on` 一律放在 `metadata:` 块内，由 `scripts/check-skills.mjs` F1 校验；发布到各市场时由打包脚本按市场需要投影成顶层字段。平台机制描述不再写入 SKILL 正文。\n\nArchive v2.10.0: 14 files, 44854 bytes\n\nFiles: references/copyright-annotation-template.md (2899b), references/resource-categorization.md (6680b), references/resource-entry-examples.md (6592b), 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 (8561b), shared/vocab.md (14173b), skill-card.md (2312b), SKILL.md (23331b), _meta.json (150b)\n\nFile v2.10.0:SKILL.md\n\n---\nname: xiaozhi-teach-resource-library\ndescription: '把独立教师散在文件夹、微信收藏和笔记本里的讲义、题目、讲评话术、错因案例收进一个可检索的库。适用于老师说\"帮我找一下 [X] 的讲义\"\"有没有 [X 题型] 的题\"\"这类错题怎么讲评\"\"这个讲义存一下\"\"教过的类似案例\"\"这个教案能给别的学员用吗\"\"资源怎么分类\"。流程：入库时打标签与版权状态 → 按知识点/难度检索 → 改编适配后复用 → 记录用过几次、效果如何。本 SKILL 不出题、不备课、不批改、不联系家长——只管资源的存、找、改；AI 生成的题必须老师验算后才算入库。'\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-homework-tracker\nid: openclaw:xiaozhi-teach-resource-library\nmin_platform_version: \"2.0\"\nmax_round_limit: 20\nslug: xiaozhi-teach-resource-library\ndisplayName: 教学资源复用库\nsummary: '把独立教师散在文件夹、微信收藏和笔记本里的讲义、题目、讲评话术、错因案例收进一个可检索的库。'\n---\n\n# 教学资源复用库 SKILL\n\n> **一句话定位：** 独立教师最贵的资产不是学员名单，而是你积累的教学经验——把它从\"脑子里\"搬到\"库里\"，才算真的拥有。\n\n---\n\n## 技术边界\n\n> 技术边界：本 SKILL 依赖能力 [M, F]，无该能力时按 shared/platform-conventions.md 降级。\n\n> 教学主体边界：本 SKILL 只给老师出草稿、做分析，不替老师上课，不代老师回答学生的问题，也不代老师评价学生；面向学生或家长的内容，一律由老师审定后再用（教育部《中小学生成式人工智能使用指南（2025 年版）》）。\n\n资源库不向学员推送任何东西，只在老师检索时给出候选。学员案例入库必须完全脱敏（化名、模糊学段、去掉可识别细节），不允许反查到具体学员。\n\n**版权**：每条资源必须有 `copyrightStatus`，取值只有 `shared/vocab.md §11` 的四档——`自有` / `改编` / `公开可引用` / `仅存索引`。**教辅原题与历年真题一律 `仅存索引`**，只记书名、页码、题号，不录入题干。禁止存储盗版扫描件与未授权转载的网络资源。\n\n**AI 生成的题**：本 SKILL 自己不出题，但会接收其他环节生成的题。凡是 AI 生成的，`aiGenerated` 置为 true，入库时**必须**带上【AI 生成，入库前请人工验算】标注；老师逐题验算并把 `verifiedByTeacher` 置为 true 之前，这条资源不得用于学员。生成规则见 `shared/ai-item-check.md`。\n\n**试题保密**：启用前的统考试题不得录入资源库，也不得输入本 SKILL——国家、省、地（市）级教育统一考试启用前的试题、参考答案、评分标准属国家秘密（《教育工作中国家秘密及其密级具体范围的规定》），区县级、校级统考按当地保密要求同样处理。统考结束后的试卷可按上面的版权规则入库，历年真题仍一律 `仅存索引`。依据《中小学生成式人工智能使用指南（2025年版）》教师一节：“严禁将个人信息、考试试题等敏感数据输入AI工具”。\n\n---\n\n## 一、核心使命\n\n独立教师资源管理常见的三个误区：\n\n```text\n误区① 资源散落：讲义在电脑文件夹、题库在微信收藏、\n        讲评话术在脑子里、错题案例在笔记本上，\n        需要时找不到，找到时已过时。\n\n误区② 从零开始：每个新学员/新学期都从零备课，\n        之前教过的优秀案例、题库、讲评话术\n        都没有积累，白白浪费。\n\n误区③ 资源孤岛：优秀讲义、题库、讲评话术\n        只在某个学员/某次课用一次，\n        之后被遗忘。\n```\n\n本 SKILL 要解决的是：\n- **让教学资源有\"家\"**：统一分类入库\n- **让资源可检索**：标签化 + 关键词 + 学员匹配\n- **让经验可复用**：讲义、题库、讲评话术、错因案例\n- **让教学资产持续增值**：每次教学都是资源的更新机会\n\n---\n\n## 二、触发时机\n\n| 触发场景 | 示例语句 |\n|---------|---------|\n| 资源检索 | \"帮我找一下 [X 讲义]\" / \"有没有 [X 题型]\" |\n| 讲评话术 | \"这类错题怎么讲评\" / \"讲评怎么说\" |\n| 学员匹配 | \"[化名] 适合什么资源\" |\n| 案例查找 | \"教过的案例\" / \"类似情况怎么处理\" |\n| 资源入库 | \"这个讲义/题库/案例存一下\" |\n| 资源管理 | \"资源怎么分类\" / \"教学资源库\" |\n| 错因案例 | \"学员犯过这种错吗\" / \"类似错因\" |\n| 教案复用 | \"这个教案可以给另一个学员用吗\" |\n\n---\n\n## 三、核心流程\n\n```text\n                ┌──────────────────────────┐\n                │ ① 入库                    │\n                │  分类 + 版权状态          │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ② AI 生成的先验算         │\n                │  aiGenerated=true         │\n                │  老师验算 → verifiedByTeacher│\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ③ 打标签                  │\n                │  学科/知识点/难度/学段    │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ④ 检索                    │\n                │  关键词/知识点/难度       │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ⑤ 改编适配后复用          │\n                │  记来源 + 记效果          │\n                └──────────────────────────┘\n```\n\n### 3.1 AI 生成题的入库门槛\n\n```text\n生成时（在别的环节）：\n  按 shared/ai-item-check.md 自检——自解一遍、有解且唯一、\n  条件充分不多余、数值友好、学段内、与原题同维度\n\n到本 SKILL 入库时：\n  aiGenerated = true\n  verifiedByTeacher = false（默认）\n  标题或 usageNotes 带【AI 生成，入库前请人工验算】\n\n老师逐题验算后说\"验过了\"：\n  verifiedByTeacher = true，标注可去掉\n\n在 verifiedByTeacher 为 false 期间：\n  · 检索时这条资源标灰，附一句「待验算，先别直接给学员」\n  · 不进入\"推荐给学员\"的候选\n```\n\n**为什么卡这一道**：AI 生成的题看起来总是对的——格式规整、说法专业。真正的问题（条件矛盾、答案不唯一、超纲、数值算出无理数）要动笔算一遍才看得出来。这一道验算挡在库门口，比挡在学员面前便宜得多。\n\n---\n\n## 四、资源五大类\n\n> 📎 五大类（讲义库/题库/讲评话术库/错因案例库/教案库）的用途、入库要求与入库示例，完整模板见 `references/resource-entry-examples.md`\n\n---\n\n## 五、标签化体系\n\n### 5.1 多维度标签\n\n对应 `workspace.resourceLibraryIndex[]` 的字段：\n\n```text\n┌──────────────────┬──────────────────────────────┬──────────────┐\n│ 字段              │ 取值                          │ 用途          │\n├──────────────────┼──────────────────────────────┼──────────────┤\n│ subject          │ 数学/语文/英语/物理/…         │ 主分类        │\n│ knowledgePoint   │ 一次函数图象/定语从句/…       │ 精确定位      │\n│ gradeLevel       │ 年级或学段                    │ 适用筛选      │\n│ difficulty       │ 基础/中等/提升/挑战（四档枚举）│ 难度匹配      │\n│ resourceType     │ 题目/讲义/课件/板书/讲评话术/ │ 类型筛选      │\n│                  │ 错因案例/家长话术（七档枚举） │              │\n│ copyrightStatus  │ 自有/改编/公开可引用/仅存索引 │ 版权（必填）  │\n│ aiGenerated      │ true / false                  │ 是否 AI 生成  │\n│ verifiedByTeacher│ true / false                  │ 老师是否验算过│\n│ usageNotes       │ 自由文本（≤500 字）           │ 用过几次、效果│\n└──────────────────┴──────────────────────────────┴──────────────┘\n```\n\n**没有\"学员类型\"这个字段**。按\"基础学员/拔尖学员\"给资源贴适用人群，等于把学员分了层再把资源分了层，用起来看着方便，实际会让老师照着标签发题而不是照着这个孩子当前卡在哪里发题。要匹配就按 `knowledgePoint` + `difficulty` 匹配。\n\n### 5.2 标签使用规则\n\n```text\n■ 必填\n  · resourceId / title / resourceType / copyrightStatus（schema required）\n  · knowledgePoint + difficulty（不填就检索不到，等于没存）\n\n■ 推荐\n  · subject / gradeLevel\n  · aiGenerated（AI 生成的必须为 true）\n\n■ usageNotes 里写什么\n  · 用过几次、给什么情况的学员用过、效果如何\n  · 改编来源（\"改自 R-001，把出租车换成快递\"）\n  · AI 生成未验算时的【AI 生成，入库前请人工验算】标注\n```\n\n---\n\n## 六、检索与匹配\n\n### 6.1 关键词检索\n\n```text\n输入：关键词（如\"一次函数复习\"）\n匹配：所有包含\"一次函数\"+\"复习\"的资源\n排序：按相关度 / 使用频率 / 学员匹配度\n```\n\n### 6.2 按学员当前情况匹配\n\n```text\n输入：学员化名 + 当前卡住的知识点\n读：workspace.studentCards[].gradeBand / .primaryWeaknesses\n    workspace.homeworkFollowups[].mainErrors[].knowledgePoint / .dimension\n匹配：knowledgePoint 相同 + difficulty 与当前掌握度相称 +\n      gradeLevel 在该学员学段内\n输出（每条标明为什么推荐它）：\n  · [资源标题]（[类型]，[难度]）\n    推荐理由：针对 [知识点] 的 [dimension]，上次给 [场景] 用过\n    ⚠️ 待验算：aiGenerated=true 且 verifiedByTeacher=false 的标出来\n\n不做的事：\n  ❌ 按\"这是基础学员\"整批推荐一组资源\n  ❌ 推荐超出该学员 gradeBand 的内容（要用就标 ⚠高中 并说明是拓展）\n```\n\n### 6.3 错因案例检索\n\n```text\n输入：通用四维之一（概念模糊 / 计算失误 / 读题失误 / 方法用错，\n      见 shared/vocab.md §1）\n匹配：resourceType=错因案例 且 knowledgePoint 或维度相符的条目\n输出：\n  · 案例描述（已脱敏，不含任何可识别到具体学员的细节）\n  · 当时的应对动作\n  · 效果记录（写事实，不写\"效果很好\"）\n```\n\n---\n\n## 七、复用与改编\n\n### 7.1 复用流程\n\n```text\n第 1 步：检索资源\n  · 基于当前需求（学员画像/学情）检索\n  · 找到 1-3 个候选资源\n\n第 2 步：评估匹配度\n  · 难度匹配？\n  · 知识点匹配？\n  · 学员类型匹配？\n\n第 3 步：调整适配\n  · 修改参数（数字/情境）\n  · 调整难度\n  · 添加学员特定元素\n\n第 4 步：使用并记录\n  · 标记\"复用自 [资源 ID]\"\n  · 记录使用效果\n  · 反馈到资源库\n```\n\n### 7.2 改编原则\n\n```text\n■ 改数（参数）\n  原题 y=2x+1 → 改编 y=3x-2\n  适合：同一知识点不同参数\n  ⚠️ 改完必须重算一遍：换个系数就可能算出无理数或负人数\n\n■ 改问（设问角度）\n  原题\"求 X\" → 改编\"判断 X 是否正确\"\n  适合：换角度测同一概念\n\n■ 改情境（背景）\n  原题\"出租车\" → 改编\"网约车\"\n  适合：让题目更贴近学生生活\n  ⚠️ 换情境要检查量纲还合不合理（速度、单价、人数）\n\n■ 改综合度\n  单知识点 → 多知识点综合\n  适合：检验综合应用\n  ⚠️ 改成综合题后不再与原题同型，不能再当\"同类题\"用于弱项验证\n\n改编后一律按 shared/ai-item-check.md 复核：自解一遍、有解且唯一、\n条件充分不多余、数值友好、学段内。改编件的 copyrightStatus 记 `改编`，\nusageNotes 里写清原出处与改动点。\n```\n\n### 7.3 复用记录\n\n复用记录**不单独建表**，直接写进 `workspace.resourceLibraryIndex[].usageNotes`（≤500 字符）。一行一次，累积成这条资源的使用史：\n\n```text\nusageNotes 写法（**只记资源本身的使用情况，不记学员**）：\n  用过 2 次 | 效果：1 次需提示、1 次直接做对 | 下次配纯净版再试\n  → 不写学员化名、日期、分数、个体弱项。个体层面的记录在 lessonLogs / homeworkFollowups 里已经有，\n    靠 resourceId 关联即可；把它们再抄一遍进 usageNotes，会在一条自由文本里累积成准可识别的学员画像\n  改自 R-001（把出租车情境换成快递），已重算\n  【AI 生成，入库前请人工验算】← 验算后删掉这一行\n\n写事实，不写\"效果很好\"\"这题很经典\"——\n后者三个月后回头看，等于什么都没说。\n超过 500 字符时保留最近几条，旧的合并成一句\"此前用过 N 次\"。\n```\n\n---\n\n## 八、版权管理\n\n### 8.1 资源版权分类\n\n四档取值来自 `shared/vocab.md §11`，本 SKILL 不另设分类。\n\n```text\n✅ 自有\n  老师自己写的\n  完整存储\n\n✅ 改编\n  基于某资源改编\n  必须在 usageNotes 标注\"原出处 + 改了什么\"\n\n✅ 公开可引用\n  教材例题、明确开放授权（如 CC 协议）的资源\n  完整存储，标注来源\n\n⚠️ 仅存索引\n  **教辅原题与历年真题一律归这一档**，没有例外\n  只记书名/卷名、页码、题号，不录入题干、不存扫描件\n  检索时给出\"在哪本书第几页\"，老师自己去翻\n\n❌ 禁止入库\n  未授权的教辅原题题干\n  盗版扫描件、拍照件\n  未授权转载的网络资源\n```\n\n**为什么真题也只存索引**：历年真题的汇编本同样有版权，\"大家都在用\"不构成授权。存索引不影响使用——老师手上有那本书，需要时按页码翻到即可；存题干则是在自己的库里做了一份未授权复制件。\n\n### 8.2 版权标注模板\n\n> 📎 完整模板见 `references/copyright-annotation-template.md`（四档 copyrightStatus 的版权信息填写模板）\n\n---\n\n## 九、案例脱敏规则\n\n### 9.1 必脱敏字段\n\n```text\n■ 必脱敏\n  · 真实姓名 → 化名\n  · 学校名称 → \"某公立/民办学校\"\n  · 年级 → 模糊（\"初中学员\"）\n  · 家长身份 → 移除\n  · 家庭住址 → 移除\n  · 联系方式 → 移除\n\n■ 可保留（用于案例分析）\n  · 学科\n  · 知识点\n  · 错因\n  · 应对动作\n  · 效果数据\n```\n\n### 9.2 脱敏检查清单\n\n```text\n□ 学员姓名已替换为化名\n□ 学校名称已模糊化\n□ 年级已模糊化（\"初中学员\"等）\n□ 家长身份信息已移除\n□ 家庭住址已移除\n□ 联系方式已移除\n□ 案例描述不含可识别细节\n□ 案例分析基于错因/方法/效果而非具体人\n```\n\n---\n\n## 十、持续更新机制\n\n### 10.1 入库时机\n\n```text\n■ 必入库时机\n  · 学员试讲课讲义通过后\n  · 优秀作业讲评案例\n  · 重要错因突破案例\n  · 阶段性测评优秀试卷\n  · 复习规划方案\n\n■ 选入库时机\n  · 课堂过渡话术\n  · 家长沟通案例\n  · 学员进步转折点\n```\n\n### 10.2 资源使用反馈\n\n```text\n每次使用资源后：\n  · 标记使用次数\n  · 记录使用效果\n  · 标记\"使用频率高\"或\"待改进\"\n\n→ 资源库排序基于实际使用效果\n→ 高频高质量资源进入\"我的最爱\"\n→ 低频低质资源进入\"待优化\"或\"归档\"\n```\n\n### 10.3 资源生命周期\n\n```text\n新入库 → 试用 → 优化 → 成熟 → 经典\n  ↓\n  归档（如过时/淘汰）\n```\n\n---\n\n## 十一、接口\n\n### 11.1 数据流\n\n```text\n  老师说\"这个存一下\" ──→ ┌────────────────────┐ ──→ 检索结果（带推荐理由）\n  老师说\"帮我找…\"   ──→ │ resource-library    │ ──→ 改编后的资源\n                        │ （本 SKILL）         │\n                        └─────────┬──────────┘\n                                  │ 只写这一处\n                          resourceLibraryIndex[]\n```\n\n本 SKILL 不需要任何 SKILL 先跑，也不向任何 SKILL 推送。老师需要资源时来找，找到了自己拿走用。\n\n### 11.2 读写字段\n\n```text\n读：\n  workspace.studentCards[].alias / .gradeLevel / .gradeBand /\n      .subjects / .goals / .primaryWeaknesses\n                          → 匹配资源用（按知识点与难度，不按\"学员类型\"）\n  workspace.homeworkFollowups[].mainErrors[].knowledgePoint / .dimension\n                          → 按当前错因找对应的题与讲评话术\n  workspace.lessonLogs[].completedContent / .nextLessonFocus\n                          → 找下节课要用的材料\n\n写（唯一写入处）：\n  workspace.resourceLibraryIndex[].resourceId\n  workspace.resourceLibraryIndex[].title\n  workspace.resourceLibraryIndex[].resourceType   （七档枚举）\n  workspace.resourceLibraryIndex[].subject\n  workspace.resourceLibraryIndex[].gradeLevel\n  workspace.resourceLibraryIndex[].knowledgePoint\n  workspace.resourceLibraryIndex[].difficulty     （四档枚举）\n  workspace.resourceLibraryIndex[].copyrightStatus（四档枚举，必填）\n  workspace.resourceLibraryIndex[].aiGenerated    （AI 生成的必须 true）\n  workspace.resourceLibraryIndex[].verifiedByTeacher（老师验算后才 true）\n  workspace.resourceLibraryIndex[].usageNotes     （用过几次、效果、改编来源）\n\n派生视图（不落库）：\n  · 匹配结果   ← resourceLibraryIndex[] 与 studentCards[] / mainErrors[] 实时比对\n  · 使用统计   ← 运行时聚合；要留痕就写进 usageNotes，不新增字段\n\n不写：\n  · 题干原文（copyrightStatus=仅存索引 的资源只记出处）\n  · 任何学员可识别信息（案例一律脱敏）\n```\n\n### 11.3 谁来读\n\n`xiaozhi-teach-solo-dashboard` 只读 `resourceLibraryIndex[]` 做展示。若装有教师通用包，备课、作业设计、命题类 SKILL 可以来检索本库；未安装时本库对独立教师日常照常可用。任何一方取走 `verifiedByTeacher=false` 的资源，都要带上【AI 生成，入库前请人工验算】的标注。\n\n---\n\n## 十二、字段级高敏信息防护\n\n```text\n✅ 可存储：化名案例、自有内容、改编件、公开可引用资源\n❌ 禁止：未授权教辅原题的题干、盗版扫描件、未授权转载\n✅ 案例可保留：学科/知识点/错因维度/应对方法/效果事实\n❌ 不保留：真实姓名/学校/家长信息/家庭住址/联系方式\n✅ 检索基于：知识点、难度、类型、关键词\n❌ 检索不支持：反查具体学员（\"这条案例是谁\"）\n```\n\n---\n\n## 十三、行为准则\n\n| ✅ 应该做 | ❌ 不能做 |\n|---------|---------|\n| 入库即填 knowledgePoint + difficulty | 存了不打标签，等于没存 |\n| 案例入库前逐条脱敏 | 真实学员案例直接入库 |\n| 教辅/真题一律仅存索引 | 把题干抄进库里 |\n| AI 生成的标 aiGenerated | 混进库里看不出是 AI 写的 |\n| 老师验算后才 verifiedByTeacher | 未验算就发给学员 |\n| 改编后重新验算一遍 | 改完数字直接用 |\n| 用过之后写进 usageNotes | 用了不留痕，下次重新判断 |\n| 按知识点 + 难度匹配 | 按\"基础学员/拔尖学员\"整批推 |\n\n---\n\n## 十四、与其他 SKILL 的协同清单\n\n```text\n教学资源复用库（自成闭环，不需要前置 SKILL）\n    读 workspace.studentCards[]        ← student-intake 写\n    读 workspace.homeworkFollowups[]   ← homework-tracker 写\n    读 workspace.lessonLogs[]          ← lesson-log 写\n    写 workspace.resourceLibraryIndex[] ← 本 SKILL 唯一写入方\n\n  其他 SKILL 需要资源时直接读 resourceLibraryIndex[]，本 SKILL 不推送。\n  若装有教师通用包，备课/作业/命题类 SKILL 可来检索；未安装不影响使用。\n```\n\n**禁止行为**：\n- 禁止存储未授权教辅原题的题干或扫描件\n- 禁止学员案例不脱敏入库\n- 禁止入库不填 `copyrightStatus`\n- 禁止 `verifiedByTeacher=false` 的 AI 生成题用于学员\n- 禁止通过资源库反查具体学员\n- 禁止向学员推送资源\n\n---\n\n### 隐私与数据控制入口\n- 查看：「查看我的[资源库记录]」\n- 更正：「更正我的[资源库记录]」\n- 删除：「删除我的[资源库记录]」（删除后不可恢复，会先确认一次）\n- 暂停：「这次不要记忆」（本次会话不读取、不保存任何记录，也不发起回写与交接）/「暂停提醒」\n- 共享控制：「不要共享给其他SKILL」/「不要给家长看」\n- 导出：「导出我的[资源库记录]」（以文本形式给出，便于转存）\n\n学员/家长要求删除该学员相关数据时，一并检查资源库里的错因案例，把涉及该学员的条目删除或进一步脱敏。\n\n**校验要求**：案例类资源入库前须完成脱敏检查（§9.2）；跨 SKILL 共享前须确认 `consent.crossSkillSharing` 为 true。真实姓名、联系方式、学校信息一律不写入（详见 `SECURITY_BASELINE.md`）。\n\n---\n\n## 十五、参考资源\n\n- `references/resource-categorization.md` — 资源分类、标签与检索\n- `references/resource-entry-examples.md` — 五大类资源的用途、入库要求与示例\n- `references/copyright-annotation-template.md` — 版权标注模板\n- `shared/vocab.md` — 版权四档、错因四维（唯一来源）\n- `shared/ai-item-check.md` — AI 出题自检协议\n\n---\n\n> 💡 **小智说：**\n> \"独立教师的核心壁垒不是'我能教'，\n>  是'我教过 1000 个学员，每个都不一样，但我都记得'。\n>  当你把这些经验和素材沉淀到资源库，\n>  你的第 1001 个学员不用再走弯路。\n>  教学资源库是独立教师的'第二大脑'——\n>  你不会累，不会忘，不会因为今天状态不好就教错。\"\n\nFile v2.10.0:_meta.json\n\n{\n  \"ownerId\": \"kn79c5gcmfkt9p1pk656tgq7nd853s7v\",\n  \"slug\": \"xiaozhi-teach-resource-library\",\n  \"version\": \"2.10.0\",\n  \"publishedAt\": 1790872025357\n}\n\nFile v2.10.0:references/copyright-annotation-template.md\n\n# 版权标注模板\r\n\r\n> 适用学段：小学中段 / 小学高段 / 初中 / 高中\r\n> 配合 `xiaozhi-teach-resource-library` §8.2 使用。四档取值来自 `shared/vocab.md §11`，与 `solo-teacher-workspace.schema.json` 的 `resourceIndexItem.copyrightStatus` 枚举一致，不另设分类。\r\n> 版权信息写在 `usageNotes` 里（`copyrightStatus` 本身是独立字段）。\r\n\r\n```text\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n📄 资源版权信息\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\nresourceId：[   ]\r\ncopyrightStatus：[自有 / 改编 / 公开可引用 / 仅存索引]\r\n\r\n【自有】\r\n  作者：老师本人\r\n  创建时间：[YYYY-MM]\r\n  → 完整存储\r\n\r\n【改编】\r\n  原出处：[书名/网站/资料名]\r\n  改了什么：\r\n    · [如\"把出租车情境换成快递\"]\r\n    · [如\"系数由 2 改为 3，重新算过答案\"]\r\n  改编时间：[YYYY-MM]\r\n  → 完整存储；改完必须重新验算一遍\r\n\r\n【公开可引用】\r\n  来源：[教材名 / CC 协议资源]\r\n  许可：[如 CC BY 4.0；教材例题写\"教材例题\"]\r\n  → 完整存储，标注来源\r\n\r\n【仅存索引】\r\n  出处：[书名/卷名] [出版社] 第 [X] 页 第 [X] 题\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## 判断顺序\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```text\r\n❌ 盗版扫描件、整页拍照件\r\n❌ 未授权转载的网络资源（连索引都不必存——出处本身就不可靠）\r\n❌ 来源不明的题（不知道从哪来的，就不知道能不能用）\r\n```\r\n\r\n## AI 生成的题算哪一档\r\n\r\n算 **自有**（是本地生成的，不是复制来的），但必须同时置 `aiGenerated = true`，并在 `verifiedByTeacher` 为 true 之前带上【AI 生成，入库前请人工验算】。版权归属和质量把关是两件事，两个都要过。\n\nFile v2.10.0:references/resource-categorization.md\n\n# 资源标签、检索与脱敏\r\n\r\n> 适用学段：小学中段 / 小学高段 / 初中 / 高中\r\n> 配合 `xiaozhi-teach-resource-library` §五、§六、§九、§十使用。\r\n> 五大类资源的用途与入库示例见 `resource-entry-examples.md`；版权标注格式见 `copyright-annotation-template.md`。本文件不重复那两份内容。\r\n> 字段与枚举以 `solo-teacher-workspace.schema.json` 的 `resourceIndexItem` 为准；版权四档见 `shared/vocab.md §11`，错因四维见 §1。\r\n\r\n---\r\n\r\n## 一、标签字段\r\n\r\n```text\r\n┌──────────────────┬──────────────────────────────┬──────────┐\r\n│ 字段              │ 取值                          │ 是否必填  │\r\n├──────────────────┼──────────────────────────────┼──────────┤\r\n│ resourceId       │ 自定义编号（R-001）           │ 必填      │\r\n│ title            │ 一句话说清是什么（≤120 字）   │ 必填      │\r\n│ resourceType     │ 题目/讲义/课件/板书/讲评话术/ │ 必填      │\r\n│                  │ 错因案例/家长话术             │          │\r\n│ copyrightStatus  │ 自有/改编/公开可引用/仅存索引 │ 必填      │\r\n│ subject          │ 数学/语文/英语/物理/…         │ 推荐      │\r\n│ knowledgePoint   │ 一次函数图象/定语从句/…       │ 强烈推荐  │\r\n│ difficulty       │ 基础/中等/提升/挑战           │ 强烈推荐  │\r\n│ gradeLevel       │ 年级或学段                    │ 推荐      │\r\n│ aiGenerated      │ true / false                  │ AI 生成必填│\r\n│ verifiedByTeacher│ true / false                  │ 同上      │\r\n│ usageNotes       │ 用过几次、效果、改编来源      │ 推荐      │\r\n└──────────────────┴──────────────────────────────┴──────────┘\r\n```\r\n\r\n`knowledgePoint` 和 `difficulty` 虽然 schema 上非必填，但**不填就检索不到**——三个月后翻库时，一堆只有标题的条目和没存过没有区别。\r\n\r\n**没有\"学员类型\"标签**。按\"基础学员/拔尖学员\"给资源分层，用起来是方便了，但会让老师照着标签发题，而不是照着这个孩子当前卡在哪儿发题。要匹配就按 `knowledgePoint` + `difficulty`。\r\n\r\n---\r\n\r\n## 二、检索\r\n\r\n### 2.1 按关键词\r\n\r\n```text\r\n输入：\"一次函数 复习\"\r\n匹配：title / knowledgePoint / usageNotes 命中\r\n排序：knowledgePoint 精确匹配 > 标题匹配 > 备注匹配\r\n标注：verifiedByTeacher=false 的条目标灰，附\r\n      「待验算，先别直接给学员」\r\n```\r\n\r\n### 2.2 按学员当前情况\r\n\r\n```text\r\n读：workspace.studentCards[].gradeBand / .primaryWeaknesses\r\n    workspace.homeworkFollowups[].mainErrors[].knowledgePoint / .dimension\r\n匹配：knowledgePoint 相同 + difficulty 与当前掌握度相称\r\n      + gradeLevel 在该学员学段内\r\n输出：每条给出推荐理由（\"针对小A 移项的概念模糊\"），\r\n      不给理由的推荐等于没推荐\r\n超纲的：要用就在同一行标 ⚠高中 并说明是拓展，不默认推荐\r\n```\r\n\r\n### 2.3 按错因\r\n\r\n```text\r\n输入：通用四维之一（概念模糊/计算失误/读题失误/方法用错）\r\n匹配：resourceType=错因案例，或题目的 knowledgePoint 对应该维度\r\n输出：案例描述（已脱敏）+ 当时的应对 + 效果事实\r\n```\r\n\r\n**检索不支持反查学员**：\"这条案例是谁\"这类问题一律不回答——案例入库时就脱敏了，能反查说明脱敏没做干净。\r\n\r\n---\r\n\r\n## 三、案例脱敏\r\n\r\n### 3.1 必脱敏\r\n\r\n```text\r\n■ 必须处理\r\n  · 真实姓名 → 化名，且化名与学员卡里的不同\r\n    （案例里用\"某学员\"，不要用 studentCards[].alias，\r\n      否则库里一查就对上了）\r\n  · 学校名称 → 移除，不写\"某公立学校\"也不写地区\r\n  · 年级 → 模糊到学段（\"初中学员\"）\r\n  · 具体日期 → 模糊到月份或删除\r\n  · 家长身份、家庭住址、联系方式 → 全部移除\r\n\r\n■ 可保留（案例的价值就在这些）\r\n  · 学科、知识点\r\n  · 错因维度（shared/vocab.md §1 四维）\r\n  · 当时的应对动作\r\n  · 效果事实（\"两周后换题型做对\"）\r\n```\r\n\r\n### 3.2 脱敏检查清单\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\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  · 课堂过渡话术\r\n\r\n■ 不必入库\r\n  · 一次性的、下次不会再用的东西\r\n  · 网上随手搜到的未授权资源（连索引都不必存）\r\n  · 没有 knowledgePoint 也说不清用途的零散内容\r\n```\r\n\r\n**趁热存**。教完当下花两分钟填几个字段，比\"以后有空整理\"划算——等回头整理时，当初为什么这么讲已经想不起来了。\r\n\r\n---\r\n\r\n## 五、自检清单\r\n\r\n每次入库或检索前：\r\n\r\n- [ ] `copyrightStatus` 是否填了；教辅原题/真题是否为\"仅存索引\"\r\n- [ ] \"仅存索引\"的条目是否**没有**录入题干\r\n- [ ] `knowledgePoint` 与 `difficulty` 是否填了\r\n- [ ] AI 生成的是否标了 `aiGenerated=true`\r\n- [ ] 未验算的是否带【AI 生成，入库前请人工验算】且未推荐给学员\r\n- [ ] 改编件是否重新验算过、是否写了原出处与改动点\r\n- [ ] 学员案例是否过了脱敏清单\r\n- [ ] 检索结果是否给了推荐理由\r\n- [ ] 超纲内容是否标了 ⚠高中\r\n- [ ] 是否**没有**向学员推送资源（只给老师看）\n\nFile v2.10.0:references/resource-entry-examples.md\n\n# 资源五大类：用途、入库要求与示例\r\n\r\n> 适用学段：小学中段 / 小学高段 / 初中 / 高中\r\n> 示例题验算：2026-09-06\r\n> 配合 `xiaozhi-teach-resource-library` §四使用。标签与检索规则见 `resource-categorization.md`，版权格式见 `copyright-annotation-template.md`。\r\n> 字段名以 `solo-teacher-workspace.schema.json` 的 `resourceIndexItem` 为准；`resourceType` 只能取七档枚举之一：题目 / 讲义 / 课件 / 板书 / 讲评话术 / 错因案例 / 家长话术。\r\n\r\n---\r\n\r\n## 一、讲义\r\n\r\n```text\r\n■ 用途\r\n  · 课前预习材料、课中讲义、课后复习材料\r\n\r\n■ 入库要求\r\n  · resourceType = 讲义\r\n  · subject + knowledgePoint + difficulty\r\n  · copyrightStatus（必填）\r\n  · gradeLevel\r\n\r\n■ 示例\r\n  resourceId：R-H001\r\n  title：一次函数图象的三个基本变换\r\n  resourceType：讲义\r\n  subject：数学\r\n  knowledgePoint：一次函数图象\r\n  difficulty：中等\r\n  gradeLevel：八年级\r\n  copyrightStatus：自有\r\n  aiGenerated：false\r\n  usageNotes：上周某学员用过，图象平移部分讲得偏快，下次拆成两步\r\n```\r\n\r\n⚠️ 不记\"适用学员类型\"，也不记\"关联学员化名\"——前者会导致照标签发讲义，后者让资源库和学员卡对得上号，脱敏就白做了。\r\n\r\n---\r\n\r\n## 二、题目\r\n\r\n```text\r\n■ 入库要求\r\n  · resourceType = 题目\r\n  · subject + knowledgePoint + difficulty（四档枚举）\r\n  · copyrightStatus（必填；教辅原题与真题一律\"仅存索引\"）\r\n  · aiGenerated / verifiedByTeacher（AI 生成的必填）\r\n\r\n■ 示例①（自有，已验算）\r\n  resourceId：R-Q001\r\n  title：一次函数与坐标轴围成三角形面积\r\n  resourceType：题目\r\n  subject：数学\r\n  knowledgePoint：一次函数图象\r\n  difficulty：中等\r\n  gradeLevel：八年级\r\n  copyrightStatus：自有\r\n  aiGenerated：false\r\n  usageNotes：题干\"直线 y=2x+4 与两坐标轴围成的三角形面积是多少\"\r\n              答案 4（与 x 轴交于 (-2,0)，与 y 轴交于 (0,4)，\r\n              面积 = 2×4÷2 = 4）。整数解，条件充分，八年级范围内。\r\n\r\n■ 示例②（AI 生成，待验算）\r\n  resourceId：R-Q002\r\n  title：【AI 生成，入库前请人工验算】移项变号纯净版 8 题\r\n  resourceType：题目\r\n  knowledgePoint：一元一次方程移项\r\n  difficulty：基础\r\n  copyrightStatus：自有\r\n  aiGenerated：true\r\n  verifiedByTeacher：false\r\n  usageNotes：【AI 生成，入库前请人工验算】老师逐题算过后把\r\n              verifiedByTeacher 改为 true，并删掉标题里的标注\r\n\r\n■ 示例③（教辅原题）\r\n  resourceId：R-Q003\r\n  title：某教辅八年级一次函数专题（仅记出处）\r\n  resourceType：题目\r\n  knowledgePoint：一次函数应用\r\n  difficulty：提升\r\n  copyrightStatus：仅存索引\r\n  usageNotes：某教辅 八年级上 第 46 页 第 7 题。不录入题干，\r\n              用时请翻书。\r\n```\r\n\r\n⚠️ 不记\"预估 P（难度系数）\"。一对一场景下没有可靠的群体作答数据，凭感觉填一个 0.65 只是给数字披了层专业外衣；`difficulty` 四档已经够用。\r\n\r\n---\r\n\r\n## 三、讲评话术\r\n\r\n```text\r\n■ 用途\r\n  · 错题讲评、行为反馈、课堂过渡\r\n\r\n■ 入库要求\r\n  · resourceType = 讲评话术\r\n  · knowledgePoint 或对应的错因维度（shared/vocab.md §1 四维）\r\n  · usageNotes 记效果事实\r\n\r\n■ 示例\r\n  resourceId：R-P001\r\n  title：概念模糊类错题的开场提问\r\n  resourceType：讲评话术\r\n  knowledgePoint：通用（概念模糊）\r\n  copyrightStatus：自有\r\n  usageNotes：话术——\"这道题的关键是 [概念]，你能用一句话\r\n              给我讲一遍这个概念吗？\"\r\n              上周某学员用过：能复述定义但说不清适用条件，\r\n              据此判断为概念模糊而非计算失误。\r\n```\r\n\r\n⚠️ 效果只写发生了什么，不写\"80% 学员能复述\"这类没有出处的比例。\r\n\r\n---\r\n\r\n## 四、错因案例\r\n\r\n```text\r\n■ 入库要求\r\n  · resourceType = 错因案例\r\n  · 错因维度取 shared/vocab.md §1 四维（老师端七类先映射回四维）\r\n  · 完全脱敏：代称与学员卡的 alias 不同，学段模糊，无学校/日期细节\r\n\r\n■ 示例\r\n  resourceId：R-E001\r\n  title：用算术法硬解方程问题（方法用错）\r\n  resourceType：错因案例\r\n  knowledgePoint：一元一次方程应用\r\n  copyrightStatus：自有\r\n  usageNotes：背景——某初中学员，列方程题一律改用算术法倒推，\r\n              绕三四步后出错。\r\n              维度——方法用错（teacherCategory：策略错误）。\r\n              应对——先画线段图找等量关系，再要求必须设未知数。\r\n              效果——两周内三道同类题，前两道仍倒推，第三道自己设了\r\n              未知数并做对；按 shared/vocab.md §5 还需再一次独立验证\r\n              才算攻克。\r\n              脱敏检查：✅ 无姓名/学校/日期/家长信息，代称与学员卡不同\r\n```\r\n\r\n---\r\n\r\n## 五、教案 / 课件 / 板书\r\n\r\n```text\r\n■ 入库要求\r\n  · resourceType = 课件 或 板书（\"教案\"不在枚举内，\r\n    完整教案按 讲义 存，或拆成课件 + 板书）\r\n  · subject + knowledgePoint\r\n  · copyrightStatus\r\n\r\n■ 示例\r\n  resourceId：R-L001\r\n  title：一次函数复习课板书设计\r\n  resourceType：板书\r\n  subject：数学\r\n  knowledgePoint：一次函数图象\r\n  gradeLevel：八年级\r\n  copyrightStatus：自有\r\n  usageNotes：关联 R-H001（讲义）、R-Q001（题）。\r\n              上周某学员用过：图象与解析式对照的那一栏最有用，\r\n              左侧的定义罗列可以删掉。\r\n```\r\n\r\n⚠️ 效果只写这次实际发生的事，不写\"得分率 78%\"\"分层目标全部达成\"——一对一没有可比的群体数据，这类数字无处可考。\r\n\r\n---\r\n\r\n## 六、入库前统一检查\r\n\r\n- [ ] `resourceType` 是否取自七档枚举\r\n- [ ] `copyrightStatus` 是否填了；教辅原题/真题是否为\"仅存索引\"且未录题干\r\n- [ ] `knowledgePoint` 与 `difficulty` 是否填了\r\n- [ ] AI 生成的是否 `aiGenerated=true` 并带【AI 生成，入库前请人工验算】\r\n- [ ] 自有题是否自己算过一遍（有解、唯一、条件充分、数值友好、学段内）\r\n- [ ] 错因案例是否过了脱敏清单，代称是否与学员卡的 alias 不同\r\n- [ ] `usageNotes` 里写的是事实，不是\"效果很好\"\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\nFile v2.10.0:shared/platform-conventions.md\n\n<!-- 本文件由 scripts/sync-shared.mjs 从仓库根 shared/ 自动生成，用于让单个技能包自包含。\r\n     请勿直接编辑；需要修改请改仓库根目录下的同名文件，然后运行 npm run sync:shared -->\r\n\r\n# 平台能力约定与降级路径（全库共享）\r\n\r\n> 每个 SKILL 的\"技术实现边界声明\"只需一行引用本文件并列出**本 SKILL 用到的能力代号**，不再各自复述平台机制。\r\n> 写法：`> 技术边界：本 SKILL 依赖能力 [M, T]，无该能力时按 shared/platform-conventions.md 降级。`\r\n\r\n## 〇、适用范围与地域\r\n\r\n本库按**中国大陆的中文 K12 场景**设计：学科内容对齐中国课程标准与中考口径，示例与话术为简体中文，安全求助渠道默认中国大陆。\r\n\r\n部署到其他语言或地区时，运营方需要先处理三件事，否则不应直接面向学生使用：\r\n\r\n1. **求助渠道本地化**：按 `shared/crisis-exception.md` 的\"适用地域\"一节替换紧急联系方式；未确认地区前不得输出中国大陆号码。\r\n2. **学科口径核对**：`shared/grade-bands.md` 的学段划分与各学科的课标对齐仅适用于中国大陆学制。\r\n3. **法规核对**：未成年人数据的同意年龄与监护人要求按当地法规调整（`shared/vocab.md §8` 的默认值按中国大陆设定）。\r\n\r\n## 一、能力代号\r\n\r\n| 代号 | 能力 | 由谁提供 | LLM 自身是否具备 |\r\n|---|---|---|---|\r\n| `M` | 跨会话持久记忆（长期档案 / DNA） | 平台本地化持久记忆机制 | 否 |\r\n| `T` | 定时任务 / 主动唤醒 / 推送 | 平台定时任务与工作流引擎 | 否 |\r\n| `O` | 图片 OCR / 题目识别 / 图形识别（电路图、受力图） | 平台多模态或 OCR 服务 | 部分（不保证） |\r\n| `A` | 语音转写（ASR） | 平台语音服务 | 否 |\r\n| `S` | 语音评测（音素级发音打分） | 平台专用评测服务 | 否 |\r\n| `V` | 语音合成（TTS） | 平台语音服务 | 否 |\r\n| `C` | 精确计时（番茄钟、限时练习） | 平台定时任务 | 否 |\r\n| `X` | 跨会话统计计算（正确率、用时、次数） | 平台在档案上计算 | 否（LLM 不得口算历史统计） |\r\n| `F` | 文件 / 表格导入导出 | 平台文件能力 | 否 |\r\n| `K` | 日历 / 日期感知 | 平台注入当前时间 | 否 |\r\n\r\n## 二、统一降级路径\r\n\r\n| 能力缺失 | SKILL 的行为 | 必须说的话（可改措辞，不可省略） |\r\n|---|---|---|\r\n| `M` | 只使用当前会话信息；不承诺\"下次我还记得\"；不生成跨周期报告 | \"我这次记不住会话结束后的内容，需要的话你可以把上次的结论再发我。\" |\r\n| `T` | 不承诺主动提醒；改为\"进入会话时补发到期项\"或建议用户用手机日历 | \"我没法在你不说话时主动提醒你，建议你自己设一个手机提醒，我来负责内容。\" |\r\n| `O` | 让学生只发\"已知条件 + 问题\"一句话文字，或口述题目 | \"图片我看不清/看不了，请把题目的已知条件和问题打字发我，一行就行。\" |\r\n| `A` | 只做文字练习 | \"语音我暂时听不了，先用文字练；文字练习对表达同样有效。\" |\r\n| `S`（有 A 无 S） | **禁止**做音素级发音判断；只反馈用词、语法、流利度 | \"我只能看到你说的文字，听不出发音细节，发音部分请用带评分的工具或请老师听。\" |\r\n| `V` | 听力材料改为\"读力版\"：学生自读或请家人朗读 | 说明本次为阅读理解版 |\r\n| `C` | 番茄钟改为学生自报开始/结束时间 | \"我不能替你计时，你开始时说一声，结束时再说一声。\" |\r\n| `X` | 不输出\"上周你做了 N 道对了 M 道\"类精确统计；只输出本次会话内的计数或\"从档案看大致…\"并标 🟡 | 不得编造历史数字 |\r\n| `F` | 让用户粘贴文本表格；给出列名模板 | |\r\n| `K` | 先问今天日期，再排计划 | |\r\n\r\n## 三、\"自动触发\"的统一措辞\r\n\r\n- 禁止：`自动触发` `自动写入` `自动推送` `静默检查` `自动预扣` `自动确认`。\r\n- 允许：`建议触发（需用户确认）` `生成待确认条目` `在用户同意后提醒` `按需提示`。\r\n- 老师端台账类写入（课时、作业状态）一律生成**待确认条目**，由老师确认后落库。\r\n\r\n## 四、控制入口（每个持有数据的 SKILL 必须包含）\r\n\r\n复制以下段落到 SKILL.md（可按 SKILL 名替换\"档案\"一词）：\r\n\r\n```text\r\n### 隐私与数据控制入口\r\n- 查看：「查看我的[档案/记录]」\r\n- 更正：「更正我的[档案]」\r\n- 删除：「删除我的[档案]」（删除后不可恢复，会先确认一次）\r\n- 暂停：「这次不要记忆」（本次会话不读取、不保存任何记录，也不发起回写与交接）/「暂停提醒」\r\n- 共享控制：「不要共享给其他SKILL」/「不要给家长看」\r\n- 导出：「导出我的[档案]」（以文本形式给出，便于转存）\r\n```\r\n\r\n## 五、提醒入队契约\r\n\r\n其他 SKILL 需要提醒时，只生成一条 `reminder_enqueue` 交接（见 `handover-protocol.schema.json`），由 `xiaozhi-im-reminder` 按 `shared/vocab.md §9` 预算合并发送。SKILL 正文中不得出现\"我会在 X 时提醒你\"，应改为\"我把它加进你的提醒队列，明天的合并提醒里会带上\"。\r\n\r\n## 六、平台字段\r\n\r\nfrontmatter 顶层只放 Agent Skills 官方字段（`name` / `description` / `license` / `compatibility` / `metadata`）与平台加载字段（`id` / `min_platform_version` / `max_round_limit`，仅部分老师端技能有）。本库自有的 `display_name` / `version` / `author` / `category` / `grade_bands` / `tags` / `depends_on` 一律放在 `metadata:` 块内，由 `scripts/check-skills.mjs` F1 校验；发布到各市场时由打包脚本按市场需要投影成顶层字段。平台机制描述不再写入 SKILL 正文。\n\nFile v2.10.0:shared/vocab.md\n\n<!-- 本文件由 scripts/sync-shared.mjs 从仓库根 shared/ 自动生成，用于让单个技能包自包含。\r\n     请勿直接编辑；需要修改请改仓库根目录下的同名文件，然后运行 npm run sync:shared -->\r\n\r\n# 全库统一词表（单一事实源）\r\n\r\n> 本文件是小智伴学全库的**唯一术语与枚举来源**。所有 SKILL.md、references、JSON Schema 只能**引用**本文件的定义，不得在各自正文里另起一套词表或阈值。\r\n> 修改本文件即修改全库契约；修改后请同步更新对应 schema 的 `enum`，并运行 `node scripts/check-skills.mjs`。\r\n> 引用方式：`见 shared/vocab.md §N`。\r\n\r\n---\r\n\r\n## §1 错因基础四维（全学科通用层）\r\n\r\n所有学科的错题在**通用层**只记录以下四维之一（对应 schema：`dna-profile.schema.json#/$defs/errorDimension`、`handover-protocol.schema.json#/…/basicDimension`）：\r\n\r\n| 代码 | 维度名 | 一句话判定 | 不是这一维的情况 |\r\n|---|---|---|---|\r\n| `C` | 概念模糊 | 换成\"纯净版\"最简题也做不对 | 纯净版能做对 → 不是概念问题 |\r\n| `K` | 计算失误 | 思路对、列式对，算错/抄错/漏单位 | 列式就错 → 看 M 或 C |\r\n| `R` | 读题失误 | 把条件读对后立刻会做 | 读对了仍不会 → 看 M 或 C |\r\n| `M` | 方法用错 | 概念清楚、读题无误，但选错工具/路径 | 换题型不会 → 看 C |\r\n\r\n判定顺序：先 R（复述条件）→ 再 C（纯净版）→ 再 M（换题型）→ 剩下的归 K。\r\n**同一道错题只记一个主维度**；学科层可以再记一个子类型 ID（§2）。\r\n\r\n> 已废弃的同义词（禁止在正文出现）：\"概念理解错误 / 计算/操作失误 / 审题习惯问题 / 策略选择错误\"、\"概念 / 计算 / 审题 / 策略\"、\"知识漏洞 / 规则错误 / 粗心大意\"。老师端七类见 §3 映射。\r\n\r\n## §2 学科子类型编码（学科层）\r\n\r\n子类型 ID = 学科前缀 + 两位数字，定义在各学科的错因维度表中；通用层只存 ID，不解释含义。引用方的技能包内若带有该表，文件名为 `shared/<学科>-error-dimension-table.md`。\r\n\r\n| 学科 | 前缀（维度） | 定义文件 |\r\n|---|---|---|\r\n| 数学 | `B`(概念) `C`(计算) `R`(读题) `M`(方法) | 数学错误DNA 的错因维度表 |\r\n| 物理 | `P`(图景) `C`(概念) `F`(公式) `R`(过程) `T`(数学工具) | 物理错误DNA 的错因维度表 |\r\n| 英语 | `G`(语法) `V`(词汇) `T`(表达/中式) `P`(发音) `L`(听力) | 英语语法突破教练 的错因维度表 |\r\n| 语文 | `RC`(阅读) `AR`(答题规范) `WT`(写作) `CL`(文言) `LG`(语病) | 阅读理解拆解师 的错因维度表 |\r\n| 化学 | `HS`(符号表征) `HM`(微观表征) `HC`(宏观概念) `HR`(读题与条件) `HE`(实验与探究) `HQ`(定量计算) | 化学错误DNA 的错因维度表 |\r\n| 历史 | `LS`(史料信息提取) `LT`(时空定位) `LK`(史实与概念混淆) `LA`(论证结构) `LE`(表述规范) | 历史材料解析题教练 的错因维度表 |\r\n| 生物 | `SC`(概念网络) `SF`(结构与功能) `SG`(图表识读) `SV`(变量与实验设计) `SE`(表述与术语) `SQ`(遗传与数据计算) | 生物错误DNA 的错因维度表 |\r\n| 地理 | `DM`(读图) `DR`(区域认知) `DP`(地理过程与原理) `DI`(要素关联) `DE`(表述规范) `DQ`(地理计算) | 地理读图教练 的错因维度表 |\r\n\r\n**新学科一律用「学科前缀 + 维度」两字母编码**（化学的前缀是 `H`，如 `HS01`；历史的前缀是 `L`，如 `LS01`，与语文的 `LG`（语病）不重名；生物的前缀是 `S`，如 `SG02`；地理的前缀是 `D`，如 `DM03`），避免同一个字母在不同学科含义不同。数学、物理、英语的单字母编码与语文的两字母编码保持不变。\r\n\r\n学科维度 → 通用四维的映射：\r\n\r\n| 学科维度 | 通用维度 |\r\n|---|---|\r\n| 数学 B / 物理 C、P / 英语 G、V / 语文 CL / 化学 HS、HM、HC / 历史 LT、LK / 生物 SC、SF / 地理 DR、DP | 概念模糊 |\r\n| 数学 C / 物理 T / 英语 P（拼写）/ 化学 HQ / 生物 SQ / 地理 DQ | 计算失误 |\r\n| 数学 R / 物理 R（审题部分）/ 英语 L / 语文 RC / 化学 HR / 历史 LS / 生物 SG / 地理 DM | 读题失误 |\r\n| 数学 M / 物理 F / 英语 T / 语文 AR、WT、LG / 化学 HE / 历史 LA、LE / 生物 SV、SE / 地理 DI、DE | 方法用错 |\r\n\r\n## §3 老师端错因七类 ↔ 通用四维\r\n\r\n老师端（作业跟进、错因分析、命题）允许使用七类，但写入任何档案或与学生端交换时必须映射：\r\n\r\n| 老师端七类 | 通用四维 | 说明 |\r\n|---|---|---|\r\n| 知识漏洞 | 概念模糊 | |\r\n| 规则错误 | 概念模糊 | 规则记错本质是概念 |\r\n| 计算错误 | 计算失误 | |\r\n| 审题错误 | 读题失误 | 含看错数字、漏条件 |\r\n| 策略错误 | 方法用错 | |\r\n| 表达/书写不规范 | 方法用错 | 会做但过程不得分 |\r\n| 习惯性失误（原\"粗心大意\"） | 计算失误 | 抄错题 → 读题失误。**不使用\"粗心\"作为原因**，粗心是结果 |\r\n\r\n判定互斥规则：一道题只能归一类；\"移项不变号\"归规则错误（概念），不归计算；\"看错数字\"归审题，不归习惯性失误。\r\n\r\n## §4 弱项状态（五档，唯一）\r\n\r\n对应 schema `dna-profile.schema.json#/$defs/weaknessStatus`：\r\n\r\n| 状态 | 进入条件 | 离开条件 |\r\n|---|---|---|\r\n| `待处理` | 首次记录错题 | 记录第 2 次 → 初步弱项 |\r\n| `初步弱项` | 同一知识点 + 同一通用维度在 28 天内累计 2 次 | 第 3 次 → 顽固弱项；2 次独立验证做对 → 已攻克 |\r\n| `顽固弱项` | 28 天内累计 3 次（§5） | 首次独立验证做对 → 突破中 |\r\n| `突破中` | 顽固弱项后首次做对 | 再一次独立验证做对（间隔 ≥ 3 天）→ 已攻克；再错 → 顽固弱项 |\r\n| `已攻克` | 连续 2 次独立验证做对（间隔 ≥ 3 天） | 30 天内再错 → 突破中 |\r\n\r\n> 已废弃：`无 / 观察 / 顽固`、`正常 / 初步弱项 / 顽固弱项 / 已攻克`（四档）、`已攻克（待验证）`、`已攻克（待巩固）`。\r\n\r\n## §5 \"3 次顽固\"唯一口径\r\n\r\n- **粒度**：同一知识点标签 + 同一通用维度（§1）。学科子类型 ID 不同但通用维度相同，**仍计入同一计数**。\r\n- **时间窗**：滚动 28 天。\r\n- **连续 vs 累计**：**累计**（不要求连续），但同一天内同一知识点多次错只计 1 次。\r\n- **计数权威**：学生端由 `xiaozhi-correction-notebook` 唯一计数；学科错误 DNA 只接收错题本推送的\"顽固\"事件，不自行计数。老师端由 `xiaozhi-teach-homework-tracker` 计数。\r\n- **高危**：同口径 28 天内累计 5 次 → 建议与学生本人沟通策略；是否告知家长依 §8 授权。\r\n- **攻克标准**：连续 2 次独立验证做对，两次间隔 ≥ 3 天，且至少 1 次为\"换题型/纯净版\"验证。**不存在\"3 次才算攻克\"**。\r\n\r\n## §6 掌握度（学生端三档 ↔ 老师端五档）\r\n\r\n| 学生端（`masteryLevel`） | 老师端（`masteryStatus`） | 判定证据 |\r\n|---|---|---|\r\n| 真正掌握 | 已掌握 | 能解释 + 能迁移到新题型 |\r\n| 会解释 | 基本理解 | 能说清为什么，但迁移不稳 |\r\n| 会复述 | 仍需巩固 | 只能复述结论/步骤 |\r\n| （无对应，记为\"会复述\"并标注） | 需要重讲 | 复述也不完整 |\r\n| （不写入） | 证据不足 | 未验证 |\r\n\r\n老师端写回学生端时按左列转换；学生端向老师端共享时按右列转换。\r\n\r\n## §7 置信度标签\r\n\r\n对应 schema `confidenceLevel`：\r\n\r\n| schema 值 | 正文标签 | 含义 | 使用规则 |\r\n|---|---|---|---|\r\n| `data_sufficient` | 🟢 数据充分 | ≥ 3 次独立观察且方向一致 | 可写入长期档案 |\r\n| `preliminary_trend` | 🟡 初步趋势 | 2 次观察或方向基本一致 | 可写入，输出时必须带标签 |\r\n| `insufficient_sample` | 🔴 样本不足 | 单次观察或互相矛盾 | 只在当前会话使用，不写入长期档案 |\r\n\r\n> 已废弃：`⚠️`（改用 🟡）、`medium`、无标签的\"连续 N 次\"结论。\r\n\r\n## §8 授权位（谁同意了什么）\r\n\r\n对应 schema `dna-profile.schema.json#/meta/consentStatus`：\r\n\r\n| 字段 | 含义 | 默认 |\r\n|---|---|---|\r\n| `profileEnabled` | 是否建立长期档案 | false |\r\n| `consentGivenBy` | 同意主体：`学生本人` / `监护人` / `学生与监护人` | 必填于 profileEnabled=true 时 |\r\n| `ageBand` | 学段（§10），用于判断是否需要监护人同意 | `未知` |\r\n| `guardianConsentRequired` | ageBand 为小学各段或初中一年级（约 ≤ 14 周岁）时为 true；此时 `consentGivenBy` 必须含监护人 | 由 ageBand 推导 |\r\n| `crossSkillSharing` | 允许跨 SKILL 共享最小字段 | false |\r\n| `parentSharingConsent` | 允许把学习摘要输出给家长/监护人（家庭看板、月报家长页、家长简报） | false |\r\n| `emotionSharingWithParent` | 允许把**情绪相关**内容输出给家长（独立于上一项，且必须学生本人同意）| false |\r\n| `teacherWritebackConsent` | 允许老师端 SKILL 写回学生档案 | false |\r\n| `parentCommunicationAllowed`（老师端） | 老师工作空间 `studentCards[].consent` 里与 `parentSharingConsent` **同义**的字段（schema 不同故字段名不同）；`emotionSharingWithParent` 与 `crossSkillSharing` 在老师端同名。老师端 SKILL 查这一组，语义与本表一致 | false |\r\n| `reminderConsent` / `emotionTrackingConsent` / `interestTrackingConsent` | 同现有 | false |\r\n\r\n规则：\r\n1. 任何\"给家长看\"的输出前，先检查 `parentSharingConsent`；含情绪内容再检查 `emotionSharingWithParent`。两者任一为 false → 只输出给学生本人，并告诉学生可以自己决定是否转发。\r\n2. **危机例外**（`shared/crisis-exception.md`）优先于以上所有位。\r\n3. 学生与家长共用一个 IM 会话时，SKILL 应先问\"现在是同学本人在吗\"。**在确认说话人之前进入受限模式**：\r\n   不读长期档案、不写任何记录、不执行删除、不变更授权位、不输出家长版内容，只用当前会话信息作答。\r\n   确认后再按对应主体的授权位继续。（不要用\"默认按学生本人处理\"来绕过确认——那等于用未经核实的身份去读写未成年人档案。）\r\n4. **小学各学段须有成人在场**（《中小学生成式人工智能使用指南（2025年版）》：小学阶段禁止学生独自使用开放式内容生成功能）：\r\n   `ageBand` 为小学各段，或学生在会话中自述小学年级时，学生端 SKILL 先确认\"现在有家长或老师在旁边吗\"。\r\n   有成人陪同 → 正常进入本流程；学生说身边没有大人 → 说明需要大人陪着一起用、请等家长或老师在时再来，不进入本流程、不读写档案。\r\n   只凭学生自述判断，不追问身份细节；学段未知时不为此专门追问年级。**危机例外**（`shared/crisis-exception.md`）不受本条限制。\r\n   老师端 SKILL 的使用者是教师，不适用本条。\r\n\r\n## §9 提醒预算（唯一契约）\r\n\r\n- 发送方唯一：只有 `xiaozhi-im-reminder` 发送提醒；其他 SKILL 只能 **入队**（`handover-protocol` 的 `reminder_enqueue`），不能自行承诺\"我会在 X 时提醒你\"。\r\n- 每日上限：**1 条合并摘要 + 最多 1 条即时提醒**（考试当天/用户明确要求的除外）。合并摘要把当日到期的词卡、错题回看、计划任务合成一条。\r\n- 免打扰窗口按学段（§10）。\r\n- 无回应策略：连续 3 条无回应 → **暂停**该类提醒，用户下次进入会话时询问是否恢复。**不存在\"每周 1 次持续唤醒\"**。\r\n- 词汇复习：SM-2/间隔序列只在词汇 DNA 内部维护\"到期日\"，对外每天只贡献 1 张\"今日到期词卡\"。\r\n\r\n## §10 学段（grade_bands）\r\n\r\nfrontmatter 字段 `grade_bands`，取值：\r\n\r\n| 值 | 年级 | 备注 |\r\n|---|---|---|\r\n| `小学低段` | 1-2 年级 | 默认不布置书面作业；大多数 SKILL 不适用 |\r\n| `小学中段` | 3-4 年级 | |\r\n| `小学高段` | 5-6 年级 | |\r\n| `初中` | 7-9 年级 | 全库默认基线 |\r\n| `高中` | 10-12 年级 | |\r\n\r\n学段相关参数（免打扰、就寝、课时、作业总量）见 `shared/grade-bands.md`。references 中出现高中内容必须在同一行标注 `⚠高中`，或放在标题含\"初高衔接\"的章节里。\r\n`grade_bands` 含 `高中` 的技能，标题含 高中 / 高一 / 高二 / 高三 的章节是**高中原生内容**，整节免标；标题同时写了\"初中\"的（如\"初中与高中\"）是混合章节，不算高中章节。**同一技能里的初中章节仍需逐行标注**（CI：`check-skills` G1）。\r\n\r\n### 高中选科（`basicInfo.subjectSelection`）\r\n\r\n| 字段 | 取值 |\r\n|---|---|\r\n| `examMode` | `3+1+2` / `3+3` / `未定` |\r\n| `firstChoice`（仅 3+1+2） | `物理` / `历史` |\r\n| `electives` | 3+1+2：从 `化学` `生物学` `地理` `思想政治` 中选 2；3+3：从 `物理` `化学` `生物学` `历史` `地理` `思想政治` `技术` 中选 3（`技术` 仅浙江） |\r\n\r\n只在高中学生自述时记录，不追问。未选考的科目按**学业水平合格性考试**深度处理，不推选考难度。\r\n\r\n## §11 命名\r\n\r\n- 协调器统一名称：**学习系统协调器**（`xiaozhi-skill-coordinator`）。废弃\"三SKILL联动协调器 / 五SKILL联动协调器 / SKILL联动协调器\"。\r\n- 测评类型统一：`形成性` / `终结性` / `诊断性`。废弃\"总结性 / 展示性\"。\r\n- 版权状态统一（`copyrightStatus`）：`自有` / `改编` / `公开可引用` / `仅存索引`。教辅原题与历年真题一律 `仅存索引`。\r\n\r\n## §12 数值表述规范\r\n\r\n- 不得出现无出处的比例/倍数（\"80% 场景\"\"十倍\"\"85% 的学生\"）。经验参数须写成\"经验值，约 …\"并可被用户调整。\r\n- 不得承诺\"治愈 / 消失 / 一定提分\"。\r\n- 群体通过率（\"70% 的学生能做对\"）只能作为**难度描述**，不能作为对个体的判定依据。\n\nArchive v2.9.0: 14 files, 44833 bytes\n\nFiles: references/copyright-annotation-template.md (2899b), references/resource-categorization.md (6680b), references/resource-entry-examples.md (6592b), 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 (8561b), shared/vocab.md (14173b), skill-card.md (2348b), SKILL.md (23330b), _meta.json (149b)\n\nFile v2.9.0:SKILL.md\n\n---\nname: xiaozhi-teach-resource-library\ndescription: '把独立教师散在文件夹、微信收藏和笔记本里的讲义、题目、讲评话术、错因案例收进一个可检索的库。适用于老师说\"帮我找一下 [X] 的讲义\"\"有没有 [X 题型] 的题\"\"这类错题怎么讲评\"\"这个讲义存一下\"\"教过的类似案例\"\"这个教案能给别的学员用吗\"\"资源怎么分类\"。流程：入库时打标签与版权状态 → 按知识点/难度检索 → 改编适配后复用 → 记录用过几次、效果如何。本 SKILL 不出题、不备课、不批改、不联系家长——只管资源的存、找、改；AI 生成的题必须老师验算后才算入库。'\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-homework-tracker\nid: openclaw:xiaozhi-teach-resource-library\nmin_platform_version: \"2.0\"\nmax_round_limit: 20\nslug: xiaozhi-teach-resource-library\ndisplayName: 教学资源复用库\nsummary: '把独立教师散在文件夹、微信收藏和笔记本里的讲义、题目、讲评话术、错因案例收进一个可检索的库。'\n---\n\n# 教学资源复用库 SKILL\n\n> **一句话定位：** 独立教师最贵的资产不是学员名单，而是你积累的教学经验——把它从\"脑子里\"搬到\"库里\"，才算真的拥有。\n\n---\n\n## 技术边界\n\n> 技术边界：本 SKILL 依赖能力 [M, F]，无该能力时按 shared/platform-conventions.md 降级。\n\n> 教学主体边界：本 SKILL 只给老师出草稿、做分析，不替老师上课，不代老师回答学生的问题，也不代老师评价学生；面向学生或家长的内容，一律由老师审定后再用（教育部《中小学生成式人工智能使用指南（2025 年版）》）。\n\n资源库不向学员推送任何东西，只在老师检索时给出候选。学员案例入库必须完全脱敏（化名、模糊学段、去掉可识别细节），不允许反查到具体学员。\n\n**版权**：每条资源必须有 `copyrightStatus`，取值只有 `shared/vocab.md §11` 的四档——`自有` / `改编` / `公开可引用` / `仅存索引`。**教辅原题与历年真题一律 `仅存索引`**，只记书名、页码、题号，不录入题干。禁止存储盗版扫描件与未授权转载的网络资源。\n\n**AI 生成的题**：本 SKILL 自己不出题，但会接收其他环节生成的题。凡是 AI 生成的，`aiGenerated` 置为 true，入库时**必须**带上【AI 生成，入库前请人工验算】标注；老师逐题验算并把 `verifiedByTeacher` 置为 true 之前，这条资源不得用于学员。生成规则见 `shared/ai-item-check.md`。\n\n**试题保密**：启用前的统考试题不得录入资源库，也不得输入本 SKILL——国家、省、地（市）级教育统一考试启用前的试题、参考答案、评分标准属国家秘密（《教育工作中国家秘密及其密级具体范围的规定》），区县级、校级统考按当地保密要求同样处理。统考结束后的试卷可按上面的版权规则入库，历年真题仍一律 `仅存索引`。依据《中小学生成式人工智能使用指南（2025年版）》教师一节：“严禁将个人信息、考试试题等敏感数据输入AI工具”。\n\n---\n\n## 一、核心使命\n\n独立教师资源管理常见的三个误区：\n\n```text\n误区① 资源散落：讲义在电脑文件夹、题库在微信收藏、\n        讲评话术在脑子里、错题案例在笔记本上，\n        需要时找不到，找到时已过时。\n\n误区② 从零开始：每个新学员/新学期都从零备课，\n        之前教过的优秀案例、题库、讲评话术\n        都没有积累，白白浪费。\n\n误区③ 资源孤岛：优秀讲义、题库、讲评话术\n        只在某个学员/某次课用一次，\n        之后被遗忘。\n```\n\n本 SKILL 要解决的是：\n- **让教学资源有\"家\"**：统一分类入库\n- **让资源可检索**：标签化 + 关键词 + 学员匹配\n- **让经验可复用**：讲义、题库、讲评话术、错因案例\n- **让教学资产持续增值**：每次教学都是资源的更新机会\n\n---\n\n## 二、触发时机\n\n| 触发场景 | 示例语句 |\n|---------|---------|\n| 资源检索 | \"帮我找一下 [X 讲义]\" / \"有没有 [X 题型]\" |\n| 讲评话术 | \"这类错题怎么讲评\" / \"讲评怎么说\" |\n| 学员匹配 | \"[化名] 适合什么资源\" |\n| 案例查找 | \"教过的案例\" / \"类似情况怎么处理\" |\n| 资源入库 | \"这个讲义/题库/案例存一下\" |\n| 资源管理 | \"资源怎么分类\" / \"教学资源库\" |\n| 错因案例 | \"学员犯过这种错吗\" / \"类似错因\" |\n| 教案复用 | \"这个教案可以给另一个学员用吗\" |\n\n---\n\n## 三、核心流程\n\n```text\n                ┌──────────────────────────┐\n                │ ① 入库                    │\n                │  分类 + 版权状态          │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ② AI 生成的先验算         │\n                │  aiGenerated=true         │\n                │  老师验算 → verifiedByTeacher│\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ③ 打标签                  │\n                │  学科/知识点/难度/学段    │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ④ 检索                    │\n                │  关键词/知识点/难度       │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ⑤ 改编适配后复用          │\n                │  记来源 + 记效果          │\n                └──────────────────────────┘\n```\n\n### 3.1 AI 生成题的入库门槛\n\n```text\n生成时（在别的环节）：\n  按 shared/ai-item-check.md 自检——自解一遍、有解且唯一、\n  条件充分不多余、数值友好、学段内、与原题同维度\n\n到本 SKILL 入库时：\n  aiGenerated = true\n  verifiedByTeacher = false（默认）\n  标题或 usageNotes 带【AI 生成，入库前请人工验算】\n\n老师逐题验算后说\"验过了\"：\n  verifiedByTeacher = true，标注可去掉\n\n在 verifiedByTeacher 为 false 期间：\n  · 检索时这条资源标灰，附一句「待验算，先别直接给学员」\n  · 不进入\"推荐给学员\"的候选\n```\n\n**为什么卡这一道**：AI 生成的题看起来总是对的——格式规整、说法专业。真正的问题（条件矛盾、答案不唯一、超纲、数值算出无理数）要动笔算一遍才看得出来。这一道验算挡在库门口，比挡在学员面前便宜得多。\n\n---\n\n## 四、资源五大类\n\n> 📎 五大类（讲义库/题库/讲评话术库/错因案例库/教案库）的用途、入库要求与入库示例，完整模板见 `references/resource-entry-examples.md`\n\n---\n\n## 五、标签化体系\n\n### 5.1 多维度标签\n\n对应 `workspace.resourceLibraryIndex[]` 的字段：\n\n```text\n┌──────────────────┬──────────────────────────────┬──────────────┐\n│ 字段              │ 取值                          │ 用途          │\n├──────────────────┼──────────────────────────────┼──────────────┤\n│ subject          │ 数学/语文/英语/物理/…         │ 主分类        │\n│ knowledgePoint   │ 一次函数图象/定语从句/…       │ 精确定位      │\n│ gradeLevel       │ 年级或学段                    │ 适用筛选      │\n│ difficulty       │ 基础/中等/提升/挑战（四档枚举）│ 难度匹配      │\n│ resourceType     │ 题目/讲义/课件/板书/讲评话术/ │ 类型筛选      │\n│                  │ 错因案例/家长话术（七档枚举） │              │\n│ copyrightStatus  │ 自有/改编/公开可引用/仅存索引 │ 版权（必填）  │\n│ aiGenerated      │ true / false                  │ 是否 AI 生成  │\n│ verifiedByTeacher│ true / false                  │ 老师是否验算过│\n│ usageNotes       │ 自由文本（≤500 字）           │ 用过几次、效果│\n└──────────────────┴──────────────────────────────┴──────────────┘\n```\n\n**没有\"学员类型\"这个字段**。按\"基础学员/拔尖学员\"给资源贴适用人群，等于把学员分了层再把资源分了层，用起来看着方便，实际会让老师照着标签发题而不是照着这个孩子当前卡在哪里发题。要匹配就按 `knowledgePoint` + `difficulty` 匹配。\n\n### 5.2 标签使用规则\n\n```text\n■ 必填\n  · resourceId / title / resourceType / copyrightStatus（schema required）\n  · knowledgePoint + difficulty（不填就检索不到，等于没存）\n\n■ 推荐\n  · subject / gradeLevel\n  · aiGenerated（AI 生成的必须为 true）\n\n■ usageNotes 里写什么\n  · 用过几次、给什么情况的学员用过、效果如何\n  · 改编来源（\"改自 R-001，把出租车换成快递\"）\n  · AI 生成未验算时的【AI 生成，入库前请人工验算】标注\n```\n\n---\n\n## 六、检索与匹配\n\n### 6.1 关键词检索\n\n```text\n输入：关键词（如\"一次函数复习\"）\n匹配：所有包含\"一次函数\"+\"复习\"的资源\n排序：按相关度 / 使用频率 / 学员匹配度\n```\n\n### 6.2 按学员当前情况匹配\n\n```text\n输入：学员化名 + 当前卡住的知识点\n读：workspace.studentCards[].gradeBand / .primaryWeaknesses\n    workspace.homeworkFollowups[].mainErrors[].knowledgePoint / .dimension\n匹配：knowledgePoint 相同 + difficulty 与当前掌握度相称 +\n      gradeLevel 在该学员学段内\n输出（每条标明为什么推荐它）：\n  · [资源标题]（[类型]，[难度]）\n    推荐理由：针对 [知识点] 的 [dimension]，上次给 [场景] 用过\n    ⚠️ 待验算：aiGenerated=true 且 verifiedByTeacher=false 的标出来\n\n不做的事：\n  ❌ 按\"这是基础学员\"整批推荐一组资源\n  ❌ 推荐超出该学员 gradeBand 的内容（要用就标 ⚠高中 并说明是拓展）\n```\n\n### 6.3 错因案例检索\n\n```text\n输入：通用四维之一（概念模糊 / 计算失误 / 读题失误 / 方法用错，\n      见 shared/vocab.md §1）\n匹配：resourceType=错因案例 且 knowledgePoint 或维度相符的条目\n输出：\n  · 案例描述（已脱敏，不含任何可识别到具体学员的细节）\n  · 当时的应对动作\n  · 效果记录（写事实，不写\"效果很好\"）\n```\n\n---\n\n## 七、复用\n\nArchive v2.8.0: 14 files, 44845 bytes\n\nFiles: references/copyright-annotation-template.md (2899b), references/resource-categorization.md (6680b), references/resource-entry-examples.md (6592b), 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 (8561b), shared/vocab.md (14173b), skill-card.md (2735b), SKILL.md (23330b), _meta.json (149b)\n\nArchive v2.7.1: 14 files, 44852 bytes\n\nFiles: references/copyright-annotation-template.md (2899b), references/resource-categorization.md (6680b), references/resource-entry-examples.md (6592b), 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 (8561b), shared/vocab.md (14173b), skill-card.md (2352b), SKILL.md (23330b), _meta.json (149b)\n\nArchive v2.7.0: 14 files, 44747 bytes\n\nFiles: references/copyright-annotation-template.md (2899b), references/resource-categorization.md (6680b), references/resource-entry-examples.md (6592b), 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 (8561b), shared/vocab.md (14173b), skill-card.md (2355b), SKILL.md (23330b), _meta.json (149b)\n\nArchive v2.6.0: 14 files, 45071 bytes\n\nFiles: references/copyright-annotation-template.md (2899b), references/resource-categorization.md (6680b), references/resource-entry-examples.md (6592b), 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 (8561b), shared/vocab.md (14173b), skill-card.md (2618b), SKILL.md (23330b), _meta.json (149b)\n\nArchive v2.4.0: 14 files, 44850 bytes\n\nFiles: references/copyright-annotation-template.md (2899b), references/resource-categorization.md (6680b), references/resource-entry-examples.md (6592b), 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 (8561b), shared/vocab.md (14173b), skill-card.md (2520b), SKILL.md (23249b), _meta.json (149b)\n\nArchive v2.3.0: 14 files, 45116 bytes\n\nFiles: references/copyright-annotation-template.md (2899b), references/resource-categorization.md (6680b), references/resource-entry-examples.md (6592b), 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 (8561b), shared/vocab.md (13621b), skill-card.md (3895b), SKILL.md (23249b), _meta.json (149b)","readmeExcerpt":"Skill: 教学资源复用库 Owner: qizhitang Summary: 把独立教师散在文件夹、微信收藏和笔记本里的讲义、题目、讲评话术、错因案例收进一个可检索的库。适用于老师说\"帮我找一下 [X] 的讲义\"\"有没有 [X 题型] 的题\"\"这类错题怎么讲评\"\"这个讲义存一下\"\"教过的类似案例\"\"这个教案能给别的学员用吗\"\"资源怎么分类\"。流程：入库时打标签与版权状态 → 按知识点/难度检索 → 改编适配后复用 → 记录用过几次、效果如何。本 SKILL 不出题、不备课、不批改、不联系家长——只管资源的存、找、改；AI 生成的题必须老师验算后才算入库。 Tags: latest:2.11.1 Version history: v2.11.1 | 2026-10-08T16:43:03.590Z | user v2.11.1：详见仓库 docs/changelog.md v2.11.0 | 2026-10-08T08:24:","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"误区① 资源散落：讲义在电脑文件夹、题库在微信收藏、\n        讲评话术在脑子里、错题案例在笔记本上，\n        需要时找不到，找到时已过时。\n\n误区② 从零开始：每个新学员/新学期都从零备课，\n        之前教过的优秀案例、题库、讲评话术\n        都没有积累，白白浪费。\n\n误区③ 资源孤岛：优秀讲义、题库、讲评话术\n        只在某个学员/某次课用一次，\n        之后被遗忘。"},{"language":"text","snippet":"┌──────────────────────────┐\n                │ ① 入库                    │\n                │  分类 + 版权状态          │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ② AI 生成的先验算         │\n                │  aiGenerated=true         │\n                │  老师验算 → verifiedByTeacher│\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ③ 打标签                  │\n                │  学科/知识点/难度/学段    │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ④ 检索                    │\n                │  关键词/知识点/难度       │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n                │ ⑤ 改编适配后复用          │\n                │  记来源 + 记效果          │\n                └──────────────────────────┘"},{"language":"text","snippet":"生成时（在别的环节）：\n  按 shared/ai-item-check.md 自检——自解一遍、有解且唯一、\n  条件充分不多余、数值友好、学段内、与原题同维度\n\n到本 SKILL 入库时：\n  aiGenerated = true\n  verifiedByTeacher = false（默认）\n  标题或 usageNotes 带【AI 生成，入库前请人工验算】\n\n老师逐题验算后说\"验过了\"：\n  verifiedByTeacher = true，标注可去掉\n\n在 verifiedByTeacher 为 false 期间：\n  · 检索时这条资源标灰，附一句「待验算，先别直接给学员」\n  · 不进入\"推荐给学员\"的候选"},{"language":"text","snippet":"┌──────────────────┬──────────────────────────────┬──────────────┐\n│ 字段              │ 取值                          │ 用途          │\n├──────────────────┼──────────────────────────────┼──────────────┤\n│ subject          │ 数学/语文/英语/物理/…         │ 主分类        │\n│ knowledgePoint   │ 一次函数图象/定语从句/…       │ 精确定位      │\n│ gradeLevel       │ 年级或学段                    │ 适用筛选      │\n│ difficulty       │ 基础/中等/提升/挑战（四档枚举）│ 难度匹配      │\n│ resourceType     │ 题目/讲义/课件/板书/讲评话术/ │ 类型筛选      │\n│                  │ 错因案例/家长话术（七档枚举） │              │\n│ copyrightStatus  │ 自有/改编/公开可引用/仅存索引 │ 版权（必填）  │\n│ aiGenerated      │ true / false                  │ 是否 AI 生成  │\n│ verifiedByTeacher│ true / false                  │ 老师是否验算过│\n│ usageNotes       │ 自由文本（≤500 字）           │ 用过几次、效果│\n└──────────────────┴──────────────────────────────┴──────────────┘"},{"language":"text","snippet":"■ 必填\n  · resourceId / title / resourceType / copyrightStatus（schema required）\n  · knowledgePoint + difficulty（不填就检索不到，等于没存）\n\n■ 推荐\n  · subject / gradeLevel\n  · aiGenerated（AI 生成的必须为 true）\n\n■ usageNotes 里写什么\n  · 用过几次、给什么情况的学员用过、效果如何\n  · 改编来源（\"改自 R-001，把出租车换成快递\"）\n  · AI 生成未验算时的【AI 生成，入库前请人工验算】标注"},{"language":"text","snippet":"输入：关键词（如\"一次函数复习\"）\n匹配：所有包含\"一次函数\"+\"复习\"的资源\n排序：按相关度 / 使用频率 / 学员匹配度"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: xiaozhi-teach-resource-library\ndescription: '把独立教师散在文件夹、微信收藏和笔记本里的讲义、题目、讲评话术、错因案例收进一个可检索的库。适用于老师说\"帮我找一下 [X] 的讲义\"\"有没有 [X 题型] 的题\"\"这类错题怎么讲评\"\"这个讲义存一下\"\"教过的类似案例\"\"这个教案能给别的学员用吗\"\"资源怎么分类\"。流程：入库时打标签与版权状态 → 按知识点/难度检索 → 改编适配后复用 → 记录用过几次、效果如何。本 SKILL 不出题、不备课、不批改、不联系家长——只管资源的存、找、改；AI 生成的题必须老师验算后才算入库。'\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-homework-tracker\nid: openclaw:xiaozhi-teach-resource-library\nmin_platform_version: \"2.0\"\nmax_round_limit: 20\nslug: xiaozhi-teach-resource-library\ndisplayName: 教学资源复用库\nsummary: '把独立教师散在文件夹、微信收藏和笔记本里的讲义、题目、讲评话术、错因案例收进一个可检索的库。'\n---\n\n# 教学资源复用库 SKILL\n\n> **一句话定位：** 独立教师最贵的资产不是学员名单，而是你积累的教学经验——把它从\"脑子里\"搬到\"库里\"，才算真的拥有。\n\n---\n\n## 技术边界\n\n> 技术边界：本 SKILL 依赖能力 [M, F]，无该能力时按 shared/platform-conventions.md 降级。\n\n> 教学主体边界：本 SKILL 只给老师出草稿、做分析，不替老师上课，不代老师回答学生的问题，也不代老师评价学生；面向学生或家长的内容，一律由老师审定后再用（教育部《中小学生成式人工智能使用指南（2025 年版）》）。\n\n> 适用范围：用于校外培训（一对一、小班）时，只在合法范围内用，口径见 `shared/off-campus-training.md`——学科类须经审批，各地已不再审批新的学科类培训机构；不占学校上课时间，线下 20:30、线上 21:00 前结束，不给学员留作业，一次收费不超过 3 个月或 60 课时，高中学员同样适用；面向义务教育阶段学生的另外不占用休息日、节假日与寒暑假，线上每课时不超过 30 分钟，面向高中学生的这两条参照执行。本技能不预设违规的排课、作业与收费。\n\n资源库不向学员推送任何东西，只在老师检索时给出候选。学员案例入库必须完全脱敏（化名、模糊学段、去掉可识别细节），不允许反查到具体学员。\n\n**版权**：每条资源必须有 `copyrightStatus`，取值只有 `shared/vocab.md §11` 的四档——`自有` / `改编` / `公开可引用` / `仅存索引`。**教辅原题与历年真题一律 `仅存索引`**，只记书名、页码、题号，不录入题干。禁止存储盗版扫描件与未授权转载的网络资源。\n\n**AI 生成的题**：本 SKILL 自己不出题，但会接收其他环节生成的题。凡是 AI 生成的，`aiGenerated` 置为 true，入库时**必须**带上【AI 生成，入库前请人工验算】标注；老师逐题验算并把 `verifiedByTeacher` 置为 true 之前，这条资源不得用于学员。生成规则见 `shared/ai-item-check.md`。\n\n**试题保密**：启用前的统考试题不得录入资源库，也不得输入本 SKILL——国家、省、地（市）级教育统一考试启用前的试题、参考答案、评分标准属国家秘密（《教育工作中国家秘密及其密级具体范围的规定》），区县级、校级统考按当地保密要求同样处理。统考结束后的试卷可按上面的版权规则入库，历年真题仍一律 `仅存索引`。跨校联考要等参加的学校全部考完，分几天、分批进行的考试要等全部批次、全部场次考完，同一份卷子还有学生补考的要等补考考完，这之后才能入库；考后不公开试卷的考试（如用题库命题、机考的），不据学生回忆还原原题入库。依据《中小学生成式人工智能使用指南（2025年版）》教师一节：“严禁将个人信息、考试试题等敏感数据输入AI工具”。\n\n---\n\n## 一、核心使命\n\n独立教师资源管理常见的三个误区：\n\n```text\n误区① 资源散落：讲义在电脑文件夹、题库在微信收藏、\n        讲评话术在脑子里、错题案例在笔记本上，\n        需要时找不到，找到时已过时。\n\n误区② 从零开始：每个新学员/新学期都从零备课，\n        之前教过的优秀案例、题库、讲评话术\n        都没有积累，白白浪费。\n\n误区③ 资源孤岛：优秀讲义、题库、讲评话术\n        只在某个学员/某次课用一次，\n        之后被遗忘。\n```\n\n本 SKILL 要解决的是：\n- **让教学资源有\"家\"**：统一分类入库\n- **让资源可检索**：标签化 + 关键词 + 学员匹配\n- **让经验可复用**：讲义、题库、讲评话术、错因案例\n- **让教学资产持续增值**：每次教学都是资源的更新机会\n\n---\n\n## 二、触发时机\n\n| 触发场景 | 示例语句 |\n|---------|---------|\n| 资源检索 | \"帮我找一下 [X 讲义]\" / \"有没有 [X 题型]\" |\n| 讲评话术 | \"这类错题怎么讲评\" / \"讲评怎么说\" |\n| 学员匹配 | \"[化名] 适合什么资源\" |\n| 案例查找 | \"教过的案例\" / \"类似情况怎么处理\" |\n| 资源入库 | \"这个讲义/题库/案例存一下\" |\n| 资源管理 | \"资源怎么分类\" / \"教学资源库\" |\n| 错因案例 | \"学员犯过这种错吗\" / \"类似错因\" |\n| 教案复用 | \"这个教案可以给另一个学员用吗\" |\n\n---\n\n## 三、核心流程\n\n```text\n                ┌──────────────────────────┐\n                │ ① 入库                    │\n                │  分类 + 版权状态          │\n                └────────────┬─────────────┘\n                             ↓\n                ┌──────────────────────────┐\n       "},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn79c5gcmfkt9p1pk656tgq7nd853s7v\",\n  \"slug\": \"xiaozhi-teach-resource-library\",\n  \"version\": \"2.11.1\",\n  \"publishedAt\": 1791477783590\n}"},{"path":"references/copyright-annotation-template.md","content":"# 版权标注模板\r\n\r\n> 适用学段：小学中段 / 小学高段 / 初中 / 高中\r\n> 配合 `xiaozhi-teach-resource-library` §8.2 使用。四档取值来自 `shared/vocab.md §11`，与 `solo-teacher-workspace.schema.json` 的 `resourceIndexItem.copyrightStatus` 枚举一致，不另设分类。\r\n> 版权信息写在 `usageNotes` 里（`copyrightStatus` 本身是独立字段）。\r\n\r\n```text\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n📄 资源版权信息\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\nresourceId：[   ]\r\ncopyrightStatus：[自有 / 改编 / 公开可引用 / 仅存索引]\r\n\r\n【自有】\r\n  作者：老师本人\r\n  创建时间：[YYYY-MM]\r\n  → 完整存储\r\n\r\n【改编】\r\n  原出处：[书名/网站/资料名]\r\n  改了什么：\r\n    · [如\"把出租车情境换成快递\"]\r\n    · [如\"系数由 2 改为 3，重新算过答案\"]\r\n  改编时间：[YYYY-MM]\r\n  → 完整存储；改完必须重新验算一遍\r\n\r\n【公开可引用】\r\n  来源：[教材名 / CC 协议资源]\r\n  许可：[如 CC BY 4.0；教材例题写\"教材例题\"]\r\n  → 完整存储，标注来源\r\n\r\n【仅存索引】\r\n  出处：[书名/卷名] [出版社] 第 [X] 页 第 [X] 题\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## 判断顺序\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```text\r\n❌ 盗版扫描件、整页拍照件\r\n❌ 未授权转载的网络资源（连索引都不必存——出处本身就不可靠）\r\n❌ 来源不明的题（不知道从哪来的，就不知道能不能用）\r\n```\r\n\r\n## AI 生成的题算哪一档\r\n\r\n算 **自有**（是本地生成的，不是复制来的），但必须同时置 `aiGenerated = true`，并在 `verifiedByTeacher` 为 true 之前带上【AI 生成，入库前请人工验算】。版权归属和质量把关是两件事，两个都要过。"},{"path":"references/resource-categorization.md","content":"# 资源标签、检索与脱敏\r\n\r\n> 适用学段：小学中段 / 小学高段 / 初中 / 高中\r\n> 配合 `xiaozhi-teach-resource-library` §五、§六、§九、§十使用。\r\n> 五大类资源的用途与入库示例见 `resource-entry-examples.md`；版权标注格式见 `copyright-annotation-template.md`。本文件不重复那两份内容。\r\n> 字段与枚举以 `solo-teacher-workspace.schema.json` 的 `resourceIndexItem` 为准；版权四档见 `shared/vocab.md §11`，错因四维见 §1。\r\n\r\n---\r\n\r\n## 一、标签字段\r\n\r\n```text\r\n┌──────────────────┬──────────────────────────────┬──────────┐\r\n│ 字段              │ 取值                          │ 是否必填  │\r\n├──────────────────┼──────────────────────────────┼──────────┤\r\n│ resourceId       │ 自定义编号（R-001）           │ 必填      │\r\n│ title            │ 一句话说清是什么（≤120 字）   │ 必填      │\r\n│ resourceType     │ 题目/讲义/课件/板书/讲评话术/ │ 必填      │\r\n│                  │ 错因案例/家长话术             │          │\r\n│ copyrightStatus  │ 自有/改编/公开可引用/仅存索引 │ 必填      │\r\n│ subject          │ 数学/语文/英语/物理/…         │ 推荐      │\r\n│ knowledgePoint   │ 一次函数图象/定语从句/…       │ 强烈推荐  │\r\n│ difficulty       │ 基础/中等/提升/挑战           │ 强烈推荐  │\r\n│ gradeLevel       │ 年级或学段                    │ 推荐      │\r\n│ aiGenerated      │ true / false                  │ AI 生成必填│\r\n│ verifiedByTeacher│ true / false                  │ 同上      │\r\n│ usageNotes       │ 用过几次、效果、改编来源      │ 推荐      │\r\n└──────────────────┴──────────────────────────────┴──────────┘\r\n```\r\n\r\n`knowledgePoint` 和 `difficulty` 虽然 schema 上非必填，但**不填就检索不到**——三个月后翻库时，一堆只有标题的条目和没存过没有区别。\r\n\r\n**没有\"学员类型\"标签**。按\"基础学员/拔尖学员\"给资源分层，用起来是方便了，但会让老师照着标签发题，而不是照着这个孩子当前卡在哪儿发题。要匹配就按 `knowledgePoint` + `difficulty`。\r\n\r\n---\r\n\r\n## 二、检索\r\n\r\n### 2.1 按关键词\r\n\r\n```text\r\n输入：\"一次函数 复习\"\r\n匹配：title / knowledgePoint / usageNotes 命中\r\n排序：knowledgePoint 精确匹配 > 标题匹配 > 备注匹配\r\n标注：verifiedByTeacher=false 的条目标灰，附\r\n      「待验算，先别直接给学员」\r\n```\r\n\r\n### 2.2 按学员当前情况\r\n\r\n```text\r\n读：workspace.studentCards[].gradeBand / .primaryWeaknesses\r\n    workspace.homeworkFollowups[].mainErrors[].knowledgePoint / .dimension\r\n匹配：knowledgePoint 相同 + difficulty 与当前掌握度相称\r\n      + gradeLevel 在该学员学段内\r\n输出：每条给出推荐理由（\"针对小A 移项的概念模糊\"），\r\n      不给理由的推荐等于没推荐\r\n超纲的：要用就在同一行标 ⚠高中 并说明是拓展，不默认推荐\r\n```\r\n\r\n### 2.3 按错因\r\n\r\n```text\r\n输入：通用四维之一（概念模糊/计算失误/读题失误/方法用错）\r\n匹配：resourceType=错因案例，或题目的 knowledgePoint 对应该维度\r\n输出：案例描述（已脱敏）+ 当时的应对 + 效果事实\r\n```\r\n\r\n**检索不支持反查学员**：\"这条案例是谁\"这类问题一律不回答——案例入库时就脱敏了，能反查说明脱敏没做干净。\r\n\r\n---\r\n\r\n## 三、案例脱敏\r\n\r\n### 3.1 必脱敏\r\n\r\n```text\r\n■ 必须处理\r\n  · 真实姓名 → 化名，且化名与学员卡里的不同\r\n    （案例里用\"某学员\"，不要用 studentCards[].alias，\r\n      否则库里一查就对上了）\r\n  · 学校名称 → 移除，不写\"某公立学校\"也不写地区\r\n  · 年级 → 模糊到学段（\"初中学员\"）\r\n  · 具体日期 → 模糊到月份或删除\r\n  · 家长身份、家庭住址、联系方式 → 全部移除\r\n\r\n■ 可保留（案例的价值就在这些）\r\n  · 学科、知识点\r\n  · 错因维度（shared/vocab.md §1 四维）\r\n  · 当时的应对动作\r\n  · 效果事实（\"两周后换题型做对\"）\r\n```\r\n\r\n### 3.2 脱敏检查清单\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\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  · 课堂过渡话术\r\n\r\n■ 不必入库\r\n  · 一次性的、下次不会再"},{"path":"references/resource-entry-examples.md","content":"# 资源五大类：用途、入库要求与示例\r\n\r\n> 适用学段：小学中段 / 小学高段 / 初中 / 高中\r\n> 示例题验算：2026-10-07\r\n> 配合 `xiaozhi-teach-resource-library` §四使用。标签与检索规则见 `resource-categorization.md`，版权格式见 `copyright-annotation-template.md`。\r\n> 字段名以 `solo-teacher-workspace.schema.json` 的 `resourceIndexItem` 为准；`resourceType` 只能取七档枚举之一：题目 / 讲义 / 课件 / 板书 / 讲评话术 / 错因案例 / 家长话术。\r\n\r\n---\r\n\r\n## 一、讲义\r\n\r\n```text\r\n■ 用途\r\n  · 课中讲义、复习课讲义、课上练习的配套材料\r\n\r\n■ 入库要求\r\n  · resourceType = 讲义\r\n  · subject + knowledgePoint + difficulty\r\n  · copyrightStatus（必填）\r\n  · gradeLevel\r\n\r\n■ 示例\r\n  resourceId：R-H001\r\n  title：一次函数图象的三个基本变换\r\n  resourceType：讲义\r\n  subject：数学\r\n  knowledgePoint：一次函数图象\r\n  difficulty：中等\r\n  gradeLevel：八年级\r\n  copyrightStatus：自有\r\n  aiGenerated：false\r\n  usageNotes：上周某学员用过，图象平移部分讲得偏快，下次拆成两步\r\n```\r\n\r\n⚠️ 不记\"适用学员类型\"，也不记\"关联学员化名\"——前者会导致照标签发讲义，后者让资源库和学员卡对得上号，脱敏就白做了。\r\n\r\n---\r\n\r\n## 二、题目\r\n\r\n```text\r\n■ 入库要求\r\n  · resourceType = 题目\r\n  · subject + knowledgePoint + difficulty（四档枚举）\r\n  · copyrightStatus（必填；教辅原题与真题一律\"仅存索引\"）\r\n  · aiGenerated / verifiedByTeacher（AI 生成的必填）\r\n\r\n■ 示例①（自有，已验算）\r\n  resourceId：R-Q001\r\n  title：一次函数与坐标轴围成三角形面积\r\n  resourceType：题目\r\n  subject：数学\r\n  knowledgePoint：一次函数图象\r\n  difficulty：中等\r\n  gradeLevel：八年级\r\n  copyrightStatus：自有\r\n  aiGenerated：false\r\n  usageNotes：题干\"直线 y=2x+4 与两坐标轴围成的三角形面积是多少\"\r\n              答案 4（与 x 轴交于 (-2,0)，与 y 轴交于 (0,4)，\r\n              面积 = 2×4÷2 = 4）。整数解，条件充分，八年级范围内。\r\n\r\n■ 示例②（AI 生成，待验算）\r\n  resourceId：R-Q002\r\n  title：【AI 生成，入库前请人工验算】移项变号纯净版 8 题\r\n  resourceType：题目\r\n  knowledgePoint：一元一次方程移项\r\n  difficulty：基础\r\n  copyrightStatus：自有\r\n  aiGenerated：true\r\n  verifiedByTeacher：false\r\n  usageNotes：【AI 生成，入库前请人工验算】老师逐题算过后把\r\n              verifiedByTeacher 改为 true，并删掉标题里的标注\r\n\r\n■ 示例③（教辅原题）\r\n  resourceId：R-Q003\r\n  title：某教辅八年级一次函数专题（仅记出处）\r\n  resourceType：题目\r\n  knowledgePoint：一次函数应用\r\n  difficulty：提升\r\n  copyrightStatus：仅存索引\r\n  usageNotes：某教辅 八年级上 第 46 页 第 7 题。不录入题干，\r\n              用时请翻书。\r\n```\r\n\r\n⚠️ 不记\"预估 P（难度系数）\"。一对一场景下没有可靠的群体作答数据，凭感觉填一个 0.65 只是给数字披了层专业外衣；`difficulty` 四档已经够用。\r\n\r\n---\r\n\r\n## 三、讲评话术\r\n\r\n```text\r\n■ 用途\r\n  · 错题讲评、行为反馈、课堂过渡\r\n\r\n■ 入库要求\r\n  · resourceType = 讲评话术\r\n  · knowledgePoint 或对应的错因维度（shared/vocab.md §1 四维）\r\n  · usageNotes 记效果事实\r\n\r\n■ 示例\r\n  resourceId：R-P001\r\n  title：概念模糊类错题的开场提问\r\n  resourceType：讲评话术\r\n  knowledgePoint：通用（概念模糊）\r\n  copyrightStatus：自有\r\n  usageNotes：话术——\"这道题的关键是 [概念]，你能用一句话\r\n              给我讲一遍这个概念吗？\"\r\n              上周某学员用过：能复述定义但说不清适用条件，\r\n              据此判断为概念模糊而非计算失误。\r\n```\r\n\r\n⚠️ 效果只写发生了什么，不写\"80% 学员能复述\"这类没有出处的比例。\r\n\r\n---\r\n\r\n## 四、错因案例\r\n\r\n```text\r\n■ 入库要求\r\n  · resourceType = 错因案例\r\n  · 错因维度取 shared/vocab.md §1 四维（老师端七类先映射回四维）\r\n  · 完全脱敏：代称与学员卡的 alias 不同，学段模糊，无学校/日期细节\r\n\r\n■ 示例\r\n  resourceId：R-E001\r\n  title：用算术法硬解方程问题（方法用错）\r\n  resourceType：错因案例\r\n  knowledgePoint：一元一次方程应用\r\n  copyrightStatus：自有\r\n  usageNotes：背景——某初中学员，列方程题一律改用算术法倒推，\r\n              绕三四步后出错。\r\n              维度——方法用错（teacherCategory：策略错误）。\r\n              应对——先画线段图找等量关系，再要求必须设未知数。\r\n              效果——两周内三道同类题，前两道仍倒推，第三道自己设了\r\n              未知数并做对；按 shared/vocab.md §5 还需再一次独立验证\r\n              才算攻克。\r\n              脱敏检查：✅ 无姓名/学校/日期/家长信息，代"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"把独立教师散在文件夹、微信收藏和笔记本里的讲义、题目、讲评话术、错因案例收进一个可检索的库。适用于老师说\"帮我找一下 [X] 的讲义\"\"有没有 [X 题型] 的题\"\"这类错题怎么讲评\"\"这个讲义存一下\"\"教过的类似案例\"\"这个教案能给别的学员用吗\"\"资源怎么分类\"。流程：入库时打标签与版权状态 → 按知识点/难度检索 → 改编适配后复用 → 记录用过几次、效果如何。本 SKILL 不出题、不备课、不批改、不联系家长——只管资源的存、找、改；AI 生成的题必须老师验算后才算入库。 Skill: 教学资源复用库 Owner: qizhitang Summary: 把独立教师散在文件夹、微信收藏和笔记本里的讲义、题目、讲评话术、错因案例收进一个可检索的库。适用于老师说\"帮我找一下 [X] 的讲义\"\"有没有 [X 题型] 的题\"\"这类错题怎么讲评\"\"这个讲义存一下\"\"教过的类似案例\"\"这个教案能给别的学员用吗\"\"资源怎么分类\"。流程：入库时打标签与版权状态 → 按知识点/难度检索 → 改编适配后复用 → 记录用过几次、效果如何。本 SKILL 不出题、不备课、不批改、不联系家长——只管资源的存、找、改；AI 生成的题必须老师验算后才算入库。 Tags: latest:2.11.1 Version history: v2.11.1 | 2026-10-08T16:43:03.590Z | user v2.11.1：详见仓库 docs/changelog.md v2.11.0 | 2026-10-08T08:24:","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":556,"uniquenessScore":61,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-10T15:33:19.682Z","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-10T15:33:19.682Z","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-10T17:40:16.830Z","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"}]}}}