Tw Wayground Skill — Development skill for Claude Code

tw-wayground-skill 使用手冊

Wayground（原 Quizizz）教學資源 Skill。它將具來源追溯與命題藍圖的測驗 JSON 轉成 `.xlsx`、`.quality.json`、`.readiness.json`，並提供正常 Chrome 的試算表匯入、PPTX 簡報教材轉換、草稿核對與發布前停點。

事前條件

• Node.js 18 以上；先在本資料夾執行 npm install。
• 可定位的教材來源、明確受測者（年級、程度、語言、先備能力）、學習目標、用途及藍圖。
• 以 assessment-brief.example.json 為起點，填入自己的資料後才命題。

標準使用與報告

npm install
node scripts/build-xlsx.mjs quiz.json out.xlsx

檔案	用途
out.xlsx	教師手動匯入的 Wayground 試算表。
out.quality.json	只有 status: "ready" 可交付；含阻擋原因、warning、逐題追溯與藍圖摘要。
out.readiness.json	匯入格式的 ready/skipped、媒體、長度與空格提醒。

assessment v1 輸入契約

Quiz 需有 `title`、`questions[]`、`assessment.version: 1`。`assessment.sources[]` 每筆都有 `id/title/locator`；`audience` 有 `gradeLevel/proficiency/language/prerequisites[]`；`objectives[]` 每筆有 `id/text`，另有 `purpose`；`blueprint[]` 每格有 `objectiveId/cognitiveLevel/difficulty/count`。每題有 `sourceRefIds[]`、`objectiveIds[]`、`cognitiveLevel`、`difficulty`。

認知層次：`remember`、`understand`、`apply`、`analyze`、`evaluate`、`create`；難度：`basic`、`developing`、`proficient`、`advanced`。所有題目必須能回查登錄的來源與目標，藍圖總數和每一格實際數量都要吻合。選擇題至少有一個正解，單選題剛好一個；`explanation` 雖非阻擋欄位，應提供給教師審核與回饋。

缺資料、未知來源／目標、錯誤答案鍵或藍圖不符時會以 `assessment-quality-blocked` 停止。這不是可由「快要上課」覆寫的提醒，而是先補 brief 的信號。

Wayground 匯入提醒

支援 `multiple_choice`、`multiple_select`、`true_false`、`fill_blank`、`short_answer`、`open_ended`、`poll`，選項最多五個。只有圖片可放入 Image Link；其他媒體需在編輯器補加。多個填空標記無法由單列格式完整表達。請完整查看 warnings。

教師操作：Wayground → Create → 評估 → 匯入工作表／問題 → 切到「試算表」分頁 → 上傳 `out.xlsx` → 在未發布草稿核對每題 → 審慎確認 metadata 與能見度後，再由教師決定發布、指派或 Live。不要將此工具描述成會代替教師執行平台操作。

Wayground 另有簡報／文件教材入口：`/admin` → `上傳` → `裝置`（或 Google 雲端硬碟）→ 選取 PPT／PPTX／PDF → 選「投影片」→「下一個」→選教學目標→`Create resource`。成功判定是回到 `/presentation//edit` 並能核對投影片數；頁面目前顯示上限 50 MB、最多 100 頁。這與 XLSX 試算表匯入是兩條不同流程。

正常 Chrome 登入與錄製後銜接

Google 登入必須由教師在平常使用的正常 Chrome 個人檔案中完成；不要讓自動化瀏覽器、嵌入式 We