# Open Vibe Developers：Vibe Coding 的最佳實踐

{%hackmd @coscup/announcement-2025 %}

> 請從這裡開始

###### tags: `COSCUP2025`, `zhtw`, `elementary`

- AI Vibe coding 為主，目前大多花時間在 Coding 實踐前的計畫，反正 coding 實踐的部分則都由 AI 來協助處理。

- 藉由 AI 來協助將專案規劃切分為：
- 輕量腳本
- 中型應用
- 複雜系統

- 有將 AI 分門別類為「能力類別分類」與「AI 自動化程度分級」
- 能力類別分類
- 語言與建構程式
- 需求拆解與需求撰寫
- 除錯測試
- 資料結構與演算法
- UI/UX 設計
- 資料庫設計
- 系統架構
- 可觀察性
- 安全與資安
- AI 自動化程度分級 from 史丹佛某 paper
- H1 - AI 可完全獨立完成任務
- H2 - 僅需極少人為調校
- H3 - AI 與人類 1:1 合作
- H4 - AI 須仰賴人類關鍵輸入
- H5 - AI 幾乎無法獨立運作
- 講者認為目前 AI 屆於 H3 到 H4 之間。
- 而 AI 目前尚無辦法達到「複雜系統」的開發。但該特點將會隨著時間改變，可能未來或許就能處理「複雜系統」。
- 目前尚處於需要人機協作的階段，而人機協作講者解釋可以想像成無人機如何抵抗強風的判斷，基本上現在都是透過 AI 去協助及校正這些誤差。
- 講者有分享一個「以 Gemini CLI 為例，了解當代 Coding Agent」的設計影片 - [影片連結](https://youtu.be/DuKV_tWES-M?si=MajstRhJ6o3ol90R)
- AI 的使用上的最佳實踐
- 最佳實踐一、規格先行:
- 產品需求文件 (PRD) : 詳細定義產品功能、使用者故事和業務目標，確保開發方向與客戶期望一致
- 流程圖
- 類別圖(Class Diagram): 不一定要需要這個，明確定義程式碼結構、物件關係和繼承層次
- C4 架構圖: 以系統、容器、組件合程式碼四個層次 ，清晰溝通軟體架構，提升團隊對整體設計的理解
- 最佳實踐二、測試驅動開發
- TDD、BDD
- 最佳實踐三、提供完整具體的 Context
- 講者分享了使用 PRD 方式當成 Prompt 來產出一個專案。
- 講者分享了使用 AI 來產生 流程圖、UML、
- 然而，透過 AI 製作出來的圖示有些太過仔細。是好是壞，講者持保留態度。
- 除了一般的提示工程(Prompt Engineering)外，還有情境工程(Context Engineering)。
- 提示工程：在對話當中使用
- 情境工程：是在整個系統中（例如放置檔案...等。），讓整個 AI 輸出結果更好。

PRD 流程圖 規格圖 C4

## 總結
1. Vibe Coding 正在改變程式開發，但是面對複雜的開發專案仍需要人機協作。
2. 我們需要一套準則（最佳實踐）幫助我們讓人機協作更順暢。
3. 了解當代 Conding Agent 的運作原理，能更好地與之協作。
4. 實踐一：規格先行，透過 PRD、流程圖、類別圖和 C4 架構圖確保開發方向。
5. 實踐二：測試驅動開發，TDD、BDD、ATDD 確保程式碼品質與業務需求一致。
6. 實踐三：提供完整且具體的 Content，透過情境工程強化 AI 環境感知，避免幻覺問題。

## Open Vibe Developers 社群
- 講者開立的一個社群
- 長期目標：提供給開發者提供並分享些 vibe coding 的實作及經驗。目前相關活動正舉辦中，未來也將舉行一些技術經驗分享會。