iSpan_python-FE_DM-cookbooks — Cursor Rules

本文件旨在建立一套涵蓋軟體開發全流程與 AGI 輔助技術的整體指引，幫助團隊與個人達成快速原型 (POC) 開發、知識積累與持續優化。文件整合了以下各部分內容： • 與使用者互動及內部記錄的基本指示 • 開發過程中各角色的分工與職責 • 軟體開發流程與運算思維方法 • 快速 POC 開發的 SOP 指引 • 持續學習與自我優化的機制 • 套件與版本紀錄機制（含版本相依性守則） • 依賴查詢：透過官方文件 URL 搜尋套件相依性資訊 ---

• 啟動命令提示字元：按下 Win + R，輸入 cmd，然後按 Enter。 • 切換目錄：使用 cd，例如 cd C:\path\to\project。 • 列出檔案與資料夾：使用 dir。 • 建立資料夾：使用 mkdir 資料夾名稱。 • 刪除檔案：使用 del 檔案名稱。 • 刪除資料夾：使用 rmdir /S /Q 資料夾名稱（包含子目錄且不提示）。 • 複製檔案：使用 copy 來源 目的地。 • 移動檔案／資料夾：使用 move 來源 目的地。 • 執行 Python 腳本：使用 python script.py 或 py script.py。 • 串接多重指令： • 使用 && 僅當前一指令成功時才執行下一指令，例如： `bat mkdir test && cd test ` • 使用 || 僅當前一指令失敗時執行下一指令，例如： `bat type missing.txt || echo File not found ` • 使用 & 不論前一指令成功或失敗都執行下一指令，例如： `bat echo step1 & echo step2 ` ---

PowerShell 為 Windows 上進階的殼層（shell）與指令腳本環境，與 Linux shell（bash/zsh）在語法與物件模型上有以下主要差異： • 物件導向管線：PowerShell 的管線傳遞物件，而非純文字。例如： `powershell Get-Process | Where-Object { $_.CPU -gt 100 } ` • 指令（cmdlet）命名慣例：多為 動詞-名詞 格式，如 Get-ChildItem、Set-Location，對應 Linux 的 ls、cd。 • 變數宣告：變數前需加 $，且不需顯式宣告類型，例如： `powershell $files = Get-ChildItem -Path . -Filter *.txt ` • 切換目錄：使用 Set-Location（別名 cd）、Push-Location / Pop-Location 管理位置堆疊。 • 列出檔案：使用 Get-ChildItem（別名 ls, dir）、可搭配 -Recurse 深度搜尋。 • 建立資料夾：使用 New-Item -ItemType Directory -Name 資料夾名稱。 • 刪除檔案／資料夾：使用 Remove-Item 路徑；加 -Recurse 刪除子目錄，加 -Force 忽略提示。 • 複製檔案：使用 Copy-Item來源 -Destination 目的地。 • 移動檔案／資料夾：使用 Move-Item 來源 -Destination 目的地。 • 執行 Python 腳本：與 CMD 相同，使用 python script.py，但可在同一行中搭配 PowerShell 參數。 • 執行腳本設定：預設禁止執行腳本，可透過 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser 設定執行策略。

• 可重用資訊記錄 在與使用者互動過程中，若發現專案中可重用的資訊（例如函式庫版本、模型名稱、錯誤修正或收到的糾正），請立即記錄於本文件的 Lessons 區塊，避免日後重複相同錯誤。 • Scratchpad 作為思考與記錄工具 • 使用本文件作為 Scratchpad（工作筆記區），組織與記錄所有新任務的思考、規劃與進度。 • 開發流程規劃 - 任務內容 • 接到新任務時，首先回顧 Scratchpad 內容，若有與當前任務無關的舊任務，請先清除。 • 說明任務內容、規劃完成任務所需步驟，可使用 todo markers 表示進度，如： • [X] 任務 1 • [ ] 任務 2 • 完成子任務時更新進度，並於每個里程碑後反思與記錄，確保全局規劃與細節追蹤兼備。 ---