上週裝的四樣，
今天全部用上

卡 1只查看（工作坊 P1）

為什麼Git 管理的不是整台電腦，是「一個資料夾」。AI 站錯資料夾，後面每一步都會做在別的地方——動作全對、位置全錯。所以第一句話永遠是「只看、不動」，替後面畫出邊界。這也是 A1（看得懂它打算做什麼）的第一次練習：它連查看都會先告訴你要跑什麼。

觀念與名詞（改寫自工作坊第一階段 P1）Git 的範圍不是整台電腦，是你現在開著的那個資料夾。AI 站錯路徑，指令本身全對，東西卻做到別的專案去了。所以第一步只讀不寫：把完整路徑、最上層有哪些檔案、這裡是不是版本庫先核對一次，等於替今天後面所有動作先畫好界線。

• 工作資料夾（working folder）：你現在開著、準備讓 AI 動手的那個資料夾——今天就是 my-panel。
• 完整路徑（full path）：這個資料夾在電腦裡的完整地址；兩個同名資料夾靠它分辨。
• 根目錄（root）：這個專案最上層那一層，不是整顆硬碟的最上層；等一下 index.html 要放在這裡。
• 版本庫（repository，簡稱 repo）：資料夾加上 Git 替它記的那份歷史；現在還沒有，卡 4 才會建。

貼這句

我已經在這裡打開了資料夾 my-panel。請只查看、不要修改任何東西：告訴我這個資料夾的完整路徑、裡面有哪些檔案、這裡現在是不是 Git 版本庫，以及這台電腦有沒有裝 git 跟 gh（GitHub CLI），各是什麼版本。

它會做什麼跑幾條只讀的指令，回報路徑、檔案清單、「not a git repository」、git／gh 有沒有裝。它的計畫應該只有四件事：回報完整路徑、列出根目錄的檔案、檢查有沒有 Git、全程不修改任何檔案——多出第五件就是越界。

你要看什麼再按同意回報的路徑是不是你剛建的那個 my-panel。「not a git repository」是正常的，還沒開始。三個地方一起對一次：資料夾名稱是 my-panel、Git 顯示「尚未建立」、commit 數是 0。

幕後指令pwd（Windows：Get-Location）、ls、git status、git --version、gh --version

卡住怎麼辦路徑不是你的資料夾 → 停，用「開啟資料夾」重開對的那個。它說「找不到 git」→ 正常，卡 2 就是裝它。

卡 2讓它替你裝工具（接 W2 作業）

為什麼agent 不只會寫程式——它會查版本、裝工具、讀錯誤訊息、告訴你下一步。這就是 W2 說的「會自己動手的 AI」。但「同意」那一下是你的：Request Review 模式下，每一條會改動這台電腦的指令都會停下來等你按（A3，破壞性動作先問）。今天你會按十幾次同意，每一次都要看得懂它要跑什麼——這比背指令重要。

貼這句

這台電腦如果沒有 git 或 gh（GitHub CLI），請幫我安裝：Windows 用 winget（套件 Git.Git 與 GitHub.cli），Mac 用 Homebrew（git 與 gh）。每一條指令執行前先告訴我它會做什麼，等我同意再跑。裝完後告訴我要不要重開終端機或重開這個程式才找得到新指令。不要幫我登入 GitHub，登入我自己來。

它會做什麼一條一條列出安裝指令，等你按同意；裝完回報版本；提醒你重開。

你要看什麼再按同意指令裡的套件名是不是 Git.Git、GitHub.cli；有沒有多裝你沒要的東西。

幕後指令winget install --id Git.Git -e、winget install --id GitHub.cli -e；Mac：brew install git gh

卡住怎麼辦winget 說找不到 → 去 git-scm.com/download/win 與 cli.github.com 下載安裝檔，一路下一步。裝完它還是說「找不到 gh」→ 把 Antigravity（或 ChatGPT）整個關掉重開，新裝的指令要重開程式才讀得到。Mac 沒有 Homebrew → 官網的 .pkg。教室網路慢到裝不完 → 今天改走路線 B，同分，回家裝好下週接上。

卡 2½登入 GitHub——這一步人自己做，AI 不碰

為什麼登入＝把一把「代表你」的鑰匙放進這台電腦。鑰匙不經過 AI：它不需要知道你的密碼，也不該知道。之後它下 git push 時，用的是這把鑰匙，不是你的密碼。

幕後指令gh auth login

⚠️ 畫面上的字句以現場為準（gh 版本會變）；順序對不上就一題一題讀。
⚠️ 那組 8 碼跟密碼一樣，不要貼進 AI 的對話框。

卡 3驗證登入、設定作者名字（工作坊 P2 前置）

為什麼每一筆 commit 都會刻著「誰、什麼時候」。這個 repo 等一下會公開，所以信箱用 GitHub 給的 noreply 位址（形如 數字+帳號@users.noreply.github.com），真信箱不上網——這是「公開之前先想個資」的第一次。順便讓 AI 示範一件它很會的事：查資料再幫你設定。

觀念與名詞（改寫自工作坊第一階段 P2 的前置）Git 跟 GitHub 是兩層：Git 在你這台電腦上記歷史，GitHub 是網路上那一份連得上、看得到的副本。這張卡做的就是兩層之間的對齊——先確認 GitHub 那一層認得你，再把「本機記歷史時要刻誰的名字」設好。名字與信箱會跟著每一筆 commit 一起公開，所以先想個資、再動手。

• Git／GitHub：Git 是本機記歷史的工具；GitHub 是保存遠端那一份、給人看與協作的網站。兩件事，別混成一件。
• 其餘 P2 的名詞（main、origin、.gitignore）在卡 4才用得到，到那裡再講。

貼這句

請確認我已經登入 GitHub：執行 gh auth status，用白話告訴我結果。接著幫我設定 git 的作者名字與信箱：名字用我的 GitHub 帳號名；信箱請先用 gh api user 查出我的帳號 id 與 login，設成 GitHub 的 noreply 格式「id+login@users.noreply.github.com」，因為這個 repo 會公開、每一筆 commit 都帶著信箱。設定前先把要執行的指令列給我看，等我同意。

它會做什麼跑 gh auth status；查你的 id 與帳號；列出兩條 git config，等你同意。動手前它應該先再確認一次工作路徑，並提醒你這個 repo 等一下會公開。

你要看什麼再按同意Logged in to github.com account 你的帳號；名字是你的帳號名；信箱是 noreply 那種。另外自己確認一次：路徑沒跑掉、等一下要公開的檔案裡沒有真名與學號，再說「同意執行」。

幕後指令gh auth status、gh api user --jq '.id, .login'、git config --global user.name "帳號"、git config --global user.email "id+帳號@users.noreply.github.com"

卡住怎麼辦說沒登入 → 回卡 2½ 再做一次。noreply 弄不出來 → 先用東華信箱也行（公開的是信箱，不是密碼），下週再改。

卡 4第一版進倉庫、上 GitHub（工作坊 P2＋P4＋P5）

先做一件手動的事：把上週存的單檔複製進 my-panel，改名 index.html（全小寫）。沒有那個檔 → 起步包 v0-sample.html 改名 index.html，同分。

為什麼三個動作，三個意思——init 是「這個資料夾從現在起有歷史」；commit 是「存一版、寫一句為什麼」；push 是「把這版放到 GitHub」。commit 不等於 push：「我存了」跟「網路上有了」是兩件事，很多人半夜就卡在這裡。公開 repo 任何人都看得到，所以個資檢查在你這一邊，不在 AI 那一邊。

觀念與名詞（改寫自工作坊第一階段 P2＋P4＋P5）Git 存一版其實分三層：工作區是你眼前那份 index.html；暫存區是「下一版要收哪些東西」；commit 才是正式的存檔點。add 只是把東西排進暫存區，既沒存版、更沒上網。最後 push 才把已經存好的版本送上 GitHub——還沒 commit 的修改一律不會跟著上去。本機的 main 跟 origin/main 指到同一筆，兩邊才算同步。

• main：今天唯一那條正式的版本主線。
• remote／origin（遠端）：remote 是網路上那一份版本庫；origin 是本機替主要那個網址取的慣用名字。
• .gitignore：寫明哪些「還沒收進歷史」的檔不要收進來。它救不了已經 commit 出去的東西，也不是保密工具。
• git add（放進暫存區）：只是排進下一版，沒有存版、也沒有上傳。
• 暫存區（staging area，也叫 index）：下一筆 commit 要收的那份清單。
• staged diff（暫存區差異）：commit 之前最後一次逐行核對——這張卡停下來等你確認的就是它。
• origin/main：你這台電腦記著的「GitHub 上那條 main 現在到哪一筆」。
• 同步：本機 main 與 origin/main 指向同一筆最新的 commit。

貼這句

資料夾裡現在有 index.html，是我上週做的面板。請照順序做，每個會改東西的步驟執行前先列出來等我同意：
1. 替這個資料夾加上 Git 版本控制，分支叫 main。
2. 建一個 .gitignore，排除 .DS_Store 與 Thumbs.db。
3. 先把要收進第一版的檔案列給我看，等我確認再 commit，訊息寫「v0：上週的面板放進版本控制」。
4. 在我的 GitHub 建一個公開 repo 叫 my-panel，把本機的 main 推上去。
5. 完成後給我 repo 網址與那筆 commit 的網址，我要自己打開確認。
公開之前提醒我檢查 index.html 裡有沒有真名、學號、電話。

它會做什麼列計畫 → init → 建 .gitignore → 列檔案等你確認 → commit → gh repo create → push → 回報兩個網址。計畫裡該看得到這幾步：再確認一次路徑、檢查有沒有不該公開的資料、建立 Git 與 .gitignore、列出將納入的檔案並顯示 staged diff 等你確認、才 commit、建立公開 repo 並設定 origin、推送 main、回報網址；全程不改寫遠端歷史。

你要看什麼再按同意要收的檔案只有 index.html 與 .gitignore；repo 名 my-panel、Public；親自打開網址看到 index.html 與 1 筆 commit。儀表板上四件事一起對：Git 已建立、分支是 main、remote 已連接、commit 數從 0 變成 1，而且工作資料夾是乾淨的（沒有漏在外面沒存到的東西）。

幕後指令git init、git branch -M main、git add index.html .gitignore、git diff --cached --stat、git commit -m "v0：上週的面板放進版本控制"、gh repo create my-panel --public --source=. --push、git remote -v

卡住怎麼辦Name already exists → 改叫 my-panel-2（⚠️網址會跟著變，交件時用複製的）。push 被拒 → 叫它先跑 gh auth status 解釋，絕不 force。它把不相關的檔一起加進去 → 「先列檔、拿掉不相關的，再顯示 staged diff」。

卡 5開網址（GitHub Pages）

為什麼Pages＝GitHub 免費把你 repo 裡的 index.html 放到一個公開網址上。它要把檔案搬到 GitHub 自己的伺服器，通常一兩分鐘，跟你的電腦快不快無關。這一步做完就是今天的夠了線。

貼這句

請替 GitHub 上的 my-panel 開啟 GitHub Pages，來源用 main 分支的根目錄。用 gh api 做，執行前先把指令給我看。開好後查詢並回報網站網址（html_url），並告訴我 GitHub 通常要等一兩分鐘才會亮。

它會做什麼一條 POST 開 Pages、一條 GET 查網址；回報 https://帳號.github.io/my-panel/。

你要看什麼再按同意網址長得像上面那樣；用手機打開看到自己的面板（沒亮就先往下做，回頭重新整理）。

幕後指令gh api -X POST repos/帳號/my-panel/pages -f 'source[branch]=main' -f 'source[path]=/'、gh api repos/帳號/my-panel/pages --jq .html_url

卡住怎麼辦API 回錯 → 改走瀏覽器：repo → Settings → Pages → Build and deployment → Deploy from a branch → main、/(root) → Save。網址開了只看到一行字 → 那是 README，代表找不到 index.html：檔名是不是全小寫、是不是在最外層。一直 404 → 先做第 6 段，回頭 Ctrl＋Shift＋R 強制重新整理。

卡 6讓它做成真的 app（工單 v1）

為什麼這是 P5「六件新事」第 ⑤ 件——交出去驗收的姿勢：工單寫清楚 → 看它的計畫 → 讓它做 → 你驗收 → 不對就退回。agent 很強，一張工單能寫出兩百行；但它做得對不對，只有你測得出來（W2 那張三行小表：我預期／實際上／一樣嗎）。工單用的是 W2 的需求卡格式，「界線（不放什麼）」那欄最重要——P5 第 ④ 件：它做錯，先看你少交代了什麼。

觀念與名詞（改寫自工作坊第一階段 P3＋P6）它說「做完了」只是回報，證據在檔案狀態裡。它改完 index.html，改動還停在工作區——檔案變了，但還沒存成任何一版，所以這一步測壞了不可怕、退得回去。status 是 Git 的現況報告，只是看、不會動到任何東西；它要是多生一個工單沒寫的檔，status 會把那個檔列成「未追蹤」，那就是越界最直接的證據。

• 工作區（working tree）：你眼前實際看到、正在編輯的那份檔案狀態。
• status（現況報告）：問 Git「現在有什麼變動」；查看它不會修改也不會存檔。
• 未追蹤（untracked）：檔案已經在了，但從來沒被收進任何一版——多出來的檔會長這樣。
• 尚未提交（uncommitted）：改動還留在工作區或暫存區，還沒成為 commit。
• Markdown（.md）：好讀的純文字格式，Git 逐行比得出差異；起步包那張 工單-v1.md 就是。

貼這句（起步包 工單-v1.md 就是這段）

請照下面這張工單改 index.html。改之前先列出實作計畫（會改哪些檔、分幾步、哪裡你不確定），等我按同意再動手；做完給我改了什麼的摘要，以及我可以怎麼測。

【任務】把 v0 面板做成「我的一週小面板」
【輸出（我預期看到什麼）】
1. 最上面顯示今天日期，格式 YYYY-MM-DD。
2. 原本那顆按鈕還在；按下去的計數重新整理後還在（存在瀏覽器裡）。
3. 每天自動從 0 開始，但保留最近 7 天的數字，畫成 7 根長條圖，今天那根標出來。
4. 右上角一顆「深色／淺色」切換，重新整理後記得我的選擇。
5. 手機直式（寬 360px）不破版、不用左右捲。
6. 一顆「清除全部資料」按鈕，按下去先在畫面上問我一次再清（不用 alert）。
【界線（不放什麼）】
單檔 index.html，CSS 與 JavaScript 都寫在裡面；不連網、不用任何外部套件或字型；不用 alert／confirm／prompt；不放真名、學號、電話；不加動畫與音效；只改 index.html、不新增其他檔案。

它會做什麼先出一份實作計畫（Antigravity 叫 Implementation Plan）等你按 Proceed；然後改 index.html；最後給摘要與測法。計畫裡要講清楚三件：只會動 index.html 的哪些地方、等你同意才動手、改完先不 commit（存版是下一張卡的事）。

你要看什麼再按同意計畫只動 index.html；沒有「順便重做整頁」。做完測五個邊角：①連按兩次→加 2？②重新整理→數字還在？③切深色再重新整理→還是深色？④視窗縮到手機寬→不用左右捲？⑤日期是 2026-09-21、不是 Sep 21？再看一次狀態：有「尚未提交的修改」、commit 數跟卡 4 一樣沒變（它不該偷偷幫你存版），而且檔案清單裡沒有工單沒寫的新檔。

卡住怎麼辦它一次改了三個檔 → 退回：「工單寫只改 index.html，請只改那一個」。跑起來壞了 → 瀏覽器按 F12 → Console 的紅字整段貼給它。它問你要不要用某個套件 → 回「不要，工單寫不連網」。

卡 6b讀 diff、存 v1、push（工作坊 P6＋P7）

為什麼diff 是你唯一能親眼看見它做了什麼的地方（A2）——紅色減號是拿掉的、綠色加號是新加的。commit 訊息是寫給三個月後的你，那時你完全不記得今天做了什麼。這一版存成一筆，之後才有東西可以回去。

觀念與名詞（改寫自工作坊第一階段 P6＋P7）紅色減號那幾行是改之前有、現在被拿掉的；綠色加號那幾行是改完才有的。紅綠只告訴你「哪裡不一樣」，不代表對或錯——你要對的是「它動的範圍，跟它先前說要動的一不一樣」。看完就把這一版存起來、推上去，日常的循環才算走完一圈：改 → 看 diff → 放進暫存區 → commit → push。commit 訊息寫「為什麼改」，不是寫檔名。

• 紅色減號（−）：改之前有、現在被移除的那一行；不代表那行內容一定錯。
• 綠色加號（＋）：改完才出現的那一行；不代表那行內容一定對。
• commit 訊息（commit message）：寫給三個月後的你看的說明，要看得懂改了什麼、為什麼改。
• 本機歷史／遠端歷史：只存在這台電腦的 commit ／ 已經 push 到 GitHub 的 commit。兩邊差一筆，同學打開看到的就是舊的。

貼這句

測過了，功能正確。請把這次修改的 diff 逐段列給我看，用白話解釋紅色減號與綠色加號各是什麼；然後只把 index.html 存成第二個版本，commit 訊息寫「v1：記得住、七天長條圖、深色模式」，推上 GitHub。推完確認本機 main 跟 origin/main 一致。

它會做什麼逐段列出 diff 並用白話解釋紅綠；只把 index.html 存成第二版、推上 GitHub；推完確認本機 main 跟 origin/main 一致。存版前它該先列出全部已暫存的檔案（結果必須只有 index.html）、顯示 staged diff、跟你核對 commit 訊息，再 commit 與 push。

你要看什麼再按同意GitHub 上 2 筆 commit；手機重新整理看到 v1（可能要等一兩分鐘）。歷史圖多出第二個節點、本機與 GitHub 同步（狀態不再說「領先 1 筆」）。

幕後指令git diff -- index.html、git add index.html、git diff --cached --stat、git commit -m "v1：記得住、七天長條圖、深色模式"、git push origin main、git status --short --branch

卡住怎麼辦GitHub 看不到第二版 → 先分辨是還沒 commit、還是 commit 了沒 push（叫它跑 git status --short --branch）。

卡 7改壞再救回（工作坊 P9 精簡成四段）

為什麼這是全部關卡裡最不該砍的一關——你半夜真正會遇到的就是它。兩種「回去」要分清楚：還沒 commit 的錯，restore 一秒回來；已經 push 出去的錯，不能抹掉、只能「再加一筆改回去」（revert）。歷史不會被改寫——所以三個月後的你、還有 W5 要審你作品的同學，永遠追得到發生了什麼。這也是為什麼全程禁止 reset、rebase、force push。

觀念與名詞（改寫自工作坊第一階段 P8＋P9）「回去」其實是三個不同動作，處理的是不同狀態：只想看舊版長什麼樣，show 讀出來就好，什麼都不會被改動；還沒 commit 的錯，restore 把工作區那份蓋回上一版（沒存過的內容就這樣沒了）；已經推出去的錯不能抹掉，revert 是再加一筆反向的 commit，原本那筆留在歷史裡。要挑哪一筆，先用 log 看歷史：每筆 commit 都有一組雜湊值當身分證，HEAD 指著你現在站在哪一筆。查歷史只是看，不會移動 HEAD、也不會改到 index.html。

• 雜湊值（hash）：Git 給每筆 commit 的身分證號，畫面上通常只顯示前幾碼；7c 要你抄下來的就是它。
• HEAD：指向你目前所在的那一筆 commit，不包含還沒 commit 的修改。
• HEAD~1：HEAD 的前一筆；今天是一條直線的歷史，所以就是上一版。
• show（只讀舊版）：直接讀出某一筆 commit 裡的檔案內容，不切換版本、不動 HEAD、不動工作區。
• reset（今天禁用）：把分支重新指到別筆；再加 --hard 還會蓋掉暫存區與工作檔。今天完全用不到，它提議就回「不要」。

7a 貼這句

請把 index.html 裡整段 <script>…</script> 刪掉並存檔，但不要 commit。然後顯示 git diff，告訴我現在工作區有什麼變化。

→ 看紅：一整段減號。瀏覽器重開 index.html：按鈕沒反應了。

7b 貼這句

我不要這個修改。請用 git restore 把 index.html 救回上一版，然後證明 diff 已經是空的、工作區乾淨。不要用 reset。

→ 幕後：git restore -- index.html、git diff、git status --short。

7c 貼這句

請再把 <script> 那一段刪掉一次，這次 commit（訊息寫「練習：故意刪掉 script」）並推上 GitHub。推完告訴我這筆 commit 的 hash。

→ 等一兩分鐘，手機重新整理：網址壞了（按鈕沒反應，但頁面沒有消失——這是「跑得起來但不對」的實體版）。

7d 貼這句

剛剛那筆是故意弄壞的。請用 git log 找到它，用 git revert 撤銷它（會新增一筆撤銷 commit，原本那筆留在歷史裡），然後推上 GitHub。全程不准 reset、rebase、force push。做完顯示最近四筆歷史，並確認本機與 origin/main 一致。

→ 幕後：git log --oneline -3、git revert --no-edit <hash>、git push origin main、git log --oneline -4、git status --short --branch

你要看什麼四筆歷史 v0／v1／練習：故意刪掉 script／Revert "練習…"；手機重新整理：活了。GitHub 的 History 也是四筆。
四段各有一個停點，它動手前要先讓你核對：①路徑對、origin 是你自己建的 my-panel、分支是 main；②只讀那一段做完，分支、HEAD、工作區都沒變；③restore 只拿掉你指定的那一段，沒順手動別的；④故意弄壞那筆仍留在歷史裡，revert 是另外新增的一筆，最後本機與 origin/main 同步。證據對不上就回一句「停」。

卡住怎麼辦revert 說有衝突 → 停，不要讓它自己選，舉手。push 被拒 → 叫它 fetch 後解釋差在哪，絕不 force。手機沒變 → 快取，Ctrl＋Shift＋R 或等一下。

卡 8你的功能＋退回它一次（A4）

為什麼拒絕得了它，你才是導演。「按一下 Review」不算，寫得出理由才算——這一句就是今天 e學苑 的第三行。這也是快的人的第四關：功能自己出，agent 再強，需求是你的。

貼這句（底線自己填；例：在面板上加一個「今天一句話」的輸入框，重新整理後還在）

我想加一個功能：＿＿＿。請先列實作計畫，不要動手。

→ 讀計畫 → 一定要退回一次：找一個你不要的（它多加的、或你想改的），按 Review 留一句「我不要 X，因為 Y」→ 它改計畫 → Proceed → 測 →

可以了。請只把這次修改 commit，訊息寫「v2：＿＿＿」，推上 GitHub。

你要看什麼計畫第二版真的拿掉了你不要的 X；GitHub 五筆歷史。

沒點子的人從三個裡挑——「今天一句話」欄位（重新整理後還在）／「本週總杯數」一行字／把七天長條圖換成七個圓點。