Michael AI Agent Lab：AI Agent 培訓 Vibe Coding 的 GitHub 入門
培訓資料庫 回首頁

Git／GitHub 安全工作流程

先會存檔，AI 才能放心加速

Claude、Cursor、Codex 問你 提交、分支、PR，不是在講艱深指令，而是在問：要不要存檔、隔離風險、送審與回復。

不用背指令，但要會下判斷。

先分清楚兩件事

Git 和 GitHub 經常被混在一起。對 AI 程式設計 來說，這個差異會影響你要不要讓 代理 上傳、回復或合併。

本機控制

Git 是本機版本控制

它負責追蹤資料夾裡的每次改動。當 AI 改壞程式時，你可以知道改了什麼，也可以回到上一個正常狀態。

雲端協作

GitHub 是雲端協作平台

它負責保存 儲存庫、分享給同事、發 PR、審查與合併。推送 之前一定要先確認不要把 key、密碼或私密檔案送上去。

十個術語的工作判斷

不要先背命令。先理解每個詞在 AI 開發流程裡到底解決什麼風險。

檢查點

commit

把目前可用狀態存成一個檢查點。AI 問你要不要 提交，就是問你要不要先買保險。

上傳

push

把本機 提交 推到 GitHub。推送 前先檢查 `.gitignore`，不要讓 API key 或公司私密檔案上雲端。

加入

clone

正式把 儲存庫 複製到本機，保留 Git 歷史與同步能力。它不是單純 下載 ZIP。

同步

pull

把 GitHub 上其他人或其他 代理 的最新進度抓回本機。PR 合併 後，本機 主分支 也要 拉取。

隔離環境

branch

開一條不影響 主分支 的實驗線。新功能、大修改、AI 不確定的任務，都應該先在 分支 做。

平行執行

worktree

幫不同 分支 建立不同實體資料夾。多個 AI 代理 同時工作時，用 獨立工作目錄 避免互相踩檔案。

複習

合併請求

Pull Request 是變更提案。讓同事或 審核者 代理 先看改了什麼、怎麼測，再決定要不要合併。

核准

merge

把審核後的 分支 合回 主分支。合併 在 GitHub 完成後，本機 主分支 還要 拉取 才會同步。

復原

restore

還沒 提交 的錯誤修改，可以恢復到上一個正常檢查點。適合「AI 剛改壞，我不要這些改動」。

安全復原

revert

已經 提交 的錯誤，用反向 提交 取消。協作時比偷偷改歷史安全，大家看得到發生過什麼。

多個 AI 同時做事時怎麼不打架

分支 像同一張桌子的不同狀態；獨立工作目錄 則是多張實體桌子。AI 代理 並行時，要給它們不同工作區。

只用 分支

A
資料庫功能 分支可以隔離 主分支，但同一個資料夾一次只能呈現一個 分支。
B
介面 重設計 分支如果兩個 代理 在同一資料夾切來切去，容易混入錯誤狀態。
改用
worktree

branch＋worktree

A
代理 A 專用資料夾只處理資料庫功能，提交 到自己的 分支。
B
代理 B 專用資料夾只處理 介面 重設計，互不污染，再各自開 PR。

AI Coding 的五個安全閘門

讓 AI 寫得快之前，先把哪些事情一定要檢查清楚。這些是降低災難成本的基本規則。

推送 前查機密

要求 代理 確認 `.env`、API key、代元、密碼都已在 `.gitignore` 或未被追蹤。

大改前先 提交

目前能跑的版本先存檔，AI 改壞時才有明確回復點。

新功能開 分支

主分支 保持穩定，新功能、重構、介面 大改都放到獨立 分支。

合併 前開 PR

PR 要說明改了什麼、測了什麼、哪些檔案受影響，方便人或 審核者 代理 檢查。

合併後 拉取

GitHub 上 合併 完，本機 主分支 不會自動更新。下一個 分支 前先 拉取。

你可以直接這樣交辦 AI

重點是把風險邊界說清楚。你不需要背 Git 指令，但要能描述你要的狀態。

開始新功能

請先從 主分支 開一個新 分支 做這個功能，所有修改都 提交 在這個 分支，不要直接動 主分支。

推送 前檢查

推送 前請檢查 `.gitignore`，確認 `.env`、API key、代元、密碼與公司私密資料沒有被 提交。

多 代理 並行

請為這個任務建立獨立 獨立工作目錄，讓它和目前工作資料夾分開，避免兩個 代理 改到同一批檔案。

準備 PR

請為這個 分支 建立 PR，說明完成內容、修改檔案、測試方式、風險點與 審核者 要注意的地方。

處理 衝突

請分析 衝突，保留朋友的新邏輯，但把我新增的分類移到右側進階選單，再跑測試確認。

改壞回復

我不要剛剛那批錯誤修改。請判斷目前狀態，若尚未 提交 就 還原，若已 提交 就用安全方式 反向提交。

來源／審查筆記