一人團隊 + AI 協作：打造極致高效的現代化開發工作流

在 AI 輔助寫程式（如 Cursor, Windsurf, Copilot）普及的今天，“Solopreneur”（單人創業者）的定義正在被改寫。我們不再是一個人在戰鬥，而是帶領著一群不知疲倦、速度極快但也容易犯錯的 AI 實習生。

這帶來了新的挑戰：如何不被 AI 產生的大量程式碼淹沒？如何確保專案品質，同時享受 AI 帶來的速度？

答案在於建立一套專為「人機協作」設計的 Git Workflow。本文將分享我們在這個專案中實踐的 「混合工作流 (Hybrid Workflow)」。

1. 核心困境：速度 vs. 安全

傳統的團隊開發流程（Git Flow）強調嚴謹的 Code Review，每一個改動都要開 Pull Request (PR)，等人審核。但在單人開發中，這個流程太慢了。

另一方面，如果所有改動都直接 git push master，當 AI 一次重構了 20 個檔案並把網站炸掉時，你會欲哭無淚。

我們需要的是一條「快車道」和一條「安全車道」。

2. 解決方案：混合工作流 (Hybrid Workflow)

我們採用的策略是根據 「變更的風險與規模」 動態選擇路徑：

🛣️ 快車道：Direct Merge

適用於風險極低、需要快速迭代的小型任務。

• 適用場景：
  • 文件更新 (Docs)
  • 修復錯字 (Typos)
  • 小型 Bug 修復 (Small Fixes)
  • 變更檔案數 < 5 個
• 流程：
  1. AI 在本地分支修改。
  2. AI 自行執行測試 (npx astro check)。
  3. Local Merge：直接在本地合併回 master。
  4. Push：推送到遠端 master 部署。

這就像是你自己隨手改了一行 Code，不需要繁瑣的儀式感。

🛡️ 安全車道：Pull Request (PR)

適用於高風險、需要視覺確認或大規模重構的任務。

• 適用場景：
  • UI 功能開發 (New Features)
  • 核心架構重構 (Refactoring)
  • 依賴升級 (Dependency Upgrades)
  • 變更檔案數 > 5 個
• 關鍵機制：預覽部署 (Preview Deployment)
  • 這是 PR 流程的靈魂。Cloudflare Pages 或 Vercel 會為每個 PR 自動生成一個臨時網址（例如 pr-12.app.com）。
  • 你不需要看艱澀的 Code Diff，你只需要點開那個網址。
  • 手機版選單正常嗎？動畫順暢嗎？顏色對嗎？
  • 確認無誤後，按下 Merge。

這就像是 AI 實習生做好了一個功能，請你先檢查一下，確認沒問題才上線。

3. 分支衛生守則 (Branch Hygiene)

AI 開發的一個副作用是「分支爆炸」。AI 習慣為每個小任務開一個分支，如果不清理，幾週後你的 GitHub 就會堆積數百個 feat/update-css-style 的殭屍分支。

我們在開發規範 (LLMGUIDE.md) 中加入了嚴格的 Definition of Done (DoD)：

Clean up LOCAL AND REMOTE branches.

這不僅僅是刪除本地分支 (git branch -d)，更重要的是刪除遠端分支 (git push origin --delete)。我們將此寫入 AI 的核心指令，讓 AI 在任務結束後自動執行清理，保持倉庫的整潔。

4. 結語

在這個工作流中，開發者的角色從「寫程式的人」轉變為「Code Reviewer」和「Release Manager」。

• 對於小事，我們信任 AI，讓它快速通關。
• 對於大事，我們利用 PR 和 Preview Deploy 建立安全網。

這套 Hybrid Workflow 讓我們在享受 AI 極速開發的同時，依然能睡個好覺，因為我們知道 master 分支永遠是乾淨、穩定且經過驗證的。