SuperAPI AI 工具集

matlab-review-code

编程与开发

查看项目

更新于 10-16 06:45

技能介绍

用途:系统审查 MATLAB 代码的质量、正确性、性能与 MathWorks 编码规范符合度,结合静态分析与人工检查。适用于用户要求审查、审计或改进代码质量,检查编码标准,代码交付、发布或开源前准备,重大实现后提交前验证,以及清理“代码异味”等场景。不适用于调试运行时错误(改用 matlab-debug-code)、性能优化(改用性能剖析技能)或生成测试(改用 matlab-write-tests)。

主要能力:先对目标文件运行 check_matlab_code MCP 工具做静态分析,再读取 matlab_coding_guidelines MCP 资源作为权威标准;检查命名(函数 lowerCamelCase、类 PascalCase、常量 UPPER_SNAKE、测试文件 t 前缀、文件名与主函数一致)、函数签名(arguments 块、输入输出数量、name-value 模式)、结构(函数长度、嵌套深度、复杂度)、代码模式(向量化、预分配、现代 API 如 tiledlayout、datetime、string、table)等。高严重度问题包括 eval/assignin/evalin、循环内数组增长、遮蔽内置函数、缺少 arguments 块、硬编码反斜杠路径。

使用方式:按工作流执行——运行静态分析、加载编码标准、检查命名、审查函数签名、评估结构、检查模式、按严重程度汇总。可用 checkcode("src/computeArea.m", "-struct") 逐文件检查,R2022b+ 可用 codeIssues("src") 做目录级分析;用 matlab.codetools.requiredFilesAndProducts 检查工具箱依赖。报告按错误>警告>建议分级。

限制:checkcode 无法捕获所有问题,如 subplot 用法、遮蔽内置变量、嵌套深度、硬编码路径、魔法数字、缺失 H1 帮助文本,需人工扫描;审查为只读评估,不应建议改变行为的修改;弃用 API 迁移细节应使用 matlab-modernize-code 技能。