Gemini CLI 學習筆記 : Python 專案開發的標準工作流程

在前一篇測試中, 我們使用 uv 工具建立 Python 專案後, 手動編輯描語境檔 GEMINI.md, 然後啟動 Gemini CLI, 它會自動讀取 GEMINI.md, 確認它所擬定的執行計畫後, 要求它開始撰寫程式. 本篇旨在摘要整理使用 Gemini CLI 開發 Python 專案時的 SOP.

本系列全部測試文章索引參考 :

# Gemini CLI 學習筆記索引

後續的測試都會使用 uv 工具來建立 Python 專案結構, 關於 uv 參考 :

# Python 學習筆記 : 整合型 Python 版本管理工具 uv  

在 Windows 下使用 Gemini CLI 進行 Vibe Coding 的工作流程如下 :

1. 生成語境檔 : 使用 Gemini 或其他 AI 生成 GEMINI.md 內容
   提示詞模板 : "我要用 Gemini CLI 開發一個 Python 專案 (使用 uv 工具), 目標是 {}, 技術堆疊是 {}, 請以繁體中文幫我撰寫 GEMINI.md 語境檔." 
2. 開啟終端機 : 開啟 PowerShell 視窗
3. 建立地基 : uv init <專案名稱> (建立資料夾與環境)
4. 進入專案 : cd <專案名稱>
5. 建立語境檔 :
• 直接在 PowerShell 輸入 notepad GEMINI.md
• 系統會問 "找不到檔案, 是否建立?", 選 "是" 
• 貼上內容後存檔關閉記事本 (notepad 預設存檔格式 UTF-8)
6. 啟動 AI : 輸入 gemini 進入 Gemini CLI
7. 載入與確認 (Prompt 優化) :
   輸入 "請讀取當前目錄下的 GEMINI.md, 根據該文件規範, 你了解這個專案的目標與限制了嗎? 請先列出你的實作計畫 (Step-by-step plan), 不需要先寫程式碼"
   (說明：明確指出要讀取的檔案, 並強調 "根據該文件" 以確保 AI 不會忽略它)
8. 執行專案 : 
   輸入 "計畫沒問題, 請開始執行第一步 (或是 Go ahead)"

如下圖所示 : 

uv init 建立的專案架構中的 pyproject.toml 是給 Python 執行環境看的專案描述檔, 此流程中我們先用 uv init 把地基打好, 然後再用 gemini 把 Gemin CLI 叫進來幹活.