從學習證據到教學改進｜課後指南：回去自己做

壹昨天我們做了什麼

兩小時真正動手的是這四件。例子故意挑最小的：一個算 BMI 的小程式，三個版本。跟我們在人工智慧概論課上給學生的作業是同一套：在自己的電腦裡存三次版本，再回頭看前一版長什麼樣。工具叫 Git，但你不必記它的指令，指令交給 AI 助手（ChatGPT 桌面版的 Codex）代打，你只看它的計畫、看前後對照、然後點頭。

01把 AI 助手跟 GitHub 接起來Codex 開在你選的資料夾裡動手；GitHub 帳號登入過（gh），作者名字跟信箱從此寫進每一筆紀錄。這一步只是身分，還沒上傳任何東西。
02第 1 版：BMI 腳本用一句話請 AI 寫一支 bmi.py（輸入身高公分、體重公斤，算 BMI 和分級），跑一次看 170 公分、65 公斤約 22.5；把資料夾交給 Git 管理、存第 1 版。重點：AI 說做完了，你要親自打開資料夾看到那個檔、自己跑一次。
03第 2 版、第 3 版：改一次存一次同一個功能改成網頁版 index.html（雙擊就能算），存第 2 版；再加一個切換鈕做成中英雙語版，存第 3 版。每次都先看前後對照（只看 − 跟＋的行），版本說明是你自己的話。
04回頭看印出版本清單，把第 1 版的腳本拿出來看、跟第 3 版比差在哪。回頭看不是回到過去改，舊版永遠在；真要退回也是「再加一筆」，不刪歷史。這就是「我改過、什麼時候改、為什麼改」拿得出來的樣子。

全場只記一句話：挑一句不同意的、改掉、寫下為什麼。AI 只整理既有的分數與文字，不替老師打分數、不替老師下結論。

貳回去自己做：七張卡

進度

0 / 7

勾選只存在這台電腦的瀏覽器裡。約定：工作資料夾＝你在 AI 助手「開啟資料夾」選的那一個；練習資料夾叫 bmi（昨天建過的可以沿用，想從零再來就改名）。做熟了把 bmi 換成你的課程資料夾，同一套。

卡 0｜開 AI 助手、選資料夾、探測一句

5 分做完了

你做什麼

①開 ChatGPT 桌面版，左上角切到 Codex。②「開啟資料夾」選一個不在 OneDrive／iCloud 同步、不需要管理員權限的位置（不要桌面、不要文件）。③輸入框下方的權限選單維持「要求核准」（英文介面 Ask for approval；每個畫面長什麼樣看授權畫面對照，有圖有影片）。④貼這句。

請印出目前工作資料夾的完整路徑，確認是我選的那一個；再列出這個資料夾第一層的檔案與子資料夾。然後只在這裡新建 write-test.md，內容寫「工作坊寫入測試」；不要改其他檔、不安裝軟體、不上傳到任何地方。

AI 會做什麼

印路徑、列清單、建一個小檔。可能問一次「要不要允許寫入」→ 允許。

你一定要自己看的

自己打開 write-test.md 看到那行字；路徑裡沒有 OneDrive／iCloud 字樣。看不到＝它在別的地方動手，重選資料夾。

卡 1｜第 1 版：BMI 腳本，交給 Git

8 分做完了

你做什麼

兩句分開貼，第一句做完、自己跑過一次，再貼第二句。

請在目前工作資料夾裡建一個資料夾 bmi，在裡面寫一支 Python 程式 bmi.py：執行後問身高（公分）和體重（公斤），印出 BMI（小數一位）和分級（過輕／正常／過重／肥胖，用台灣常見的 18.5、24、27 門檻）。寫好請你自己用 170 和 65 跑一次，把結果印給我看，並顯示 bmi.py 的完整路徑。不要安裝任何套件、不要上傳到任何地方。

請把 bmi 資料夾交給 Git 管理，存成第一個版本，版本說明寫「v1 BMI 腳本」。不要上傳到任何地方。如果需要先設定作者名字和信箱，名字用我的 GitHub 帳號名、信箱用 GitHub 註冊的信箱，設完告訴我你設了什麼。存完把版本清單印給我看。

AI 會做什麼

第一句：建資料夾、寫 bmi.py、自己跑一次給你看結果、印路徑。第二句：初始化 Git（第一次會設作者名字信箱）、存第 1 版（commit）、印版本清單。它問「要不要允許」→ 允許。

你一定要自己看的

①照它印的路徑打開資料夾，親眼看到 bmi.py。②自己跑一次（Windows 在資料夾空白處按右鍵「在終端機開啟」，打 python bmi.py）：170、65 → 約 22.5、分級「正常」。③版本清單一筆、說明是「v1 BMI 腳本」。④它設的名字信箱是你的。

卡 2｜第 2 版：同一個功能改成網頁版

6 分做完了

你做什麼

貼這句。它改完先列前後對照，你看過再說「可以存」。

請在 bmi 資料夾裡新增 index.html：跟 bmi.py 同一個功能的網頁版，一個檔就能在瀏覽器打開，輸入身高公分、體重公斤，按鈕算出 BMI 和分級，全中文。不要動 bmi.py、不要另外建資料夾、不要用任何外部套件。做完先把新增了哪些行列給我看，等我說「可以存」再存版本，版本說明寫「v2 網頁版」，存完印版本清單。

AI 會做什麼

新增 index.html（HTML＋一點 JavaScript，單檔、離線能開），列出新增了哪些行；等你說可以，存第 2 版、印清單。

你一定要自己看的

①資料夾裡多了 index.html，bmi.py 還在。②自己雙擊 index.html，輸 170、65，看到約 22.5 和分級。③版本清單兩筆。AI 若另存成 bmi-v2.html 之類：版本靠紀錄留、不靠檔名，叫它改成 index.html。

卡 3｜第 3 版：中英雙語版

6 分做完了

你做什麼

同一個 index.html 改，不另存；版本靠紀錄留、不靠檔名。

請把 bmi/index.html 改成中英雙語版：加一個語言切換鈕，可以換中文和 English，兩套文字都放在同一個檔裡，數字算法不變。先把前後對照列給我看，確認只改了 index.html；等我說「可以存」再存版本，版本說明寫「v3 中英雙語」，存完印版本清單。

AI 會做什麼

在同一個 index.html 加語言切換鈕與兩套文字，列前後對照；等你說可以，存第 3 版、印清單。

你一定要自己看的

①重新整理網頁，多一個切換鈕：按了變 English、再按回中文，數字算得一樣。②對照裡只有 index.html 的改動，bmi.py 沒被碰。③版本清單三筆：v1 腳本、v2 網頁版、v3 中英雙語，三句都是你的話。

卡 4｜回頭看：把第 1 版拿出來看、跟第 3 版比

5 分做完了

你做什麼

這是昨天最後做的那件事。三句由淺到深，貼第一句就夠；第三句是真的要退回才用。

請把 bmi 資料夾裡「v1 BMI 腳本」那個版本的 bmi.py 完整內容印給我看，不要改現在的檔案、不要切換版本。然後列出第 1 版跟目前最新版（第 3 版）之間的前後對照：哪些檔新增、哪些檔改了。

請把 bmi 每一個版本「改了哪些檔、每個檔加減幾行」列成一張表，從第 1 版到最新版，附上每一版的時間與說明。不要改任何東西。

我決定撤銷第 3 版（中英雙語版），回到第 2 版的樣子。請不要刪掉任何歷史、不要用 reset 或強制：用 git revert 把第 3 版撤銷，當成新的一版存起來，版本說明照 git 預設的 Revert 寫法再加一句「因為【一句理由】」。存完印出版本清單，應該有四筆，第 3 版那筆還在。

AI 會做什麼

第一句：把第 1 版的 bmi.py 印出來（幕後是 git show）、列第 1 版到第 3 版的差異（git diff），現在的檔一個字都不動。第二句：列每版改了哪些檔、加減幾行。第三句：用「新的一版」撤銷第 3 版（幕後是 git revert），歷史四筆都在。

你一定要自己看的

①印出來的是第 1 版的腳本原樣。②差異裡 index.html 是新增的、bmi.py 沒動。③做了第三句的話：版本清單四筆、沒有任何一筆消失，重新整理網頁切換鈕不見了、回到第 2 版的樣子；AI 若提議「reset」「強制」「刪掉」，一律說不。回頭看不是回到過去改，是把舊版拿出來看；真要退回也是往前多存一版。

卡 5｜（選做）接上 GitHub：三筆一起上去

8 分做完了

你做什麼

①瀏覽器登入 GitHub → 右上角「＋」→ New repository → 名稱 bmi（練習用公開或不公開都行；課程資料一律 Private）→ Create repository，README 不用勾。②複製它的網址（像 https://github.com/你的帳號/bmi）。③貼這句，【】換成網址。

請把 bmi 資料夾連到這個 GitHub 網址【貼網址】，並把版本紀錄上傳（push）。動手前先告訴我你會連哪個資料夾、上傳哪些檔、哪幾個版本；我看過再允許。不要改任何檔案內容、不要 force。

AI 會做什麼

先列計畫（哪個資料夾、哪些檔、幾個版本）等你允許；然後設定遠端、上傳。瀏覽器可能跳出 GitHub 授權 → 授權。

你一定要自己看的

①repo 頁面打開看得到 bmi.py 和 index.html。②點頁面上時鐘圖示的 commits，看到你電腦裡那幾筆版本、時間與說明一樣（三筆或四筆）。這一條時間線就是研究歷程資料：它能證明你改過，不能單獨證明調整有效。不接也可以，電腦裡與網頁上各保留一段。

卡 6｜日常：平常只用 GitHub 網頁版上傳就夠

3 分做完了

你做什麼

之後換成你的課程資料夾（評分規準表、抽查紀錄）也是同一套。改了檔不必開 AI 助手：到 repo 頁面 → Add file → Upload files → 把改好的檔拖進去 → 下方「Commit changes」寫一句為什麼改 → 綠色按鈕。這一個動作就是一筆紀錄，跟昨天用 AI 存的長一樣。

AI 會做什麼

（不用 AI）

你一定要自己看的

上傳後點時鐘圖示的 commits，新的一筆在最上面、說明是你寫的那句。學期末把這條時間線整理成一張表（什麼時候、改了什麼、為什麼），就是計畫書「研究歷程與教學調整」那一段。

貳之二一句話版：只講目的，讓 AI 把整件事做完

上面七張卡是「一步一句、每步你看一次」，適合第一次。熟了以後其實不用拆步驟：你用白話講目的，AI 助手自己判斷要裝什麼、設什麼、跑什麼，做完回報。下面每一句都可以整句貼，【】換成你的。每句尾巴那段護欄請留著：它讓 AI 動手前先說計畫、要連網或動帳號先問你、不准刪歷史。

裝工具、登入（第一次用這台電腦）

我想在這台電腦用 Git 留課程資料的版本紀錄。請幫我檢查 git、GitHub CLI（gh）裝好了沒，沒有就幫我裝（Windows 另外確認 PowerShell 是 7 開頭，不是就一起裝）；裝好後幫我登入 GitHub（登入畫面跳出來我自己按）。每一步動手前先用一句話告訴我你要做什麼，做完列出你裝了什麼、設了什麼、哪些本來就有。

在這個資料夾用 Git（卡 1 的一句話版）

我想在目前這個資料夾用 Git 留紀錄。請把需要的都弄好：交給 Git 管理、作者名字用我的 GitHub 帳號名、信箱用 GitHub 註冊的信箱、把現在的內容存成第一版，版本說明寫「【這一版做了什麼，一句】」。不要上傳到任何地方。動手前先告訴我你的計畫，做完印出版本清單跟資料夾的完整路徑。

改了東西，存一版（卡 2、卡 3 的一句話版）

我改了【檔名】。請先把前後對照列給我看，等我說可以再存版本，版本說明寫：「【第 N 版：改了哪一格、為什麼，用你自己的話】」。只存這個資料夾裡的改動，不要動其他檔、不要上傳。

回頭看（卡 4 的一句話版）

幫我看看這個資料夾到目前為止改過哪些版本：每一版什麼時候、改了什麼、我當時寫的理由，用白話整理給我，再把最早那版跟最新版的差異列出來。不要改任何東西、不要切換版本。

我想退回【第 1 版】的寫法，但不要弄丟任何紀錄：不准 reset、不准強制覆蓋。把內容還原成那一版，當成新的一版存起來，說明寫「退回第 1 版，因為【理由】」，存完印出版本清單給我確認沒有少任何一筆。

接到 GitHub（卡 5 的一句話版）

我想把目前這個資料夾接到我的 GitHub，用不公開（Private）的 repo，名稱【資料夾名】；還沒有這個 repo 就幫我建，然後把所有版本紀錄上傳。做之前先告訴我：你會建什麼、上傳哪些檔、幾個版本，我看過再允許；要登入或授權的畫面我自己按。做完給我 repo 網址，並確認頁面上是鎖頭（不公開）。

把紀錄整理成計畫書用的表

請把這個資料夾的版本紀錄整理成一張表，欄位：日期、版本說明、改了哪個檔、加減幾行；存成 history.md 放在資料夾裡，然後存一版，說明寫「整理版本時間線」。這張表我要放進教學實踐研究計畫的「研究歷程」那一段，請用白話、不要有指令或代碼。

一句話版的三條護欄（每句尾巴已經寫進去了）：①動手前先說計畫，要連網、要動帳號、要裝東西先問你；②AI 說做完了，你要親自看到檔案或版本清單；③不准 reset、不准強制覆蓋、不准刪歷史。AI 提議這三件事，一律說不。

參模擬器：三次版本，然後回頭看（不用裝任何東西）

按鈕的順序就是卡 1 到卡 4。左邊是資料夾裡現在的檔，右邊是版本清單。按「看第 1 版」會把舊版拿出來看，左邊的檔不會變；按「撤銷第 3 版」會多一筆、不會少一筆。

資料夾 bmi／（工作中的檔）

（還沒有這個資料夾）

版本清單（git log）

（還沒有版本）

第 1 版的內容（只是拿出來看，工作中的檔沒動）

肆三題自測

1. AI 說「已經存好第 1 版了」，你下一步是？

2. 前後對照（diff）畫面裡，你要看的是哪些行？

3. 你想撤銷第 3 版（中英雙語版），回到第 2 版的樣子。哪個做法對？

伍想做深一點：昨天的教材都還在

講義參：四塊逐步昨天走的是 BMI 三版，講義的四塊沒走到；第一塊是課程資料夾版的同一套，第二塊（AI 起草 Rubric、你改一格、AI 扮審查者）、第三塊（分析＋抽 3 筆）、第四塊（一頁設計）每步都有複製鈕，自己走得完。
講義的六張提示詞P1 起草 Rubric、P2 嚴格審查者、P3 三方分數落差、P4 反思分類、P5 清髒資料、P6 審查委員三問。純文字版在 prompts/。
工作台：Rubric 工作台左欄貼第 1 版、右欄改、「比較兩版」看紅綠行、「匯出這一輪」。純網頁、離線能開、不呼叫 AI。
工作台：證據儀表板示範資料的三方分數落差圖、AI 分類、「抽 3 筆回查」、三句結論、匯出抽查紀錄。講師模式可以看那筆故意分錯的。
工作台：一頁設計「帶入示範課」「帶入演講課」，改兩格、匯出 Markdown，十一欄對應計畫書章節。
試評練習：同一週 10 份學習單從作業原文開始：自己評三份、AI 試評、程式核對、你決定。七步每句可複製，約 50 分鐘。
講義柒：課後手冊兩種紀錄怎麼讀成同一種、髒資料先清、接到計畫書哪一章、三條誠實限制。
講師的成績批改實況講師自己這學期六門課怎麼收作業、三個 AI 評分者對齊、只看差距大的；有 3 分半的影片。
授權畫面對照真的拍下來的 12 張圖＋2 分鐘影片：切到 Codex、建立專案、權限選單、允許視窗、允許之後、gh 登入。對不上就看這頁。
先玩一遍5 分鐘互動導覽，給還沒裝任何東西的同事看。
上一場 Git×AI 工作坊的練習台工作區、暫存區、版本庫的互動模擬，想弄懂 Git 幕後在做什麼再去。

陸講師指南：想自己帶一場的老師

昨天講師手上那份逐步講稿公開在這裡：每一段「你做什麼、你要講什麼、老師看什麼、會卡在哪」，加上開場四句、16:25 講師模式的台詞、老師最常問的六題、時間落後的逃生門。拿去帶自己系上的同事，改掉課名就能用。

打開講師逐步講稿（網頁）講師參考指南 Word（13 頁）投影片 16 頁

教材授權 CC BY-NC-SA 4.0：可以改、可以拿去教，註明出處、不商用、改作同樣授權。