把工作現場搬到你的電腦
第 1 堂你在瀏覽器上傳檔案;今天把 repo 搬到你自己的電腦,裝好兩個工具——一個負責「說」(Claude Code,用白話請它改東西)、一個負責「看」(GitHub Desktop,看它改了哪、確認 OK 才送上線)。做完你就能在自己電腦上:用講的改功能 → 看它改了哪 → 一鍵送上線。
第 1 堂用 GitHub 網頁上傳檔案,夠簡單——但有天花板:你沒辦法讓 AI 在你電腦上連續、對話式地改一整包檔案,也很難看清楚每次到底改了哪幾行。今天把 repo 拉到本機,就打開了這個能力。
Claude Code=你「說」的工具:用白話請它改東西,它動手。GitHub Desktop=你「看」的工具:看它改了哪一行、確認沒問題,再一鍵送上線。你不用會寫程式,但要會看懂與把關——這就是危險雷達。
GitHub Desktop 你應該已經照課前信裝好——它是一個圖形介面 App,把雲端的 repo 下載一份到你電腦,並幫你處理登入、上傳、下載。今天要做的只是確認裝好、登入,然後把課程 repo clone 下來。
- 打開 GitHub Desktop,確認顯示已 Sign in to GitHub.com(沒登入就現在登入,不用產金鑰、不用密碼貼來貼去)
- File → Clone repository → 選課程 repo → 選一個本機資料夾 → 按 Clone(這一步就是「把 repo 綁到本機」)
- 完成後按 Show in Finder,看得到那個資料夾——這就是你電腦上的工作現場
Claude Code 你第 1 堂已經裝好了——它是能讀你整個資料夾、照你講的話改檔案的 AI 助手。今天唯一的新動作,是讓它對準你剛剛 clone 下來的那個資料夾工作。
- 打開 Claude Code 桌面版 App → 用「開啟資料夾」指到剛剛 clone 的專案資料夾
- 確認還登得進去(需付費方案;第一次可能要再用瀏覽器登入一下)
- 隨口問它「這個資料夾裡有什麼?」——它答得出你的檔案,就代表接上了
搬到本機後,你會真的開始存檔。玩過遊戲都知道:不會每走一步就存,而是做完一個段落存一次——存檔的意義是「這裡是一個我想得回的點」。
第 1 堂是用網頁上傳,檔名沒有固定規則——現在要在本機資料夾裡工作,第一件事是先找到「哪個檔案是我的」。
- 打開
submissions/u/你的帳號.html(你的個人頁),點「開啟完整作品 →」——網址列顯示的檔名就是你的檔案 - 在 clone 下來的資料夾裡新增
submissions/你的帳號/lesson-02/資料夾 - 把剛剛找到的檔案複製進去,改名為
index.html
lesson-XX/ 資料夾延續改——每堂課都是接著上一堂的存檔點繼續,不是從零重來。接下來兩個改動都只動你自己的 index.html,不會跟任何人的東西衝突——先把「說 → 看 → 送出」的手感練熟,各自完成一次 commit → push。
用下面的 Prompt A 請 Claude Code 打開 submissions/lunch-locations.json(全班第 1 堂收集到的真實地點),挑一個補進你的揪團卡。看 GitHub Desktop 的 diff → 寫一句 commit 訊息 → push。
逛過同學作業應該碰過:直接打開別人的頁面,沒辦法點回作業列表。用下面的 Prompt B 請它幫你的頁面也加一個「← 回作業索引」的小連結。看 diff → commit → push。
對著 Claude Code 用自己的話講
請打開 submissions/lunch-locations.json,這是我們班第 1 堂收集到的真實店家清單。 挑一個地點,把它的名稱、地址(如果有)等資訊,補進我目前的揪團卡片裡,取代原本寫死的範例資料。 改完用一兩句話告訴我你補了哪一家、動了哪個檔案。
我的這個檔案放在 submissions/我的帳號/lesson-02/index.html。 請幫我在頁面右上角加一個小小的「← 回作業索引」連結,連到 submissions/index.html (注意相對路徑要從我這個檔案的位置往上算兩層)。
剛剛兩次改動只動自己的檔案。但現在要做一件不一樣的事:把一個新地點加進 submissions/lunch-locations.json——這個檔案全班都會動到。
issue=留一句話紀錄「我打算加什麼」,尤其是要動大家共用的東西時——方便之後回頭追蹤是誰、為什麼加的。PR=我已經做完了,拿出來給大家看、等講師合併。動自己的檔案通常可以省略 issue 直接開 PR;動共用資源,留一個 issue 紀錄比較好追。
- 找一個
lunch-locations.json清單上還沒有的真實地點 - 開一個 issue:「新增地點:[店名]」,一句話寫清楚要加什麼
- 開分支 → 用 Claude Code 把這個地點加進
submissions/lunch-locations.json(格式跟現有的一樣)→ commit → push - push 後開 PR,描述裡連結剛剛的 issue(例如
Closes #12)
對著 Claude Code 用自己的話講
請幫我在 submissions/lunch-locations.json 裡新增一筆地點: [店名、地址等你知道的資訊] 格式要跟檔案裡現有的其他筆一致,加完幫我確認整份 JSON 還是合法的。
作業:完成本堂兩個「自己檔案」的 commit + push,再加一個「新增地點到共用清單」的 issue + PR。PR 描述請 AI 幫你寫,說明你新增的地點是什麼、為什麼選它。課後到至少一位同學的 PR 留言。
講師 / 助教檢核重點
- 個人資料夾 submissions/你的帳號/lesson-02/index.html 已建立且能開啟
- 完成至少兩次「自己檔案」的 commit + push(補資料 + 回索引連結)
- 1 張 issue(新增地點)+ 1 個連結該 issue 的 PR(改動 lunch-locations.json)
- 學員能說出「動自己的檔案」跟「動共用檔案」在 issue/PR 用法上的差別
- 課後每個 PR 收到至少一則同學留言