Gemini CLI 教學【番外篇】：PM 的 AI 協作護城河—無痛導入 Git 版控

步驟一：安裝 Git

Git 是負責在背景默默記錄所有變更的核心引擎。

步驟二：安裝 Visual Studio Code (VS Code)

這是我們編輯文件和操作 Git 的介面。它比 Word 更輕量，比記事本更強大。

1. 前往 VS Code 官網 下載並安裝。
2. 安裝完成後打開 VS Code。

步驟三：設定您的「簽名」

在時光機運作前，它需要知道「你是誰」，這樣未來的您才知道這些變更是誰做的。

1. 打開 VS Code。
2. 點擊上方選單的 "Terminal" (終端機) > "New Terminal" (新增終端機)。
3. 下方會出現一個黑色或深藍色的視窗，請依序複製貼上以下兩行指令 (記得將引號內的內容改成您自己的)：

git config --global user.name "您的英文名字"
git config --global user.email "您的Email"

例如：

git config --global user.name "John Doe"
git config --global user.email "johndoe@example.com"

圖說：在終端機輸入這兩行指令，按下 Enter 後不會有特別的顯示，這是正常的。

步驟一：註冊與建立專案

1. 前往 GitHub 註冊一個免費帳號。
2. 登入後，點擊右上角的 "+" 號，選擇 "New repository" (新增專案)。
3. Repository name：填寫專案名稱 (例如：My-PRD-Project)。
4. Private：重要！請務必勾選 Private (私有)，這樣只有您自己看得到這些文件。
5. 點擊最下方的 "Create repository" 按鈕。

圖說：請務必選擇 Private，保護您的商業機密。

步驟二：取得保險庫地址

建立完成後，您會看到一個充滿程式碼的頁面。請找到 "HTTPS" 的網址欄位，點擊旁邊的複製按鈕。

圖說：點擊這個小按鈕複製網址。

步驟一：Clone 專案到電腦

1. 回到 VS Code 主頁 (起始畫面)。
2. 點擊：Clone Git Repostory。
3. 在上方跳出的搜尋框貼上剛剛從 GitHub 複製的網址，按下 Enter。
4. 選擇一個您想存放這個專案的資料夾，例如 C:\GitSrc。(請注意，不必手動再建立下一層資料夾，因為我們 Clone 後就會在地端自動建立那個資料夾。)

建立 .gitignore 檔案

這是一個特殊的檔案，它的名字就叫做 .gitignore (注意開頭有一個點)。任何被寫在這個檔案裡的名稱，Git 都會假裝沒看到。(在 VS Code 視窗中，這個檔案會是灰色的，很好識別)

1. 在 VS Code 左側檔案總管的空白處點擊右鍵，選擇 "New File" (新增檔案)。
2. 輸入檔名 .gitignore 並按下 Enter。
3. 將下方的範本內容複製貼上到這個檔案中，並存檔 (Ctrl+S / Cmd+S)。

# --- 系統檔案 (不需要備份) ---
.DS_Store
Thumbs.db

# --- 敏感資訊 (絕對不能上傳！) ---
.env
secrets.txt

# --- 大型檔案或過程產物 (建議自己留著就好) ---
*.mp4
*.mov
*.mp3
*.wav
*.zip
Record/
LegacyPRD/

語法小教學：

• *.mp4：星號 * 代表「所有」，所以這行意思是「忽略所有副檔名是 mp4 的檔案」。
• .env：這是存放 API Key 等機密資訊的檔案，雖然您現在可能還沒用到，但先把它加進來是個好習慣，務必將不能上雲的機敏資訊放在 .env。
• Record/：這代表專案資料夾裡面的，名稱叫做 Record 子資料夾裡面的東西，都不會上 Git 版控，您可以把大檔案如訪談錄音、不上雲的資料夾都加入到 .gitignore 類似 LegacyPRD 這個資料夾這樣。

圖說：建立好這個檔案，您的版控生涯會少掉一半的麻煩。

動作一：打包 (Stage)

告訴 Git 哪些檔案的變更要被記錄。

1. 點擊左側選單的 "Source Control" (原始檔控制) 圖示 (看起來像樹枝分岔的圖案)。
2. 您會看到 PRD_v1.md 出現在 "Changes" (變更) 清單中。
3. 將滑鼠移到檔案名稱旁，點擊 "+" (Stage Changes) 號。
4. 檔案會移動到 "Staged Changes" (暫存的變更) 區域。這表示「行李打包好了」。
5. 接下來依序將您剛剛複製進來的工作檔案一個一個 "+" (Stage Changes)即可，包含 .gitignore 也要喔。
6. (剛開始先不使用 Stage all，我們手動逐一暫存比較放心。)

動作二：標記 (Commit)

為這包行李貼上說明標籤，方便以後查找。

1. 在上方輸入框輸入這次變更的說明。例如：「完成會員註冊流程草稿」，這部分要簡潔扼要又不失重點，將來您要找這個變更時，一眼就能看懂。
2. 點擊 "Commit" (提交) 按鈕。

圖說：寫給未來的自己看，越清楚越好。

動作三：Push (推送)

將紀錄推送到雲端保險庫。

1. 點擊雲朵圖案 "Publish Branch" 按鈕。

往下看到 "GRAPH" 區塊，已經可以看到我們的 main 分支已經有了我們的紀錄。(紫色雲朵圖)

步驟一：召喚時光機面板

VS Code 把這個強大的功能藏在檔案總管的最下面。

1. 在左側欄中，點擊一下 "Source Control" (原始檔控制) 圖示 (看起來像樹枝分岔的圖案)。。
2. 將視線移到左側欄位的中下方區域，您會看到一個叫做 "GRAPH" 的區塊。
3. 如果它是收合的 (只看到標題)，請點擊箭頭把它展開。
4. 您會看到一串清單，上面寫著 "Uncommitted Changes" (尚未提交的變更) 以及您之前寫過的 Commit 紀錄 (例如「完成會員註冊流程草稿」)。

圖說：這就是通往過去的入口。

步驟二：穿越時空 (比對差異)

假設您發現：「糟糕！我昨天寫的那段『使用者故事』被爆走的 AI 不小心刪掉了！」別擔心，我們來找回來。

1. 在 GRAPH 清單中，試著點擊昨天的某個紀錄點。
2. 畫面會瞬間變成「左右分割」的狀態：
   • 左邊視窗 (The Past)：這是過去那個時間點的檔案內容。
   • 右邊視窗 (The Present)：這是現在您正在編輯的檔案內容。
3. VS Code 會很貼心地用顏色標示差異：紅色代表被刪除的，綠色代表新增加的。

圖說：左邊是過去，右邊是現在，差異一目了然。

步驟三：取回遺失的寶物

Git 有很多進階指令可以「倒帶」，但對於剛入門的您，我建議用最直覺、最安全的方法：複製貼上。

1. 在左邊視窗 (過去) 找到您誤刪的那段文字。
2. 像平常一樣選取它，按 Ctrl+C (複製)。
3. 回到被您改壞的那個檔案編輯視窗，找到您想插入的位置。
4. 按 Ctrl+V (貼上)。
5. 按下 Ctrl+S 存檔。

步驟一：重新整理 GitHub 頁面

1. 回到您的瀏覽器，打開剛剛那個 GitHub 專案的頁面。
2. 按一下重新整理 (F5 或 Cmd+R)。
3. 您會發現原本空蕩蕩的列表，現在已經出現了您剛剛推送的檔案 (例如 PRD_v1.md)。

圖說：檔案已經安全地躺在雲端保險庫了。

步驟二：查看雲端歷史紀錄

GitHub 上也有一份完整的歷史紀錄，而且介面非常漂亮。

1. 在檔案列表的右上方，找到一個時鐘圖示，旁邊寫著 "X commits" (X 代表提交次數)。
2. 點擊進去，您會看到每一次 Commit 的清單，包含您寫的標題、時間、以及是誰提交的。
3. 點擊任一個 Commit 的標題 (例如「完成會員註冊流程草稿」)，就可以看到那次變更具體改了什麼內容 (綠色是新增，紅色是刪除)。

圖說：這裡清楚記錄了專案的演進史。