🎓 小智伴学 · SKILL 库

面向中国 K12 的 AI 学习与教学 SKILL 集合 — 学生端 · 老师端 作者：小智伴学 ｜ 适用平台：WorkBuddy / SkillHub · OpenClaw / ClawHub ｜ 当前版本：v2.12.0 全库 83 个 SKILL（学生端 49 + 老师端 34）+ 1 个开发者工具，299 份 references、6 份共享约定、4 份 JSON Schema（含 8 份示例）、3 个校验脚本。

传统 AI 容易被当成"给答案的计算器"。这套 SKILL 库的目标，是把 AI 变成追问思路的教练和减轻教师重复劳动的助手，并让学生、老师、家长三方在明确授权的前提下共享必要的学习证据。

适用范围（校外培训）：本库学科技能涉及的道德与法治、语文、历史、地理、数学、外语、物理、化学、生物学，在义务教育阶段的校外培训中都按学科类管理，面向普通高中学生的学科类培训参照管理。学生端与学校老师端照常使用。独立教师包（一对一、小班）用于有偿的学科类校外培训时，只在合法范围内使用：面向中小学生的学科类校外培训须经审批，各地已不再审批新的面向义务教育阶段学生和普通高中学生的学科类校外培训机构；未经审批以"一对一""一对多"等形式有偿开展的属违法情形；在职中小学教师不得有偿补课。在合法范围内，面向中小学生（含普通高中学生）的校外培训不与学校教学时间冲突，线下结束不晚于 20:30、线上不晚于 21:00，不给学员留作业，一次收费的时间跨度不超过 3 个月，也不超过 60 课时；面向义务教育阶段学生的学科类培训另外不占用国家法定节假日、休息日和寒暑假，线上每课时不超过 30 分钟、课程间隔不少于 10 分钟，面向普通高中学生的这几条参照执行。技能本身不预设周末、节假日、寒暑假排课，不预设课时包规模、优惠与推荐返利，也不制作招生广告；是否合规由使用者按当地规定判断。口径见 shared/contracts/off-campus-training.md。

---

🧭 设计底座（先读这六份）

全库所有 SKILL 只引用以下共享约定，不再各自定义术语、阈值或降级规则：

安全与隐私边界见 SECURITY_BASELINE.md。

---

📦 目录结构

xiaozhi-skills/
├── shared/          共享约定源文件（词表 / 平台 / 危机 / 提示阶梯 / 出题自检 / 学段）
│                   —— 由 npm run sync:shared 同步进每个 SKILL 目录，使单技能包自包含
│   └── contracts/   跨学科契约源文件（实验安全），只分发给引用它的 SKILL
├── student/         学生端 49 个 SKILL
│   ├── general/     通用学习 13 个
│   ├── chinese/     语文 5 个（小学高段 + 初中 + 高中必修与选择性必修）
│   ├── math/        数学 5 个（初中 + 高中必修与选择性必修）
│   ├── english/     英语 5 个（小学高段 + 初中 + 高中必修与选择性必修）
│   ├── physics/     物理 5 个（初中 + 高中必修与选择性必修）
│   ├── chemistry/   化学 5 个（初中 + 高中必修与选择性必修）
│   ├── history/     历史 3 个（初中 + 高中）
│   ├── biology/     生物 5 个（初中 + 高中必修与选择性必修）
│   └── geography/   地理 3 个（初中 + 高中）
├── teacher/         老师端 34 个 SKILL
│   ├── general/     通用教学 6 个（小学中段–高中）+ schemas/
│   ├── independent/ 独立教师日常 8 个 + schemas/
│   ├── chinese/     语文教学 3 个（小学高段 + 初中 + 高中）
│   ├── math/        数学教学 3 个（初中 + 高中）
│   ├── english/     英语教学 3 个（小学高段 + 初中 + 高中）
│   ├── physics/     物理教学 3 个（初中 + 高中）
│   ├── chemistry/   化学教学 3 个（初中 + 高中）
│   ├── history/     历史教学 2 个
│   ├── biology/     生物教学 2 个（含生地学业水平考试复习规划）
│   └── geography/   地理教学 1 个
├── tools/           开发者工具（SKILL 编写工具，非学生学习任务）
├── evals/           回归用例（84 份，不进发布包）
├── scripts/         CI 校验与回归运行脚本
└── docs/            架构、安装指南、版本历史、评估报告

---

🗂️ SKILL 一览

学生端 · 通用（13）

学生端 · 学科专项（36）

学科 SKILL 默认基线为初中；小学高段可用的已在 metadata.grade_bands 中标明，超出学段的内容在正文中带 ⚠高中 标注。语文、数学、物理、化学、英语的学生端声明了高中学段：高中章节按高中课标写，不逐行标注，目前语文覆盖必修与选择性必修（选修课程不覆盖；卷面题型名与作文字数按本地考试说明，不说成课标要求），数学覆盖必修与选择性必修（选修课程，以及必修与选择性必修以外的方法不覆盖），物理覆盖必修与选择性必修，化学覆盖必修与选择性必修（选修课程不覆盖），英语覆盖必修与选择性必修（选修提高类的倒装、强调等只求读懂）。化学开课的年级各地不同，技能先问学校教没教过，不按年级号一刀切（shared/grade-bands.md §四）。历史三个学生端技能同样覆盖初中与高中，高中覆盖必修与选择性必修（选修课程不覆盖），按选科定合格考或等级考的深度，史事与评价口径以课程标准和统编教材为准（SECURITY_BASELINE.md 4.4）。生物、地理的学生端同样覆盖初中与高中：初中兼顾学业水平考试（会考）的复习，高中按选科定合格考或等级考的深度，其中生物覆盖必修与选择性必修（选修课程不覆盖；课标没写的教材说法与试剂不说成课标要求），地理覆盖必修与选择性必修（选修课程不覆盖；课标没点名的地貌类型、天气系统名称、案例区域与国家战略以所用教材为准）；生物涉及人体健康的内容不做诊断，地理用教材地图或标准地图，不绘制国界与行政区划（SECURITY_BASELINE.md 4.4）。

老师端（34）

开发者工具

---

🔌 数据契约

跨 SKILL 的数据流动只能走以下四份 schema，任何 SKILL 正文中的接口路径都必须是这些 schema 中真实存在的字段（由 CI 校验）：

---

🛡️ 安全与授权

• 授权分主体：档案与情绪记录区分"学生本人 / 监护人"；小学各学段必须监护人同意；学生与家长共用会话时先确认说话人。
• 家长可见内容有门控：parentSharingConsent 控制学习摘要，emotionSharingWithParent 单独控制情绪内容。
• 危机例外优先：出现自伤、轻生、霸凌、家庭安全等信号时，所有 SKILL 立即停止本流程，按 shared/crisis-exception.md 处置，不做低敏美化；家庭安全类信号（伤害可能来自家里）不提示监护人、不写进家长可见的内容：学生端建议告诉家庭以外信任的大人；老师端按学校或机构的学生保护流程报告，学校、机构没有及时报告的老师自己报告，独立教师直接向公安机关报告。家长、监护人自己说打了孩子的，也按这一类处理：不说教、不吓唬，也不当作没听见，先问孩子有没有受伤，说清打骂解决不了问题、法律也要求家长用文明的方式教育孩子、不允许家庭暴力，这件事不记档案；老师端照样报告，回家长的消息在学习安排之外只加一句不带指责的劝阻，孩子受了伤、经常挨打的先报告，回不回、怎么回听学校（机构）和公安的。
• 控制入口：每个持有数据的 SKILL 都提供查看 / 更正 / 删除 / 暂停 / 共享控制 / 导出六项口令。
• 最小化记录：不记真实姓名、联系方式、住址、证件、医疗与家庭信息；学员一律化名或座号，讲评投影原卷先遮住姓名、学号与分数。用户主动发来这类信息时，不写入，并提醒下次不必发。
• 小学须有成人在场：小学各学段须有家长或老师陪同使用（shared/vocab.md §8 规则 4）。
• 考试中不讲题：学生说明正在考试或测验时不讲该题，约好考完再复盘；考完的题照常讲（shared/hint-ladder.md §〇）。
• 试题保密：启用前的统考试题属国家秘密，会出题、组卷或存卷的老师端 SKILL 不接收、不入库（SECURITY_BASELINE.md 4.2）。
• 实验安全：理化生与地理实验的 safetyLevel 三档、跨学科硬红线与化学、生物必守规范只在 shared/contracts/lab-safety.md 定义一次。不给学生在家操作的危险实验步骤（含培养微生物、采集血液），不指导混用家用化学品，高档实验只讲不练、由老师演示；要敞口使用、灌装或转移水银的实验（如托里拆利实验）只看教材插图或视频。
• 内容边界：历史技能的评价与史观以课程标准和统编教材为准，不替学生给观点、不引入争议性解读；开卷答题教练只教方法，不产出道德与法治的观点性内容；生物技能涉及人体健康的内容以教材为准，不做诊断、不给用药建议；地理技能用教材地图或标准地图，不绘制、不修改国界与行政区划；老师通用技能对道德与法治、思想政治只给工具层（框架、格式、课堂组织、统计），不生成题目（老师给出的教材原文可以改排成填空题）、参考答案、评分要点与观点（SECURITY_BASELINE.md 4.4，CI 项 B1）。
• 不承诺提分：不输出"预期提分 X 分"或"治愈焦虑"类表述。

---

📜 政策对标

---

🤝 在 WorkBuddy 中使用

本库已上架 WorkBuddy 官方技能市场 SkillHub（skillhub.cn）。

最省事的装法是在对话里直接说：

安装 小智伴学 智能错题本

需要整套使用、或要改内容时，建议整库安装以保持目录结构（全库有 707 处 shared/ 引用与 39 处跨 SKILL 引用，都相对仓库根目录）：

git clone https://github.com/qizhitang/xiaozhi-skills.git ~/.workbuddy/skills/xiaozhi-skills

之后在 WorkBuddy 里执行 /reload-skills。

每个技能包都自带 shared/ 六份共享约定，跨技能引用的契约与参考资料也按需随包分发，单技能安装已完全自包含（npm run check 逐一核对全部 84 个技能：SKILL.md、references/ 与 shared/ 中写到的路径都落在本技能目录内）。完整说明（安装位置、触发与指定、更新卸载、能力降级、装后验证）见 安装指南。

---

✅ 校验

npm install
npm run check

推送与 PR 时由 GitHub Actions（.github/workflows/check.yml）自动跑同一套校验。

行为层回归不进 npm run check（要 API key、非确定）：ANTHROPIC_API_KEY=... npm run evals:run [skill...] 把 SKILL.md 喂给模型逐条对话并判卷，报告在 evals/report/。格式与写法见 evals/README.md。

---

📚 更多文档

• 技能索引 — 全库 84 个技能的显示名 / 目录 / 学段 / 依赖，由 npm run docs:gen 从 frontmatter 生成
• 🏛️ 系统架构与方法论 — 完整清单、协作架构、方法论依据、目录树
• 🗺️ 安装指南 — WorkBuddy 安装方式、分阶段安装路径与打包建议
• 🔄 版本历史 — 版本演进与本轮变更
• 📋 评估报告 2026-09 — 本轮问题清单与优化路线图
• 🧭 学科扩展路线图 — 按各地中考与高考学科要求重排：物理高中化、化学、历史、高中生物与地理、数学高中化、英语高中化、语文高中化（第零批随 v2.1.13、第一批随 v2.2.0、第二批随 v2.3.0、第三批随 v2.4.0、第四批与第五批随 v2.6.0、第六批随 v2.7.0、第七批随 v2.8.0、第八批与第九批随 v2.9.0、第十批随 v2.10.0 发布）

---

💡 小智寄语： “工具不是装得越多越好。先把错题本用熟，再谈其余。 真正有用的，是你自己想明白的那一步。”