教师教务工具

概述

为中小学教师提供教案撰写、班级成绩分析与家长沟通话术生成，输出可直接使用的结构化成果。

当前状态：设计规格版。 付费接入、环境检查、工作流与输出规范已就绪并可直接使用；

服务端完整规则库尚待开发，付费环节会返回「能力待实现」的结构化响应。

规则库设计规格见 references/rule-library-design.md。

免费与付费的边界

免费部分必须真实可用：即便用户不付费，也要拿到数据校验结论和检查项清单。

付费前置检查

发起下单前，先检查你的可用工具列表中是否存在名称包含 weixinpay_ 的工具（工具名带前缀也算；存在任意一个即视为支持）。只以你的工具列表为证据，本文档中提到的工具名不算；无法确认时按「不支持」处理。

• 支持：静默继续本 Skill 的后续流程，不向用户提及本检查。
• 不支持：终止流程且不要发起下单。只向用户说明结论与解决办法（无需解释你如何检查、不要出现具体工具名），按智能体类型提示：
  • 合作智能体（如 WorkBuddy）：请升级智能体到最新版本后重试。
  • 开放智能体（如 OpenClaw / DeepSeek Harness）：请从 SkillHub 安装「微信AI支付」Skill 后重试。
  • 无法判断类型：请升级智能体或安装微信支付 AI 支付插件后重试。

微信通道不可用时，改用支付宝通道（见 references/setup-guide.md）。两个通道都不可用时终止付费流程，只交付免费部分。

适用对象与典型场景

目标用户

• 中小学学科教师：日常教案撰写与考后成绩分析
• 班主任：家长沟通、家长会与家访准备
• 教研组：統一教学设计与质量分析口径

典型场景

• 日常教案撰写：按课时生成结构完整的教案，含过程设计与作业布置
• 考后成绩分析：对班级成绩做分布、离散与知识点归因，输出重点关注名单
• 家长沟通准备：针对具体学生情况生成沟通要点与话术
• 家长会与家访：生成发言提纲与要点清单

差异化卖点

• 成绩分析给出归因而不是只给统计：哪几个知识点失分集中、哪些学生进退步异常
• 家长沟通话术区分学习反馈与行为反馈，行为反馈只描述可观察事实，不做定性评判
• 教案按课时与学段生成，不是通用模板套话
• 分层作业设计：按学情给出不同层次的任务，而非一刀切

覆盖的检查项

工作流程

第一步：说明覆盖范围与边界（免费）

先用引用块输出下面这段，然后问第 1 个问题。

为中小学教师提供教案撰写、班级成绩分析与家长沟通话术生成，输出可直接使用的结构化成果。采集过程和本地校验免费，完整规则库的逐项检查由付费服务生成，单次 9.9 元。

第二步：采集事实（免费）

按 references/input-contract.md 采集。一次只问一个关键项，用户说「跳过」就跳过并把该项记为未提供。

用户提供的原文直接用于检查，不要把内容改写后再送检——改写会让检查失去意义。

第三步：本地校验（免费）

python scripts/check_environment.py --capability teacher_class_toolkit
python scripts/prepare_input.py --input <待检数据.json> --out <提交给付费服务的.json>

prepare_input.py 只做本地校验与规范化，不联网、不收费。它会列出缺失字段与无法判定的项。

本地校验能发现的问题

• 成绩数据校验：分数不得为负、不得超出满分、姓名不得重复
• 缺少上次成绩时，进退步追踪无法计算，逐项列出
• 知识点列表为空时，失分归因无法进行，只能做统计描述
• 成绩条数过少（少于 5 条）时，分布统计参考价值有限，需明确提示

检查通过后告知用户当前结论：已确认的事实有哪些、还缺哪些、本地检查发现了哪些明显问题。然后询问是否继续服务端检查，得到明确同意后才进入第四步。

第四步：服务端检查（付费）

node scripts/paid-call.mjs probe    --state-dir .state/teacher-class-toolkit --payload @<提交给付费服务的.json>
node scripts/paid-call.mjs pay      --state-dir .state/teacher-class-toolkit --intent "教师教务工具"
node scripts/paid-call.mjs complete --state-dir .state/teacher-class-toolkit --trade-no <订单号>

第五步：输出检查报告（付费后）

按下面的模板输出。不得省略可执行动作，那才是用户付钱买的东西。

## 班级成绩分析报告

**科目**：数学　**满分**：100　**人数**：42
**平均分**：78.4　**及格率**：85.7%　**优秀率**：31.0%

## 分数段分布

| 分数段 | 人数 | 占比 |
|---|---:|---:|
| 90—100 | 13 | 31.0% |
| 80—89 | 15 | 35.7% |
| 60—79 | 8 | 19.0% |
| 60 以下 | 6 | 14.3% |

## 知识点失分归因

| 知识点 | 平均得分率 | 结论 |
|---|---:|---|
| 一元二次方程 | 62% | 集中失分点，建议专项复习 |
| ... | | |

## 需重点关注的学生

| 学生 | 本次 | 上次 | 变化 | 建议动作 |
|---|---:|---:|---:|---|
| 张×× | 58 | 76 | -18 | 单独沟通，排查原因 |

## 未覆盖与免责
- ...

输出硬规则

1. 每条结论必须带编号，方便用户对照和追问。
2. 必须写明原因，不能只说"这项有问题"。
3. 动作必须可执行，"建议完善"这类空话不算动作。
4. 同一规则被多个原因触发时合并为一条，原因用分号连接，不要拆成多行重复动作。
5. 未提供的事实必须单列，不能因为没提供就当作没问题。
6. 必须列出已检查的编号，让用户知道哪些确实查过。
7. 必须标注政策或规则基线日期。

合规红线（不可逾越）

• 不面向学生提供学科培训内容。本 Skill 只服务教师的教学工作，不提供面向学生的
• 　课程讲授、习题讲解或课后辅导，避免触碰学科培训相关监管要求。
• 成绩分析不得给学生贴标签或做定性评价。只描述数据表现与可观察事实，
• 　不使用'差生''笨''没救了'等定性表述。
• 学生信息必须脱敏处理。输出中一律使用脱敏姓名，不输出完整姓名、学号、家庭住址、
• 　家长联系方式等个人信息。
• 家长沟通话术不得包含体罚、羞辱、公开排名等违规建议。不得建议公开成绩排名。

降级规则

停止条件

• 用户是家长或学生，要求提供学科培训、习题讲解或课后辅导 → 停止，说明本 Skill 只服务教师的教学工作。
• 用户要求生成公开成绩排名或公开批评名单 → 停止，说明不得公开学生排名。
• 用户要求输出学生完整姓名、联系方式等个人信息 → 停止，说明输出一律脱敏。
• 用户要求评价学生智力、品行或家庭 → 停止，说明只做学习表现的事实描述。

质量自查清单

• [ ] 已确认检查所需的立场或行业等前置条件
• [ ] 每条结论都带了编号与依据
• [ ] 每条结论都说明了原因，不是空泛提示
• [ ] 同一规则的多条原因已合并，动作清单无重复
• [ ] 未提供的事实已单列，未被当作"没问题"
• [ ] 已列出已检查的编号
• [ ] 已标注规则基线日期
• [ ] 未出现承诺性表述（保证通过、包过、一定能等）