matlab-mcp-workspace
Skill: MATLAB MCP Workspace 結構化管理 + matlab-skills Plugin 整合
安裝
在 Claude Code 中執行以下指令：
# 1. 新增 Marketplace 來源
claude plugin marketplace add felimet/matlab-mcp-workspace
# 2. 進行安裝
claude plugin install matlab-mcp-workspace
為什麼需要這個 Skill
matlab-mcp-core-server 的 Initial Working Folder 是固定的。沒有任何結構約束的話，不同任務、不同對話生成的 .m 全部攤在同一層，三個月後你不知道哪個是哪個、哪個還能用、哪個是廢料。
| 問題 | 解法 |
|---|
| 跨任務程式碼混雜 | projects\ / _temp\ / _shared\ 三分法 |
| 跨對話失去 context | README.md 狀態機 + Session Announcement |
| 函數被覆蓋 / 版本衝突 | 結構性改寫先備份 + Git 整合 |
| 每次重啟 path 消失 | startup_workspace.m 自動維護 startup.m |
| 路徑寫死 → 換機器就炸 | 所有程式碼用 mfilename 自我定位，零 hardcode |
| matlab-skills 不知道要寫去哪 | 本 skill 先跑確認路徑，再交棒給對應 skill |
與 matlab-skills Plugin 的分工
matlab-skills plugin 安裝了 MathWorks 官方的六個 skill，它們各自有很好的程式碼生成邏輯。本 skill 不跟它們競爭，而是作為前置層：
本 skill（先） matlab-skills（後）
──────────────────────── ──────────────────────────────
Session Announcement 生成 Live Script 格式
確認 / 建立 project 目錄 寫 *Test.m 測試類別
init_project.m 建立 tests\ 等 執行 buildtool / runtests
確認 src\ 存在（filter-design 需要） 設計 FIR/IIR 濾波器
判斷是否需先備份（optimizer 前） 套用 vectorization 技術
| 使用者的任務 | 先用本 skill | 再用 matlab-skills |
|---|
| 寫 Live Script | 確認 / 建立路徑 | matlab-live-script |
| 建單元測試 | 確認 tests\ 存在 | matlab-test-creator |
| 跑測試 / coverage | 確認在 project root | matlab-test-execution |
| 效能優化 | 判斷是否需先備份 | matlab-performance-optimizer |
| 建 HTML App | 確認 src\html\ | matlab-uihtml-app-builder |
| 設計濾波器 | 確認 src\ 存在 | matlab-digital-filter-design |
[!NOTE]
matlab-digital-filter-design 強制所有程式碼先寫成 .m 檔再執行，不可以直接傳入 evaluate_matlab_code。這表示它必須有一個 src\ 目錄可以寫入——本 skill 的 init_project.m 就是為此而存在的前置條件。
路徑設計原則
[!IMPORTANT]
Workspace root 路徑從不寫死在任何程式碼或文件中。
scripts\ 裡的程式碼用 mfilename('fullpath') 反推自身位置，src\ 裡的程式碼用 get_ws_root() 找到標記檔 ws_config.m。兩條路，都不需要 hardcode。
文件中所有 <WORKSPACE_ROOT> 均代表你的實際 workspace 根目錄，可以是任何路徑。
Workspace 根目錄結構
<WORKSPACE_ROOT>\
├── projects\ # 正式任務（持久化，跨對話延續）
│ └── YYYYMMDD_<slug>\
│ ├── README.md # 跨 session 記憶載體
│ ├── main.m
│ ├── buildfile.m # buildtool 入口（matlab-test-execution）
│ ├── src\ # 模組化函數（按功能分子目錄）
│ │ ├── <module>\ # 功能模組（如 preprocessing\、training\）
│ │ ├── _backups\ # 結構性改寫備份
│ │ └── html\ # uihtml 前端（選用）
│ ├── tests\ # *Test.m（matlab-test-creator）
│ ├── docs\ # 專案說明文件
│ │ ├── architecture.md
│ │ ├── api.md
│ │ └── experiments.md
│ ├── data\
│ └── output\
├── _temp\ # 臨時測試（≤ 14 天生命週期）
├── _shared\ # 跨專案工具函數（永久）
├── _archive\ # 已完成專案（封存）
├── scripts\ # 本 skill 工具程式碼
├── ws_config.m # Workspace 標記檔（勿移動）
├── startup.m # 由 startup_workspace.m 自動維護
└── .gitignore
快速上手
% 1. 每次 session 開始（腳本自己知道 workspace 在哪）
run('<WORKSPACE_ROOT>\skills\matlab-mcp-workspace\scripts\startup_workspace.m')
% 2. 新建 project（建立 src\、tests\、buildfile.m 等）
% → 修改 init_project.m 的 CONFIG 後執行
% 3. 繼續舊 project
run('<WORKSPACE_ROOT>\skills\matlab-mcp-workspace\scripts\list_workspace.m')
% → 確認 folder 名稱 → cd 進去 → 讀 README.md
% 4. 定期健康檢查
run('<WORKSPACE_ROOT>\skills\matlab-mcp-workspace\scripts\workspace_health.m')
[!NOTE]
唯一需要你手填 <WORKSPACE_ROOT> 的地方只有啟動那一行。之後腳本全部自動定位。
常用腳本索引
| 腳本 | 何時用 |
|---|
skills/matlab-mcp-workspace/scripts/startup_workspace.m | 每次 session 開始 |
skills/matlab-mcp-workspace/scripts/init_project.m | 建立新 project（含 tests\ + buildfile.m） |
skills/matlab-mcp-workspace/scripts/list_workspace.m | 跨對話繼續前 |
skills/matlab-mcp-workspace/scripts/upgrade_temp.m | Temp 決定保留時 |
skills/matlab-mcp-workspace/scripts/workspace_health.m | 定期清理 |
skills/matlab-mcp-workspace/scripts/get_ws_root.m | 在 src\ 程式碼中取得 workspace root |
references/
