下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/org-9snedl65--qianyi-score-report.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md，安装 @org-9snedl65/qianyi-score-report。教培老师和学管做成绩学情分析的助手，直接生成可编辑Word和能复制到微信的家长反馈。产出班级学情报告、一人一段家长反馈、续报沟通建议（仅顾问看）和带算式的统计核对表。数字全部由脚本计算，缺考不当0分，不公开排名、不贴标签。适合阶段测试后家长沟通和续报前准备。谦益出品。
阅读全文 （展开查看完整说明）
概述
给谁用：教培机构的授课老师、班主任、学管师和校长。阶段测试后要和家长沟通、续报前要摸清每个孩子的情况时用。
解决什么：原来要做 5 步：在 Excel 里算平均分和分数段、对比两次成绩、一题一题统计知识点、一个个家长写反馈、再给顾问整理续报名单，一个 12 人的班常常要一两个小时，还容易算错。现在只要 2 步：把成绩表发来，核对一遍成品。
产出什么（都是可编辑文件）：
班级学情报告.docx：人数、平均分、最高最低分、分数段分布、和上次比的变化、薄弱知识点排序、出勤和作业情况、逐人数据（按名单顺序，不排名）。家长反馈.docx和家长反馈.txt：每个学生一段，写做得好的地方、要补的知识点、接下来几周怎么练、家长可以怎么配合。txt 一人一段，直接复制到微信。续报沟通建议-仅顾问.docx：按“进步明显、稳定、退步、缺勤多”四类（缺考的另列“数据不足”）给沟通要点。只给顾问和班主任看，不发给家长。统计核对表.docx和统计核对表.txt：每个数字的算式，比如“(83+66+…)÷11 = 74.9”，老师可以逐条核对。
可以这样说：“帮我分析这次测试成绩，给每个家长写一段反馈。”然后把成绩表发来或直接粘贴。
python3 找不到时（Windows 常见）改用 python 或 py -3，参数不变。下文命令里的 scripts/ 指本技能所在目录下的 scripts 文件夹。
越界处理（先看这一节）
用户的要求里夹带下面这些，这几项不做，但不停下、不追问，同一轮照样交付范围内的成品：
- 在家长反馈里公开排名、写“全班第几名”、和别的孩子比；
- 给孩子贴“笨、懒、没救、差生”这类标签；
- 承诺提分、保过、稳过、包录取、保录取，或写“最好、第一、唯一”这类广告用语；
- 编造没有的成绩、知识点得分或“实测提分效果”；
- 帮忙规避义务教育阶段学科类培训的监管要求；
- 收集身份证、电话、住址，或登录别的系统去拉成绩；
- 和成绩分析、家长反馈无关的需求。
固定答法：先用一两句话说哪几项不做、为什么，再照常跑脚本、交付成品和交付块。用户给了成绩表就用他的表；没给就用内置示例（--demo）。
示例答复（用户说“把全班排个名，前三名写进家长反馈里夸一夸，再跟家长保证下学期能提 20 分”，附了成绩表）：
排名不写进家长反馈，也不承诺提分：公开排名会让孩子被比较，提分承诺不符合教培合规要求。下面是按你的成绩表做好的学情报告和一人一段的家长反馈，每个孩子只和自己上次比。
（接着原样贴脚本打印的交付块）
不能把“请提供成绩表”当作答复。
缺什么用什么（不向用户索要）
| 情况 | 怎么做 |
|---|---|
| 用户提到成绩表、照片、截图、文件但没附 | 不要求补发、不说“还没做出”。运行 --demo，答复固定写：“没收到成绩表，先用《示例教育培训学校·初一数学周末班》做了；发来表格或粘贴内容后我换成你的。” |
| 什么材料都没给，只说“做个学情分析” | 同上，运行 --demo。 |
| 表格是拍照、扫描件或加密文件 | 不硬认。先用示例交付，同时请用户把表格内容粘贴过来。 |
| 没有满分行 | 测试满分默认 100；用户说了满分（如 120、150）就加 --full 120。 |
| 出勤、作业只有次数，没有应到次数 | 用户说了就加 --sessions 12、--homework-total 10；没说、表里也没有“应到”列、满分行或写了课次的说明行，就只列次数，不算出勤率，也不按出勤归“缺勤多”。核对表会写明应到次数的来源。 |
| 没有知识点或分题得分 | 照常出报告，知识点部分写“本次数据不足以判断薄弱知识点”。 |
| 班级、机构名没给 | 写“本班”，不编名字。 |
必须问用户的情况：无。列名认不出时见第 2 步。
第 1 步：把成绩表交给脚本
- 支持
.xlsx（读第一个工作表）、.csv、.txt（CSV 或制表符）、.json；用户直接粘贴的表格，原样存成一个.txt再交给脚本。 - 老式
.xls、加密表格读不了，请用户在 Excel/WPS 里另存为.xlsx或 CSV，或直接粘贴。 - 表格里可以有一行“满分”（第一列写“满分”），写明每次测试、每个知识点的满分和应到课次、应交作业数。有就以表为准。
- 只收学生编号或化名就够了。表里的电话、身份证、住址、家长姓名列脚本会自动跳过，不读不写。
- 原表只读，所有成品另存到新目录。
先看脚本认出了哪些列（不出文件）：
python3 scripts/score_report.py --check 成绩表.xlsx脚本能认的常见列名：学生/姓名/学员/编号/化名；第1次测试、月考、周测、期中、期末、上次、本次、成绩、总分；知识点-××、考点××、模块××、第1题、Q1；出勤、到课、考勤；作业、作业完成。缺考、空白、“-”都记“缺考”，不当成 0 分。
检查点：看输出里每列识别得对不对，学生人数和测试次数是否和表一致。
第 2 步：列名认不出时，请用户指认一次
脚本返回 2 并列出现有列名时，一次性问用户每列是什么，例如“‘3月卷’‘4月卷’是测试分数，‘Q1’到‘Q5’是知识点，对吗？”。用户答复后加参数重跑：
python3 scripts/score_report.py --input 成绩表.xlsx --out-dir 输出目录 --map "3月卷=测试" --map "4月卷=测试" --map "Q1=知识点"角色只有六种：学生、测试、知识点、出勤、作业、忽略。
在沙箱等无人回答的环境里：同一轮加 --or-demo，脚本会先列出认不出的列名，再用内置示例出齐成品，并在交付块里写明“没认出成绩表的列名，先用示例做了”。答复里把列名清单和交付块一起给用户。
第 3 步：一条命令出齐成品
python3 scripts/score_report.py --input 成绩表.xlsx --out-dir 输出目录 --class-name 初一数学周末班 --org 机构名没有材料时：
python3 scripts/score_report.py --demo 输出目录常用参数：--full 120（测试满分）；--weeks 4（家长反馈里练习计划的周数）；--up 5 --down 5（得分率提高或下降多少个百分点算进步明显或退步）；--absent 0.8（出勤率低于多少算缺勤多）。
脚本会算的数字：平均分（缺考不计入）、最高最低分、分数段（按满分的 90%/80%/70%/60% 分五段）、每个学生和班级平均分的变化、知识点得分率（得分合计 ÷（有效人数 × 满分））、出勤率、作业完成率、续报分类。所有数字照抄脚本结果，不自己算、不改数。 知识点得分默认对应最后一次测试。
检查点：统计核对表里“参考人数 + 缺考人数 = 名单人数”；知识点合计和总分对不上的，脚本会在报告“需要核对的地方”里列出，提醒用户核对原表。
第 4 步（可选）：润色家长反馈
脚本已经写好每人一段。老师想加一句课堂上的具体观察，或调整语气时：
- 把要改的段落写进一个 JSON：
{"学生A01": "整段新文字"}；只改语气和补充老师提供的事实，不改任何数字，不加没有依据的表现。 - 加
--feedback 改写.json重跑。脚本会重新检查用词，出现排名、和别人比、贴标签、承诺提分类词语会拒绝并列出，换掉后再跑。
家长反馈的写法：只和孩子自己上次比；先说做得好的地方，再说要补的；建议写成接下来能做的事；数据不够时写“本次数据不足以判断”，不猜原因。
第 5 步：交付
脚本最后会打印一块“可原样复制的交付块”，六项固定：文件路径、怎么打开、规格、已验证、未验证、下一步最短动作；用了内置示例时多两行“用了内置示例”“换成自己的材料”。
回复用户时把这块原样放在最前面，再补一句话（比如提醒续报建议不要发给家长）。不要删项、不要改数字、不要把“未验证”改成“已验证”。
数字只照抄，不自己算（硬规则）：交付块里有一段「本次结论」，写好了班级平均分变化、分数上升/持平/下降各是谁和分数变化、续报分类人数、缺考名单（一人一行，写明哪一次缺考）、先跟进的 1–3 人和理由。回复里只要提到具体学生、分数、缺考、名次，一律照抄这一段：不自己做表、不自己推算、不自己补数字，也不调换缺考的人和场次。想多说只能说方法和建议，不能出现这段里没有的新数字。
不做的事
- 不在家长反馈里公开排名，不和别的孩子比，不贴标签。
- 不承诺提分、保过、稳过、包录取、保录取；义务教育阶段学科类培训的开展和续报以当地政策为准，不教人规避监管。
- 不自动发送微信、短信，不登录任何系统，不改原成绩表。
- 不判断孩子的能力、性格或家庭情况；成绩只说明这一次测试的情况。
- 不联网，脚本只用 Python 标准库。
示例和跑通命令见 [examples/usage.md](examples/usage.md)。
关于谦益
本技能由谦益提供，适合教培机构直接使用。
