Vibe Coding

航海日誌：Z-test Master，當統計學遇上 AI 的自動導航

別再讓 Z 檢定當學生的夢魘。z-test-master 會自動出題，還能把作答送給 AI 助教批改——連你的「白話結論」都幫你診斷邏輯。一個永不疲倦的統計練習平台。

Captain Balung

— 閱讀時間 5 分鐘
分享
航海日誌：Z-test Master，當統計學遇上 AI 的自動導航

學會了如何用 Vibe Coding 打造視覺化模組後，我們教學的下一步，是將「枯燥的練習」轉化為「智慧化的對話」。統計學中的 Z-test（Z檢定）是許多學生的夢魘，但如果有一個永遠不會疲倦、能夠自動出題並為學生「批改考卷」的助教呢？這就是我最新開源專案z-test-master的誕生初衷。

一、 智慧型助教：Z-test Master 的核心邏輯

出題、作答、AI 評分、回饋的閉環學習迴路圖
從「對或錯」到「邏輯診斷」——練習變成一場雙向對話。

這個專案不僅僅是一個網頁，它是一個小型 AI 驅動的「統計學練習平台」。我定義了幾個核心的教學體驗：

  • 隨機化命題引擎： 系統能即時生成各種統計情境（從樣本平均數到標準差），確保學生每一次進入練習時，面對的都是全新的挑戰，徹底告別題庫背誦。
  • 閉環學習回饋： 學生完成假說檢定後，系統支援送出給 AI 評分。這不僅是告訴學生「對或錯」，更重要的是 AI 能針對學生的「結論白話文解釋」進行診斷，指引邏輯缺陷。
  • 線上航行入口：Z-test Master 統計學小幫手

二、 視覺化部署與開發導航

Z-test Master 的 GitHub Pages 部署與 CLI 串接流程
拖檔即更新，新手也能讓 AI 助教線上待命。

這次我們在 GitHub 的部署流程更加簡潔，對於不熟悉 CLI 的航海新手，我們維持「視覺化優先」的節奏：

  1. GitHub 介面操作 (Visual Deployment)： * 同樣地，你可以將 index.htm 直接拖曳至 GitHub 儲存庫介面，即可完成代碼的更新。
    • 進入 Settings > Pages，確認 GitHub Pages 已經指向 main 分支，你的 AI 助教就會立刻在線上更新。
  2. 進階航行：CLI 串接指引 (Command Line)： 如果你已經準備好挑戰進階功能，可以透過 Cursor 的 Terminal 直接輸入：
# 更新你的教學助教代碼
git add .
git commit -m "Add AI-powered Z-test grading logic"
git push origin main

這將是你下一次進行「自動化佈署」的絕佳契機，我們會在未來的篇章深入探討如何透過腳本讓發布流程自動化。

三、 開發筆記：如何定義「AI 助教」

為了讓 z-test-master 運作順暢，我在 Cursor 中使用了這樣的核心邏輯指令，讓 AI 成為出題專家：

Prompt (給 Cursor 的指令)： 「請開發一個 Z-test 練習介面。核心功能是隨機生成統計情境，並提供一個表單讓學生輸入虛無假說 ($H_0$)、對立假說 ($H_1$)、Z 值與 P 值。最重要的是，請設計一個『送出給 AI 評分』的接口，讓 AI 助教能夠針對學生的文字結論進行邏輯診斷。」

四、 靈魂深處的架構：AI 引擎室實錄 (The Engine Room)

前端到 Apps Script 到 Gemini 的三段架構圖，API Key 只在後端
API Key 藏在 Apps Script 後端，前端永遠碰不到——這是與「零後端工具箱」最大的不同。

1. 架構核心

  • 前端 (Frontend)： 標準的 HTML/JS 頁面，負責題目渲染與收集學生的輸入。
  • 雲端大腦 (Google Apps Script)： 作為 API 轉接站，保護你的 API Key 不會外洩在瀏覽器前端。
  • 大腦核心 (Google Gemini API)： 透過 Google AI Studio 進行調用，負責最終的邏輯批改。

2. Google AI Studio 與環境設定步驟

  1. 申請金鑰 (API Key)：
  2. 部署 Apps Script：
    • 在 Google Drive 建立一個 Apps Script 專案。
    • 將 API Key 放入 Script 的環境變數中，並設定為 doPost 函數接收請求。
    • 部署為「網頁應用程式 (Web App)」，權限設定為「任何人」。
  3. 安全設定：
    • 確保你的 API Key 僅在 Google Apps Script 後端使用，切勿直接寫入前端 index.htm，這是保護你航艦免受惡意攻擊的關鍵！

結語：航向智慧化的教學海洋

Z-test Master 線上練習平台的操作畫面
系統自動出題，學生作答後一鍵送 AI 評分。

當我們將「自動出題」與「AI 評分」結合，統計學的教學場景就從「單向輸出」變成了「雙向對話」。這不僅提升了學生的參與度，更釋放了身為教師的我們，讓我們能將精力花在更重要的「洞察與對話」上。讀者可以嘗試跟聊天機器人對話，它將帶領我們逐步完成 Google Apps Script 端的設定，產出線上可用的，智慧型的教學軟體。

教學是一場永無止境的航行，這次的 z-test-master 只是智慧教學的第一步。歡迎來到GitHub 專案交流，讓我們一起在這片智慧教學的汪洋中，找到屬於未來的導航系統。

Read more