前言¶
解析班級成績表這件事看起來簡單，實際很容易出錯：一次考試一個文件，文件名可能重複，列的類型（姓名、學號、分數、總分、名次）要靠猜，改完格式還要重新給家長髮鏈接。更麻煩的是規則不固定——這次按分數排序、下次按學號排，列寬一會兒用字符一會兒用像素，權限有時公開有時私有。結果是每處理一次都要重新做一遍約定。
下面介紹的 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
