前言¶
解析班级成绩表这件事看起来简单，实际很容易出错：一次考试一个文件，文件名可能重复，列的类型（姓名、学号、分数、总分、名次）要靠猜，改完格式还要重新给家长发链接。更麻烦的是规则不固定——这次按分数排序、下次按学号排，列宽一会儿用字符一会儿用像素，权限有时公开有时私有。结果是每处理一次都要重新做一遍约定。
下面介绍的 Skill 把这套流程固化成一个唯一事实源：它自己定义目录约定、去重方式、审阅步骤、云文档更新方式和权限默认值，处理成绩时按同一套规则执行，规则不再随每次操作漂移。
这是什么¶
班主任助手（成绩管理）是一个社区发布的 Agent Skill，坐标 @user_cf809658/grade-manager，当前版本 1.0.1，分类 office-efficiency，由社区发布者 user_cf809658 维护。
它解决的问题是：把班级考试成绩汇总 Excel 解析成每位学生的历次成绩档案，档案同时落在本地 Excel 和腾讯文档在线表格里，并通过 tencent-docs 连接器同步到教师本人的云文档。初次分享给家长的链接不用改，之后历次成绩会自动更新到同一份云文档中。
它把完整工作流写进 Skill 自身，包括目录约定、按文件名去重、审阅确认、原地更新云文档不删除、列宽用像素单位、权限默认保持私密。这些约定不再依赖使用者每次回忆或临时约定。
核心功能¶
- 解析班级考试成绩汇总 Excel，生成每位学生的历次成绩档案。
- 档案同时产出本地 Excel 与腾讯文档在线表格两份。
- 经 tencent-docs 连接器同步到教师本人云文档。
- 初次分享给家长后，该链接对应的云文档可以自动更新学生历次成绩，无需重新分享。
- 内置唯一事实源工作流：目录约定、按文件名去重、审阅确认、原地更新云文档不删除、列宽像素单位、权限保持私密。
需要说明的是，官方简介未列出支持的 Excel 版本、单表行数上限、是否支持多 sheet 或多班级混排。这些参数以 Skill 文档和实际文件为准，本文不推测。
安装与启用¶
官方页面地址：
https://api.skillhub.cn/user_cf809658/grade-manager
SkillHub 页面：
https://www.skillhub.cn/skills/user_cf809658/grade-manager
坐标与标签：
坐标: @user_cf809658/grade-manager
版本: 1.0.1
来源: community
分类: office-efficiency
标签: requires_api_key=true
启用方式需要注意两点：
requires_api_key=true表示该 Skill 需要配置 API key。 tencent-docs 连接器也需要对应的授权凭据，未完成授权时同步类操作不会成功。- 官方页面在抓取时未能返回正文内容，因此本文不提供未经核实的安装命令或配置字段名。请以官方页面上的启用说明为准，不要照抄二手教程里的命令。
典型用法¶
以下用法来自官方简介中列出的触发场景，具体参数以 Skill 文档为准。
输入成绩汇总 Excel 后，让 Agent 解析并生成成绩单：
上传或引用班级考试成绩汇总 Excel，要求解析并生成学生历次成绩档案
直接点名 Skill：
使用班主任助手处理这次考试成绩，生成成绩档案并同步云文档
判断成绩表的列类型，再决定如何写入档案：
判断这份成绩表的列类型（姓名/学号/各科分数/总分/名次）
完成本地档案后同步到教师本人云文档：
把生成的成绩档案通过 tencent-docs 同步到我的云文档，权限保持私密
工作流上，按 Skill 自身约定执行：先按目录约定读取文件，再按文件名去重，然后做一次审阅确认，最后原地更新云文档、不删除旧内容。列宽以像素单位设置，权限保持私密。
适用场景与注意¶
适合的人：
- 需要把多次考试成绩整理成每人一份历次档案的班主任或任课教师。
- 希望家长通过一个固定链接看到孩子历次成绩的人。
- 希望把成绩处理规则固定下来、避免每次操作口径不一致的人。
限制与坑：
- 依赖腾讯文档连接器，凭据或授权失效时同步会失败，本地 Excel 仍会生成。
- 按文件名去重，同名文件会被当作同一文件处理；如果文件命名习惯不好，需要先规范命名。
- 原地更新云文档不删除，意味着历史内容会累积，首次使用前建议先确认目标云文档是专用文档。
- 权限保持私密是 Skill 的默认约定，初次分享给家长后要按实际需要单独调整可见范围。
- 官方页面目前未能稳定返回正文，安装前建议在官方页面确认最新版本与授权要求。
结尾¶
这套 Skill 的价值不在于多了一个 Excel 解析脚本，而在于把目录约定、去重、审阅、原地更新、列宽单位、权限这些容易漂移的规则收进同一个 Skill，让每次处理成绩都走同一套流程。如果你的工作流正是”成绩汇总表 → 学生历次档案 → 腾讯文档在线表格”，可以从官方页面开始试用。
https://api.skillhub.cn/user_cf809658/grade-manager
