VS Code

Visual Studio Code 是目前最受歡迎的開發環境，
免費、開源、輕巧、擴充性超高。

常用插件推薦

Cursor：AI 時代的 IDE

基於 VS Code 打造的「AI IDE」
你可以直接用自然語言對程式說話

• 「幫我重構這段函式」
• 「解釋這個錯誤訊息」
• 「產生這段邏輯的測試程式」

function getOddNumbers(arr) {
  const result = [];
  for (let i = 0; i < arr.length; i++) {
    if (arr[i] % 2 !== 0) result.push(arr[i]);
  }
  return result;
}

在 Cursor 裡，選取這段程式 → 輸入 /refactor
AI 會自動建議：

const getOddNumbers = arr => arr.filter(n => n % 2 !== 0);

常用指令

開發思維

功能討論 → 文件撰寫 → 程式實作 → 測試驗證 → AI 自我監督與文件同步

一) 功能討論與文件

• 重點：在動手寫程式前，先用文字說清楚要做什麼。

  欄位	說明
  功能名稱	清楚表達功能用途
  使用情境	誰會用、為什麼需要
  輸入（Input）	要傳入什麼資料
  輸出（Output）	回傳什麼結果
  邏輯流程	步驟／流程圖說明
  例外狀況	錯誤時該怎麼處理
  測試情境	預先想到的測試案例

//功能名稱
calculateAverage()

//使用情境
計算一組數字的平均值。

//輸入
[80, 90, 100]

//輸出
90

邏輯流程

1. 檢查是否為陣列
2. 過濾非數字項
3. 求和除以長度
4. 回傳平均值

測試案例

- [80, 90, 100] → 90
- [80, "a", 100] → 90
- [] → null

二) 文件自動更新（AI 文件同步）

• 每次修改程式碼後，AI 可以幫你同步更新文件。

  AI 文件更新 Prompt：
  「請根據以下程式碼的變化，自動更新功能文件。
  若文件與程式不一致，請標註差異部分並建議修正。」

  這樣就能確保「功能文件永遠最新」。

三) Git Commit 流程

• 每次提交都應該清楚表達「改了什麼」。
  使用統一格式，可以讓專案回顧更簡單。

  類型	用途
  feat	新功能
  fix	修正錯誤
  docs	文件更新
  test	測試補充
  refactor	程式重構
  chore	設定與雜項

  feat: add calculateAverage() | 計算平均值功能
  docs: update README for average function
  test: add edge case test for empty array
  

四) AI 自我監督與測試循環

• 在測試階段，AI 不只是「寫測試」，
  還能「幫你審查測試是否夠完整」。

  AI 測試監督 Prompt：
  「請檢查以下程式與測試案例是否涵蓋所有邏輯。
  若缺少邊界測試、錯誤處理或命名不一致，請提出具體改進建議。」

AI 能幫你：

• 找出未測試的情境
• 發現文件與實作不一致
• 自動生成補充測試案例

五) 最終自動化循環圖

[功能討論]
   ↓
[AI 產生功能文件]
   ↓
[人工審閱 + 實作程式]
   ↓
[AI 生成測試 + 自我檢查]
   ↓
[Git Commit + 文件同步更新]
   ↓
[AI 比對版本差異 → 提醒更新]
   ↺（再回到起點）

Prompt 架構構想：

• 請持續監控專案文件與程式碼一致性。
• 若文件未更新、測試覆蓋率下降或 commit message 不清楚
  自動提出改善建議並生成可行修改方案。