fw1201 學習單生成工具
設計系統 V2.0：Edu Warm × A4 格線
基於 Claude Design（2026-04-17）+ canvas-design 最少裝飾原則
A4 版面格線系統（595×842pt）
所有邊距: 72pt（1英寸）
內容欄寬: 451pt
格線 base unit: 8pt
行距建議: 1.75（閱讀舒適）
Edu Warm 學習單字型
主標題（學習單名稱）: Work Sans Bold 18pt / color: #d97757
小節標題: Work Sans SemiBold 14pt
正文/問題: Noto Sans TC Regular 12pt / line-height: 1.75
填答空格標示: Noto Sans TC Regular 12pt / color: #6B6B6B
頁碼: Noto Sans TC Regular 10pt
禁用字型：Inter、Roboto、Arial — 缺乏教育溫感，改用 Work Sans + Noto Sans TC
禁用模式：每題加邊框裝飾色條、漸層背景 — 學習單以留白與對齊勝出
HTML artifact 輸出（A4 可列印版）
學習單優先輸出為 HTML artifact（A4 比例，可直接列印）：
.worksheet { width: 595px; min-height: 842px; padding: 72pt;
font-family: 'Noto Sans TC', sans-serif;
background: white; }
.worksheet p, .worksheet li { text-wrap: pretty; } /* 防止孤字 */
@media print { .worksheet { page-break-inside: avoid; } }
canvas-design 最少裝飾原則
- 格線輔助：8pt 格線保持元素對齊，不顯示格線本身
- 色彩克制：最多 3 種顏色（Edu Warm 主色 #d97757 + 黑 + 灰）
- 空間留白：每個問題區塊之間保持 16pt 間距
Step 0：讀取文件
/mnt/skills/public/docx/SKILL.md
概念對齊協議（必要前置步驟）：
../../shared/concept-alignment.md
→ 在執行任何工作前，先完成概念對齊確認卡。
Step 1：資訊收集
- 科目、年級、課文/主題？
- 這份學習單的目的（預習/課中/複習/作業）？
- 需要哪類活動設計？
- 閱讀理解提問（三層次：字面/推論/評鑑）
- 概念圖/心智圖填寫框架
- 表格比較分析
- 仿作/創作引導
- 反思與自評
Step 2：生成學習單
python scripts/generate_worksheet.py \
--subject "[科目]" --grade "[年級]" --topic "[主題]" \
--purpose "[preview/inclass/review/homework]" \
--activities "[comprehension,concept_map,compare,writing]" \
--output "/mnt/user-data/outputs/[主題]_學習單.docx"
設計規範
- A4 直向，留白充足（學生書寫空間 > 50%）
- 標題明確，每個活動有清楚的任務說明
- 提供布魯姆層次提示（讓學生了解思考深度）
- 頁尾有班級/姓名/日期填寫欄
- 美觀排版：使用線框、底色區塊區隔不同活動
設計原則（影響學習效果的關鍵）
每頁聚焦一個核心任務 若學習單涵蓋多個概念，請切分為多頁或明確的多段。學生的注意力一次能有效處理的訊息有限，把多個任務塞進同一頁會讓他們來回切換、反而每個都學得淺。
圖文相鄰原則 說明文字與對應圖表放在相鄰位置，不分頁。純裝飾性插圖（不傳達概念的插圖）省略，視覺裝飾分散注意力而非幫助理解。
三層次題目設計邏輯
- 基礎題：確認學生是否具備先備知識
- 核心題：落在「有引導就能完成、無引導則困難」的區間
- 延伸題：讓能力較強的學生繼續探索
鷹架是可以撤除的支持 句型提示、部分填寫示例設計為可逐步移除：第一次使用 → 完整鷹架；熟悉後 → 只保留問題引導；最終目標是學生能獨立完成。
年級適應 + 引導式收集（v2.0 更新）
自動年級偵測
從使用者輸入辨識學習階段（國小/國中/高中），自動調整：
- 教學語言複雜度與詞彙難度
- 布魯姆認知層次分布
- 活動設計的自主程度
- 課綱代碼學段後綴（-E- / -J- / -U-）
詳見：../../shared/grade-adapter.md
引導式資訊收集
啟動時執行漸進式三輪問答，確保取得充足資訊再開始任務。
詳見：../../shared/guided-collection.md
MCP 連接器
Claude Code ／ Claude.ai（Pro/Team/Enterprise）
WebSearch（自動啟用）：
搜尋最新課綱資料、教材資源、時事素材
Google Drive（若已連接，Settings → Connectors）：
直接從 Drive 讀取現有教材
完成後直接儲存輸出文件到 Drive
Codex 平台
MCP Connectors 透過 ~/.codex/config.toml 設定（codex mcp add 指令或手動編輯）。
未設定時自動降級：請參閱上方降級方案。
Antigravity 平台（Google AI IDE）
MCP 透過 MCP Server Hub（1,500+ servers）或 ~/.gemini/antigravity/mcp_config.json 設定。
支援 Jupyter Notebook 整合。未設定時自動降級：請參閱上方降級方案。
MCP 整合更新（v3.0）
讀取全域策略文件：../../shared/mcp-strategy.md
本 Skill 適用的 MCP 最佳化
WebSearch（已啟用）： 搜尋最新課綱資料、教學素材、時事情境。
Canva MCP（若已連接）： 使用者說「幫我做更美觀的版本」或「Canva 設計」時： → 呼叫 Canva:generate-design 生成高設計感版本 → 優先適用：教案封面、簡報、學習單封面
Google Drive（若已連接）： 文件生成後詢問：「要上傳到 Google Drive 嗎？」 → 確認後上傳，返回分享連結 → 不修改任何現有檔案的分享權限
安全原則： 所有 MCP 寫入操作執行前，必須顯示確認摘要並等待使用者確認。