vibeCoding-mcp: Cursor rule for Cursor

.cursorrules 文件：軟體開發與 AGI 融合指引 (Windows 環境優化版)

本文件旨在建立一套涵蓋軟體開發全流程與 AGI 輔助技術的整體指引，特別針對 Windows 環境與 PowerShell 進行優化，幫助團隊與個人達成快速原型 (POC) 開發、知識積累與持續優化。

🖥️ Windows 環境特別說明

本指引特別針對 Windows 10/11 環境進行優化，包含：

• PowerShell 與 Linux 指令對照表
• Windows 特有問題解決方案
• 跨平台開發最佳實踐
• Windows 開發環境設定指引

文件整合了以下各部分內容：

• 與使用者互動及內部記錄的基本指示
• 開發過程中各角色的分工與職責
• 軟體開發流程與運算思維方法
• 快速 POC 開發的 SOP 指引
• 持續學習與自我優化的機制
• 套件與版本紀錄機制（含版本相依性守則）
• 依賴查詢：透過官方文件 URL 搜尋套件相依性資訊
• Windows 環境專用開發指引 ⭐ 新增

---

一、基本指示 (Instructions)

🖥️ Windows 環境優先考量

• 指令使用: 優先使用 PowerShell 指令，必要時提供 Linux 對照
• 路徑格式: 使用 Windows 路徑格式 (C:\path\to\file)，但程式碼中使用跨平台寫法
• 權限管理: 注意 PowerShell 執行政策與管理員權限需求
• 編碼問題: 預設使用 UTF-8 without BOM 避免編碼問題

📝 記錄與協作規則

• 可重用資訊記錄
  在與使用者互動過程中，若發現專案中可重用的資訊（例如函式庫版本、模型名稱、錯誤修正或收到的糾正），請立即記錄於本文件的 Lessons 區塊，避免日後重複相同錯誤。

  Windows 特別注意:

  • 記錄 PowerShell 特有的解決方案
  • 標註需要管理員權限的操作
  • 記錄路徑相關的問題與解決方案

• Scratchpad 作為思考與記錄工具

  • 使用本文件作為 Scratchpad（工作筆記區），組織與記錄所有新任務的思考、規劃與進度。
  • 開發流程規劃 - 任務內容
  • 接到新任務時，首先回顧 Scratchpad 內容，若有與當前任務無關的舊任務，請先清除。
  • 說明任務內容、規劃完成任務所需步驟，可使用 todo markers 表示進度，如：
    • 任務 1
    • 任務 2
  • 完成子任務時更新進度，並於每個里程碑後反思與記錄，確保全局規劃與細節追蹤兼備。

  Windows 任務規劃特別事項:

  • 標明需要管理員權限的任務
  • 考慮 Windows Defender 或防毒軟體的影響
  • 規劃跨平台相容性測試

---

二、開發指引

development_guideline.md

此區為根據 產品開發流程使用說明書.md 的指引，規劃整個系統的開發流程作為基本指示 (Instructions) 的 checklist。

---

三、資料夾結構規劃

folder_structure.md

此區為規劃整個系統的資料夾模組和套件的結構，詳細說明每個檔案的目的用途。

資料夾規劃說明

1. 模組化結構:

   • 依照課程六大模組建立對應資料夾
   • 各模組下設立統一的子資料夾: data, exercises, notebooks, slides

2. 教材層次化:

   • notebooks目錄下的教材依照課程內容進行編號
   • 從基礎到進階的漸進式知識建構

3. 實務導向:

   • 每個模組均包含exercises提供練習
   • M6設置專案目錄用於整合性專題製作

4. 補充資源區:

   • 提供參考資料、進階主題與通用資料集
   • 常用函數模組化於common目錄下便於重複利用

5. 資料集管理:

   • 各模組教學所需的資料集放在模組內的data目錄
   • 通用大型資料集集中在supplementary/datasets目錄

---

四、Scratchpad

Scratchpad.md

此區為內部記錄區，請在進行每項任務時依序記錄任務目標、規劃步驟、進度更新與反思筆記，確保能夠隨時回顧與調整作業策略。