SuperAPI AI 工具集

matlab-runner

编程与开发

查看项目

更新于 10-16 07:30

技能介绍

MATLAB Runner 是一个用于在 Codex 中安全、可重复地执行 MATLAB 工作的技能,通过官方 MATLAB MCP 服务器运行,默认优先使用自动模式,仅在用户明确要求时才使用终端批量工作流。它是所有其他 MATLAB 技能的基础技能。

用途 该技能用于执行 MATLAB R2026a 任务,提供基于 MCP 的可靠执行、日志、产物、工具箱清单、冒烟测试和可复现验证。

主要能力

  • 通过官方 MATLAB MCP 自动模式执行 MATLAB 工作,可复用已有共享会话或自动启动 MATLAB。
  • 捕获日志、版本信息、工作目录和产物路径。
  • 支持工具箱清单检查、冒烟测试与可复现验证。
  • 提供 PowerShell 包装脚本用于批量执行、MCP 自动模式设置与验证、以及完整本地冒烟测试。
  • 包含 MATLAB 发现顺序、错误处理流程和验收检查标准。
  • 支持开源论文复现模式。

使用方式 执行规则:

  • 优先使用官方 MATLAB MCP 自动模式。
  • 当预期使用 MCP 时,不要静默回退到 matlab -batch。
  • 在适用的情况下捕获日志、版本信息、工作目录和产物路径。
  • 从项目根目录运行,而不是随机临时文件夹,除非需要隔离。
  • 将生成文件放在 artifacts/ 或用户指定的输出文件夹下。
  • 保持脚本确定性:为随机生成器设置种子并记录数据来源。

MCP 默认要求:

  • 优先使用官方 MATLAB MCP 自动模式,以便服务器复用现有共享会话或自动启动 MATLAB。
  • 如果任务需要重复模型编辑、带实时检查的参数扫描或用户可见的桌面交互,请继续使用 MCP。
  • 批量模式保留给用户明确请求,例如 CI、无头冒烟测试或可复现的一次性运行。
  • 如果 MCP 不可用,报告阻塞问题,而不是静默更改执行模式。

首选包装脚本:

  • 如果用户明确请求批量执行,优先使用: powershell -ExecutionPolicy Bypass -File .\scripts\Invoke-MatlabBatch.ps1 -Script .\path\to\script.m
  • 官方 MCP 自动模式设置与验证: powershell -ExecutionPolicy Bypass -File .\scripts\Setup-MatlabMcpExistingSession.ps1 powershell -ExecutionPolicy Bypass -File .\scripts\Test-MatlabMcpExistingSession.ps1
  • 完整本地冒烟测试: powershell -ExecutionPolicy Bypass -File .\scripts\Test-MatlabSkills.ps1
  • 如果包装脚本不可用,直接调用 MATLAB: matlab -batch "disp(version); v=ver; disp({v.Name}')"

MATLAB 发现顺序:

  1. 官方 MATLAB MCP 自动配置
  2. 现有的官方 MATLAB 共享会话元数据(如果存在)
  3. $env:MATLAB_EXE、Get-Command matlab 和已知安装路径,仅用于 MCP 环境的设置/验证

在运行昂贵工作前验证: disp(version) v = ver; {v.Name}'

错误处理:

  • 阅读第一个错误和最深的堆栈帧。
  • 使用 license('test', product) 和 ver 检查缺失的工具箱。
  • 使用 which functionName -all 检查路径歧义。
  • 在编辑大型代码之前重新运行最小复现。
  • 保存失败的命令和日志路径。
  • 如果失败发生在 MCP 上,报告确切的 MCP 阻塞问题,不要用批量重跑掩盖它。

验收检查(至少选择一项):

  • 使用 runtests 和 assertSuccess 的单元测试通过。
  • 数值容差检查通过。
  • Simulink 模型仿真到停止时间,且记录信号非空。
  • 图、数据文件、报告或生成的代码存在且大小非零。
  • 对触及文件的静态检查(如 checkcode)未返回关键问题。

论文复现模式:

  • 记录论文 URL、提交哈希、数据集 URL、MATLAB 版本、工具箱列表。
  • 先运行最小的官方示例。
  • 在扩展到整篇论文之前,先复现一个图或表。
  • 保存 manifest.json、原始日志、处理后的数据和生成的图。
  • 明确标记与论文的差异,而不是平滑处理。

适用场景 适用于在 Codex 中执行 MATLAB 任务,包括需要 MCP 自动模式、批量执行、冒烟测试、工具箱检查、可复现验证以及开源论文复现的场景。

限制

  • 批量模式仅在用户明确要求时使用。
  • 如果 MCP 不可用,应报告阻塞问题,而不是静默更改执行模式。
  • 具体收费、价格、平台支持范围等信息暂未提供。