前言¶
做在線課堂的老師和教研，手裏通常有一批現成的試卷、練習卷，題型是單選、多選、判斷。要把這些題搬進 QuickClass 當作業，常見做法是人工逐題敲進後臺，或者寫腳本解析文檔再拼 JSON，兩次都要對着題乾和選項覈對，出錯率不低。
下面介紹的是一個 Skill：QuickClass作業轉換器。它把這條鏈路壓縮成一步——給一份試卷（Word/PDF/圖片）或學習材料，產出 QuickClass 能識別的作業 JSON。前面省下的手工錄入時間，就是它解決的問題。
這是什麼¶
QuickClass作業轉換器是一個面向教育場景的轉換類 Skill，座標 @user_d101a129/quickclass-quiz-converter，當前版本 1.0.1，來源爲 community（社區發佈），由發佈者 user_d101a129 維護，SkillHub 分類爲 education。
它做的事只有一件：把試卷、試題、學習材料等輸入，轉換爲 QuickClass 支持的作業格式，輸入可以是文檔、PDF、圖片。
版本、來源、分類這類信息以 SkillHub 頁面爲準；頁面上沒有列出作者的其他背景，這裏不做延伸。
核心功能¶
已覈實的能力：
- 輸入類型支持文檔（Word）、PDF、圖片。
- 輸出爲 QuickClass 支持的作業 JSON。
- 支持三種題型：
SINGLE_CHOICE（單選）、MULTIPLE_CHOICE（多選）、TRUE_FALSE（判斷）。 - 標籤顯示
requires_api_key=false，按 SkillHub 頁面標註，使用該 Skill 不需要單獨的 API Key。
Skill 的觸發條件和不觸發邊界，官方描述寫得很明確，調用時要照着走：
- 用戶想生成 QuickClass 作業 JSON，或提到 QuickClass / 課堂作業 / 題目轉換 / 試卷轉 JSON 時，應觸發該 Skill。
- 用戶只是想查看或理解 JSON 結構、從 JSON 反向導出、或只討論教學內容而不生成作業時，不應觸發。
這條邊界的意義在於：它不是「能轉 JSON」的通用工具，而是「爲 QuickClass 作業生成 JSON」的專用工具。拿來做別的解析，屬於誤觸發。
安裝與啓用¶
SkillHub 頁面未列出單獨的安裝命令或配置字段。這類基於通用 SKILL.md 格式的 Skill，一般通過 SkillHub 獲取後由宿主在對話中識別觸發，具體入口以 SkillHub 頁面爲準。頁面標註的 requires_api_key=false，即沒有需要填的密鑰項。
按官方給出的觸發條件啓用即可：當需求是生成 QuickClass 作業 JSON，或對話裏出現 QuickClass / 課堂作業 / 題目轉換 / 試卷轉 JSON 這些關鍵詞時，交給該 Skill 處理。
典型用法¶
官方資料給出的可復現示例是「把試卷、試題、學習材料等轉換爲 quickclass 支持的作業格式，支持文檔、pdf、圖片等」。據此，使用路徑如下：
1、準備輸入：試卷、試題或學習材料，格式爲 Word 文檔、PDF 或圖片。
2、發起需求：說明要生成 QuickClass 作業 JSON，或直接提到題目轉換、試卷轉 JSON。
3、接收輸出：QuickClass 支持的作業 JSON，題型落在 SINGLE_CHOICE、MULTIPLE_CHOICE、TRUE_FALSE 三類。
頁面沒有給出具體的輸入樣例文件和輸出 JSON 片段，這裏不做補寫，以免與官方資料不符。
適用場景與注意¶
適合誰：
- 使用 QuickClass 佈置課堂作業、考試或練習題的老師、教研和助教。
- 需要把紙質或電子版題庫批量搬進 QuickClass 的人。
- 手上只有試卷圖片或 PDF，希望直接產出作業 JSON 的場景。
限制與坑：
- 題型只覆蓋單選、多選、判斷。填空、簡答等題型不在支持範圍內，遇到這類題需要先改成支持的題型或另行處理。
- 識別質量取決於輸入文檔和圖片本身的清晰度，掃描件模糊、排版混亂會直接影響提取結果，轉換後仍需逐題覈對題干與選項。
- 注意觸發邊界：只是想看 JSON 結構、從 JSON 反向導出、或討論教學內容而不生成作業時，不要用這個 Skill。
- 該 Skill 標註
requires_api_key=false，即不涉及額外密鑰。
結尾¶
QuickClass作業轉換器把「試卷 → 作業 JSON」這一步固定下來，輸入文檔、PDF 或圖片，輸出三種題型的 QuickClass 作業 JSON，省掉手工錄入和自寫解析腳本的成本，但提取結果仍需人工覈對。
官方地址：https://api.skillhub.cn/user_d101a129/quickclass-quiz-converter
SkillHub 頁面：https://www.skillhub.cn/skills/user_d101a129/quickclass-quiz-converter
