用途:在打包 MATLAB 工具箱前评估其就绪度,并给出改进建议。适用于运行 matlab-build-toolbox 之前、用户询问“是否可打包/还差什么”或“让它可发布”时,也可作为开发中的定期健康检查。不用于构建(用 matlab-build-toolbox)、发布(matlab-publish-toolbox)、定义 API(matlab-define-toolbox-api)或生成文档(matlab-document-toolbox)。
主要能力:提供 Quick(仅检查 1、4、7、12)、Standard(全部 16 项,默认)、Deep(全部文件加跨文件分析)三档。检查项包括 H1 帮助、完整帮助文本、arguments 块、测试存在与通过、覆盖率、代码问题、规格漂移、依赖、函数签名、版本号、README、许可证、toolbox 文件夹分离、GettingStarted 指南、忽略文件。每项有固定影响等级(HIGH/MEDIUM/LOW),按优先级输出待办清单,并报告通过项与跳过项。
使用方式:输入 project_root(默认当前目录),可选 spec(buildUtilities/toolboxSpecification.m)与 manifest(buildUtilities/tbxManifest.m)。先询问评估级别,再扫描目录、运行 mcp__matlab__check_matlab_code 等 MCP 工具,按 1–16 顺序检查,输出报告后询问修复哪些项(全部/选择/跳过),经批准才执行修复。
限制:评估阶段严格只读,即使用户要求也不得写文件;仅能委托已加载的 /matlab-document-toolbox 与 /matlab-exclude-files,其他发现只能作为“未来改进”提示;不重构或移动文件;结论须有具体文件或模式证据;不得更改影响等级或跳过检查(除非用户明确要求)。